Fix URL documentation

It's not true that long URLs are not broken by default.
They are just broken only at certain characters, and this can be customized.

It's also not true that the font formatting cannot be customized.

diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx
index 320156593411ec4f52da629a309f54bbf07626ec..38afa845bda50f54a2d996fdfb5372501fd7ceae 100644 (file)
--- a/lib/doc/UserGuide.lyx
+++ b/lib/doc/UserGuide.lyx
@@ -33773,7 +33773,7 @@ Here is an example URL:
 's homepage:
  
 \begin_inset Flex URL
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -33786,24 +33786,194 @@ https://www.lyx.org
 \end_layout
 
 \begin_layout Standard
-You cannot change the style of the link text,
+
+\change_deleted -712698321 1676535921
+You cannot change the style of the link text
+\change_inserted -712698321 1676535924
+By default
+\change_unchanged
+,
  the URL text will always be in the style 
 \family typewriter
 Typewriter
 \family default
 .
- To be able to format the URL text,
+ 
+\change_inserted -712698321 1676535967
+You can globally change the formatting by putting to 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+LaTeX Preamble
+\family default
+:
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1676536088
+
+\backslash
+urlstyle{<xx>}
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1676536347
+where 
+\family typewriter
+<xx>
+\family default
+ is either 
+\family typewriter
+rm
+\family default
+ (Roman),
+ 
+\family typewriter
+sf
+\family default
+ (Sans Serif),
+ 
+\family typewriter
+tt
+\family default
+ (Typewriter),
+ or 
+\family typewriter
+same
+\family default
+ (use whatever the current text font is).
+ To have italicized URLs,
+ use this instead:
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1676536274
+
+\backslash
+def
+\backslash
+UrlFont{
+\backslash
+rmfamily
+\backslash
+itshape}
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted -712698321 1676536203
+To be able to format the URL text,
  use hyperlinks as explained in the next subsection.
+ By default longer 
+\change_inserted -712698321 1676535961
+
+\end_layout
+
+\begin_layout Standard
 
 \change_inserted 5863208 1676462413
- By default longer URLs will not break at the of the line;
- if 
-\series bold
+URLs will 
+\change_deleted -712698321 1676534694
+not 
+\change_inserted 5863208 1676462413
+break 
+\change_inserted -712698321 1676535379
+between lines at certain characters,
+ namely:
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1676535384
+.
+ @ 
+\backslash
+ / !
+ _ | ;
+ > ] % ) ,
+ ?
+ & ' + = #
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1676535411
+It does not break at a hyphen (
+\family typewriter
+-
+\family default
+) by default,
+ but you can change that by adding 
+\family sans
+hyphens
+\family default
+ to 
+\change_deleted -712698321 1676535339
+at the of the line
+\change_inserted -712698321 1676535862
+
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Document Class\SpecialChar menuseparator
+Class Options\SpecialChar menuseparator
+Custom
+\family default
+.
+\change_deleted -712698321 1676535861
+;
+
+\change_inserted 5863208 1676462413
+ 
+\change_deleted -712698321 1676535863
+i
+\change_inserted -712698321 1676535864
+I
+\change_inserted 5863208 1676462413
+f 
+\change_inserted -712698321 1676535842
+this still does not break URLs suitably to you,
+ a last resort is to put
+\family typewriter
+ 
+\change_inserted 5863208 1676462413
 
 \backslash
 usepackage{xurl}
-\series default
- is put in the preamble then the URL can be broken at every character.
+\change_deleted -712698321 1676535846
+
+\family default
+ is put 
+\change_inserted -712698321 1676536760
+ to 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+LaTeX Preamble
+\family default
+;
+ 
+\change_deleted -712698321 1676535894
+in the preamble then the
+\change_inserted -712698321 1676535897
+this will cause
+\change_inserted 5863208 1676462413
+ URL
+\change_inserted -712698321 1676535899
+s
+\change_inserted 5863208 1676462413
+ 
+\change_deleted -712698321 1676535445
+can
+\change_inserted -712698321 1676535903
+to
+\change_inserted 5863208 1676462413
+ be broken at every character.
+
+\change_deleted -712698321 1676536383
  
 \change_unchanged
 

diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx
index faac96752dcd555bfe2fc50670c2cd58f83d3878..c8e4f1d8ba33cff3bd056fac58d7583f766b1c05 100644 (file)
--- a/lib/doc/de/UserGuide.lyx
+++ b/lib/doc/de/UserGuide.lyx
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 614
+\lyxformat 615
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -8951,10 +8951,12 @@ Unformatiert
 \end_layout
 
 \begin_layout Verbatim
+
 Dies ist Unformatiert.
 \end_layout
 
 \begin_layout Verbatim
+
 Die folgenden 2 Zeilen sind leer:
 \end_layout
 
@@ -8967,6 +8969,7 @@ Die folgenden 2 Zeilen sind leer:
 \end_layout
 
 \begin_layout Verbatim
+
 Fast alles ist in Unformatiert erlaubt:"%&$§#~'`
 \backslash
 }][{|
@@ -8992,6 +8995,7 @@ Unformatiert
 \end_layout
 
 \begin_layout Verbatim*
+
 Dies ist Unformatiert*.
 \end_layout
 
@@ -30516,7 +30520,7 @@ URL
 -Homepage:
  
 \begin_inset Flex URL
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -30585,9 +30589,119 @@ Wichtiger Hinweis
 \end_layout
 
 \begin_layout Standard
-Der Text eines URLs wird immer im Schreibmaschinenstil gedruckt.
+Der Text eines URLs wird per Voreinstellung immer im 
+\family typewriter
+Schreibmaschinenstil
+\family default
+ gedruckt.
  Um den Text zu formatieren,
  müssen Sie einen Hyperlink benutzen.
+ Sie können den Stil global ändern,
+ indem Sie in 
+\family sans
+Dokument\SpecialChar menuseparator
+Einstellungen\SpecialChar menuseparator
+LaTeX-Vorspann
+\family default
+ folgendes einfügen:
+\end_layout
+
+\begin_layout LyX-Code
+
+\backslash
+urlstyle{<xx>}
+\end_layout
+
+\begin_layout Standard
+wobei 
+\family typewriter
+<xx>
+\family default
+ entweder 
+\family typewriter
+rm
+\family default
+ (Serifenschrift),
+ 
+\family typewriter
+sf
+\family default
+ (serifenlose Schrift),
+ 
+\family typewriter
+tt
+\family default
+ (Schreibmaschine) oder 
+\family typewriter
+same
+\family default
+ (verwende die aktuellen Schrifteinstellungen) ist.
+ Für kursive URLs verwenden Sie stattdessen dies:
+\end_layout
+
+\begin_layout LyX-Code
+
+\backslash
+def
+\backslash
+UrlFont{
+\backslash
+rmfamily
+\backslash
+itshape}
+\end_layout
+
+\begin_layout Standard
+URLs werden am Zeilenende nur nach bestimmten Zeichen umbrochen,
+ nämlich:
+\end_layout
+
+\begin_layout LyX-Code
+.
+ @ 
+\backslash
+ / !
+ _ | ;
+ > ] % ) ,
+ ?
+ & ' + = #
+\end_layout
+
+\begin_layout Standard
+Ein Zeilenumbruch nach Bindestrich (
+\family typewriter
+-
+\family default
+) findet per Voreinstellung nicht statt,
+ aber Sie können dies erzwingen,
+ indem Sie 
+\family sans
+hyphens
+\family default
+ in
+\family sans
+ Dokument\SpecialChar menuseparator
+Einstellungen\SpecialChar ldots
+\SpecialChar menuseparator
+Dokumentklasse\SpecialChar menuseparator
+Klassenoptionen
+\family default
+ eingeben.
+ Wenn Ihre URLs danach immer noch nicht gut genug umbrochen werden,
+ können Sie als letzten Ausweg
+\family typewriter
+ 
+\backslash
+usepackage{xurl}
+\family default
+ in 
+\family sans
+Dokument\SpecialChar menuseparator
+Einstellungen\SpecialChar menuseparator
+LaTeX-Vorspann
+\family default
+ einfügen;
+ dann werden URLs nach jedem beliebigen Zeichen umbrochen.
 \end_layout
 
 \begin_layout Subsection