]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
Make doc/UserGuide.lyx independent of French and Spanish language LaTeX support.
[lyx.git] / lib / doc / UserGuide.lyx
index 4d65a9f8c5236a38eeeb0fe506a1712c42c5eadd..2bf42fd6589562e3acab44652fa953e0ae9f4920 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 568
+\lyxformat 575
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -57,11 +57,11 @@ logicalmkup
 \maintain_unincluded_children false
 \language english
 \language_package default
-\inputencoding auto
+\inputencoding utf8
 \fontencoding auto
 \font_roman "lmodern" "default"
-\font_sans "lmss" "default"
-\font_typewriter "lmtt" "default"
+\font_sans "default" "default"
+\font_typewriter "default" "default"
 \font_math "auto" "auto"
 \font_default_family default
 \use_non_tex_fonts false
@@ -72,10 +72,12 @@ logicalmkup
 \use_microtype false
 \use_dash_ligatures false
 \graphics default
-\default_output_format pdf2
+\default_output_format default
 \output_sync 0
 \bibtex_command bibtex
 \index_command default
+\float_placement class
+\float_alignment class
 \paperfontsize 12
 \spacing single
 \use_hyperref true
@@ -115,6 +117,8 @@ logicalmkup
 \justification true
 \use_refstyle 1
 \use_minted 0
+\use_lineno 0
+\lineno_options 
 \notefontcolor #0000ff
 \branch Question
 \selected 1
@@ -141,12 +145,15 @@ logicalmkup
 \papercolumns 1
 \papersides 2
 \paperpagestyle default
+\tablestyle default
 \tracking_changes true
 \output_changes false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
+\author -1402925745 "Günter Milde"
 \author -712698321 "Jürgen Spitzmüller"
+\author 5863208 "ab"
 \end_header
 
 \begin_body
@@ -17911,7 +17918,13 @@ ligature dashes
 
  (-- and ---).
  \SpecialChar LaTeX
- allows line breaks after hyphens, en-dashes and em-dashes.
+ allows line breaks after hyphens
+\change_deleted -1402925745 1558782973
+,
+\change_inserted -1402925745 1558782983
+ and these
+\change_unchanged
+ en-dashes and em-dashes.
 \end_layout
 
 \begin_layout Enumerate
@@ -17931,7 +17944,17 @@ The Elements of Typographic Style
 \end_layout
 
 \begin_layout Enumerate
-Unwanted line breaks after dashes can be prevented by wrapping in a makebox
+Unwanted line breaks 
+\series bold
+after
+\series default
+ dashes 
+\change_inserted -1402925745 1558782702
+must
+\change_deleted -1402925745 1558782715
+can
+\change_unchanged
+ be prevented by wrapping in a makebox
 \begin_inset Foot
 status collapsed
 
@@ -17960,8 +17983,33 @@ Objects
 nobreakdash
 \series default
  in \SpecialChar TeX
- code.
- Examples:
+ code
+\change_inserted -1402925745 1558782753
+, a protected space does not suffice
+\change_unchanged
+.
+ Examples
+\change_inserted -1402925745 1558782332
+
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1402925745 1558782431
+It is generally recommended to set the correct language for text parts not
+ in the document language.
+ We don't do this here to prevent a dependency on LaTeX support for French
+ and Spanish.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+:
 \end_layout
 
 \begin_deeper
@@ -17999,8 +18047,6 @@ status open
 \end_layout
 
 \begin_layout Itemize
-
-\lang french
 Les incises 
 \begin_inset Box Frameless
 position "t"
@@ -18021,8 +18067,6 @@ backgroundcolor "none"
 status open
 
 \begin_layout Plain Layout
-
-\lang french
 –
 \begin_inset space ~
 \end_inset
@@ -18040,8 +18084,6 @@ même
 \end_layout
 
 \begin_layout Itemize
-
-\lang spanish
 En una frase 
 \begin_inset ERT
 status collapsed
@@ -18094,8 +18136,6 @@ Line breaks are still allowed after spaced dashes.
 
 \begin_deeper
 \begin_layout Itemize
-
-\lang french
 Les incises –
 \begin_inset space ~
 \end_inset
@@ -21287,7 +21327,11 @@ Insert\SpecialChar menuseparator
 Table
 \family default
 .
- A dialog will appear, asking you for the number of rows and columns.
+ A dialog will appear, asking you for the number of rows and columns
+\change_inserted -712698321 1554288358
+, and you can select a specific (border) style
+\change_unchanged
+.
  The default table has lines around any cell and the first row appears separated
  from the rest of the table.
  This separation appears due to a double line: The cells of the first row
 \end_inset
 
 
+\change_inserted -712698321 1554288479
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1554288540
+This corresponds to the 
+\begin_inset Quotes eld
+\end_inset
+
+Grid with Head
+\begin_inset Quotes erd
+\end_inset
+
+ table style listed in the style selection.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1554288387
+Other available styles include:
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1554288551
+A 
+\begin_inset Quotes eld
+\end_inset
+
+simple grid
+\begin_inset Quotes erd
+\end_inset
+
+ which looks line the above table, but without the first row being separated
+ via double line,
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1554288764
+a border-less table with no lines at all,
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1554289543
+and a so-called 
+\begin_inset Quotes eld
+\end_inset
+
+formal table
+\begin_inset Quotes erd
+\end_inset
+
+ as often used in professional publishing with horizontal lines only and
+ bold top/bottom lines (see 
+\emph on
+Embedded Objects
+\emph default
+ manual, section 
+\emph on
+Formal Tables
+\emph default
+).
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1554288823
+The default style used in the dialog as well as the style used by the toolbar
+ button can be changed in 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Text Layout
+\family default
+.
+ So if the default style above is not the one you need, you should alter
+ this setting.
 \end_layout
 
 \begin_layout Subsection
@@ -29985,7 +30110,9 @@ status collapsed
 \end_inset
 
 .
- In order to do so, the label needs to be given the form 
+ In order to do so, 
+\change_deleted -712698321 1555659455
+the label needs to be given the form 
 \begin_inset Quotes eld
 \end_inset
 
@@ -30007,7 +30134,9 @@ without
 \emph default
  a blank between the author(s) and the opening parenthesis that delimits
  the year.
- Then, if you select 
+ Then, if you 
+\change_unchanged
+select 
 \family sans
 Natbib
 \begin_inset space ~
@@ -30044,7 +30173,91 @@ noprefix "false"
 
 \end_inset
 
-), you can select between different author-year or author-number styles.
+)
+\change_inserted -712698321 1555660530
+.
+ Once you have done that, the 
+\family sans
+Bibliography
+\family default
+ dialog has three input fields instead of the 
+\family sans
+Label
+\family default
+ field:
+\family sans
+ Author Names
+\family default
+, 
+\family sans
+Year
+\family default
+ and 
+\family sans
+All Author Names
+\family default
+.
+ The first one takes the Author list as it should be displayed in the citation
+ reference, the second the year (without parentheses).
+ These two are madatory.
+ If there are multiple authors and you want to both refer to them as a full
+ list (
+\emph on
+Baker, Jones, and Williams
+\emph default
+) and in abrreviated form (
+\emph on
+Baker et al.
+\emph default
+)
+\change_unchanged
+,
+\change_inserted -712698321 1555660544
+ add the abbreviated form to 
+\family sans
+Author Names
+\family default
+ and the full list to the optional 
+\family sans
+All Author Names
+\family default
+ field.
+
+\change_unchanged
+\change_inserted -712698321 1555659886
+If specified like this, 
+\change_unchanged
+you can select between different author-year or author-number styles
+\change_inserted -712698321 1555660646
+ in the 
+\family sans
+Insert\SpecialChar menuseparator
+Citation
+\family default
+ dialog, and if 
+\family sans
+All Author Names
+\family default
+ is specified, toggling 
+\begin_inset Quotes eld
+\end_inset
+
+All authors
+\begin_inset Quotes erd
+\end_inset
+
+ in the citation dialog or the citation context menu will switch between
+ full and abbreviated list
+\change_unchanged
+.
+
+\change_inserted -712698321 1555660793
+ Note that the author and year specified in the dialog are only used for
+ the citation references.
+ In the bibliography entry, author and year must be added manually.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -45063,6 +45276,24 @@ Use justification in \SpecialChar LyX
  justifies the text on screen.
  This only affects the text inside \SpecialChar LyX
  not in the output.
+\change_inserted -712698321 1554288869
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1554288904
+The 
+\family sans
+Default Style
+\family default
+ setting in 
+\family sans
+Table Style
+\family default
+ lets you select which style newly inserted tables should use by default.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -45142,24 +45373,162 @@ The document language and quote styles are set here.
 -commands (this can fail if a \SpecialChar LaTeX
 -command is not known for
  a particular character).
+\change_inserted -712698321 1557594829
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557596095
+By default, \SpecialChar LyX
+ outputs \SpecialChar LaTeX
+ files in Unicode – or utf8, for that matter (which
+ is nowadays also \SpecialChar LaTeX
+'s default encoding).
+ This should normally fit your needs, since \SpecialChar LaTeX
+'s Unicode support covers the
+ characters of most scripts.
+ Nonetheless it is not yet comprehensive, so there might be cases where
+ using one of the traditional, or 
+\begin_inset Quotes eld
+\end_inset
+
+legacy
+\begin_inset Quotes erd
+\end_inset
+
+, encodings is necessary.
 \end_layout
 
 \begin_layout Standard
+
+\change_inserted -712698321 1557596136
+\SpecialChar LyX
+ provides support for these traditional encodings.
+ If you chose 
+\family sans
+Traditional (auto-selected)
+\family default
+ from the 
+\family sans
+Encodings
+\family default
+ dropdown, \SpecialChar LyX
+ automatically selects the appropriate traditional encoding for
+ the given language(s).
+\change_deleted -712698321 1557595310
+
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted -712698321 1557595310
 If you use the option 
 \family sans
 Language Default
 \family default
 , \SpecialChar LyX
  determines the encoding of a text part from the language of this text.
- If the document contains text in more than one language you may get more
- than one encoding in the \SpecialChar LaTeX
+\change_unchanged
+If the document contains text in more than one language you 
+\change_inserted -712698321 1557595342
+thus 
+\change_unchanged
+may get more than one encoding in the \SpecialChar LaTeX
  file.
- If you do not use this option then the complete document will always use
+\change_deleted -712698321 1557595350
+If you do not use this option then the complete document will always use
  exactly one encoding.
  Checking this option is the preferred setting.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557596155
+As a third option, \SpecialChar LyX
+ provides the 
+\family sans
+ASCII
+\family default
+ selection.
+ If this is chosen, any character outside the 7bit ASCII range will be output
+ as a \SpecialChar LaTeX
+ command.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557645585
+Finally, you can also select 
+\family sans
+Custom
+\family default
+, which lets you specify a specific (single) encoding for the whole document.
+ Note that this encoding is then used for 
+\emph on
+any
+\emph default
+ language.
+ The custom list (which is spelled out below) consists of traditional encodings
+ and some special cases of Unicode for specific purposes (see explanation
+ below).
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557645268
+The 
+\family sans
+Do not load inputenc
+\family default
+ checkbox does what it states: It prevents \SpecialChar LyX
+ from automatically loading the
+ \SpecialChar LaTeX
+-package 
+\series bold
+inputenc
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1557645185
+\SpecialChar LaTeX
+ packages ! inputenc
+\end_layout
+
+\end_inset
+
+.
+ This option might be useful if you use a class or package that pre-loads
+ inputenc or if inputenc must not be used for some reason.
+ When using this, you probably need to load some additional packages manually
+ in the preamble and specify the used encoding for text parts in foreign
+ languages in \SpecialChar TeX
+ code.
+ Note that this option is only available for the standard 
+\family sans
+Unicode
+\family default
+ and 
+\family sans
+Traditional (auto-selected)
+\family default
+ encodings.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1557596063
 \SpecialChar LyX
  also supports Unicode output, which is particularly useful if you need
  lots of special symbols or non-alphabetic scripts, respectively.
@@ -45227,6 +45596,8 @@ reference "subsec:Output-file-formats"
 Language Default
 \family default
  fails, you might try out one of these new engines.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -45361,6 +45732,8 @@ Here is a list with the important encodings:
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1557645284
 Language
 \begin_inset space ~
 \end_inset
@@ -45398,6 +45771,8 @@ status collapsed
  in the preamble and specify the used encoding for text parts in foreign
  languages in \SpecialChar TeX
  code.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -45407,6 +45782,19 @@ ASCII the ASCII encoding, covers only plain English (7-bit ASCII).
  commands, which may result in a big
  file when lots of \SpecialChar LaTeX
 -commands are needed.
+
+\change_inserted -712698321 1557596221
+ This is the same as the 
+\family sans
+ASCII
+\family default
+ option in the main 
+\family sans
+Encoding
+\family default
+ dropdown list.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -45878,6 +46266,21 @@ status collapsed
 \end_inset
 
  (for the languages Chinese, Japanese and Korean)
+\change_inserted -712698321 1557596410
+.
+ This encoding is selected by \SpecialChar LyX
+ with the default encoding (
+\family sans
+Unicode (utf8) [default]
+\family default
+ in the main 
+\family sans
+Encoding
+\family default
+ dropdown list) with CJK languages.
+ Normally you do not need to set this encoding manually.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -45941,7 +46344,24 @@ status collapsed
 
 \end_inset
 
- (comprehensive, including Latin, Greek, Cyrillic and CJK scripts).
+ (
+\change_deleted -712698321 1557596443
+comprehensive, 
+\change_unchanged
+including Latin, Greek, Cyrillic and CJK scripts).
+
+\change_inserted -712698321 1557596475
+ This used to be more comprehensive than 
+\family sans
+Unicode
+\begin_inset space ~
+\end_inset
+
+(utf8)
+\family default
+, but meanwhile it is rather outdated.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -45966,8 +46386,24 @@ status collapsed
 \end_inset
 
 .
- Currently only a limited range of characters (mainly for Latin scripts)
+\change_deleted -712698321 1557596266
+Currently only a limited range of characters (mainly for Latin scripts)
  is supported.
+\change_inserted -712698321 1557596400
+This encoding is selected by \SpecialChar LyX
+ with the default encoding (
+\family sans
+Unicode (utf8) [default]
+\family default
+ in the main 
+\family sans
+Encoding
+\family default
+ dropdown list) with non-CJK languages.
+ Normally you do not need to set this encoding manually.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -46380,6 +46816,55 @@ reference "subsec:Numbering-depth"
 \end_inset
 
 .
+\change_inserted 5863208 1558620045
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 5863208 1558620379
+You can typeset lines numbering in the output file by enabling the checkbox
+ at the bottom.
+ The functionality is handled by package lineno and and additional options
+ of this package can be used as well.
+ The most common one are:
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620630
+right Line numbers to the right margin
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620589
+switch Line number to the outer margin (left – even pages, right – odd pages)
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620637
+switch* Line numbers to the inner margin 
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620780
+modulo Print numbers only on multiples of five lines
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620792
+displaymath,
+\begin_inset space ~
+\end_inset
+
+mathlines Line numbers for math environments (both options needed).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -51110,7 +51595,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://texcatalogue.ctan.org/bytopic.html
+https://ctan.org/topic
 \end_layout
 
 \end_inset