From 075306e1e612a4610b37459a2f8571faa760b8d2 Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Sat, 16 Dec 2017 17:35:40 +0100 Subject: [PATCH] Further modifications of the "Dashes and Linebreaks" section (cherry picked from commit ad093160d8c183f2b09d8e844047ea4b8813f079) --- lib/doc/UserGuide.lyx | 308 ++++++++++++++++++++++++++++++++++++--- lib/doc/de/UserGuide.lyx | 235 ++++++++++++++--------------- 2 files changed, 395 insertions(+), 148 deletions(-) diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx index 0f405f7929..2a0ac1c199 100644 --- a/lib/doc/UserGuide.lyx +++ b/lib/doc/UserGuide.lyx @@ -140,11 +140,12 @@ enumitem \papercolumns 1 \papersides 2 \paperpagestyle default -\tracking_changes false +\tracking_changes true \output_changes false \html_math_output 0 \html_css_as_file 0 \html_be_strict true +\author -712698321 "Jürgen Spitzmüller" \end_header \begin_body @@ -8335,12 +8336,14 @@ Verbatim \end_layout \begin_layout Verbatim + This is Verbatim. \end_layout \begin_layout Verbatim \noindent \align block + The following 2 lines are empty: \end_layout @@ -8353,6 +8356,7 @@ The following 2 lines are empty: \end_layout \begin_layout Verbatim + Almost everything is allowed in Verbatim:"%&$§#~'` \backslash }][{| @@ -8376,6 +8380,7 @@ Verbatim \end_layout \begin_layout Verbatim* + This is Verbatim*. \end_layout @@ -16563,7 +16568,7 @@ literal "false" \end_layout \begin_layout Subsection -Dashes and line breaks +Dashes and Line Breaks \begin_inset CommandInset label LatexCommand label name "subsec:Dashes-and-line-breaks" @@ -16574,8 +16579,13 @@ name "subsec:Dashes-and-line-breaks" \end_layout \begin_layout Standard -Whether line breaks around dashes are allowed depends on the use case and - locale: +Whether line breaks +\change_deleted -712698321 1513438804 +around +\change_inserted -712698321 1513438805 +at +\change_unchanged + dashes are allowed depends on the use case and locale: \end_layout \begin_layout Itemize @@ -16595,9 +16605,20 @@ In French and Spanish, dashes around parenthetical statements are treated \end_layout \begin_layout Standard + +\change_deleted -712698321 1513437551 In \SpecialChar LyX -, line breaks after en-dashes and em-dashes are only allowed (without - manual intervention), if the option +, +\change_inserted -712698321 1513437622 +The dashes that are output by \SpecialChar LyX + to \SpecialChar LaTeX + by default generally allow for +\change_unchanged +line breaks after en-dashes and em-dashes +\change_inserted -712698321 1513437597 +as well as linebreaks before em-dashes. +\change_deleted -712698321 1513438851 +are only allowed (without manual intervention), if the option \family sans Document\SpecialChar menuseparator Settings\SpecialChar menuseparator @@ -16636,6 +16657,8 @@ In this case, the dashes are output as \end_inset +\change_unchanged + \end_layout \begin_layout Standard @@ -16643,12 +16666,22 @@ Please note: \end_layout \begin_layout Enumerate + +\change_deleted -712698321 1513437637 This results in optional line breaks after \emph on all \emph default en- and em-dashes. - Unwanted line breaks must be prevented by wrapping in a makebox + +\change_unchanged +Unwanted line breaks +\change_deleted -712698321 1513437645 +must +\change_inserted -712698321 1513437646 +can +\change_unchanged + be prevented by wrapping in a makebox \begin_inset Foot status collapsed @@ -16784,6 +16817,8 @@ An incorrect line break is easily overlooked because \end_deeper \begin_layout Enumerate + +\change_deleted -712698321 1513437701 The setting is ignored for documents using non-\SpecialChar TeX fonts. \begin_inset Foot @@ -16814,9 +16849,13 @@ XeTeXdashbreakstate=0 \end_inset +\change_unchanged + \end_layout \begin_layout Enumerate + +\change_deleted -712698321 1513437705 Em dashes in \family typewriter typewriter @@ -16830,22 +16869,63 @@ typewriter --- \family default in the output. +\change_unchanged + \end_layout \begin_layout Enumerate -Hyphenation is suppressed in words adjacent to hyphens and ligature dashes. + +\change_inserted -712698321 1513437950 +The default dashes output to \SpecialChar LaTeX + disable +\change_deleted -712698321 1513437951 +H +\change_inserted -712698321 1513437954 +h +\change_unchanged +yphenation +\change_deleted -712698321 1513437961 +is suppressed +\change_unchanged +in words adjacent to hyphens and ligature dashes. \end_layout \begin_layout Standard -If the option +If +\change_inserted -712698321 1513438154 +you want to globally disable line breaks at dashes, you can select +\change_unchanged +the option \family sans Document\SpecialChar menuseparator Settings\SpecialChar menuseparator Fonts\SpecialChar menuseparator + +\change_inserted -712698321 1513438180 +Disallow line breaks at dashes +\family default +. + In this case optional line breaks at individual +\family sans + dashes +\change_deleted -712698321 1513438124 Output en- and em-dashes as ligatures \family default - has not been selected, you can insert optional line breaks via the menu + has not been selected, you +\change_unchanged + can +\change_inserted -712698321 1513438126 +be +\change_deleted -712698321 1513438191 +insert +\change_inserted -712698321 1513438193 +re-allowed +\change_unchanged +\change_deleted -712698321 1513438149 +optional line breaks +\change_unchanged +via the menu \family sans Insert\SpecialChar menuseparator Formatting\SpecialChar menuseparator @@ -16862,12 +16942,55 @@ should be broken \end_layout \begin_layout Standard + +\change_inserted -712698321 1513440855 +Note: Up to \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.1, you could insert en-dashes and em-dashes as -- and ---, respectively; + they were automatically merged to proper (breakable) dashes in the output, + but kept as consecutive hyphen characters in the LyX document. + If you inserted literal dash characters, however, they were output to \SpecialChar LaTeX + + as +\emph on +non-breakable +\emph default + dashes (this was actually rather by accident than intentionally, but some + used these two forms of dashes deliberately). + +\change_unchanged As of \SpecialChar LyX \begin_inset space ~ \end_inset -2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation +2.2, +\change_inserted -712698321 1513439795 +things work differently: consecutive hyphens are merged to dashes immediately + in the input. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1513439552 +The behavior was changed since it led to different look in \SpecialChar LyX +, text export, + HTML export and the PDF export. +\end_layout + +\end_inset + + If you copy consecutive hyphens, by contrast, they are output as consecutive + hyphen characters. + An unintended consequence of this change was that all dashes now were output + as non-breakable dashes. + +\change_deleted -712698321 1513438403 +-- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation to dashes. \begin_inset Foot status collapsed @@ -16885,16 +17008,117 @@ Up to \SpecialChar LyX \end_inset - Occurrences in older documents are converted to literal Unicode dashes. - This led to different line breaks in some documents. + +\change_unchanged + +\change_inserted -712698321 1513439864 +Since furthermore, in order to maintain the output, +\change_deleted -712698321 1513439597 +O +\change_inserted -712698321 1513439745 +o +\change_unchanged +ccurrences +\change_inserted -712698321 1513439745 +of consecutive hyphens +\change_unchanged +in +\change_deleted -712698321 1513439612 +older +\change_unchanged +documents +\change_inserted -712698321 1513439745 + that were saved by +\change_unchanged + +\change_inserted -712698321 1513439745 +\SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.1 or earlier versions, +\change_deleted -712698321 1513439871 +a +\change_inserted -712698321 1513439871 +we +\change_unchanged +re converted to literal +\change_deleted -712698321 1513438458 +Unicode +\change_inserted -712698321 1513439745 +en- and em- +\change_unchanged +dash +\change_inserted -712698321 1513439745 + charact +\change_unchanged +e +\change_inserted -712698321 1513439745 +r +\change_unchanged +s +\change_inserted -712698321 1513439884 +, respectively, these were output to \SpecialChar LaTeX + in \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.2 as +\emph on +non-breakable +\emph default + dashes as well +\change_unchanged +. + +\change_inserted -712698321 1513439888 +An obvious drawback of all this was that +\change_deleted -712698321 1513438506 +This +\change_inserted -712698321 1513439745 +it +\change_deleted -712698321 1513440124 + led to +\change_inserted -712698321 1513440127 +resulted in +\change_unchanged + different line breaks in some documents. \SpecialChar LyX \begin_inset space ~ \end_inset -2.3 provides the aforementioned option +2.3 +\change_inserted -712698321 1513439906 +, by contrast and as outlined above, outputs +\change_unchanged + +\change_inserted -712698321 1513441767 + +\emph on +breakable +\emph default + dashes by default, so if you load a document saved previous to LyX 2.2, + you should get the identical output with LyX 2.3 for the dashes inserted + with -- and ---. + Furthermore, \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.3 +\change_unchanged +provides the aforementioned option +\change_deleted -712698321 1513438447 + \family sans Output en- and em-dashes as ligatures +\change_inserted -712698321 1513441759 +Disallow line breaks at dashes +\change_unchanged + \family default in the menu \family sans @@ -16903,12 +17127,28 @@ Settings\SpecialChar menuseparator Fonts. \family default - It is on by default but unselected when opening documents edited with \SpecialChar LyX + It is o +\change_deleted -712698321 1513438517 +n +\change_inserted -712698321 1513441759 +ff +\change_unchanged + by default but +\change_deleted -712698321 1513438522 +un +\change_unchanged +selected when opening documents edited with \SpecialChar LyX \begin_inset space ~ \end_inset -2.2. +2.2 +\change_inserted -712698321 1513441759 + in order to maintain line breaking between \SpecialChar LyX + 2.2 and 2.3 (so these document + have non-breakable dashes) +\change_unchanged +. \begin_inset Newline newline \end_inset @@ -16917,27 +17157,55 @@ Note the following side-effects of the changes in \SpecialChar LyX \end_layout \begin_layout Itemize -If you used literal em- and en dashes in pre-\SpecialChar LyX +If you used +\change_inserted -712698321 1513440192 +only +\change_unchanged +literal em- and en dashes in pre-\SpecialChar LyX \begin_inset space ~ \end_inset -2.2 documents, you must manually unselect +2.2 documents, you must manually +\change_deleted -712698321 1513438688 +un +\change_unchanged +select +\change_deleted -712698321 1513438687 + \family sans Output en- and em-dashes as ligatures +\change_inserted -712698321 1513438687 +Disallow line breaks at dashes +\change_unchanged + \family default to ensure unchanged behavior. \end_layout \begin_layout Itemize -If you used both, literal and ligature dashes in pre-\SpecialChar LyX +If you used both +\change_deleted -712698321 1513441852 +, +\change_unchanged + literal and +\change_deleted -712698321 1513441864 +ligature +\change_inserted -712698321 1513441867 +--/--- +\change_unchanged + dashes in pre-\SpecialChar LyX \begin_inset space ~ \end_inset 2.2 documents, you may need to enable or prevent individual line breaks as - shown above to restore the correct line breaking behaviour. + shown above to restore the correct line breaking behavio +\change_deleted -712698321 1513441864 +u +\change_unchanged +r. \end_layout \begin_layout Itemize diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx index 0595b63424..832ac90e31 100644 --- a/lib/doc/de/UserGuide.lyx +++ b/lib/doc/de/UserGuide.lyx @@ -8597,10 +8597,12 @@ Unformatiert \end_layout \begin_layout Verbatim + Dies ist Unformatiert. \end_layout \begin_layout Verbatim + Die folgenden 2 Zeilen sind leer: \end_layout @@ -8613,6 +8615,7 @@ Die folgenden 2 Zeilen sind leer: \end_layout \begin_layout Verbatim + Fast alles ist in Unformatiert erlaubt:"%&$§#~'` \backslash }][{| @@ -8636,6 +8639,7 @@ Unformatiert \end_layout \begin_layout Verbatim* + Dies ist Unformatiert*. \end_layout @@ -16928,61 +16932,17 @@ Im Französischen und Spanischen werden Gedankenstriche um eingeschobene \begin_layout Standard In \SpecialChar LyX - sind Zeilenumbrüche nach Halbgeviert- und Geviertstrichen nur dann ohne - manuellen Eingriff erlaubt, wenn die Option -\family sans -Dokument\SpecialChar menuseparator -Einstellungen\SpecialChar menuseparator -Schriften\SpecialChar menuseparator -Halbgeviert- und Geviertstriche als Ligaturen - ausgeben -\family default - gewählt wurde (bei \SpecialChar LyX - 2.3 ist das die Voreinstellung). -\begin_inset Foot -status collapsed - -\begin_layout Plain Layout -Die Striche werden in diesem Fall als -\begin_inset Quotes gld -\end_inset - --- -\begin_inset Quotes grd -\end_inset - - und -\begin_inset Quotes gld -\end_inset - ---- -\begin_inset Quotes grd -\end_inset - - in die \SpecialChar LaTeX - Quelldatei geschrieben. - Der \SpecialChar TeX --Ligaturmechanismus konvertiert sie zu (Halb-)Geviertstrichen, auf - die ein optionaler Zeilenumbruch folgt. -\end_layout - -\end_inset - - + sind Zeilenumbrüche nach Halbgeviert- und Geviertstrichen sowie vor + Geviertstrichen in der Voreinstellung grundsätzlich erlaubt. \end_layout \begin_layout Standard -Vorsicht: +Bitte beachten Sie: \end_layout \begin_layout Enumerate -Die Einstellung erlaubt Zeilenumbrüche nach -\emph on -allen -\emph default - Halbgeviert- und Geviertstrichen. - Unerwünschte Zeilenumbrüche können verhindert werden, indem man sie in - eine Makebox packt +Unerwünschte Zeilenumbrüche können verhindert werden, indem man sie in eine + Makebox packt \begin_inset Foot status collapsed @@ -17110,57 +17070,9 @@ Ein inkorrekter Zeilenumbruch wird schnell übersehen, denn \end_deeper \begin_layout Enumerate -In Dokumenten, die keine \SpecialChar TeX --Schriften verwenden, wird die Option ignoriert. -\begin_inset Foot -status open - -\begin_layout Plain Layout -Xe\SpecialChar TeX - bietet die Einstellung -\series bold - -\backslash -XeTeXdashbreakstate -\series default -. - Die Voreinstellung bewirkt, dass sich alle Halbgeviert- und Geviertstriche - sich wie Ligaturstriche verhalten. - Mit -\series bold - -\backslash -XeTeXdashbreakstate=0 -\series default - im \SpecialChar LaTeX --Vorspann kann auf das Verhalten von normalen Halbgeviert- und Geviertstrich -en umgestellt werden. -\end_layout - -\end_inset - - -\end_layout - -\begin_layout Enumerate -Gedankenstriche in -\family typewriter -Schreibmaschinenschrift -\family default - werden -\family typewriter -–- -\family default - oder -\family typewriter ---- -\family default - in der Ausgabe. -\end_layout - -\begin_layout Enumerate -Bei Wörtern, die an Ligatur-Gedankenstriche grenzen, erfolgt – wie bei zusammeng -esetzten Wörtern mit Bindestrich – keine automatische Worttrennung (vgl. +Bei Wörtern, die direkt an Halbgeviert- und Geviertstriche grenzen, erfolgt + – wie bei zusammengesetzten Wörtern mit Bindestrich – keine automatische + Worttrennung (vgl. Abschnitt \begin_inset space ~ \end_inset @@ -17179,22 +17091,24 @@ noprefix "false" \end_layout \begin_layout Standard -Wurde die Option +Wenn sie global Zeilenumbrüche nach Halbgeviertstrichen sowie vor und nach + Geviertstrichen verhindern wollen, wählen Sie die Option \family sans Dokument\SpecialChar menuseparator Einstellungen\SpecialChar menuseparator Schriften\SpecialChar menuseparator -Halbgeviert- und Geviertstriche als Ligaturen - ausgeben +Zeilenumbruch bei Halbgeviert- und Geviertstrichen + verhindern \family default - nicht gewählt, kann man umgekehrt optionale Zeilenumbrüche mit dem Menü - +. + In diesem Fall können Sie optionale Zeilenumbrüche bei einzelnen dieser + Striche mit dem Menü \family sans Einfügen\SpecialChar menuseparator Formatierung\SpecialChar menuseparator Optionaler Zeilenumbruch \family default - einfügen: + einfügen wieder erlauben: \end_layout \begin_layout Itemize @@ -17205,42 +17119,102 @@ sollten an der Zeile umbrochen werden \end_layout \begin_layout Standard -Seit \SpecialChar LyX +Achtung: Bis \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.1 konnten Sie Halbgeviert- und Geviertstriche als -- und --- eingeben; + sie wurden automatisch in der Ausgabe in ( +\emph on +umbrechbare +\emph default +) Halbgeviert- und Geviertstriche umgewandelt, im \SpecialChar LyX +-Dokument aber als Reihe + von Bindestrichen beibehalten. + Wenn Sie dagegen einen richtigen Halbgeviert- oder Geviertstrich eingegeben + haben, wurde dieser als +\emph on +nicht umbrechbar +\emph default + nach \SpecialChar LaTeX + ausgegeben (das war eher ein Versehen als Absicht, aber Einige haben + diese beiden Varianten der Halbgeviert- oder Geviertstriche bewusst verwendet). + Seit \SpecialChar LyX \begin_inset space ~ \end_inset -2.2 werden beim LaTeX-Export -- und --- als -{}- und -{}-{}- ausgegeben um - die Ligatur zu einem Halbgeviert- oder Geviertstrich zu verhindern. +2.2 werden nacheinander eingegebene Bindestriche direkt in \SpecialChar LyX + in echte Halbgeviert- + oder Geviertstriche umgewandelt. \begin_inset Foot status collapsed \begin_layout Plain Layout -Bis zu \SpecialChar LyX +Das wurde geändert, weil das frühere Verhaltens zu unterschiedlichem Aussehen + in \SpecialChar LyX +, Text- und HTML-Export im Vergleich zu DVI-, PDF-, und Postscript-Export + führte. +\end_layout -\begin_inset space ~ \end_inset -2.1 wurde -- und --- in \SpecialChar LyX - unverändert ausgegeben, was zu unterschiedlichem - Aussehen in \SpecialChar LyX -, Text- und HTML-Export im Vergleich zu DVI-, PDF-, und Postscript- -Export führte. -\end_layout + Wenn Sie aufeinander folgende Bindestrich in ein \SpecialChar LyX +-Dokument kopieren, werden + diese hingegen auch als aufeinander folgende Bindestriche ausgegeben. + Eine unbeabsichtigte Folge dieser Veränderung war es, dass nun alle Halbgeviert +- oder Geviertstriche als +\emph on +nicht umbrechbar +\emph default + ausgegeben wurden. + Da weiterhin, um die Ausgabe von Halbgeviert- oder Geviertstrichen aus + alten Dokumenten zu gewährleisten, Vorkommen von -- und --- in Dokumenten, + die mit \SpecialChar LyX +\begin_inset space ~ \end_inset - Vorkommen in älteren Dokumenten werden in die entsprechenden Unicode-Zeichen - konvertiert. - Dies führte in einigen Dokumenten zu veränderten Zeilenumbrüchen. +2.1 (oder einer älteren Version) gespeichert wurden, in die (Halb)Geviertzeichen + konvertiert wurden, wurden diese folglich auch als +\emph on +nicht umbrechbare +\emph default + Zeichen ausgegeben. + Dies führte offensichtlich dazu, dass es in einigen Dokumenten veränderte + Zeilenumbrüche gab. Seit \SpecialChar LyX \begin_inset space ~ \end_inset -2.3 gibt es die oben erwähnte Option +2.3 werden, im Gegensatz dazu und wie oben erläutert, per Voreinstellung + immer +\emph on +umbrechbare +\emph default + Halbgeviert- oder Geviertstriche ausgegeben. + Wenn Sie also ein Dokument, dass mit \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.1 (oder einer älteren Version) gespeichert wurde, mit \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.3 laden, sollten Sie für die mit -- und --- eingegebenen Striche dieselbe + Ausgabe bekommen. + Zudem gibt es seit \SpecialChar LyX + +\begin_inset space ~ +\end_inset + +2.3 die oben erwähnte Option \family sans -Halbgeviert- und Geviertstriche als Ligaturen ausgeben +Zeilenumbruch bei Halbgeviert- und Geviertstrichen verhindern \family default im Menü \family sans @@ -17249,13 +17223,14 @@ Einstellungen\SpecialChar menuseparator Schriften \family default . - Sie ist per Voreinstellung aktiviert, wird aber deaktiviert, wenn Dokumente + Sie ist per Voreinstellung deaktiviert, wird aber aktiviert, wenn Dokumente geöffnet werden, die mit \SpecialChar LyX \begin_inset space ~ \end_inset -2.2 erstellt wurden. +2.2 erstellt wurden, um Zeilenumbrüche zwischen diesen beiden Versionen unverände +rt zu lassen (diese Dokumente haben also weiterhin nicht umbrechbare Striche). \begin_inset Newline newline \end_inset @@ -17263,17 +17238,21 @@ Beachten Sie die folgenden Nebeneffekte der Änderungen: \end_layout \begin_layout Itemize -Falls Sie gewöhnliche Gedankenstriche in Dokumenten älter als \SpecialChar LyX +Falls Sie ausschließlich echte Gedankenstriche in Dokumenten älter als \SpecialChar LyX \begin_inset space ~ \end_inset -2.2 verwendet haben, müssen Sie die Option manuell ausschalten um sicherzustellen -, dass diese Dokumente unverändert ausgegeben werden. +2.2 verwendet haben, müssen Sie die Option +\family sans +Zeilenumbruch bei Halbgeviert- und Geviertstrichen verhindern +\family default + manuell auswählen, um sicherzustellen, dass diese Dokumente unverändert + ausgegeben werden. \end_layout \begin_layout Itemize -Falls Sie gewöhnliche und Ligatur-Gedankenstriche in älteren Dokumenten +Falls Sie echte und zusammengesetzte Gedankenstriche in älteren Dokumenten parallel verwendet haben, müssen möglicherweise einige Zeilenumbrüche individue ll erlaubt oder unterdrückt werden um das korrekte Verhalten wiederherzustellen. \end_layout -- 2.39.5