]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Tutorial.lyx
Don't allow newline characters in document settings.
[lyx.git] / lib / doc / Tutorial.lyx
index 03565baff38f44717e300ca8ff3a9e8c98a96c8c..10ffa1c1aa1e4678633c173cb55e47fb78c9b942 100644 (file)
@@ -1,5 +1,5 @@
-#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 376
+#LyX 2.0 created this file. For more info see http://www.lyx.org/
+\lyxformat 413
 \begin_document
 \begin_header
 \textclass book
   \pdfbookmark[1]{\contentsname}{}
   \myTOC
   \mainmatter }
-
-% redefine the \LyX macro for PDF bookmarks
-\def\LyX{\texorpdfstring{%
-  L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
-  {LyX}}
 \end_preamble
 \use_default_options false
 \begin_modules
@@ -41,13 +36,14 @@ logicalmkup
 \end_modules
 \maintain_unincluded_children false
 \language english
+\language_package default
 \inputencoding auto
 \fontencoding global
 \font_roman default
 \font_sans default
 \font_typewriter default
 \font_default_family default
-\use_xetex false
+\use_non_tex_fonts false
 \font_sc false
 \font_osf false
 \font_sf_scale 100
@@ -55,6 +51,7 @@ logicalmkup
 
 \graphics default
 \default_output_format default
+\output_sync 0
 \bibtex_command default
 \index_command default
 \paperfontsize 12
@@ -73,17 +70,19 @@ logicalmkup
 \pdf_colorlinks true
 \pdf_backref false
 \pdf_pdfusetitle false
-\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,pdfpagelayout=OneColumn, pdfnewwindow=true,pdfstartview=XYZ, plainpages=false, pdfpagelabels"
+\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
 \papersize default
 \use_geometry false
 \use_amsmath 0
 \use_esint 0
 \use_mhchem 1
+\use_mathdots 1
 \cite_engine basic
 \use_bibtopic false
 \use_indices false
 \paperorientation portrait
 \suppress_date false
+\use_refstyle 0
 \index Index
 \shortcut idx
 \color #008000
@@ -96,11 +95,11 @@ logicalmkup
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
-\tracking_changes true
+\tracking_changes false
 \output_changes false
-\html_use_mathml true
-\html_be_strict true
-\author 2 "Richard Heck" 
+\html_math_output 0
+\html_css_as_file 0
+\html_be_strict false
 \end_header
 
 \begin_body
@@ -380,7 +379,7 @@ View
 
 \begin_layout Standard
 In this Tutorial, we are going to assume that you have a fully working version
- of LyX, as well as a LaTeX-distribution, a DVI-, and a PDF-viewer.
+ of LyX, as well as a LaTeX-distribution and a PDF-viewer.
  This should be the case on all major Linux- and BSD-distributions, as well
  as on Windows, where this is setup by the LyX installers.
 \end_layout
@@ -1177,7 +1176,7 @@ Environment
 
 , and typesets it in a font which is bigger than regular text but smaller
  than the section title.
- Change the fourth line 
+ Change the fourth line to the 
 \family sans
 Subsection
 \family default
@@ -1758,7 +1757,7 @@ Environment
 
 \begin_layout Standard
 Font sizes, one- or two-column printing, and page headings are just some
- of the ways journals typesettings differ from one another.
+ of the ways journals' typesettings differ from one another.
  As the Computer Age continues to mature, journals have begun accepting
  electronic submissions, creating LaTeX 
 \begin_inset Quotes eld
@@ -2017,10 +2016,6 @@ Address
  environment, which do not even exist in most other document classes.
  Others, like 
 \family sans
-Quote
-\family default
- and 
-\family sans
 Description
 \family default
 , are familiar.
@@ -2258,7 +2253,7 @@ Your first cross-reference
 \end_layout
 
 \begin_layout Standard
-Place the cursor somewhere in section
+Place the cursor somewhere in Section
 \begin_inset space ~
 \end_inset
 
@@ -2271,11 +2266,19 @@ If you want to know more about this document, then see
 \begin_inset Newline newline
 \end_inset
 
-section, which can be found on page.
+Section, which can be found on page.
 \end_layout
 
 \begin_layout Standard
-Now — with the cursor after the word `Section' — choose 
+Now — with the cursor after the word 
+\begin_inset Quotes eld
+\end_inset
+
+Section
+\begin_inset Quotes erd
+\end_inset
+
+ — choose 
 \family sans
 Insert\SpecialChar \menuseparator
 Cross
@@ -2295,11 +2298,42 @@ Reference
 .
  The Cross-reference dialog pops up.
  It shows a list of the possible labels you can reference.
- At the moment, there should be only one, `sec:About-This-Document'.
- First, select the drop-down menu labeled Format and select '<reference>
- on page <page>.' Then select `sec:About-This-Document' (it may be selected
- by default), and a reference marker will appear containing `Ref+Text: sec:About
--This-Document' (To be really correct, you should put a 
+ At the moment, there should be only one, 
+\begin_inset Quotes eld
+\end_inset
+
+sec:About-This-Document
+\begin_inset Quotes erd
+\end_inset
+
+.
+ First, select the drop-down menu labeled Format and select 
+\begin_inset Quotes eld
+\end_inset
+
+<reference> on page <page>
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Then select 
+\begin_inset Quotes eld
+\end_inset
+
+sec:About-This-Document
+\begin_inset Quotes erd
+\end_inset
+
+ (it may be selected by default), and a reference marker will appear containing
+\begin_inset Quotes eld
+\end_inset
+
+Ref+Text: sec:About-This-Document
+\begin_inset Quotes erd
+\end_inset
+
+ (To be really correct, you should put a 
 \family sans
 Protected
 \begin_inset space ~
@@ -2307,7 +2341,15 @@ Protected
 
 Space
 \family default
- in between the word `Section' and the reference).
+ in between the word 
+\begin_inset Quotes eld
+\end_inset
+
+Section
+\begin_inset Quotes erd
+\end_inset
+
+ and the reference).
  Alternatively to that method, you can right-click on a label and use in
  the appearing context menu 
 \family sans
@@ -2329,9 +2371,43 @@ Ctrl+V
  section number and then the page number.
  View your document as DVI, and you will see that LaTeX has been even cleverer
  than that.
- It refers to `Section 2' and depending how much text you have between the
- start of Section 2 and this cross-reference you may see `on this page,'
- 'on the previous page' or `on page n' (whereas 
+ It refers to 
+\begin_inset Quotes eld
+\end_inset
+
+Section 2
+\begin_inset Quotes erd
+\end_inset
+
+ and depending how much text you have between the start of Section
+\begin_inset space ~
+\end_inset
+
+2 and this cross-reference you may see 
+\begin_inset Quotes eld
+\end_inset
+
+on this page
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+on the previous page
+\begin_inset Quotes erd
+\end_inset
+
+ or 
+\begin_inset Quotes eld
+\end_inset
+
+on page n
+\begin_inset Quotes erd
+\end_inset
+
+ (whereas 
 \emph on
 n
 \emph default
@@ -2434,7 +2510,7 @@ status collapsed
 
 \begin_layout Plain Layout
 By the way, copying a chapter title may cause an error, because chapters
- are not allowed in the article class, see section
+ are not allowed in the article class, see Section
 \begin_inset space ~
 \end_inset
 
@@ -4053,12 +4129,14 @@ Environment
 \end_inset
 
  
-\begin_inset Formula \[
+\begin_inset Formula 
+\[
 f(x)=\left\{ \begin{array}{cc}
 \log_{8}x & x>0\\
 0 & x=0\\
 \sum_{i=1}^{5}\alpha_{i}+\sqrt{-\frac{1}{x}} & x<0
-\end{array}\right.\]
+\end{array}\right.
+\]
 
 \end_inset
 
@@ -4450,7 +4528,7 @@ LyX cannot do absolutely everything that LaTeX can do.
 \backslash
 usepackage{foo}
 \family default
- in the preamble (see section
+ in the preamble (see Section
 \begin_inset space ~
 \end_inset
 
@@ -4466,13 +4544,7 @@ reference "sec:preamble"
 \end_layout
 
 \begin_layout Subsection
-Importing LaTeX Documents
-\change_deleted 2 1263335457
- — 
-\change_inserted 2 1263335459
----
-\change_unchanged
-
+Importing LaTeX Documents — 
 \family typewriter
 tex2lyx
 \family default
@@ -4499,162 +4571,57 @@ LaTeX
 \family default
  menu in LyX.
  This will call the program 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
-\end_layout
-
-\end_inset
-
- which will create a file 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-foo.lyx
-\end_layout
-
-\end_inset
-
- from the file 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-foo.tex
-\end_layout
-
-\end_inset
-
-
-\change_inserted 2 1263337184
-; LyX will 
-\change_deleted 2 1263337185
- and 
-\change_unchanged
-then open that file.
+\family default
+ which will create a file foo.lyx from the file foo.tex.
+ LyX will then open that file.
  If the translation does not work, you can try calling 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
-\end_layout
-
-\end_inset
-
+\family default
  from the command line, possibly using fancier options.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 2 1263337199
 Even when the translation does work, 
-\change_unchanged
-
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
-\end_layout
-
-\end_inset
-
-\change_inserted 2 1263337202
-may not 
-\change_deleted 2 1263337203
-will 
-\change_unchanged
-translate 
-\change_deleted 2 1263337205
-most legal LaTeX, but not 
-\change_unchanged
-everything
-\change_inserted 2 1263337217
-, though it does handle most legal LaTeX
-\change_unchanged
-.
+\family default
+ may not translate everything, though it does handle most legal LaTeX.
  It will leave things it does not understand in TeX mode; so, after translating
  a file with 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
-\end_layout
-
-\end_inset
-
+\family default
 , you can look for the red text and manually edit it to get it right.
 \end_layout
 
 \begin_layout Standard
-\begin_inset Flex CharStyle:Code
-status collapsed
 
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
-\end_layout
-
-\end_inset
-
- has its own 
-\change_inserted 2 1263337255
-documentation
-\change_deleted 2 1263337260
-manpage.
-\change_inserted 2 1263337293
-, which *nix users can access via 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 2 1263337285
-man tex2lyx
-\change_unchanged
-
-\end_layout
-
+\family default
+ has its own documentation (manpage), which Unix/Linux users can access
+ via the console command 
+\family typewriter
+man
+\begin_inset space ~
 \end_inset
 
+tex2lyx
+\family default
 .
- The manpage describes 
-\change_deleted 2 1263337296
- Read it to find out 
-\change_unchanged
-which LaTeX commands and environments are not supported, 
-\change_inserted 2 1263335470
-what bugs you might run into 
-\change_deleted 2 1263335471
-bugs 
-\change_unchanged
-(and how to get around them), and how to use the various options.
-\change_inserted 2 1263335473
-
+ The manpage describes which LaTeX commands and environments are not supported,
+ what bugs you might run into (and how to get around them), and how to use
+ the various options.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 2 1263337717
-It is extremely important to understand that 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 2 1263335502
+It is important to understand that 
+\family typewriter
 tex2lyx
-\change_unchanged
-
-\end_layout
-
-\end_inset
-
+\family default
  can only translate files whose document class is 
 \begin_inset Quotes eld
 \end_inset
@@ -4663,86 +4630,26 @@ known
 \begin_inset Quotes erd
 \end_inset
 
- to LyX, that is, for which there is a corresponding LyX `layout file'.
+ to LyX, that is, for which there is a corresponding LyX 
+\family sans
+layout file
+\family default
+.
  If there is no layout file, then you will get an error saying that the
  conversion could not be performed.
- The reason for this is that, in a sense, LyX doesn't know anything about
- LaTeX: very little of the information LyX has about LaTeX is contained
- in the program itself.
- That information is instead contained in layout files.
- You can think of the layout file for a document class as a translation
- manual between LyX constructs---paragraphs with their corresponding styles,
- etc---and the corresponding LaTeX commands and environments.
- So, unless you have a layout for 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 2 1263336322
-foo.tex
-\change_unchanged
-
-\end_layout
-
-\end_inset
-
-'s document class, 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 2 1263336331
+ So, unless you have a layout for the document class of your LaTeX file,
+\family typewriter
 tex2lyx
-\change_unchanged
-
-\end_layout
-
-\end_inset
-
- simply will not now how to translate the LaTeX that it finds there into
+\family default
+ simply will not know how to translate the LaTeX that it finds there into
  things LyX understands.
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted 2 1263337784
-When you installed LyX, you also installed layout files for almost 100 different
- document types (though some of these are DocBook, rather than LaTeX).
- Still, there are many, many more document classes than that, and new ones
- are probably invented every day.
- There is no way that LyX itself can include layout files for every document
- class you might want to use.
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted 2 1263337857
-So what can you do if LyX does not include a layout file for your fancy
- new document class? Create your own.
- If your new document class is based upon, or very similar to, one for which
- there already is a layout file, which is true in many cases, then creating
- a new layout file may be as easy as copying a file and changing a few lines.
- In the other cases, you may have more work to do.
- But while you will have to learn a bit, it is not really that difficult,
- and many of the people who contribute to the users' mailing list have a
- great deal of experience they are willing to share.
-\change_unchanged
-
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted 2 1263337162
-The format of LyX's layout files and the process of creating new ones are
- discussed in detail in Chapter 5 of the 
+ More about layout files and how they are created is explained in detail
+ in Chapter 5 of the 
 \emph on
 Customization
 \emph default
  manual.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Subsection
@@ -4877,7 +4784,7 @@ After you have done this, you can use citations from any bibliographies
 Insert\SpecialChar \menuseparator
 Citation
 \family default
- (see section
+ (see Section
 \begin_inset space ~
 \end_inset