]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
backport cs.po
[lyx.git] / lib / doc / UserGuide.lyx
index cabffd917b1161e5890e1334cc302c7382aa1a98..188a16dc6ff6cb8cf71488cce15c7dba207c05f4 100644 (file)
@@ -140,12 +140,11 @@ enumitem
 \papercolumns 1
 \papersides 2
 \paperpagestyle default
-\tracking_changes true
+\tracking_changes false
 \output_changes false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
-\author -1402925745 "Günter Milde"
 \end_header
 
 \begin_body
@@ -8337,14 +8336,12 @@ 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
 
@@ -8357,7 +8354,6 @@ The following 2 lines are empty:
 \end_layout
 
 \begin_layout Verbatim
-
 Almost everything is allowed in Verbatim:"%&$§#~'`
 \backslash
 }][{|
@@ -8381,7 +8377,6 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim*
-
 This is Verbatim*.
 \end_layout
 
@@ -12697,7 +12692,7 @@ status open
 Note:
 \series default
  In practice, some fonts might fail due to a legacy (non Unicode) font encoding,
- bad metrics, and other font deficiencies; so you might have to experiment.
+ bad metrics, or other font deficiencies; so you might have to experiment.
 \end_layout
 
 \end_inset
@@ -16095,7 +16090,7 @@ In \SpecialChar LyX
 \begin_inset Quotes erd
 \end_inset
 
character comes in four variants: the 
symbol comes in four variants: the 
 \emph on
 hyphen
 \emph default
@@ -16243,15 +16238,31 @@ status collapsed
 \begin_layout Plain Layout
 On Mac and Linux, the en dash is entered with 
 \family sans
-Option-hyphen
+Opt+
+\begin_inset Quotes eld
+\end_inset
+
+-
+\begin_inset Quotes erd
+\end_inset
+
+
 \family default
  and the em dash with 
 \family sans
-Shift-Option-hyphen
+Shift-Opt+
+\begin_inset Quotes erd
+\end_inset
+
+-
+\begin_inset Quotes erd
+\end_inset
+
+
 \family default
  (
 \family sans
-Option
+Opt
 \family default
  is the Mac label for the right 
 \family sans
@@ -16281,8 +16292,8 @@ unicode-insert
 \end_inset
 
  \SpecialChar LyX
- function with the Unicode code as argument (2013 for the em dash and 2014
- for the en dash).
+ function with the Unicode code point as argument (2013 for the em dash
and 2014 for the en dash).
 \end_layout
 
 \end_inset
@@ -16397,6 +16408,29 @@ minus sign
 
 \end_layout
 
+\begin_layout Standard
+Dashes can also be inserted with 
+\family sans
+Insert\SpecialChar menuseparator
+Special
+\begin_inset space ~
+\end_inset
+
+Character\SpecialChar menuseparator
+Symbols
+\family default
+ or the 
+\begin_inset Quotes eld
+\end_inset
+
+unicode-insert
+\begin_inset Quotes erd
+\end_inset
+
+ \SpecialChar LyX
+ function.
+\end_layout
+
 \begin_layout Standard
 Hyphen and dashes are distinct from the minus sign, which appears in math
  mode and has a length of its own.
@@ -16432,20 +16466,6 @@ en dash
 \end_layout
 
 \begin_layout Enumerate
-Dashes indicate interruptions, performing a function related to – but subtly
- different from – parentheses.
-\begin_inset space \hfill{}
-\end_inset
-
-(
-\emph on
-en dash
-\emph default
-)
-\end_layout
-
-\begin_deeper
-\begin_layout Standard
 The em dash is used without spaces: Oh—there's a dash.
 \begin_inset space \hfill{}
 \end_inset
@@ -16457,7 +16477,6 @@ em dash
 )
 \end_layout
 
-\end_deeper
 \begin_layout Enumerate
 \begin_inset Formula $x^{2}-y^{2}=z^{2}$
 \end_inset
@@ -16498,8 +16517,8 @@ name "subsec:Dashes-and-line-breaks"
 \end_layout
 
 \begin_layout Standard
-Whether line breaks before or after dashes are allowed depends on the use
case and locale:
+Whether line breaks around dashes are allowed depends on the use case and
+ locale:
 \end_layout
 
 \begin_layout Itemize
@@ -16507,13 +16526,13 @@ No line breaks are allowed in ranges of values like A–Z or 1975–1982.
 \end_layout
 
 \begin_layout Itemize
-In English, lines may break after dashes used to set off parenthetical statement
-s.
+In English, dashes used to set off parenthetical statements should not start
+ a new line.
 \end_layout
 
 \begin_layout Itemize
 In French and Spanish, dashes around parenthetical statements are treated
- similar to quote signs and line breaks are not allowed on the left side.
+ similar to brackets: line breaks are not allowed on the inner side.
 \end_layout
 
 \begin_layout Standard
@@ -16525,7 +16544,7 @@ When using spaced en dashes
 \begin_inset space ~
 \end_inset
 
-- line breaks before the dash with protected spaces are not allowed.
+- line breaks before the dash can be prevented with protected spaces.
 \end_layout
 
 \begin_layout Standard
@@ -16575,7 +16594,7 @@ This forces the output of dashes as
 \end_layout
 
 \begin_layout Standard
-Subtleties:
+Caution:
 \end_layout
 
 \begin_layout Enumerate
@@ -16613,11 +16632,12 @@ Objects
 nobreakdash
 \series default
  in \SpecialChar TeX
- code:
+ code.
+ Examples:
 \end_layout
 
 \begin_deeper
-\begin_layout Quote
+\begin_layout Itemize
 Pages
 \begin_inset space ~
 \end_inset
@@ -16650,8 +16670,7 @@ status open
 
 \end_layout
 
-\begin_deeper
-\begin_layout Standard
+\begin_layout Itemize
 
 \lang french
 Les incises 
@@ -16692,8 +16711,7 @@ même
 – sont très utiles.
 \end_layout
 
-\end_deeper
-\begin_layout Quote
+\begin_layout Itemize
 
 \lang spanish
 En una frase 
@@ -16729,10 +16747,10 @@ An incorrect line break is easily overlooked because
 \begin_layout Enumerate
 The setting is ignored for documents using non-\SpecialChar TeX
  fonts.
-\end_layout
+\begin_inset Foot
+status collapsed
 
-\begin_deeper
-\begin_layout Standard
+\begin_layout Plain Layout
 Xe\SpecialChar TeX
  provides the 
 \series bold
@@ -16741,20 +16759,24 @@ Xe\SpecialChar TeX
 XeTeXdashbreakstate
 \series default
  setting.
- The default,
-\begin_inset Newline newline
-\end_inset
-
-
+ 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=1
+XeTeXdashbreakstate=0
+\family default
 \series default
- causes literal dashes to behave like ligature dashes.
+ into the \SpecialChar LaTeX
+ preamble.
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
-\end_deeper
 \begin_layout Enumerate
 Em dashes in 
 \family typewriter
@@ -16773,32 +16795,16 @@ typewriter
 
 \begin_layout Enumerate
 Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
-\change_inserted -1402925745 1504003612
-
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -1402925745 1504709020
-Changes:
-\end_layout
-
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-\SpecialChar LyX
-
-\change_inserted -1402925745 1504711065
+Since \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.2 -- and --- 
-\change_unchanged
-in LyX are o
-\change_inserted -1402925745 1504711065
-utput as -{}- and -{}-{}- to prevent ligation to dashes.
-\change_unchanged
-
+2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation
+ to dashes.
 \begin_inset Foot
 status collapsed
 
@@ -16808,119 +16814,86 @@ Up to \SpecialChar LyX
 \begin_inset space ~
 \end_inset
 
-2.1 -- and --- in \SpecialChar LyX
- was output unchanged which led to different look in the
- within \SpecialChar LyX
-, text export, HTML export and the PDF export.
+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_inset
 
- Occurrences 
-\change_inserted -1402925745 1504711065
-in older documents are converted to literal Unicode dashe
-\change_unchanged
-s.
-\change_inserted -1402925745 1504711065
-
-\end_layout
-
-\begin_deeper
-\begin_layout Itemize
-
-\change_inserted -1402925745 1504709468
-In some cases this leads to different line breaks.
-\end_layout
-
-\begin_layout Itemize
-
-\change_inserted -1402925745 1504710005
-It is no longer possible to differentiate dashes with/without optional line
- break using --- and -- vs.
- literal dashes.
- Either convert one sort t
-\change_unchanged
-o \SpecialChar TeX
- code 
-\change_inserted -1402925745 1504710005
-or insert optional line break characters.
-\change_unchanged
-
-\end_layout
-
-\end_deeper
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-\SpecialChar LyX
-
-\change_inserted -1402925745 1504710385
+ Occurrences in older documents are converted to literal Unicode dashes.
+ This led to different line breaks in some documents.
+ \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.3 New
-\change_unchanged
- option 
-\change_inserted -1402925745 1504710385
-
+2.3 provides the option 
+\family sans
+Output en- and em-dashes as ligatures
+\family default
+ in the menu 
 \family sans
 Document\SpecialChar menuseparator
 Settings\SpecialChar menuseparator
-Fonts\SpecialChar menuseparator
-Output en- and em-dashes as ligatures.
+Fonts.
 
 \family default
- It is on by default but unselected when opening documents edited with 
-\change_unchanged
-\SpecialChar LyX
+ It is on by default but unselected when opening documents edited with \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-
-\change_inserted -1402925745 1504710385
 2.2.
+\begin_inset Newline newline
+\end_inset
+
+Note the following side-effects of the changes in \SpecialChar LyX
+'s dash handling:
 \end_layout
 
-\begin_deeper
 \begin_layout Itemize
+If you used literal em- and en dashes in pre-\SpecialChar LyX
 
-\change_inserted -1402925745 1504712456
-If you used literal em- and en dashes in pre-2.2 documents, you must manually
- unselect it to ensure unchanged 
-\change_unchanged
-behavior
-\change_inserted -1402925745 1504712456
-.
+\begin_inset space ~
+\end_inset
+
+2.2 documents, you must manually unselect 
+\family sans
+Output en- and em-dashes as ligatures
+\family default
+ to ensure unchanged behavior.
 \end_layout
 
 \begin_layout Itemize
-
-\change_inserted -1402925745 1504712456
-ZWSP characters (u200b) following literal em- and en-dashes are deleted
- by lyx2lyx when converting to 2.3 format.
- If you used them as optional line breaks after dashes, convert them to
- space insets before opening your document with 
-\change_unchanged
-\SpecialChar LyX
+If you used both, literal and ligature dashes in pre-\SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-
-\change_inserted -1402925745 1504712456
-2.3 or the optional line breaks will be lost!
+2.2 documents, you may need to enable or prevent individual line breaks as
+ shown above to restore the correct line breaking behaviour.
 \end_layout
 
 \begin_layout Itemize
+Zero-width space (ZWSP) characters in older \SpecialChar LyX
+ documents that follow literal
+ em- and en-dashes are removed during the conversion to the format of \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.3.
+ If you used them as optional line breaks after dashes, convert them to
+ space insets before opening your document with \SpecialChar LyX
 
-\change_inserted -1402925745 1504709574
-As with all settings, the default for new documents can be configured via
- templates.
+\begin_inset space ~
+\end_inset
+
+2.3 or the optional line breaks will be lost.
 \end_layout
 
-\end_deeper
 \begin_layout Subsection
 Hyphenation
 \begin_inset Index idx
@@ -38747,13 +38720,9 @@ reference "subsec:Ligatures"
 \end_inset
 
 .
-\change_inserted -1402925745 1503938048
-
 \end_layout
 
 \begin_layout Description
-
-\change_inserted -1402925745 1503938353
 Optional
 \begin_inset space ~
 \end_inset
@@ -38762,7 +38731,8 @@ Line
 \begin_inset space ~
 \end_inset
 
-Break Inserts a line break point (ZWSP) that is invisible in the output.
+Break Inserts a line break point (zero-width space character) that is invisible
+ in the output.
  See section
 \begin_inset space ~
 \end_inset
@@ -38778,8 +38748,6 @@ noprefix "false"
 \end_inset
 
  for a usage example.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description