From 76280b84db255380f6f27e4386fbaf98cdeb9b7c Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Thu, 16 Feb 2023 09:40:39 +0100 Subject: [PATCH] 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. --- lib/doc/UserGuide.lyx | 186 +++++++++++++++++++++++++++++++++++++-- lib/doc/de/UserGuide.lyx | 120 ++++++++++++++++++++++++- 2 files changed, 295 insertions(+), 11 deletions(-) diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx index 3201565934..38afa845bd 100644 --- 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{} +\end_layout + +\begin_layout Standard + +\change_inserted -712698321 1676536347 +where +\family typewriter + +\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 faac96752d..c8e4f1d8ba 100644 --- 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{} +\end_layout + +\begin_layout Standard +wobei +\family typewriter + +\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 -- 2.39.5