]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Tutorial.lyx
Revert docbook updates to Customization manual.
[lyx.git] / lib / doc / Tutorial.lyx
index a20549d426955efeffa6d07d273ab90809042005..708eb02b93300247628f3f6243ba5c5d453dcff1 100644 (file)
@@ -1,5 +1,5 @@
-#LyX 2.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 508
+#LyX 2.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 544
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -12,7 +12,7 @@ logicalmkup
 \maintain_unincluded_children false
 \language english
 \language_package default
-\inputencoding auto
+\inputencoding utf8
 \fontencoding global
 \font_roman "palatino" "default"
 \font_sans "helvet" "default"
@@ -20,10 +20,12 @@ logicalmkup
 \font_math "auto" "auto"
 \font_default_family default
 \use_non_tex_fonts false
-\font_sc true
+\font_sc false
 \font_osf false
 \font_sf_scale 100 100
 \font_tt_scale 100 100
+\use_microtype false
+\use_dash_ligatures false
 \graphics default
 \default_output_format pdf2
 \output_sync 0
@@ -48,16 +50,16 @@ logicalmkup
 \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_package amsmath 0
-\use_package amssymb 0
-\use_package cancel 0
-\use_package esint 0
+\use_package amsmath 1
+\use_package amssymb 1
+\use_package cancel 1
+\use_package esint 1
 \use_package mathdots 1
-\use_package mathtools 0
+\use_package mathtools 1
 \use_package mhchem 1
-\use_package stackrel 0
-\use_package stmaryrd 0
-\use_package undertilde 0
+\use_package stackrel 1
+\use_package stmaryrd 1
+\use_package undertilde 1
 \cite_engine basic
 \cite_engine_type default
 \biblio_style plain
@@ -67,6 +69,7 @@ logicalmkup
 \suppress_date false
 \justification true
 \use_refstyle 0
+\use_minted 0
 \index Index
 \shortcut idx
 \color #008000
@@ -75,15 +78,20 @@ logicalmkup
 \tocdepth 2
 \paragraph_separation indent
 \paragraph_indentation default
-\quotes_language english
+\is_math_indent 0
+\math_numbering_side default
+\quotes_style english
+\dynamic_quotes 0
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
-\tracking_changes false
+\tracking_changes true
 \output_changes false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict false
+\author -712698321 "Jürgen Spitzmüller"
+\author -131811572 "Yuriy Skalko"
 \end_header
 
 \begin_body
@@ -108,6 +116,7 @@ If you have comments on or corrections to this documentation, please send
 LatexCommand href
 target "lyx-docs@lists.lyx.org"
 type "mailto:"
+literal "false"
 
 \end_inset
 
@@ -275,10 +284,6 @@ will not
 \begin_layout Itemize
 Detailed explanations of all of \SpecialChar LyX
 's features.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
@@ -294,10 +299,6 @@ User's Guide
 \begin_layout Itemize
 Detailed explanations of \SpecialChar LaTeX
 .
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
@@ -403,9 +404,18 @@ In this Tutorial, we are going to assume that you have a fully working version
 
 \begin_layout Standard
 Finally, we have written a file called 
+\change_deleted -712698321 1553351112
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351120
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  to let you practice your \SpecialChar LyX
  skills.
  Imagine that it was typed by someone who did not know about any of \SpecialChar LyX
@@ -414,11 +424,28 @@ example_raw.lyx
  As you learn new \SpecialChar LyX
  functions, we will suggest that you fix those parts of
  
+\change_deleted -712698321 1553351165
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351165
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
 .
- It also contains `subtle' hints about how to fix things.
+ It also contains 
+\begin_inset Quotes els
+\end_inset
+
+subtle
+\begin_inset Quotes ers
+\end_inset
+
+ hints about how to fix things.
 \begin_inset Foot
 status collapsed
 
@@ -438,29 +465,63 @@ Notes
 \end_inset
 
  If you want to cheat, or check what you have done, there is also a file
- called
-\begin_inset Newline newline
-\end_inset
-
+ called 
+\change_deleted -712698321 1553351273
 
 \family typewriter
 example_lyxified.lyx
+\change_inserted -712698321 1553351278
+
 \family default
+\emph on
+Example (LyXified)
+\change_unchanged
+
+\emph default
  which contains the same text written and typeset by a \SpecialChar LyX
  master.
 \end_layout
 
 \begin_layout Standard
-The example files can be found in the 
+The example files can be found in 
+\change_inserted -712698321 1553351405
+the 
+\begin_inset Quotes eld
+\end_inset
+
+General
+\begin_inset Quotes erd
+\end_inset
+
+ section of 
+\family sans
+File\SpecialChar menuseparator
+Open Example\SpecialChar ldots
+
+\change_deleted -712698321 1553351425
+
+\family default
+the 
 \family typewriter
 examples
 \family default
  directory of \SpecialChar LyX
-'s installation folder.
+'s installation folder
+\change_unchanged
+.
  Open the document 
+\change_deleted -712698321 1553351441
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351441
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  and use 
 \family sans
 File\SpecialChar menuseparator
@@ -476,11 +537,23 @@ As
 \end_layout
 
 \begin_layout Standard
-By the way, the 
+By the way, 
+\change_deleted -712698321 1553351473
+the 
 \family typewriter
 examples
 \family default
- directory contains lots of other examples files.
+ directory
+\change_inserted -712698321 1553351473
+
+\family sans
+File\SpecialChar menuseparator
+Open Example\SpecialChar ldots
+
+\change_unchanged
+
+\family default
+ contains lots of other examples files.
  They will show you how to do various fancy things with \SpecialChar LyX
 .
  After you have read the Tutorial, or when you are confused about how to
@@ -589,6 +662,16 @@ arg   "buffer-view"
  respectively.
 \end_layout
 
+\begin_layout Standard
+
+\series bold
+Another hint:
+\series default
+ In case you are using a high-resolution display, the LyX toolbar icons
+ are quite small.
+ To change their size, right-click into a toolbar.
+\end_layout
+
 \begin_layout Subsection
 Simple Operations
 \end_layout
@@ -627,10 +710,6 @@ arg   "redo"
 \end_inset
 
 ) to get it back.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
@@ -1397,6 +1476,14 @@ Subsubsection
 Exercise
 \series default
 : Fix the section and subsection headings in
+\change_inserted -712698321 1553351516
+\emph on
+Example (raw)
+\change_deleted -712698321 1553351522
+
+\emph default
+
 \begin_inset Newline newline
 \end_inset
 
@@ -1406,6 +1493,8 @@ example_raw.lyx
 \family default
 .
  
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsection
@@ -1494,7 +1583,7 @@ Environment
  box (
 \begin_inset Info
 type  "icon"
-arg   "layout Itemize"
+arg   "layout-toggle Itemize"
 \end_inset
 
 ).
@@ -1596,7 +1685,7 @@ Environment
  box (
 \begin_inset Info
 type  "icon"
-arg   "layout Enumerate"
+arg   "layout-toggle Enumerate"
 \end_inset
 
 ).
@@ -1629,13 +1718,13 @@ Labeling
  (
 \begin_inset Info
 type  "icon"
-arg   "layout Description"
+arg   "layout-toggle Description"
 \end_inset
 
  and 
 \begin_inset Info
 type  "icon"
-arg   "layout List"
+arg   "layout-toggle List"
 \end_inset
 
 ), in order to see what they look like.
@@ -1697,8 +1786,17 @@ s.
 Exercise
 \series default
 : Typeset the list in 
+\change_deleted -712698321 1553351539
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351539
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -1787,12 +1885,22 @@ Quote, \SpecialChar LyX
 Verse
 \family default
  in
+\change_inserted -712698321 1553351552
+\emph on
+Example (raw)
+\change_deleted -712698321 1553351554
+
+\emph default
+
 \begin_inset Newline newline
 \end_inset
 
 
 \family typewriter
 example_raw.lyx
+\change_unchanged
+
 \end_layout
 
 \begin_layout Chapter
@@ -1948,10 +2056,6 @@ Special Document Classes
 Additional Features
 \emph default
  manual for many more details.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -2151,12 +2255,26 @@ from
 \end_inset
 
 Template
+\change_inserted -712698321 1553351676
+
 \family default
+\SpecialChar ldots
+
+\change_unchanged
 .
  Select 
+\change_deleted -712698321 1553351662
+
 \family typewriter
 letter.lyx
+\change_inserted -712698321 1553351666
+
 \family default
+\emph on
+Letter (Standard Class)
+\change_unchanged
+
+\emph default
  as the template.
  Save and print the file to see how the various environments are typeset.
 \end_layout
@@ -2342,8 +2460,17 @@ Abstract
 Exercise
 \series default
 : Fix the title, date, and author in 
+\change_deleted -712698321 1553351568
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351568
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -2486,7 +2613,7 @@ Format
 \begin_inset Quotes eld
 \end_inset
 
-<reference> on page <page>
+<reference>
 \begin_inset Quotes erd
 \end_inset
 
@@ -2504,7 +2631,7 @@ sec:About-This-Document
 \begin_inset Quotes eld
 \end_inset
 
-Ref+Text: sec:About-This-Document
+Ref: sec:About-This-Document
 \begin_inset Quotes erd
 \end_inset
 
@@ -2519,7 +2646,7 @@ Space
  (shortcut 
 \begin_inset Info
 type  "shortcut"
-arg   "command-alternatives space-insert protected ; math-space"
+arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
 ) in between the word 
@@ -2550,7 +2677,7 @@ arg   "paste"
 
 ).
  In the printed document, this reference marker will be replaced with the
- section number and then the page number.
+ section number.
  Preview your document and you will see that \SpecialChar LaTeX
  has been even cleverer than
  that.
@@ -2562,39 +2689,7 @@ 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
-
- (where 
-\emph on
-n
-\emph default
- is the page number).
+.
 \end_layout
 
 \begin_layout Standard
@@ -2722,8 +2817,17 @@ reference "sec:Document-Classes"
 Exercise
 \series default
 : Fix the references in 
+\change_deleted -712698321 1553351573
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351573
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -2901,8 +3005,17 @@ Change your \SpecialChar LyX
 Exercise
 \series default
 : Fix the footnote in 
+\change_deleted -712698321 1553351579
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351579
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -3094,8 +3207,17 @@ User's Guide
 Exercise:
 \series default
  Fix the bibliography and citation in 
+\change_deleted -712698321 1553351585
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351585
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -3122,7 +3244,19 @@ List
 \begin_inset space ~
 \end_inset
 
-TOC\SpecialChar menuseparator
+TOC
+\change_inserted -712698321 1590305779
+
+\begin_inset space \thinspace{}
+\end_inset
+
+/
+\begin_inset space \thinspace{}
+\end_inset
+
+References
+\change_unchanged
+\SpecialChar menuseparator
 Table
 \begin_inset space ~
 \end_inset
@@ -3207,8 +3341,17 @@ To get rid of the Table of Contents, you can delete the table of contents
 Exercise
 \series default
 : Fix the table of contents in 
+\change_deleted -712698321 1553351589
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351589
+
+\family default
+\emph on
+Example (raw)
+\change_unchanged
+
 \end_layout
 
 \begin_layout Chapter
@@ -3233,12 +3376,8 @@ Using Math
 , then the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-Panel
 \family default
- will allow you to write professional-looking math quickly and easily.
toolbar will allow you to write professional-looking math quickly and easily.
 \end_layout
 
 \begin_layout Section
@@ -3510,12 +3649,9 @@ Exponents and Indices
 An exponent can be entered from the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-Toolbar
 \family default
- (see below), but it is actually simpler just to type the caret key, 
+ toolbar (see below), but it is actually simpler just to type the caret
+ key, 
 \begin_inset Quotes eld
 \end_inset
 
@@ -3569,9 +3705,18 @@ Exercise
 \end_inset
 
 1 of 
+\change_deleted -712698321 1553351597
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351597
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  into math mode.
 \end_layout
 
@@ -3583,13 +3728,9 @@ The Math toolbar
 The 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-toolbar
 \family default
- is a convenient way to enter symbols and/or to perform complicated formula
- operations.
+ toolbar is a convenient way to enter symbols and/or to perform complicated
formula operations.
  Many of these operations can be accomplished from the keyboard or the 
 \family sans
 Insert\SpecialChar menuseparator
@@ -3604,13 +3745,9 @@ Math
  However, we are going to concentrate on using the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-toolbar
 \family default
-, just to let you know what is out there; you can learn keyboard shortcuts
- and commands later from the 
+ toolbar, just to let you know what is out there; you can learn keyboard
shortcuts and commands later from the 
 \emph on
 Math
 \emph default
@@ -3621,13 +3758,9 @@ Math
 The 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-toolbar
 \family default
- is shown when the cursor is in a formula and can also be turned on manually
- in the menu 
+ toolbar is shown when the cursor is in a formula and can also be turned
on manually in the menu 
 \family sans
 View\SpecialChar menuseparator
 Toolbars
@@ -3668,13 +3801,9 @@ Toolbars
  menu, the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-toolbar
 \family default
- is only shown when the cursor is within a formula; this state is visualized
- by the renaming of the menu entry from 
+ toolbar is only shown when the cursor is within a formula; this state is
visualized by the renaming of the menu entry from 
 \begin_inset Quotes eld
 \end_inset
 
@@ -3705,13 +3834,10 @@ Greek and symbols
 The 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-toolbar
 \family default
- allows you to choose from a large array of symbols used in math: operators,
- arrows, relationships, delimiters, special characters, sums and integrals.
+ toolbar allows you to choose from a large array of symbols used in math:
+ operators, arrows, relationships, delimiters, special characters, sums
+ and integrals.
  Note that subscripting and superscripting allow you to put lower and upper
  limits on sums and integrals.
 \end_layout
@@ -3782,6 +3908,10 @@ arg   "dialog-show mathdelimiter"
 
  to pop up the 
 \family sans
+Math
+\begin_inset space ~
+\end_inset
+
 Delimiter
 \family default
  dialog.
@@ -3809,6 +3939,10 @@ Delimiter
 If you are lazy, you can type actual parentheses in math mode, rather than
  using the 
 \family sans
+Math
+\begin_inset space ~
+\end_inset
+
 Delimiter
 \family default
  dialog.
@@ -3831,12 +3965,8 @@ You can also put delimiters or a square root sign or a decoration on already
  on the button you want from the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-Toolbar
 \family default
-.
+ toolbar.
  Try using this to change Newton's second law from scalar to vector form
  (
 \begin_inset Formula $f=ma$
@@ -3847,7 +3977,7 @@ Toolbar
 \end_inset
 
 ).
- Once you have  learned about matrices, this is how you will put parentheses
+ Once you have learned about matrices, this is how you will put parentheses
  or brackets around them.
 \end_layout
 
@@ -3857,20 +3987,28 @@ Fractions
 
 \begin_layout Standard
 To create a fraction, click on the fraction button 
+\change_deleted -131811572 1566935165
+
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\frac-square"
 \end_inset
 
+
+\change_inserted -131811572 1566935147
+
+\begin_inset Info
+type  "icon"
+arg   "math-insert \\frac"
+\end_inset
+
+
+\change_unchanged
  in the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-Toolbar
 \family default
-.
+ toolbar.
  \SpecialChar LyX
  writes two insertion points in a fraction.
  As you would expect, you can use arrow keys or the mouse to move around
@@ -3900,7 +4038,6 @@ Down
  You have made a fraction! Of course you can type anything within each of
  the two boxes: variables with exponents, square roots, other fractions,
  whatever.
 \end_layout
 
 \begin_layout Labeling
@@ -3914,9 +4051,18 @@ Exercise
 \end_inset
 
 2 of 
+\change_deleted -712698321 1553351607
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351607
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  into math mode.
 \end_layout
 
@@ -4012,12 +4158,8 @@ Space
 Click on the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
-
-Toolbar
 \family default
- button 
toolbar button 
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\functions"
@@ -4102,9 +4244,18 @@ Exercise
 \end_inset
 
 3 of 
+\change_deleted -712698321 1553351612
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351612
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  into math mode.
 \end_layout
 
@@ -4122,11 +4273,11 @@ arg   "dialog-show mathmatrix"
  in the 
 \family sans
 Math
-\begin_inset space ~
-\end_inset
+\change_inserted -131811572 1566934540
 
-Toolbar
 \family default
+ toolbar
+\change_unchanged
 .
  A pop-up dialog allows you to choose how many rows and columns you want
  in your matrix.
@@ -4244,14 +4395,13 @@ arg   "math-display"
 
  in the 
 \family sans
-Math Toolbar
+Math
 \family default
-.
+ toolbar.
  This centers the formula and adds a blank line before and after it.
  Now type in an expression and compile your file to see how it looks.
  The display button is actually a toggle; use it now to change a couple
  of your expressions to display mode and back.
 \end_layout
 
 \begin_layout Standard
@@ -4309,9 +4459,18 @@ after
 Exercise
 \series default
 : Put the various equations in 
+\change_deleted -712698321 1553351617
+
 \family typewriter
 example_raw.lyx
+\change_inserted -712698321 1553351617
+
 \family default
+\emph on
+Example (raw)
+\change_unchanged
+
+\emph default
  into display mode, and see how they are typeset differently.
 \end_layout
 
@@ -5039,8 +5198,12 @@ Bib\SpecialChar TeX
 \begin_layout Standard
 \SpecialChar LyX
  has support for Bib\SpecialChar TeX
-, which allows you to build databases of bibliographical
- references to be used in multiple documents.
+
+\change_inserted -712698321 1590301994
+ and Biblatex
+\change_unchanged
+, which allows you to build databases of bibliographical references to be
+ used in multiple documents.
  Select 
 \family sans
 Insert\SpecialChar menuseparator
@@ -5052,8 +5215,24 @@ List
 \begin_inset space \thinspace{}
 \end_inset
 
-TOC\SpecialChar menuseparator
-BibTeX
+TOC
+\change_inserted -712698321 1590301964
+
+\begin_inset space \thinspace{}
+\end_inset
+
+/
+\begin_inset space \thinspace{}
+\end_inset
+
+References
+\change_unchanged
+\SpecialChar menuseparator
+Bib
+\change_inserted -712698321 1590301973
+(la)
+\change_unchanged
+TeX
 \begin_inset space ~
 \end_inset
 
@@ -5068,14 +5247,44 @@ Bib\SpecialChar TeX
  In the 
 \family sans
 Database
+\change_inserted -712698321 1590302046
+s
+\change_unchanged
+
 \family default
- field you load Bib\SpecialChar TeX
- files, in the 
+\change_deleted -712698321 1590302066
+field
+\change_inserted -712698321 1590302067
+widget
+\change_unchanged
+ you 
+\change_deleted -712698321 1590302057
+load
+\change_inserted -712698321 1590302058
+select
+\change_unchanged
+ Bib\SpecialChar TeX
+ files
+\change_inserted -712698321 1590302061
+ to load
+\change_unchanged
+, in the 
 \family sans
 Style
 \family default
- field you can load Bib\SpecialChar TeX
- style files.
+ field you can 
+\change_deleted -712698321 1590302077
+load
+\change_inserted -712698321 1590302078
+select a
+\change_unchanged
+ Bib\SpecialChar TeX
+ style file
+\change_deleted -712698321 1590302081
+s
+\change_unchanged
+.
 \end_layout
 
 \begin_layout Standard
@@ -5107,6 +5316,13 @@ Bib\SpecialChar TeX
 
 \family default
  file.
+
+\change_inserted -712698321 1590302176
+ If you want to use Biblatex rather than classic Bib\SpecialChar TeX
+, please refer to the
+ User Guide for instructions.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section