]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Tutorial.lyx
Acknowledgments.lyx: fix a typo
[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
 \begin_document
 \begin_header
 \textclass book
   \pdfbookmark[1]{\contentsname}{}
   \myTOC
   \mainmatter }
   \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
 \end_preamble
 \use_default_options false
 \begin_modules
@@ -41,13 +36,14 @@ logicalmkup
 \end_modules
 \maintain_unincluded_children false
 \language english
 \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
 \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
 \font_sc false
 \font_osf false
 \font_sf_scale 100
@@ -55,6 +51,7 @@ logicalmkup
 
 \graphics default
 \default_output_format default
 
 \graphics default
 \default_output_format default
+\output_sync 0
 \bibtex_command default
 \index_command default
 \paperfontsize 12
 \bibtex_command default
 \index_command default
 \paperfontsize 12
@@ -73,17 +70,19 @@ logicalmkup
 \pdf_colorlinks true
 \pdf_backref false
 \pdf_pdfusetitle false
 \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
 \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
 \cite_engine basic
 \use_bibtopic false
 \use_indices false
 \paperorientation portrait
 \suppress_date false
+\use_refstyle 0
 \index Index
 \shortcut idx
 \color #008000
 \index Index
 \shortcut idx
 \color #008000
@@ -96,11 +95,11 @@ logicalmkup
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
-\tracking_changes true
+\tracking_changes false
 \output_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
 \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
 
 \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
  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.
 
 , 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
 \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
 
 \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
  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
  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.
 Description
 \family default
 , are familiar.
@@ -2258,7 +2253,7 @@ Your first cross-reference
 \end_layout
 
 \begin_layout Standard
 \end_layout
 
 \begin_layout Standard
-Place the cursor somewhere in section
+Place the cursor somewhere in Section
 \begin_inset space ~
 \end_inset
 
 \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
 
 \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
 \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
 \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.
 .
  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 ~
 \family sans
 Protected
 \begin_inset space ~
@@ -2307,7 +2341,15 @@ Protected
 
 Space
 \family default
 
 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
  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.
  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
 \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
 
 \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
 
 \begin_inset space ~
 \end_inset
 
@@ -4053,12 +4129,14 @@ Environment
 \end_inset
 
  
 \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
 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
 
 
 \end_inset
 
@@ -4450,7 +4528,7 @@ LyX cannot do absolutely everything that LaTeX can do.
 \backslash
 usepackage{foo}
 \family default
 \backslash
 usepackage{foo}
 \family default
- in the preamble (see section
+ in the preamble (see Section
 \begin_inset space ~
 \end_inset
 
 \begin_inset space ~
 \end_inset
 
@@ -4466,13 +4544,7 @@ reference "sec:preamble"
 \end_layout
 
 \begin_layout Subsection
 \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
 \family typewriter
 tex2lyx
 \family default
@@ -4499,162 +4571,57 @@ LaTeX
 \family default
  menu in LyX.
  This will call the program 
 \family default
  menu in LyX.
  This will call the program 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
 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 
  If the translation does not work, you can try calling 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
 tex2lyx
-\end_layout
-
-\end_inset
-
+\family default
  from the command line, possibly using fancier options.
 \end_layout
 
 \begin_layout Standard
  from the command line, possibly using fancier options.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 2 1263337199
 Even when the translation does work, 
 Even when the translation does work, 
-\change_unchanged
-
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
+\family typewriter
 tex2lyx
 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 
  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
 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
 , 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
 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
 
 \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
 \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
 tex2lyx
-\change_unchanged
-
-\end_layout
-
-\end_inset
-
+\family default
  can only translate files whose document class is 
 \begin_inset Quotes eld
 \end_inset
  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
 
 \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.
  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
 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.
  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.
 \emph on
 Customization
 \emph default
  manual.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Subsection
 \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
 Insert\SpecialChar \menuseparator
 Citation
 \family default
- (see section
+ (see Section
 \begin_inset space ~
 \end_inset
 
 \begin_inset space ~
 \end_inset