]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx - few notes for lineno.
[lyx.git] / lib / doc / UserGuide.lyx
index dd7d0a1d9ae4a0c67fa58fe4d8451b15990e8619..3a8ddf60a340edc9ab461198e9d3945db292ea97 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 573
+\lyxformat 575
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -57,7 +57,7 @@ logicalmkup
 \maintain_unincluded_children false
 \language english
 \language_package default
-\inputencoding auto-legacy
+\inputencoding utf8
 \fontencoding auto
 \font_roman "lmodern" "default"
 \font_sans "lmss" "default"
@@ -148,6 +148,7 @@ logicalmkup
 \html_css_as_file 0
 \html_be_strict true
 \author -712698321 "Jürgen Spitzmüller"
+\author 5863208 "ab"
 \end_header
 
 \begin_body
@@ -45334,24 +45335,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.
@@ -45419,6 +45558,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
@@ -45553,6 +45694,8 @@ Here is a list with the important encodings:
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1557645284
 Language
 \begin_inset space ~
 \end_inset
@@ -45590,6 +45733,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
@@ -45599,6 +45744,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
@@ -46070,6 +46228,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
@@ -46133,7 +46306,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
@@ -46158,8 +46348,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
@@ -46572,6 +46778,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