-#LyX 1.4.0cvs created this file. For more info see http://www.lyx.org/
-\lyxformat 245
+#LyX 1.5.0rc1 created this file. For more info see http://www.lyx.org/
+\lyxformat 271
\begin_document
\begin_header
\textclass book
\language english
\inputencoding latin1
-\fontscheme default
+\font_roman default
+\font_sans default
+\font_typewriter default
+\font_default_family default
+\font_sc false
+\font_osf false
+\font_sf_scale 100
+\font_tt_scale 100
\graphics none
\paperfontsize default
\spacing single
\papersize default
\use_geometry false
\use_amsmath 0
+\use_esint 0
\cite_engine basic
\use_bibtopic false
\paperorientation portrait
\papersides 2
\paperpagestyle headings
\tracking_changes false
-\output_changes true
+\output_changes false
+\author "usti"
\end_header
\begin_body
\noun default
.
If you have comments or error corrections, please send them to the LyX
- Documentation mailing list, <lyx-docs@lists.lyx.org>.
+ Documentation mailing list,
+\family typewriter
+lyx-docs@lists.lyx.org
+\family default
+.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \tableofcontents{}
+\begin_inset LatexCommand tableofcontents
\end_inset
To get the most out of this document, you should read through the document,
typing all the silly little things we're telling you to type and trying
out all of the exercises to see if you get them right.
- For convenience, you might want to print out the PostScript® version of
+ For convenience, you might want to print out the PostScript® version of
this document.
\end_layout
\emph default
, you should definitely check out Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:latexusers}
+\begin_inset LatexCommand ref
+reference "sec:latexusers"
\end_inset
\end_layout
\begin_layout Section
-Your First LyX Document
+Your First LyX Document
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:first-doc-ex}
+\begin_inset LatexCommand label
+name "sec:first-doc-ex"
\end_inset
Before you do, though, there are a few things we need to mention, which
will hopefully make the
\emph on
-Tutorial
+Tutorial
\emph default
-more instructive, useful, and fun.
+ more instructive, useful, and fun.
\end_layout
Because there's lots of information that we won't be giving you, the
\emph on
first
-\series medium
\emph default
- thing that you need to do is find the
+
+\series medium
+thing that you need to do is find the
\series default
-other
+ other
\series medium
help files.
Luckily, this is very simple.
\family sans
\bar under
-D
+V
\bar default
-ocuments
+iew
\family default
- menu to switch between them.
- The
+ menu or the document tabs to switch between them.
+ The
\emph on
- Tutorial
+Tutorial
\emph default
will not cover in detail subjects which are described in the other LyX
manuals.
\family typewriter
dvi
\family default
- documents to PostScript® documents, and a working printer.
+ documents to PostScript® documents, and a working printer.
This is a lot to assume.
If any of this is not true, you (or a friendly system administrator) will
need to set up your system.
dit\SpecialChar \menuseparator
Cut
\family default
-,
+,
\family sans
\bar under
- E
+E
\bar default
dit\SpecialChar \menuseparator
Copy
\bar default
ind\InsetSpace ~
&\InsetSpace ~
-Replace
+Replace
\family default
-for a search.
+ for a search.
In the dialog, search with the
\family sans
\bar under
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:whitespace}
+\begin_inset LatexCommand label
+name "sec:whitespace"
\end_inset
\family sans
Return
\family default
- grammatically separates paragraphs, and a
+ grammatically separates paragraphs, and a
\family sans
- Space
+Space
\family default
grammatically separates words, so there is no reason to have several of
them in a row; a
what you mean.
The
\emph on
-User's Guide
+User's Guide
\emph default
-has information about all that.
+ has information about all that.
It includes
\family sans
HFill
\family sans
Section
\family default
- from the
+ from the
\family sans
- Environment
+Environment
\family default
menu again.
LyX writes a
\family sans
Section
\family default
- from the
+ from the
\family sans
- Environment
+Environment
\family default
menu again.
Again, LyX writes
\family sans
Subsection
\family default
- from the
+ from the
\family sans
- Environment
+Environment
\family default
menu.
LyX numbers the subsection
s, but you're only allowed to use them in certain types (text classes) of
LyX documents (see Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:textclasses}
+\begin_inset LatexCommand ref
+reference "sec:textclasses"
\end_inset
\begin_layout Standard
Finally, you may want to have sections or subsections that are not numbered.
There are environments for this as well.
- If you change one of your section headings to the
+ If you change one of your section headings to the
\family sans
- Section*
+Section*
\family default
environment (you may have to scroll down in the
\family sans
\end_layout
\begin_layout Itemize
-An outline would use the
+An outline would use the
\family sans
- Enumerate
+Enumerate
\family default
environment's numbered lists (and lettered sublists).
\begin_layout Itemize
A document describing several software packages could use the
\family sans
-Description
+Description
\family default
-environment, where each item in the list begins with a bold-faced word.
+ environment, where each item in the list begins with a bold-faced word.
\end_layout
LyX won't let you select the first bullet unless you also select the paragraph
\emph on
-before
+before
\emph default
-the list, which you probably don't want to do.
+ the list, which you probably don't want to do.
Similarly, you can't select the actual number in a numbered section title.
Don't worry about it.
\end_layout
\begin_layout Standard
+
\backslash
linebreak
\end_layout
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:textclasses}
+\begin_inset LatexCommand label
+name "sec:textclasses"
\end_inset
\end_inset
-
+
\emph default
-takes care of these large scale differences between different sorts of documents.
+ takes care of these large scale differences between different sorts of
+ documents.
This
\emph on
Tutorial
American Mathematics Society journals using the
\family sans
Article\InsetSpace ~
-(AMS)
+(AMS)
\family default
-text class.
+ text class.
\end_layout
\begin_layout Standard
Letter
\family default
\SpecialChar \@.
- One way to write a letter would be to open a new
-\family sans
-
-\family default
-file, and choose
+ One way to write a letter would be to open a new file, and choose
\family sans
Letter
\family default
menu, you'll see several environments, like the
\family sans
My\InsetSpace ~
-Address
+Address
\family default
-environment, which don't even exist in most other text classes.
+ environment, which don't even exist in most other text classes.
Others, like
\family sans
-Quote
+Quote
\family default
-and
+ and
\family sans
Description
\family default
\begin_inset Quotes erd
\end_inset
- here; just write a letter to someone
+ here; just write a letter to someone!
\begin_inset Foot
status collapsed
\end_inset
-!
+
\end_layout
\begin_layout Standard
\begin_layout Standard
Go back to your
\family typewriter
-newfile.lyx
+newfile.lyx
\family default
-document and make sure it's using the
+ document and make sure it's using the
\family sans
-Article
+Article
\family default
-text class.
+ text class.
\begin_inset Foot
status collapsed
environment.
On the next line, type your name and change it to the
\family sans
-Author
+Author
\family default
-environment.
+ environment.
On the next line, write the date in the
\family sans
Date
Abstract
\family default
environment.
- Now see how it looks when printed.
+ Notice how the title is presented when it's printed out.
+ If you changed the document format to Book, you'll get a separate title
+ page, like the first page of this tutorial.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:labels}
+\begin_inset LatexCommand label
+name "sec:labels"
\end_inset
\end_inset
.
- Click at the end of the section title line, and select
+ Click at the end of the section title line, and select
\family sans
\bar under
- I
+I
\bar default
nsert\SpecialChar \menuseparator
\begin_inset Quotes erd
\end_inset
-
-\family typewriter
-
-\family default
---- choose
+ --- choose
\family sans
\bar under
I
In the printed document, this reference marker will be replaced with either
the page or section number (depending on what you selected in the
\family sans
-Insert\InsetSpace ~
Reference
\family default
dialog).
\end_layout
\begin_layout Standard
-Conveniently, a cross-reference acts a hyperlink when you're editing a document
- in LyX; clicking on it will pop up the
+Conveniently, a cross-reference acts as a hyperlink when you're editing
+ a document in LyX; clicking on it will pop up the
\family sans
Reference
\family default
\family sans
Go\InsetSpace ~
to\InsetSpace ~
-reference
+Label
\family default
will move the cursor to the referenced label.
\end_layout
test that.
Add a new section before Section\InsetSpace ~
2.
- Now rerun LaTeX, and --- voilà! --- the section cross reference changed
+ Now rerun LaTeX, and --- voilà! --- the section cross reference changed
to
\begin_inset Quotes eld
\end_inset
If you'll be inserting cross-references often (if, for example, you're
writing a journal article), it may be convenient to leave the
\family sans
-Insert\InsetSpace ~
Reference
\family default
- window open.
+ dialog open.
\end_layout
\begin_layout Standard
If this happens, just delete the chapter title.
If you want to know why this happens, see Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:textclasses}
+\begin_inset LatexCommand ref
+reference "sec:textclasses"
\end_inset
Insert\InsetSpace ~
Footnote
\family default
- button; change a footnote to regular text by clicking the
+ button; change a footnote to regular text by hitting the
\family sans
-Insert\InsetSpace ~
-Footnote
+Backspace
\family default
- button when the cursor is in a footnote.
+ key when the cursor is in the first position of a footnote, or by hitting
+ the
+\family sans
+Delete
+\family default
+ key when the cursor is in the very last position of the footnote, respectively.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:bibliographies}
+\begin_inset LatexCommand label
+name "sec:bibliographies"
\end_inset
\family default
environment.
Now, each paragraph you type will be a reference.
- Type
+ Type
\family typewriter
- The Lyx Tutorial, by the LyX Documentation Team
+The Lyx Tutorial, by the LyX Documentation Team
\family default
as your first reference.
Note that LyX automatically puts a number in a box before each reference.
\bar under
C
\bar default
-itation\InsetSpace ~
-Reference\SpecialChar \@.
-
+itation
\family default
+.
A
\family sans
Citation
\begin_layout Standard
How are the other fields used? The
\family sans
-Text\InsetSpace ~
-aft
\bar under
-e
+T
\bar default
-r
+ext\InsetSpace ~
+after
\family default
field in the
\family sans
\bar under
L
\bar default
-abel
+abel
\family default
-field in the
+ field in the
\family sans
Bibliography\InsetSpace ~
-item
+Entry\InsetSpace ~
+Settings
\family default
dialog.
As usual, you can see the
\begin_layout Standard
\series bold
-Exercise:
+Exercise:
\series default
-Fix the bibliography and citation in
+ Fix the bibliography and citation in
\family typewriter
example_raw.lyx
\end_layout
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:matrices}
+\begin_inset LatexCommand label
+name "sec:matrices"
\end_inset
\emph default
), and multi-line equations (see Sec.
-\begin_inset LatexCommand \ref{sec:multiline}
+\begin_inset LatexCommand ref
+reference "sec:multiline"
\end_inset
\begin_layout Itemize
LyX also supports including pictures in a number of formats (including JPEG
- and other bitmap formats, PostScript® and raw LaTeX) within documents.
+ and other bitmap formats, PostScript® and raw LaTeX) within documents.
(You guessed it:
\family sans
\bar under
\bar default
raphics
\family default
-\SpecialChar \@.
+.
Then click on the figure to choose the file to include, rotate or scale
it, etc.) Tables and figures can have captions, and LyX will automatically
generate lists of figures and/or tables.
LyX can read in LaTeX documents.
See Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:relyx}
+\begin_inset LatexCommand ref
+reference "sec:tex2lyx"
\end_inset
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:latexusers}
+\begin_inset LatexCommand label
+name "sec:latexusers"
\end_inset
The short answer is that LyX can do pretty much everything LaTeX can do
in one form or another, and it definitely simplifies most parts of writing
a LaTeX document.
- Currently, there may be some annoyance in converting old LaTeX documents
- and in a couple other areas, but later releases of LyX will get rid of
- these problems.
+ The tool that is used to convert a LaTeX document to LyX was rewritten
+ completely for LyX\InsetSpace ~
+1.4.
+ It should now be able to handle most LaTeX gracefully.
\end_layout
\begin_layout Standard
Te
\bar under
X
-\family default
\bar default
+\InsetSpace ~
+Code
+\family default
.
This creates a text box, and everything within it is passed straight to
LaTeX.
\family default
in the preamble (see Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:preamble}
+\begin_inset LatexCommand ref
+reference "sec:preamble"
\end_inset
\end_layout
\begin_layout Subsection
-Importing LaTeX Documents---
+Importing LaTeX Documents ---
\family typewriter
-reLyX
+tex2lyx
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:relyx}
+\begin_inset LatexCommand label
+name "sec:tex2lyx"
\end_inset
aTeX
\family default
command in LyX.
- This will call a Perl script called
+ This will call
\family typewriter
-reLyX
+tex2lyx
\family default
----which will create a file
+ which will create a file
\family typewriter
foo.lyx
\family default
\family typewriter
foo.tex
\family default
----and then open that file.
+ --- and then open that file.
If the translation doesn't work, you can try calling
\family typewriter
-reLyX
+tex2lyx
\family default
- from the command line
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-When LyX is installed, a separate executable called
-\family typewriter
-reLyX
-\family default
- will be placed in the same folder as the
-\family typewriter
-lyx
-\family default
- executable (e.g.,
-\family typewriter
-/usr/local/bin/reLyX
-\family default
-).
-
-\family typewriter
- reLyX
-\family default
- requires Perl (version 5.002 as of this writing).
-\end_layout
-
-\end_inset
-
-, possibly using fancier options.
+ from the command line, possibly using fancier options.
\end_layout
\begin_layout Standard
\family typewriter
-reLyX
+tex2lyx
\family default
will translate most legal LaTeX, but not everything.
It will leave things it doesn't understand in TeX mode, so after translating
a file with
\family typewriter
-reLyX
+tex2lyx
\family default
, you can look for red text and hand-edit it to look right.
\end_layout
\begin_layout Standard
\family typewriter
-reLyX
+tex2lyx
\family default
has its own manpage.
Read it to find out about which LaTeX commands and environments aren't
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand \label{sec:preamble}
+\begin_inset LatexCommand label
+name "sec:preamble"
\end_inset
B
\bar default
ibTeX\InsetSpace ~
-Reference
+Reference
\family default
-to include a
+ to include a
\family typewriter
bib
\family default
button, and you will get a
\family sans
-BibTeX
+BibTeX
\family default
-dialog.
+ dialog.
In the
\family sans
Database
.
Similarly, in the
\family sans
-Style
+Style
\family default
-field, type what you would type inside the braces of a
+ field, type what you would type inside the braces of a
\family typewriter
\backslash
\bar under
C
\bar default
-itation\InsetSpace ~
-Reference
+itation
\family default
(see Section\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:bibliographies}
+\begin_inset LatexCommand ref
+reference "sec:bibliographies"
\end_inset
\begin_layout Standard
Sometimes when you LaTeX a document, there will be errors, things that LyX
or LaTeX can't understand.
- When this happens, LyX will create an error box (a box with the word
-\begin_inset Quotes eld
-\end_inset
-
-error
-\begin_inset Quotes erd
-\end_inset
-
- in it).
- Clicking on this box will pop up a window showing what the error was.
- LyX will just include the error message that LaTeX gave.
- Note that the placement of these errors in often not accurate.
+ When this happens, LyX will open a
+\family sans
+LaTeX\InsetSpace ~
+Errors
+\family default
+ dialog.
+ Clicking on individual errors in this dialog will take you to the place
+ in the LyX document where the error occurs and also display the detailed
+ LaTeX error message.
\end_layout
\end_body
projects / lyx.git / blobdiff