anne/lyx_mirror
1
0
Fork 0
mirror of https://git.lyx.org/repos/lyx.git synced 2025-01-03 08:28:25 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

UserGuide.lyx: distribute dash changes

Browse Source
This commit is contained in:
Uwe Stöhr 2017-12-18 01:32:10 +01:00
parent bf94813b2f
commit 72bb33422c
4 changed files with 295 additions and 729 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

358
lib/doc/UserGuide.lyx
View File

@ -140,12 +140,11 @@ enumitem
\papercolumns 1 \papercolumns 1
\papersides 2 \papersides 2
\paperpagestyle default \paperpagestyle default
\tracking_changes true \tracking_changes false
\output_changes false \output_changes false
\html_math_output 0 \html_math_output 0
\html_css_as_file 0 \html_css_as_file 0
\html_be_strict true \html_be_strict true
\author -712698321 "Jürgen Spitzmüller"
\end_header \end_header
\begin_body \begin_body
@ -16575,13 +16574,7 @@ name "subsec:Dashes-and-line-breaks"
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
Whether line breaks Whether line breaks at dashes are allowed depends on the use case and locale:
\change_deleted -712698321 1513438804
around
\change_inserted -712698321 1513438805
at
\change_unchanged
dashes are allowed depends on the use case and locale:
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -16601,62 +16594,10 @@ In French and Spanish, dashes around parenthetical statements are treated
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\change_deleted -712698321 1513437551
In \SpecialChar LyX
,
\change_inserted -712698321 1513437622
The dashes that are output by \SpecialChar LyX The dashes that are output by \SpecialChar LyX
to \SpecialChar LaTeX to \SpecialChar LaTeX
by default generally allow for by default generally allow for line breaks
\change_unchanged after en-dashes and em-dashes.
line breaks after en-dashes and em-dashes
\change_deleted -712698321 1513498469
\change_inserted -712698321 1513437597
.
\change_deleted -712698321 1513438851
are only allowed (without manual intervention), if the option
\family sans
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures
\family default
is selected (this is the default in \SpecialChar LyX
2.3).
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
In this case, the dashes are output as
\begin_inset Quotes eld
\end_inset
--
\begin_inset Quotes erd
\end_inset
and
\begin_inset Quotes eld
\end_inset
---
\begin_inset Quotes erd
\end_inset
, respectively, when exporting to \SpecialChar LaTeX
.
The \SpecialChar TeX
font ligature mechanism converts them to dash characters followed
by an optional line break.
\end_layout
\end_inset
\change_unchanged
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -16664,22 +16605,7 @@ Please note:
\end_layout \end_layout
\begin_layout Enumerate \begin_layout Enumerate
Unwanted line breaks can be prevented by wrapping in a makebox
\change_deleted -712698321 1513437637
This results in optional line breaks after
\emph on
all
\emph default
en- and em-dashes.
\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 \begin_inset Foot
status collapsed status collapsed
@ -16815,115 +16741,26 @@ An incorrect line break is easily overlooked because
\end_deeper \end_deeper
\begin_layout Enumerate \begin_layout Enumerate
\change_deleted -712698321 1513437701
The setting is ignored for documents using non-\SpecialChar TeX
fonts.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Xe\SpecialChar TeX
provides the
\series bold
\backslash
XeTeXdashbreakstate
\series default
setting.
The default causes dashes to behave like ligature dashes.
The usual behaviour of literal dashes can be achieved by inserting
\family typewriter
\series bold
\backslash
XeTeXdashbreakstate=0
\family default
\series default
into the \SpecialChar LaTeX
preamble.
\end_layout
\end_inset
\change_unchanged
\end_layout
\begin_layout Enumerate
\change_deleted -712698321 1513437705
Em dashes in
\family typewriter
typewriter
\family default
fonts become
\family typewriter
–-
\family default
or
\family typewriter
---
\family default
in the output.
\change_unchanged
\end_layout
\begin_layout Enumerate
\change_inserted -712698321 1513437950
The default dashes output to \SpecialChar LaTeX The default dashes output to \SpecialChar LaTeX
disable disable hyphenation in words adjacent to hyphens
\change_deleted -712698321 1513437951 and ligature dashes.
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 \end_layout
\begin_layout Standard \begin_layout Standard
If If you want to globally disable line breaks after dashes, you can select
\change_inserted -712698321 1513498511
you want to globally disable line breaks after dashes, you can select
\change_unchanged
the option the option
\family sans \family sans
Document\SpecialChar menuseparator Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator Fonts\SpecialChar menuseparator
\change_inserted -712698321 1513498530
Disallow line breaks after dashes Disallow line breaks after dashes
\family default \family default
. .
In this case optional line breaks after individual In this case optional line breaks after individual
\family sans \family sans
dashes dashes
\change_deleted -712698321 1513438124
Output en- and em-dashes as ligatures
\family default \family default
has not been selected, you can be re-allowed via the menu
\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 \family sans
Insert\SpecialChar menuseparator Insert\SpecialChar menuseparator
Formatting\SpecialChar menuseparator Formatting\SpecialChar menuseparator
@ -16940,8 +16777,6 @@ should be broken
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\change_inserted -712698321 1513440855
Note: Up to \SpecialChar LyX Note: Up to \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
@ -16958,23 +16793,17 @@ non-breakable
\emph default \emph default
dashes (this was actually rather by accident than intentionally, but some dashes (this was actually rather by accident than intentionally, but some
used these two forms of dashes deliberately). used these two forms of dashes deliberately).
\change_unchanged
As of \SpecialChar LyX As of \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2, 2.2, things work differently: consecutive hyphens are merged to dashes immediatel
\change_inserted -712698321 1513439795 y in the input.
things work differently: consecutive hyphens are merged to dashes immediately
in the input.
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
\change_inserted -712698321 1513439552
The behavior was changed since it led to different look in \SpecialChar LyX The behavior was changed since it led to different look in \SpecialChar LyX
, text export, , text export,
HTML export and the PDF export. HTML export and the PDF export.
@ -16986,78 +16815,14 @@ The behavior was changed since it led to different look in \SpecialChar LyX
hyphen characters. hyphen characters.
An unintended consequence of this change was that all dashes now were output An unintended consequence of this change was that all dashes now were output
as non-breakable dashes. as non-breakable dashes.
Since furthermore, in order to maintain the output, occurrences of consecutive
\change_deleted -712698321 1513438403 hyphens in documents that were saved by \SpecialChar LyX
-- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation
to dashes.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Up to \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX 2.1 or earlier versions, were converted to literal en- and em-dash characters,
, text respectively, these were output to \SpecialChar LaTeX
export, HTML export and the PDF export.
\end_layout
\end_inset
\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 in \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
@ -17067,34 +16832,15 @@ s
\emph on \emph on
non-breakable non-breakable
\emph default \emph default
dashes as well dashes as well.
\change_unchanged An obvious drawback of all this was that it resulted in different line
. breaks in some documents.
\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 \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.3 2.3, by contrast and as outlined above, outputs
\change_inserted -712698321 1513439906
, by contrast and as outlined above, outputs
\change_unchanged
\change_inserted -712698321 1513441767
\emph on \emph on
breakable breakable
\emph default \emph default
@ -17106,17 +16852,9 @@ breakable
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.3 2.3 provides the aforementioned option
\change_unchanged
provides the aforementioned option
\change_deleted -712698321 1513438447
\family sans \family sans
Output en- and em-dashes as ligatures
\change_inserted -712698321 1513498544
Disallow line breaks after dashes Disallow line breaks after dashes
\change_unchanged
\family default \family default
in the menu in the menu
\family sans \family sans
@ -17125,28 +16863,14 @@ Settings\SpecialChar menuseparator
Fonts. Fonts.
\family default \family default
It is o It is off by default but selected when opening documents edited with \SpecialChar LyX
\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 ~ \begin_inset space ~
\end_inset \end_inset
2.2 2.2 in order to maintain line breaking between \SpecialChar LyX
\change_inserted -712698321 1513441759
in order to maintain line breaking between \SpecialChar LyX
2.2 and 2.3 (so these document 2.2 and 2.3 (so these document
have non-breakable dashes) have non-breakable dashes).
\change_unchanged
.
\begin_inset Newline newline \begin_inset Newline newline
\end_inset \end_inset
@ -17155,55 +16879,27 @@ Note the following side-effects of the changes in \SpecialChar LyX
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
If you used If you used only literal em- and en dashes in pre-\SpecialChar LyX
\change_inserted -712698321 1513440192
only
\change_unchanged
literal em- and en dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you must manually 2.2 documents, you must manually select
\change_deleted -712698321 1513438688
un
\change_unchanged
select
\change_deleted -712698321 1513438687
\family sans \family sans
Output en- and em-dashes as ligatures
\change_inserted -712698321 1513498551
Disallow line breaks after dashes Disallow line breaks after dashes
\change_unchanged
\family default \family default
to ensure unchanged behavior. to ensure unchanged behavior.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
If you used both If you used both literal and --/--- dashes in pre-\SpecialChar LyX
\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 ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you may need to enable or prevent individual line breaks as 2.2 documents, you may need to enable or prevent individual line breaks as
shown above to restore the correct line breaking behavio shown above to restore the correct line breaking behavior.
\change_deleted -712698321 1513441864
u
\change_unchanged
r.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize

216
lib/doc/es/UserGuide.lyx
View File

@ -16958,8 +16958,7 @@ name "subsec:Dashes-and-line-breaks"
\begin_layout Standard \begin_layout Standard
\lang english \lang english
Whether line breaks around dashes are allowed depends on the use case and Whether line breaks at dashes are allowed depends on the use case and locale:
locale:
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -16987,49 +16986,10 @@ In French and Spanish, dashes around parenthetical statements are treated
\begin_layout Standard \begin_layout Standard
\lang english \lang english
In \SpecialChar LyX The dashes that are output by \SpecialChar LyX
, line breaks after en-dashes and em-dashes are only allowed (without to \SpecialChar LaTeX
manual intervention), if the option by default generally allow for line breaks
\family sans after en-dashes and em-dashes.
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures
\family default
is selected (this is the default in \SpecialChar LyX
2.3).
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
In this case, the dashes are output as
\begin_inset Quotes eld
\end_inset
--
\begin_inset Quotes erd
\end_inset
and
\begin_inset Quotes eld
\end_inset
---
\begin_inset Quotes erd
\end_inset
, respectively, when exporting to \SpecialChar LaTeX
.
The \SpecialChar TeX
font ligature mechanism converts them to dash characters followed
by an optional line break.
\end_layout
\end_inset
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -17041,12 +17001,7 @@ Please note:
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
This results in optional line breaks after Unwanted line breaks can be prevented by wrapping in a makebox
\emph on
all
\emph default
en- and em-dashes.
Unwanted line breaks must be prevented by wrapping in a makebox
\lang spanish \lang spanish
\begin_inset Foot \begin_inset Foot
@ -17190,76 +17145,28 @@ An incorrect line break is easily overlooked because
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
The setting is ignored for documents using non-\SpecialChar TeX The default dashes output to \SpecialChar LaTeX
fonts. disable hyphenation in words adjacent to hyphens
\begin_inset Foot and ligature dashes.
status collapsed
\begin_layout Plain Layout
\lang english
Xe\SpecialChar TeX
provides the
\series bold
\backslash
XeTeXdashbreakstate
\series default
setting.
The default causes dashes to behave like ligature dashes.
The usual behaviour of literal dashes can be achieved by inserting
\family typewriter
\series bold
\backslash
XeTeXdashbreakstate=0
\family default
\series default
into the \SpecialChar LaTeX
preamble.
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
\lang english
Em dashes in
\family typewriter
typewriter
\family default
fonts become
\family typewriter
–-
\family default
or
\family typewriter
---
\family default
in the output.
\end_layout
\begin_layout Enumerate
\lang english
Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\lang english \lang english
If the option If you want to globally disable line breaks after dashes, you can select
the option
\family sans \family sans
Document\SpecialChar menuseparator Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
has not been selected, you can insert optional line breaks via the menu .
In this case optional line breaks after individual
\family sans
dashes
\family default
can be re-allowed via the menu
\family sans \family sans
Insert\SpecialChar menuseparator Insert\SpecialChar menuseparator
Formatting\SpecialChar menuseparator Formatting\SpecialChar menuseparator
@ -17280,41 +17187,86 @@ should be broken
\begin_layout Standard \begin_layout Standard
\lang english \lang english
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).
As of \SpecialChar LyX As of \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation 2.2, things work differently: consecutive hyphens are merged to dashes immediatel
to dashes. y in the input.
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
\lang english \lang english
Up to \SpecialChar LyX The behavior was changed since it led to different look in \SpecialChar LyX
, text export,
\begin_inset space ~ HTML export and the PDF export.
\end_inset
2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX
, text
export, HTML export and the PDF export.
\end_layout \end_layout
\end_inset \end_inset
Occurrences in older documents are converted to literal Unicode dashes. If you copy consecutive hyphens, by contrast, they are output as consecutive
This led to different line breaks in some documents. hyphen characters.
An unintended consequence of this change was that all dashes now were output
as non-breakable dashes.
Since furthermore, in order to maintain the output, occurrences of consecutive
hyphens in documents that were saved by \SpecialChar LyX
\begin_inset space ~
\end_inset
2.1 or earlier versions, were converted to literal en- and em-dash characters,
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.
An obvious drawback of all this was that it resulted in different line
breaks in some documents.
\SpecialChar LyX \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.3, by contrast and as outlined above, outputs
\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 provides the aforementioned option 2.3 provides the aforementioned option
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
in the menu in the menu
\family sans \family sans
@ -17323,12 +17275,14 @@ Settings\SpecialChar menuseparator
Fonts. Fonts.
\family default \family default
It is on by default but unselected when opening documents edited with \SpecialChar LyX It is off by default but selected when opening documents edited with \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2. 2.2 in order to maintain line breaking between \SpecialChar LyX
2.2 and 2.3 (so these document
have non-breakable dashes).
\begin_inset Newline newline \begin_inset Newline newline
\end_inset \end_inset
@ -17339,14 +17293,14 @@ Note the following side-effects of the changes in \SpecialChar LyX
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used literal em- and en dashes in pre-\SpecialChar LyX If you used only literal em- and en dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you must manually unselect 2.2 documents, you must manually select
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
to ensure unchanged behavior. to ensure unchanged behavior.
@ -17355,13 +17309,13 @@ Output en- and em-dashes as ligatures
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used both, literal and ligature dashes in pre-\SpecialChar LyX If you used both literal and --/--- dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you may need to enable or prevent individual line breaks as 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 behavior.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize

220
lib/doc/fr/UserGuide.lyx
View File

@ -9027,12 +9027,14 @@ Verbatim
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
This is Verbatim. This is Verbatim.
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
\noindent \noindent
\align block \align block
The following 2 lines are empty: The following 2 lines are empty:
\end_layout \end_layout
@ -9045,6 +9047,7 @@ The following 2 lines are empty:
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
Almost everything is allowed in Verbatim:"%&$§#~'` Almost everything is allowed in Verbatim:"%&$§#~'`
\backslash \backslash
}][{| }][{|
@ -9077,6 +9080,7 @@ Verbatim
\end_layout \end_layout
\begin_layout Verbatim* \begin_layout Verbatim*
This is Verbatim*. This is Verbatim*.
\end_layout \end_layout
@ -17884,8 +17888,7 @@ name "subsec:Dashes-and-line-breaks"
\begin_layout Standard \begin_layout Standard
\lang english \lang english
Whether line breaks around dashes are allowed depends on the use case and Whether line breaks at dashes are allowed depends on the use case and locale:
locale:
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -17913,49 +17916,10 @@ In French and Spanish, dashes around parenthetical statements are treated
\begin_layout Standard \begin_layout Standard
\lang english \lang english
In \SpecialChar LyX The dashes that are output by \SpecialChar LyX
, line breaks after en-dashes and em-dashes are only allowed (without to \SpecialChar LaTeX
manual intervention), if the option by default generally allow for line breaks
\family sans after en-dashes and em-dashes.
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures
\family default
is selected (this is the default in \SpecialChar LyX
2.3).
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
In this case, the dashes are output as
\begin_inset Quotes eld
\end_inset
--
\begin_inset Quotes erd
\end_inset
and
\begin_inset Quotes eld
\end_inset
---
\begin_inset Quotes erd
\end_inset
, respectively, when exporting to \SpecialChar LaTeX
.
The \SpecialChar TeX
font ligature mechanism converts them to dash characters followed
by an optional line break.
\end_layout
\end_inset
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -17967,12 +17931,7 @@ Please note:
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
This results in optional line breaks after Unwanted line breaks can be prevented by wrapping in a makebox
\emph on
all
\emph default
en- and em-dashes.
Unwanted line breaks must be prevented by wrapping in a makebox
\lang french \lang french
\begin_inset Foot \begin_inset Foot
@ -18116,76 +18075,28 @@ An incorrect line break is easily overlooked because
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
The setting is ignored for documents using non-\SpecialChar TeX The default dashes output to \SpecialChar LaTeX
fonts. disable hyphenation in words adjacent to hyphens
\begin_inset Foot and ligature dashes.
status collapsed
\begin_layout Plain Layout
\lang english
Xe\SpecialChar TeX
provides the
\series bold
\backslash
XeTeXdashbreakstate
\series default
setting.
The default causes dashes to behave like ligature dashes.
The usual behaviour of literal dashes can be achieved by inserting
\family typewriter
\series bold
\backslash
XeTeXdashbreakstate=0
\family default
\series default
into the \SpecialChar LaTeX
preamble.
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
\lang english
Em dashes in
\family typewriter
typewriter
\family default
fonts become
\family typewriter
–-
\family default
or
\family typewriter
---
\family default
in the output.
\end_layout
\begin_layout Enumerate
\lang english
Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\lang english \lang english
If the option If you want to globally disable line breaks after dashes, you can select
the option
\family sans \family sans
Document\SpecialChar menuseparator Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
has not been selected, you can insert optional line breaks via the menu .
In this case optional line breaks after individual
\family sans
dashes
\family default
can be re-allowed via the menu
\family sans \family sans
Insert\SpecialChar menuseparator Insert\SpecialChar menuseparator
Formatting\SpecialChar menuseparator Formatting\SpecialChar menuseparator
@ -18206,41 +18117,86 @@ should be broken
\begin_layout Standard \begin_layout Standard
\lang english \lang english
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).
As of \SpecialChar LyX As of \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation 2.2, things work differently: consecutive hyphens are merged to dashes immediatel
to dashes. y in the input.
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
\lang english \lang english
Up to \SpecialChar LyX The behavior was changed since it led to different look in \SpecialChar LyX
, text export,
\begin_inset space ~ HTML export and the PDF export.
\end_inset
2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX
, text
export, HTML export and the PDF export.
\end_layout \end_layout
\end_inset \end_inset
Occurrences in older documents are converted to literal Unicode dashes. If you copy consecutive hyphens, by contrast, they are output as consecutive
This led to different line breaks in some documents. hyphen characters.
An unintended consequence of this change was that all dashes now were output
as non-breakable dashes.
Since furthermore, in order to maintain the output, occurrences of consecutive
hyphens in documents that were saved by \SpecialChar LyX
\begin_inset space ~
\end_inset
2.1 or earlier versions, were converted to literal en- and em-dash characters,
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.
An obvious drawback of all this was that it resulted in different line
breaks in some documents.
\SpecialChar LyX \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.3, by contrast and as outlined above, outputs
\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 provides the aforementioned option 2.3 provides the aforementioned option
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
in the menu in the menu
\family sans \family sans
@ -18249,12 +18205,14 @@ Settings\SpecialChar menuseparator
Fonts. Fonts.
\family default \family default
It is on by default but unselected when opening documents edited with \SpecialChar LyX It is off by default but selected when opening documents edited with \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2. 2.2 in order to maintain line breaking between \SpecialChar LyX
2.2 and 2.3 (so these document
have non-breakable dashes).
\begin_inset Newline newline \begin_inset Newline newline
\end_inset \end_inset
@ -18265,14 +18223,14 @@ Note the following side-effects of the changes in \SpecialChar LyX
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used literal em- and en dashes in pre-\SpecialChar LyX If you used only literal em- and en dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you must manually unselect 2.2 documents, you must manually select
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
to ensure unchanged behavior. to ensure unchanged behavior.
@ -18281,13 +18239,13 @@ Output en- and em-dashes as ligatures
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used both, literal and ligature dashes in pre-\SpecialChar LyX If you used both literal and --/--- dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you may need to enable or prevent individual line breaks as 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 behavior.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize

220
lib/doc/ja/UserGuide.lyx
View File

@ -7172,12 +7172,14 @@ Space
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
これは原文儘(verbatim)環境です． これは原文儘(verbatim)環境です．
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
\noindent \noindent
\align block \align block
この下の2行は空白行です． この下の2行は空白行です．
\end_layout \end_layout
@ -7190,6 +7192,7 @@ Space
\end_layout \end_layout
\begin_layout Verbatim \begin_layout Verbatim
右記の各文字を始め，ほぼすべての文字が使えます．例："%&$§#~'` 右記の各文字を始め，ほぼすべての文字が使えます．例："%&$§#~'`
\backslash \backslash
}][{| }][{|
@ -7212,6 +7215,7 @@ Space
\end_layout \end_layout
\begin_layout Verbatim* \begin_layout Verbatim*
This is Verbatim*. This is Verbatim*.
\end_layout \end_layout
@ -14179,8 +14183,7 @@ name "subsec:Dashes-and-line-breaks"
\begin_layout Standard \begin_layout Standard
\lang english \lang english
Whether line breaks around dashes are allowed depends on the use case and Whether line breaks at dashes are allowed depends on the use case and locale:
locale:
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -14208,49 +14211,10 @@ In French and Spanish, dashes around parenthetical statements are treated
\begin_layout Standard \begin_layout Standard
\lang english \lang english
In \SpecialChar LyX The dashes that are output by \SpecialChar LyX
, line breaks after en-dashes and em-dashes are only allowed (without to \SpecialChar LaTeX
manual intervention), if the option by default generally allow for line breaks
\family sans after en-dashes and em-dashes.
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures
\family default
is selected (this is the default in \SpecialChar LyX
2.3).
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
In this case, the dashes are output as
\begin_inset Quotes eld
\end_inset
--
\begin_inset Quotes erd
\end_inset
and
\begin_inset Quotes eld
\end_inset
---
\begin_inset Quotes erd
\end_inset
, respectively, when exporting to \SpecialChar LaTeX
.
The \SpecialChar TeX
font ligature mechanism converts them to dash characters followed
by an optional line break.
\end_layout
\end_inset
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -14262,12 +14226,7 @@ Please note:
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
This results in optional line breaks after Unwanted line breaks can be prevented by wrapping in a makebox
\emph on
all
\emph default
en- and em-dashes.
Unwanted line breaks must be prevented by wrapping in a makebox
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
@ -14415,76 +14374,28 @@ An incorrect line break is easily overlooked because
\begin_layout Enumerate \begin_layout Enumerate
\lang english \lang english
The setting is ignored for documents using non-\SpecialChar TeX The default dashes output to \SpecialChar LaTeX
fonts. disable hyphenation in words adjacent to hyphens
\begin_inset Foot and ligature dashes.
status collapsed
\begin_layout Plain Layout
\lang english
Xe\SpecialChar TeX
provides the
\series bold
\backslash
XeTeXdashbreakstate
\series default
setting.
The default causes dashes to behave like ligature dashes.
The usual behaviour of literal dashes can be achieved by inserting
\family typewriter
\series bold
\backslash
XeTeXdashbreakstate=0
\family default
\series default
into the \SpecialChar LaTeX
preamble.
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
\lang english
Em dashes in
\family typewriter
typewriter
\family default
fonts become
\family typewriter
–-
\family default
or
\family typewriter
---
\family default
in the output.
\end_layout
\begin_layout Enumerate
\lang english
Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\lang english \lang english
If the option If you want to globally disable line breaks after dashes, you can select
the option
\family sans \family sans
Document\SpecialChar menuseparator Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator Settings\SpecialChar menuseparator
Fonts\SpecialChar menuseparator Fonts\SpecialChar menuseparator
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
has not been selected, you can insert optional line breaks via the menu .
In this case optional line breaks after individual
\family sans
dashes
\family default
can be re-allowed via the menu
\family sans \family sans
Insert\SpecialChar menuseparator Insert\SpecialChar menuseparator
Formatting\SpecialChar menuseparator Formatting\SpecialChar menuseparator
@ -14505,41 +14416,86 @@ should be broken
\begin_layout Standard \begin_layout Standard
\lang english \lang english
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).
As of \SpecialChar LyX As of \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation 2.2, things work differently: consecutive hyphens are merged to dashes immediatel
to dashes. y in the input.
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
\lang english \lang english
Up to \SpecialChar LyX The behavior was changed since it led to different look in \SpecialChar LyX
, text export,
\begin_inset space ~ HTML export and the PDF export.
\end_inset
2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX
, text
export, HTML export and the PDF export.
\end_layout \end_layout
\end_inset \end_inset
Occurrences in older documents are converted to literal Unicode dashes. If you copy consecutive hyphens, by contrast, they are output as consecutive
This led to different line breaks in some documents. hyphen characters.
An unintended consequence of this change was that all dashes now were output
as non-breakable dashes.
Since furthermore, in order to maintain the output, occurrences of consecutive
hyphens in documents that were saved by \SpecialChar LyX
\begin_inset space ~
\end_inset
2.1 or earlier versions, were converted to literal en- and em-dash characters,
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.
An obvious drawback of all this was that it resulted in different line
breaks in some documents.
\SpecialChar LyX \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.3, by contrast and as outlined above, outputs
\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 provides the aforementioned option 2.3 provides the aforementioned option
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
in the menu in the menu
\family sans \family sans
@ -14548,12 +14504,14 @@ Settings\SpecialChar menuseparator
Fonts. Fonts.
\family default \family default
It is on by default but unselected when opening documents edited with \SpecialChar LyX It is off by default but selected when opening documents edited with \SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2. 2.2 in order to maintain line breaking between \SpecialChar LyX
2.2 and 2.3 (so these document
have non-breakable dashes).
\begin_inset Newline newline \begin_inset Newline newline
\end_inset \end_inset
@ -14564,14 +14522,14 @@ Note the following side-effects of the changes in \SpecialChar LyX
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used literal em- and en dashes in pre-\SpecialChar LyX If you used only literal em- and en dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you must manually unselect 2.2 documents, you must manually select
\family sans \family sans
Output en- and em-dashes as ligatures Disallow line breaks after dashes
\family default \family default
to ensure unchanged behavior. to ensure unchanged behavior.
@ -14580,13 +14538,13 @@ Output en- and em-dashes as ligatures
\begin_layout Itemize \begin_layout Itemize
\lang english \lang english
If you used both, literal and ligature dashes in pre-\SpecialChar LyX If you used both literal and --/--- dashes in pre-\SpecialChar LyX
\begin_inset space ~ \begin_inset space ~
\end_inset \end_inset
2.2 documents, you may need to enable or prevent individual line breaks as 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 behavior.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize