]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx: fix bug 4192 (hopefully)
[lyx.git] / lib / doc / UserGuide.lyx
index 6fdf78148b0fd4db555cb56e5e5ad4bf1a51d6b6..39061a74a317232ed055b15dcfc29845ef21f3cb 100644 (file)
@@ -23880,7 +23880,7 @@ The nomenclature entries are sorted alphabetically by the LaTeX-code of
 a
 \begin_inset LatexCommand nomenclature
 symbol "a"
-description "dummy entry for the character \"a\"\\nomnorefpage"
+description "dummy entry for the character \"a\""
 
 \end_inset
 
@@ -24190,24 +24190,6 @@ nomnorefpage,\InsetSpace ~
 nomnorefeqpage Turns off the corresponding options
 \end_layout
 
-\begin_layout Standard
-The option 
-\series bold
-
-\backslash
-nomnorefpage
-\series default
- was used in this document in the nomenclature entry for the 
-\begin_inset Quotes eld
-\end_inset
-
-a
-\begin_inset Quotes erd
-\end_inset
-
-.
-\end_layout
-
 \begin_layout Subsection
 Printing the Nomenclature
 \begin_inset LatexCommand index
@@ -24699,6 +24681,26 @@ usepackage[labelfont=bf]{caption}
 
 \begin_layout Standard
 to the preamble and the problem is solved.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Standard
+For more commands provided by the 
+\series bold
+caption
+\series default
+ package, have a look at its documentation, 
+\begin_inset LatexCommand cite
+key "caption"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
@@ -25115,8 +25117,11 @@ reference "sub:Settings"
 
 \end_inset
 
- Enable this if you can't spell check words with international letters in
- them.
+ Only enable this if you use 
+\family typewriter
+ispell
+\family default
+ and can't spell check words with international letters in them.
  There have been reports that this does not work with all dictionaries,
  so this is disabled by default.
 \end_layout
@@ -25765,18 +25770,12 @@ Choose your language in the
 \family sans
 Language
 \family default
- section of the 
-\family sans
-Document\SpecialChar \menuseparator
-Settings
-\family default
- dialog.
+ section of this dialog.
  The default is 
 \family sans
 English
 \family default
 .
- Scroll to find the language you want and then click on your choice.
 \end_layout
 
 \begin_layout Standard
@@ -25784,25 +25783,14 @@ The
 \family sans
 Encoding
 \family default
- box lets you choose the character encoding map you want to use.
- When you select the encoding 
-\family sans
-LaTeX\InsetSpace ~
-default
-\family default
- or the option 
-\family sans
-Use language's default encoding
-\family default
-, the encoding is used that LaTeX uses by default for the selected language,
- e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-for English it is 
+ box lets you choose the character encoding map you want to use for LaTeX
+ export.
+ The option 
 \family sans
-latin9
+use language's default encoding
 \family default
-.
The different encodings are explained in section\InsetSpace ~
+ is the preferred choice and works well in most cases.
For details abhout the different encoding options see section\InsetSpace ~
 
 \begin_inset LatexCommand ref
 reference "sub:Settings"
@@ -25812,62 +25800,6 @@ reference "sub:Settings"
 .
 \end_layout
 
-\begin_layout Standard
-LyX also supports Unicode output, which is particularly useful if you need
- lots of special symbols or non-alphabetic scripts, respectively.
- If you want to use this (and your LaTeX installation supports Unicode,
- for that matter), the 
-\family typewriter
-utf8
-\family default
- encoding is the right choice for most purposes.
- Besides this, you will find some alternative Unicode encodings for specific
- purposes: 
-\family typewriter
-UTF8
-\family default
- and 
-\family typewriter
-utf8x
-\family default
- are provided for CJK languages (Chinese, Japanese, Korean), 
-\family typewriter
-utf8-plain
-\family default
-, finally, should be chosen for 
-\family sans
-XeTeX
-\family default
-, which uses Unicode directly, without the help of the LaTeX-package 
-\series bold
-inputenc
-\series default
-
-\begin_inset LatexCommand index
-name "LaTeX-packages ! inputenc"
-
-\end_inset
-
-.
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-See section\InsetSpace ~
-
-\begin_inset LatexCommand ref
-reference "sub:Settings"
-
-\end_inset
-
- for details.
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
 \begin_layout Subsection
 Keyboard mapping configuration
 \end_layout
@@ -32399,11 +32331,27 @@ name "Language ! Encoding"
 
 \begin_layout Standard
 The document language and quote styles are set here.
- The encoding is necessary to be able to enter characters in the document
- language.
- E.g.
- you want to enter the æ-ligature directly with the keyboard and not by
- using LaTeX-commands.
+ The encoding specifies how the document content is exported to LaTeX (the
+ LyX file is always encoded in utf8).
+ All characters that cannot be encoded using the specified encoding will
+ be exported as LaTeX-commands (this can fail if a LaTeX-command is not
+ known for a particular character).
+\begin_inset Foot
+status collapsed
+
+\begin_layout Standard
+The known commands are defined in a text file.
+ You can add commands for unknown symbols to that file yourself, see the
+\emph on
+Customization
+\emph default
+ manual for details.
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
@@ -32411,7 +32359,52 @@ If you use the option
 \family sans
 use language's default encoding
 \family default
-, the default encoding for the selected language is used.
+, LyX determines the encoding of a portion of text 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 LaTeX file.
+ If you do not use this option then the complete document will always use
+ exactly one encoding.
+ Checking this option is the preferred setting unless you use 
+\family sans
+XeTeX
+\family default
+
+\begin_inset Foot
+status collapsed
+
+\begin_layout Standard
+XeTeX is a TeX typesetting engine, an alternative for LaTeX.
+ It natively supports Unicode while its input file is assumed to be in UTF-8
+ encoding.
+ More about using LyX with XeTeX can be found in 
+\begin_inset LatexCommand cite
+key "XeTeX"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+ (see below).
+\end_layout
+
+\begin_layout Standard
+LyX also supports Unicode output, which is particularly useful if you need
+ lots of special symbols or non-alphabetic scripts, respectively.
+ If you want to use this (and your LaTeX installation supports Unicode,
+ for that matter), choose one of the four utf8 variants from the list below.
+ Unfortunately the unicode support of standard LaTeX is quite incomplete,
+ so it is not uncommon that a file with lots of unicode symbols works fine
+ with 
+\family sans
+use language's default encoding
+\family default
+ (when LyX uses it's list of known LaTeX-commands), but does not work with
+ a fixed utf8 encoding (when the list of known LaTeX-commands is ot used,
+ because all unicode symbols can be encoded in utf8).
 \end_layout
 
 \begin_layout Standard
@@ -32419,7 +32412,32 @@ Here is a list with the important encodings:
 \end_layout
 
 \begin_layout Description
-amscii8 encoding for Armenian
+LaTeX\InsetSpace ~
+default Same as 
+\family sans
+use language's default encoding
+\family default
+, but the LaTeX-package 
+\series bold
+inputenc
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! inputenc"
+
+\end_inset
+
+ is not used.
+ You probably need to load some other packages manually in the preamble.
+\end_layout
+
+\begin_layout Description
+armscii8 encoding for Armenian
+\end_layout
+
+\begin_layout Description
+ascii the ASCII encoding, covers only plain English, may result in a big
+ file because lots of LaTeX-commands may be needed
 \end_layout
 
 \begin_layout Description
@@ -32518,52 +32536,67 @@ pt154 Cyrillic for Kazakh
 \end_layout
 
 \begin_layout Description
-utf8 code page for Unicode utf8
+utf8 Unicode utf8 with the LaTeX-package 
+\series bold
+inputenc
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! inputenc"
+
+\end_inset
+
+ (first variant, for latin symbols and some others).
 \end_layout
 
 \begin_layout Description
-UTF8 code page provided for CJK languages (Chinese, Japanese, Korean)
+utf8x Unicode utf8 with the LaTeX-package 
+\series bold
+inputenc
+\series default
+ (second variant, for greek and CJK symbols and some others).
 \end_layout
 
 \begin_layout Description
-utf8-plain code page provided to be used with for 
-\family sans
-XeTeX
-\family default
-
-\begin_inset Foot
-status collapsed
+UTF8 Unicode utf8 with the LaTeX-package 
+\series bold
+CJK
+\series default
 
-\begin_layout Standard
-XeTeX is a TeX typesetting engine, an alternative for LaTeX.
- It natively supports Unicode while its input file is assumed to be in UTF-8
- encoding.
- More about using LyX with XeTeX can be found here: 
-\begin_inset LatexCommand url
-target "http://wiki.lyx.org/LyX/XeTeX"
+\begin_inset LatexCommand index
+name "LaTeX-packages ! CJK"
 
 \end_inset
 
-
+ (for the languages Chinese, Japanese and Korean)
 \end_layout
 
-\end_inset
-
+\begin_layout Description
+utf8-plain Unicode utf8 to be used with 
+\family sans
+XeTeX
+\family default
 , which uses Unicode directly, without the help of the LaTeX-package 
 \series bold
 inputenc
 \series default
+\begin_inset Foot
+status collapsed
 
-\begin_inset LatexCommand index
-name "LaTeX-packages ! inputenc"
+\begin_layout Standard
+More about using LyX with XeTeX can be found in 
+\begin_inset LatexCommand cite
+key "XeTeX"
 
 \end_inset
 
 .
 \end_layout
 
-\begin_layout Description
-utf8x code page provided for CJK languages
+\end_inset
+
+
 \end_layout
 
 \begin_layout Subsubsection*
@@ -36673,6 +36706,57 @@ target "http://www.tex.ac.uk/cgi-bin/texfaq2html"
 \end_inset
 
 
+\end_layout
+
+\begin_layout Bibliography
+\begin_inset LatexCommand bibitem
+key "caption"
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/caption/caption.pdf}{
+\end_layout
+
+\end_inset
+
+Documentation
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+ of the LaTeX-package 
+\series bold
+caption
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! caption"
+
+\end_inset
+
+:
+\newline
+
+\begin_inset LatexCommand url
+target "ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/caption/caption.pdf"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Bibliography
@@ -36879,6 +36963,47 @@ target "http://www.ctan.org/tex-archive/fonts/tipa/tipaman.pdf"
 \end_inset
 
 
+\end_layout
+
+\begin_layout Bibliography
+\begin_inset LatexCommand bibitem
+key "XeTeX"
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{http://wiki.lyx.org/LyX/XeTeX}{
+\end_layout
+
+\end_inset
+
+Wiki-page
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+ how to use LyX with XeTeX:
+\newline
+
+\begin_inset LatexCommand url
+target "http://wiki.lyx.org/LyX/XeTeX"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Bibliography
@@ -37089,7 +37214,7 @@ target "http://wiki.lyx.org/LyX/LyxFunctionList1-5-1"
 \begin_layout Standard
 
 \newpage
-Bibliography created from a BibTeX-database:
+
 \begin_inset LatexCommand bibtex
 options "biblio/alphadin"
 bibfiles "biblio/LyXDocs"
@@ -37097,6 +37222,13 @@ bibfiles "biblio/LyXDocs"
 \end_inset
 
 
+\end_layout
+
+\begin_layout Standard
+The above bibliography is created from a BibTeX-database.
+\end_layout
+
+\begin_layout Standard
 \begin_inset ERT
 status collapsed