-#LyX 1.6.2svn created this file. For more info see http://www.lyx.org/
-\lyxformat 345
+#LyX 2.1 created this file. For more info see http://www.lyx.org/
+\lyxformat 474
\begin_document
\begin_header
\textclass article
\myTOC
\cleardoublepage
\pagenumbering{arabic} }
-
-% 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
+\maintain_unincluded_children false
\language english
+\language_package default
\inputencoding auto
+\fontencoding global
\font_roman default
\font_sans default
\font_typewriter default
+\font_math auto
\font_default_family default
+\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100
\font_tt_scale 100
-
\graphics default
+\default_output_format default
+\output_sync 0
+\bibtex_command default
+\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\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 a4paper
\use_geometry false
-\use_amsmath 1
-\use_esint 0
+\use_package amsmath 1
+\use_package amssymb 1
+\use_package cancel 0
+\use_package esint 0
+\use_package mathdots 1
+\use_package mathtools 0
+\use_package mhchem 1
+\use_package stackrel 0
+\use_package stmaryrd 0
+\use_package undertilde 0
\cite_engine basic
+\cite_engine_type default
+\biblio_style plain
\use_bibtopic false
+\use_indices false
\paperorientation portrait
+\suppress_date false
+\justification true
+\use_refstyle 0
+\index Index
+\shortcut idx
+\color #008000
+\end_index
\secnumdepth 3
\tocdepth 2
\paragraph_separation indent
-\defskip medskip
+\paragraph_indentation default
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes false
-\author ""
-\author ""
+\html_math_output 0
+\html_css_as_file 0
+\html_be_strict false
\end_header
\begin_body
\begin_layout Plain Layout
\noindent
-If you have comments or error corrections, please send them to the LyX Documenta
-tion mailing list:
+If you have comments on or corrections to this documentation, please send
+ them to the LyX Documentation mailing list:
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs@lists.lyx.org"
\begin_layout Standard
LyX is a document preparation system.
It excels at letting you create complex technical and scientific articles
- with mathematics, cross-references, bibliographies, indices, etc.
- It is very good at documents of any length in which the usual processing
- abilities are required: automatic sectioning and pagination, spellchecking,
- and so forth.
+ with mathematics, cross-references, bibliographies, indexes, etc.
+ It is very good for working with documents of any length in which the usual
+ processing abilities are required: automatic sectioning and pagination,
+ spell checking and so forth.
It can also be used to write a letter to your mom, though granted, there
are probably simpler programs available for that.
It is definitely not the best tool for creating banners, flyers, or advertiseme
nts (we'll explain why later), though with some effort all these can be
done, too.
- Some examples of what it is used for: memos, letters, dissertations and
- theses, lecture notes, seminar notebooks, conference proceedings, software
+ Here are some examples of what it is used for: memos, letters, dissertations
+ and theses, lecture notes, seminar notebooks, conference proceedings, software
documentation, books, articles in refereed scientific journals, scripts
for plays and movies, business proposals, presentations \SpecialChar \ldots{}
.
It is designed for authors who want professional output quickly with a
- minimum of effort without becoming specialists in typesetting.
+ minimum of effort and without becoming specialists in typesetting.
The job of typesetting is done mostly by the computer, not the author;
- with LyX, the author can concentrate on the contents of her writing.
+ with LyX, the author can concentrate on the contents of his writing.
\end_layout
\begin_layout Standard
\emph default
and LyX takes care of the rest, following a set of rules called a
\emph on
-style.
+style
\emph default
-
+.
\begin_inset Foot
status collapsed
.
Of course, if you later decide that this section belongs someplace else
- in the document, or if you insert a new section before it, you need to
- change the numbering for this and all following sections, as well as any
- entry in the table of contents.
-
+ in the document or if you insert a new section before it, you need to change
+ the numbering for this and all following sections, as well as any entry
+ in the table of contents.
\end_layout
\begin_layout Standard
\begin_inset Quotes eld
\end_inset
-Introduction\SpecialChar \@.
-
+Introduction
\begin_inset Quotes erd
\end_inset
-
+.
\end_layout
\begin_layout Standard
\end_inset
4.
- However, you forget that you were using 18pt bold instead of 16pt, so you
- type in the heading for Section
+ However, you forget that you were using 18
+\begin_inset space \thinspace{}
+\end_inset
+
+pt bold instead of 16
+\begin_inset space \thinspace{}
+\end_inset
+
+pt, so you type in the heading for Section
\begin_inset space ~
\end_inset
-4 in a different font that what you used for Section
+4 in a different font from the one you used for Section
\begin_inset space ~
\end_inset
that label should be, how many blank lines to put between each item, and
so on.
Under LyX, you have only two concerns: what kind of list is this, and what
- do I want to put in it.
- That's it.
+ do I want to put in it? That is it.
\end_layout
\begin_layout Standard
\begin_layout Subsection
Differences between LyX and Other Word Processors
-\begin_inset OptArg
+\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
\end_layout
\begin_layout Itemize
-Extra whitespace (i.
+Extra whitespace (e.
\begin_inset space \thinspace{}
\end_inset
Tab stops, along with a ruler showing you the position of things on the
page, are useless in LyX.
The program worries about where things go on the page, not you.
- Extra whitespace is similar; LyX adds them where necessary, depending on
+ Extra whitespace is similar; LyX adds it where necessary, depending on
context.
Not being able to type two blank lines in a row will be annoying at first,
but it makes more sense once you're thinking in WYSIWYM terms.
\end_layout
\begin_layout Itemize
-Line spacing (i.
+Line spacing (e.
\begin_inset space \thinspace{}
\end_inset
\end_inset
-
+
\end_layout
\begin_layout Standard
WYSIWYM concept.
However, they've only recently been able to do so, whereas LyX is built
upon the LaTeX document preparation system.
- LaTeX has been around for over 20 years, and
+ LaTeX has been around since 1985, and
\emph on
works
\emph default
\begin_layout Plain Layout
The source for the info in this section is
-\begin_inset Quotes eld
-\end_inset
-
-
\emph on
A Guide to LaTeX2e
\emph default
-,
-\begin_inset Quotes erd
-\end_inset
-
- by Helmut Kopka and Patrick Daly, which has an entry in the bibliography
+, by Helmut Kopka and Patrick Daly, which has an entry in the bibliography
of the
\emph on
User's Guide
\end_inset
of the printing trade were modeled by Knuth as computer algorithms and
- incorporated into TeX, thus its excellent printed appearance.
+ incorporated into TeX, hence its excellent printed appearance.
What comes directly out of TeX is the portable document format
\emph on
pdf
\end_layout
\begin_layout Standard
-TeX isn't only a typesetting engine, it also allows you to define macros.
+TeX isn't only a typesetting engine; it also allows you to define macros.
Most people who use TeX are actually using a macro package which Knuth
created to hide a lot of the typesetting details.
This is where Leslie Lamport enters our story.
He wanted a macro package that was more user- and less typesetter-oriented,
with a set of commands that consistently typeset things like sections,
- tables or math formulas in an uniform, consistent fashion.
+ tables or math formulas in a uniform, consistent fashion.
This is how LaTeX was born.
\end_layout
or an article.
There are classes for slides, for physics and math journals\SpecialChar \ldots{}
many universities
- even have a class for their thesis format! A
+ even have a class for their thesis format.
+ A
\emph on
style
\emph default
\end_layout
\begin_layout Description
-classes: Descriptions of a type of document, using LaTeX\SpecialChar \@.
+classes: Descriptions of types of document used with LaTeX\SpecialChar \@.
\end_layout
\begin_layout Description
-styles: Alters the default behavior of LaTeX in some way.
+styles: Descriptions of the default behavior of particular elements of LaTeX.
\end_layout
\begin_layout Description
-LyX: Visual, WYSIWYM word-processor that uses LaTeX to do its typesetting.
+LyX: Visual, WYSIWYM document processor that uses LaTeX to do its typesetting.
\end_layout
\begin_layout Standard
-This section attempts to account for the difference between LyX and other
- word processors.
+This section attempts to explain the difference between LyX and a word processor.
Simply put, LaTeX is the difference.
- By using LaTeX as its backend, LyX helps you think more about
+ By using LaTeX as its backend, LyX helps you to think more about
\emph on
- what
+ what
\emph default
(as in the
\emph on
To make it easier to answer your questions and describe all of the features
of LyX, the documentation has been split up into several different files.
Each one has its own purpose, as described below.
- Before you go plowing into any of those files, however, you should read
- this chapter thoroughly first, since it contains a lot of useful information
+ Before you go ploughing into any of those files, however, you should read
+ this chapter thoroughly, since it contains a lot of useful information
and commentary that can save you some time.
\end_layout
\begin_layout Standard
-The developing of LyX will hopefully never stop, so that some of the documentati
-on may be incomplete or a bit out of date, though we try to keep up.
+Hopefully, the development of LyX will never stop; so some of the documentation
+ may be incomplete or a bit out of date, though we try to keep up-to-date.
Like the rest of LyX, the manuals are the work of a group of volunteers
who have
\begin_inset Quotes eld
\begin_inset Quotes erd
\end_inset
-, families, dishes to clean, kitty litter to dispose of, et cetera.
+, families, dishes to clean,
+\emph on
+et cetera
+\emph default
+.
If you want to help out, be sure to read Section
\begin_inset space ~
\end_inset
\begin_layout Standard
Also, please do us a favor – if anything in these manuals confuses you,
is unclear, or wrong, don't hesitate to let us know! You can reach the
- current document maintainers by mailing to
+ current document maintainers by emailing
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs@lists.lyx.org"
\end_inset
.
- If you have questions which are not obviously answered in the documentation,
+ If you have questions that are not obviously answered in the documentation,
and need help fast, there is an active users' mailing list which you can
reach at
\begin_inset CommandInset href
\end_layout
\begin_layout Standard
-Some may have printed out the manuals.
- Others may be reading it within LyX.
+Some of you may have printed out the manuals.
+ Others may be reading them within LyX.
There are some differences between the LyX-file and the printed version.
- First, the title is simply at the top of the document, not formatted on
+ In LyX, the title is simply at the top of the document, not formatted on
a separate page as in some of the printed versions.
Nor are any of the footnotes or the Table of Contents fully visible.
To open a footnote, which looks like this:
\begin_layout Standard
In the printed manuals, all cross-references appear as the actual numbers
for a chapter, section, subsection, and so on.
- Online, however, all cross-references appear as a light-grey box like the
- following:
+ In the LyX-file, however, all cross-references appear as light-grey boxes
+ like the following:
\begin_inset Graphics
filename clipart/referenceQt4.png
scale 75
\end_inset
.
- If you click on that box with the left mouse button, a dialog box will
+ If you click on such a box with the left mouse button, a dialog box will
appear containing a list of all the cross-references in the document.
- You can go to the referred section by right-clicking on the box or by clicking
- the button
+ You can go to the referenced section by right-clicking on the box or by
+ clicking the button
\family sans
Go
\begin_inset space ~
\family default
in the opened dialog.
Going back to where you came from is just as easy.
- Clicking on
+ Click on
\family sans
Go
\begin_inset space ~
\begin_layout Standard
Now that we've cleared up some of the differences between the printed and
- online versions of this file, we can start looking at the format of this
+ LyX-file versions of this file, we can start looking at the format of this
document.
You'll occasionally notice things in different fonts:
\end_layout
\end_layout
\begin_layout Standard
-For menu accelerator keys and keybindings, you'll probably get referred
- to the
-\emph on
-Key Bindings
-\emph default
- section of the
-\begin_inset Quotes eld
-\end_inset
-
-
-\emph on
-Addtional Features Manual
-\emph default
-
-\begin_inset Quotes erd
-\end_inset
-
- (the file
-\family typewriter
-Extended.lyx
-\family default
-).
- When we do need to reference keys, we'll use the following prefixing convention
-:
+When we do need to reference keys, we'll use the following prefixing convention:
\end_layout
\begin_layout Itemize
\family sans
-C-
+Ctrl+
\family default
\begin_inset Quotes erd
indicates the
\family sans
-Control-
+Control
\family default
key.
\end_layout
\family sans
-S-
+Shift+
\family default
\begin_inset Quotes erd
indicates the
\family sans
-Shift-
+Shift
\family default
key.
\end_layout
\family sans
-M-
+Alt+
\family default
\begin_inset Quotes erd
indicates the
\family sans
-Meta-
+Alt
\family default
- key, which on some keyboards will be the
+ (
\family sans
-Alt-
+Meta
\family default
- key.
+) key.
\end_layout
\begin_layout Itemize
\end_layout
\begin_layout Standard
-You'll also see something like
-\begin_inset Quotes eld
-\end_inset
-
-(See
-\emph on
-
-\begin_inset Quotes els
-\end_inset
-
-Extended
-\emph default
-
-\begin_inset Quotes ers
-\end_inset
-
-)
-\begin_inset Quotes erd
-\end_inset
-
- from time to time.
- We've listed the possible default keybindings for a function in its entry
- in the
-\begin_inset Quotes eld
-\end_inset
-
-
-\emph on
-Additional Features Manual
-\emph default
-,
-\begin_inset Quotes erd
-\end_inset
-
- so check there, too.
- Note that there are two different keybinding maps in common use in the
- LyX community: the
-\begin_inset Quotes eld
-\end_inset
-
-CUA
-\begin_inset Quotes erd
-\end_inset
-
- style which is the default and familiar to those coming from the PC world,
- and the
-\begin_inset Quotes eld
-\end_inset
-
-emacs
-\begin_inset Quotes erd
-\end_inset
-
- style, which is common with those who
-\begin_inset Quotes eld
-\end_inset
-
-grew up
-\begin_inset Quotes erd
-\end_inset
-
- on Unix systems and use the Emacs editor.
- Unless specifically noted, the keybindings in the documentation are from
- the default CUA map.
- If you like Emacs, you should be smart enough to read the documentation
- and figure out the bindings on your own.
+The list with the currently set shortcuts can be found in the
+\family sans
+Help
+\family default
+ menu under
+\family sans
+Shortcuts
+\family default
+.
\end_layout
\begin_layout Subsection
\begin_inset CommandInset ref
LatexCommand ref
-reference "cap:Units-for-image"
+reference "tab:Units"
\end_inset
\begin_layout Standard
\begin_inset Float table
-placement t
wide false
sideways false
status open
\begin_layout Plain Layout
-\begin_inset Caption
+\begin_inset Caption Standard
\begin_layout Plain Layout
\begin_inset CommandInset label
LatexCommand label
-name "cap:Units-for-image"
+name "tab:Units"
\end_inset
\align center
\begin_inset Tabular
<lyxtabular version="3" rows="20" columns="2">
-<features>
-<column alignment="center" valignment="top" width="0">
-<column alignment="center" valignment="top" width="0">
+<features rotate="0" booktabs="true" tabularvalignment="middle">
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top">
<row>
-<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\begin_inset Text
\begin_layout Plain Layout
-inch
+inch (1
+\begin_inset space \thinspace{}
+\end_inset
+
+in = 2.54
+\begin_inset space \thinspace{}
+\end_inset
+
+cm)
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-The following list describes the contents of each of the files in the documentat
-ion:
+The following list describes the contents of the basic documentation files
+ that you find in the
+\family sans
+Help
+\family default
+ menu:
\end_layout
\begin_layout Description
\begin_inset Quotes erd
\end_inset
- (Skimming the rest of the document wouldn't hurt, either.)
+ (Skimming through the rest of the document wouldn't hurt, either.)
\end_layout
\begin_layout Description
most
\emph default
of the basic operation and available features of LyX here.
- The main manual assumes that you've read the
+ The main manual assumes that you have read the
\emph on
Tutorial
\emph default
User's Guide
\emph default
.
- Documents in detail how to use tables, graphics, floats, notes, and boxes.
+ Documents in detail how to use tables, graphics, floats, notes, program
+ listings and boxes.
It also includes many tricks of the LaTeX masters.
\end_layout
\begin_layout Description
-Extended
+Math Extension of the
+\emph on
+User's Guide
+\emph default
+.
+ Documents in detail how to typeset any kind of formula.
+\end_layout
+
+\begin_layout Description
+Additional
\begin_inset space ~
\end_inset
User's Guide
\emph default
.
- Documents how to use raw LaTeX commands, additional layouts, and special-purpos
-e editing features.
+ Documents how to use raw LaTeX commands, additional layouts and special-purpose
+ editing features.
\end_layout
\begin_layout Description
Customization A description of advanced LyX features, including how to customize
the overall behavior of LyX\SpecialChar \@.
This includes such things as keybindings, internati
-onalization, and configuration files.
+onalization and configuration files.
+ It also includes information about layout files, which are needed to get
+ LyX to support LaTeX classes or packages.
+\end_layout
+
+\begin_layout Description
+Shortcuts Tables of the currently defined LyX shortcuts.
\end_layout
\begin_layout Description
\begin_inset space ~
\end_inset
-configuration LyX investigates your system upon installation.
- This file contains info on what LyX learned about your installation.
+Configuration A report produced by LyX about your system.
+ This file contains information on what LyX learned about your installation.
Check it to see if you're missing something you might like to have.
\end_layout
\begin_layout Standard
Otherwise, you could needlessly frustrate yourself.
- LyX does all that you need a word processor to do, but using a different
- approach.
\end_layout
\begin_layout Section
\begin_layout Plain Layout
-http://bugzilla.lyx.org/
+http://www.lyx.org/trac/wiki/BugTrackerHome
\end_layout
\end_inset
Accurate, detailed descriptions are preferred - the more time developers
have to spend to pinpoint the source of a bug, the less time they have
for other improvements.
- Mention the system and system version you are running LyX with.
+ Mention the system and system version on which you are running LyX.
Give the versions of the libraries you have installed on your system, and,
if relevant, the versions of external programs that LyX uses.
If it's a compilation or configuration problem, include the file
config.log
\family default
, and mention which compiler you are using.
-
\end_layout
\begin_layout Subsubsection
\begin_layout Plain Layout
-http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc
+http://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master
\end_layout
\end_inset
-\begin_inset Newline newline
-\end_inset
-
-Inside that directory is a file called
-\family typewriter
-DocStyle.lyx
-\family default
-.
- Read it; it's the style sheet for the documentation.
\end_layout
\begin_layout Enumerate
\emph on
User's Guide
\emph default
- is likely to be the most up-to-date of all of the documentation.
+ are likely to be the most up-to-date of all of the documentation.
You should be able to glean some insights into how we want the manuals
to read and to look.
\end_layout
\begin_inset Newline newline
\end_inset
-to discuss your intended changes, and get some feedback on them.
+to discuss your intended changes and to get some feedback on them.
\end_layout
\begin_layout Standard
projects / lyx.git / blobdiff