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.
This commit is contained in:
Juergen Spitzmueller 2023-02-16 09:40:39 +01:00
parent 62ea103662
commit 76280b84db
2 changed files with 295 additions and 11 deletions

View File

@ -33773,7 +33773,7 @@ Here is an example URL:
's homepage: 's homepage:
\begin_inset Flex URL \begin_inset Flex URL
status collapsed status open
\begin_layout Plain Layout \begin_layout Plain Layout
@ -33786,24 +33786,194 @@ https://www.lyx.org
\end_layout \end_layout
\begin_layout Standard \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 the URL text will always be in the style
\family typewriter \family typewriter
Typewriter Typewriter
\family default \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. use hyperlinks as explained in the next subsection.
By default longer
\change_inserted -712698321 1676535961
\end_layout
\begin_layout Standard
\change_inserted 5863208 1676462413
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 \change_inserted 5863208 1676462413
By default longer URLs will not break at the of the line;
if
\series bold
\backslash \backslash
usepackage{xurl} usepackage{xurl}
\series default \change_deleted -712698321 1676535846
is put in the preamble then the URL can be broken at every character.
\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 \change_unchanged

View File

@ -1,5 +1,5 @@
#LyX 2.4 created this file. For more info see https://www.lyx.org/ #LyX 2.4 created this file. For more info see https://www.lyx.org/
\lyxformat 614 \lyxformat 615
\begin_document \begin_document
\begin_header \begin_header
\save_transient_properties true \save_transient_properties true
@ -8951,10 +8951,12 @@ Unformatiert
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
Dies ist Unformatiert. Dies ist Unformatiert.
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
Die folgenden 2 Zeilen sind leer: Die folgenden 2 Zeilen sind leer:
\end_layout \end_layout
@ -8967,6 +8969,7 @@ Die folgenden 2 Zeilen sind leer:
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
Fast alles ist in Unformatiert erlaubt:"%&$§#~'` Fast alles ist in Unformatiert erlaubt:"%&$§#~'`
\backslash \backslash
}][{| }][{|
@ -8992,6 +8995,7 @@ Unformatiert
\end_layout \end_layout
\begin_layout Verbatim* \begin_layout Verbatim*
Dies ist Unformatiert*. Dies ist Unformatiert*.
\end_layout \end_layout
@ -30516,7 +30520,7 @@ URL
-Homepage: -Homepage:
\begin_inset Flex URL \begin_inset Flex URL
status collapsed status open
\begin_layout Plain Layout \begin_layout Plain Layout
@ -30585,9 +30589,119 @@ Wichtiger Hinweis
\end_layout \end_layout
\begin_layout Standard \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, Um den Text zu formatieren,
müssen Sie einen Hyperlink benutzen. 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 \end_layout
\begin_layout Subsection \begin_layout Subsection