X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Fdoc%2FTutorial.lyx;h=10ffa1c1aa1e4678633c173cb55e47fb78c9b942;hb=c48091f33a773732fa6c789927e5833e44108d9d;hp=03565baff38f44717e300ca8ff3a9e8c98a96c8c;hpb=3fef24069aca9ad6802717afb291aa392060d1b1;p=lyx.git diff --git a/lib/doc/Tutorial.lyx b/lib/doc/Tutorial.lyx index 03565baff3..10ffa1c1aa 100644 --- a/lib/doc/Tutorial.lyx +++ b/lib/doc/Tutorial.lyx @@ -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 @@ -29,11 +29,6 @@ \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 ' - on 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 + + on 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