-#LyX 1.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 221
+#LyX 1.4.0cvs created this file. For more info see http://www.lyx.org/
+\lyxformat 245
+\begin_document
+\begin_header
\textclass book
\language english
\inputencoding default
\fontscheme default
\graphics default
\paperfontsize default
-\spacing single
-\papersize Default
-\paperpackage a4
-\use_geometry 0
+\spacing single
+\papersize default
+\use_geometry false
\use_amsmath 0
-\use_natbib 0
-\use_numerical_citations 0
+\cite_engine basic
+\use_bibtopic false
\paperorientation portrait
\secnumdepth 2
\tocdepth 2
\paragraph_separation indent
\defskip medskip
\quotes_language english
-\quotes_times 2
\papercolumns 1
\papersides 2
\paperpagestyle default
+\tracking_changes false
+\output_changes true
+\end_header
-\layout Title
+\begin_body
+\begin_layout Title
Introduction to LyX
-\layout Author
+\end_layout
+\begin_layout Author
by the LyX Team
\begin_inset Foot
-collapsed true
+status collapsed
-\layout Standard
-
-Principal maintainer of this file is
-\noun on
-John Weiss
-\noun default
-.
- If you have comments or error corrections, please send them to the LyX
- Documentation mailing list, <lyx-docs@lists.lyx.org>.
-\end_inset
+\begin_layout Standard
+If you have comments or error corrections, please send them to the LyX Documenta
+tion mailing list, <lyx-docs@lists.lyx.org>.
+\end_layout
+\end_inset
-\layout Standard
+\end_layout
+\begin_layout Standard
\begin_inset LatexCommand \tableofcontents{}
-\end_inset
+\end_inset
-\layout Chapter
+\end_layout
+\begin_layout Chapter
The Philosophy of LyX
-\layout Quote
-
+\end_layout
+\begin_layout Quote
\begin_inset Quotes eld
-\end_inset
+\end_inset
Uncle Cosmo, why do they call this a word processor?
\begin_inset Quotes erd
-\end_inset
+\end_inset
-\layout Quote
-
+\end_layout
+\begin_layout Quote
\begin_inset Quotes eld
-\end_inset
+\end_inset
It's simple, Skyler.
You've seen what food processors do to food, right?
\begin_inset Quotes erd
-\end_inset
+\end_inset
-\layout Quote
+\end_layout
+\begin_layout Quote
-\hfill
+\hfill
--- Jeff MacNelly in
\begin_inset Quotes eld
-\end_inset
+\end_inset
Shoe
\begin_inset Quotes erd
-\end_inset
+\end_inset
-\layout Section
+\end_layout
+\begin_layout Section
What is LyX?
-\layout Standard
+\end_layout
+\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.
scientific journals, scripts for plays and movies, business proposals \SpecialChar \ldots{}
you get the idea.
-\layout Standard
+\end_layout
+\begin_layout Standard
LyX is a program that provides a modern approach to writing documents with
a computer by using a markup language paradigm, an approach that breaks
with the obsolete tradition of the
\begin_inset Quotes eld
-\end_inset
+\end_inset
typewriter concept.
\begin_inset Quotes erd
-\end_inset
+\end_inset
It is designed for authors who want professional output quickly with a
minimum of effort 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.
-\layout Standard
+\end_layout
+\begin_layout Standard
Part of the initial challenge of using LyX comes from the change in thinking
that you, the user, must make.
At one time, all we had for creating documents were typewriters, so we
all learned certain tricks to get around their limitations.
Underlining, which is little more than overstriking with the
\begin_inset Quotes eld
-\end_inset
+\end_inset
_
\begin_inset Quotes erd
-\end_inset
+\end_inset
character, became a way to emphasize text.
You were forced to figure out column sizes and tab stops, and set them,
before creating a table.
The same applied for letters and other right justified text.
Hyphenation at the end of a line required a careful eye and a lot of foresight.
-\layout Standard
+\end_layout
+\begin_layout Standard
In other words, we've all been trained to worry about the little details
of which character goes where.
Consequently, almost all word processors have this mentality.
wheel.
This is the underlying philosophy of a WYSIWYG word processor:
\begin_inset Quotes eld
-\end_inset
+\end_inset
What You See Is What You Get
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
Unfortunately, that paradigm often results in
\begin_inset Quotes eld
-\end_inset
+\end_inset
What You See Is All You Get
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
-\layout Standard
+\end_layout
+\begin_layout Standard
This is where LyX differs from an ordinary word processor.
You don't concern yourself with what character goes where.
You tell LyX
-\emph on
+\emph on
what you're doing
-\emph default
+\emph default
and LyX takes care of the rest, following a set of rules called a
-\emph on
+\emph on
style.
-\emph default
+\emph default
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
To be fair, most recent versions of the most popular office suites now have
some sort of style sheets which follow a similar markup method.
However, our experience is that they are still rarely used in practice.
-\end_inset
+\end_layout
+
+\end_inset
Let's look at a little example:
-\layout Standard
+\end_layout
+\begin_layout Standard
Suppose you are writing a report.
To begin your report, you want a section called
\begin_inset Quotes eld
-\end_inset
+\end_inset
Introduction\SpecialChar \@.
\begin_inset Quotes erd
-\end_inset
+\end_inset
So, you go into whatever menu it is in your word processor that changes
font sizes and decide on a new font size.
Then you turn on bold face.
Then you type,
\begin_inset Quotes eld
-\end_inset
+\end_inset
-1.\SpecialChar ~
-\SpecialChar ~
+1.\InsetSpace ~
+\InsetSpace ~
Introduction
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
Of course, if you later decide that this section belongs someplace else
change the numbering for this and all following sections, as well as any
entry in the table of contents.
-\layout Standard
+\end_layout
+\begin_layout Standard
In LyX, you go to the pull-down on the far left of the button bar and select
-\family sans
+\family sans
Section
-\family default
+\family default
, and type
\begin_inset Quotes eld
-\end_inset
+\end_inset
Introduction\SpecialChar \@.
\begin_inset Quotes erd
-\end_inset
+\end_inset
-\layout Standard
+\end_layout
+\begin_layout Standard
Yes, that's all.
If you cut and paste the section, it will automatically be renumbered ---
everywhere.
And if you enter references to that section correctly (by inserting cross-refer
ence tags), LyX will automatically update them all throughout the file so
that you never, ever type a section number.
-\layout Standard
+\end_layout
+\begin_layout Standard
Now let's look at the problem of consistency.
- Five days later, you reopen your report and start Section\SpecialChar ~
+ Five days later, you reopen your report and start Section\InsetSpace ~
4.
However, you forget that you were using 18pt bold instead of 16pt, so you
- type in the heading for Section\SpecialChar ~
+ type in the heading for Section\InsetSpace ~
4 in a different font that what you used
- for Section\SpecialChar ~
+ for Section\InsetSpace ~
1.
That problem doesn't even exist in LyX.
The computer takes care of all that silly bookkeeping about which thing
has what size font, not you.
After all, that's what a computer is good at.
-\layout Standard
+\end_layout
+\begin_layout Standard
Here's another example.
Suppose you're making a list.
In other word processors, a list is just a bunch of tab stops and newlines.
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.
-\layout Standard
+\end_layout
+\begin_layout Standard
So, the basic idea behind LyX is: specify
-\emph on
+\emph on
what
-\emph default
+\emph default
you're doing, not
-\emph on
+\emph on
how
-\emph default
+\emph default
to do it.
Instead of
\begin_inset Quotes eld
-\end_inset
+\end_inset
What You See Is What You Get,
\begin_inset Quotes erd
-\end_inset
+\end_inset
the LyX model is
\begin_inset Quotes eld
-\end_inset
+\end_inset
What You See Is What You
-\emph on
+\emph on
Mean
-\emph default
+\emph default
\begin_inset Quotes erd
-\end_inset
+\end_inset
or
\begin_inset Quotes eld
-\end_inset
+\end_inset
WYSIWYM.
\begin_inset Quotes erd
-\end_inset
+\end_inset
It's a powerful idea that greatly simplifies the mechanics of writing documents.
This is also why LyX isn't so good for creating posters and flyers---in
this case, you
-\emph on
+\emph on
do
-\emph default
+\emph default
want to specify exactly where everything goes, because there are no functional
units like paragraphs, sections, etc.
This doesn't mean LyX is missing some cool function.
It simply means that it isn't the right tool for the job --- you don't
use a screwdriver to drive in nails (unless your screwdriver comes with
a lifetime warranty).
-\layout Section
+\end_layout
+\begin_layout Section
Differences between LyX and Other Word
-\newline
+\newline
Processors
\begin_inset OptArg
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
LyX and Other Word Processors
-\end_inset
+\end_layout
+\end_inset
-\begin_inset Foot
-collapsed true
-\layout Standard
+\begin_inset Foot
+status collapsed
+\begin_layout Standard
No, we're not trying to start (or win) a word processor holy war here.
But we do think it's important to describe LyX's features.
And one of LyX's main features, WYSIWYM, is a fundamentally different concept
than the one that most of people have about word processing.
-\end_inset
+\end_layout
+\end_inset
-\layout Standard
+\end_layout
+
+\begin_layout Standard
Here's a list of things you won't find in LyX:
-\layout Itemize
+\end_layout
+\begin_layout Itemize
The document ruler
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Tab stops
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Extra whitespace (i.e.
hitting
-\family sans
+\family sans
Enter
-\family default
+\family default
or
-\family sans
+\family sans
Space
-\family default
+\family default
two or more times)
-\layout Standard
+\end_layout
+\begin_layout Standard
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.
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.
-\layout Standard
+\end_layout
+\begin_layout Standard
Here are some things that exist in LyX, but aren't used as you might think:
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Indenting controls
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Page breaks
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Line spacing (i.e.
single spaced, double spaced, etc.)
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Whitespace, horizontal and vertical
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Fonts and font sizes
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Typefaces (bold, italic, underline, etc.)
-\layout Standard
+\end_layout
+\begin_layout Standard
Although they exist in LyX, you generally don't need them.
LyX will take care of these things for you, depending on what you're doing.
Different parts of the document are automatically set in a different typeface
In general, the space between lines, between words, and between paragraphs
is variable, set by LyX.
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
There are ways to adjust all of these (only some of which require knowledge
of LaTeX), either for a whole document or for a specific location in a
document.
See the
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
and/or the
-\emph on
+\emph on
Extended Features
-\emph default
+\emph default
manual for details.
-\end_inset
+\end_layout
+
+\end_inset
-\layout Standard
+\end_layout
+\begin_layout Standard
Lastly, there are a few areas where we believe LyX (and LaTeX) surpasses
many word processors:
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Hyphenation
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Lists of any type
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Mathematics
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Tables
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Cross-referencing
-\layout Standard
+\end_layout
+\begin_layout Standard
Granted, many modern word processors can handle mathematical symbols, tables,
and hyphenation, and many have moved towards style definitions and the
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 15 years, and
-\emph on
+ LaTeX has been around for decades, and
+\emph on
works
-\emph default
+\emph default
.
-\layout Section
+\end_layout
+\begin_layout Section
What the heck
-\emph on
+\emph on
is
-\emph default
+\emph default
LaTeX (and why do I care)?
-\layout Standard
+\end_layout
+\begin_layout Standard
LaTeX is a document preparation system designed by Leslie Lamport in 1985.
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
The source for the info in this section is
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\emph on
+\emph on
A Guide to LaTeX2e
-\emph default
+\emph default
,
\begin_inset Quotes erd
-\end_inset
+\end_inset
by Helmut Kopka and Patrick Daly, which has an entry in the bibliography
of the
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
\SpecialChar \@.
-\end_inset
+\end_layout
+
+\end_inset
It, in turn, was built up from a typesetting language called TeX, created
by Donald Knuth in 1984.
\begin_inset Quotes eld
-\end_inset
+\end_inset
TeX
\begin_inset Quotes erd
-\end_inset
+\end_inset
is pronounced like
\begin_inset Quotes eld
-\end_inset
+\end_inset
blech!
\begin_inset Quotes erd
-\end_inset
+\end_inset
which is how many people feel about it.
However, most folks don't understand just what TeX is.
It's a bit more complicated than a typewriter, but not nearly as involved
as an actual printing press; however, many of the
\begin_inset Quotes eld
-\end_inset
+\end_inset
tricks
\begin_inset Quotes erd
-\end_inset
+\end_inset
of the printing trade were modeled by Knuth as computer algorithms and
incorporated into TeX, thus its excellent printed appearance.
In any case, what comes directly out of TeX is the so-called
\begin_inset Quotes eld
-\end_inset
+\end_inset
device independent
\begin_inset Quotes erd
-\end_inset
+\end_inset
format file, or
-\family typewriter
+\family typewriter
dvi
-\family default
+\family default
for short.
You can then feed the
-\family typewriter
+\family typewriter
dvi
-\family default
+\family default
file to anything that understands
-\family typewriter
+\family typewriter
dvi
-\family default
+\family default
, or converts
-\family typewriter
+\family typewriter
dvi
-\family default
+\family default
to other formats like PostScript®, PDF, etc.
-\layout Standard
+\end_layout
+\begin_layout Standard
If it weren't for one other feature, all TeX would be is a typesetting engine.
However, TeX also allows you to define macros.
This is where the action begins.
-\layout Standard
+\end_layout
+\begin_layout Standard
Most people who use TeX are actually using a macro package which Knuth created
to hide a lot of the typesetting details.
This is what most people think of when they think of TeX\SpecialChar \@.
tables or math formulae in a uniform, consistent fashion with as little
fuss as possible.
This is how LaTeX was born.
-\layout Standard
+\end_layout
+\begin_layout Standard
Now, in parallel with the development and growth of LaTeX, other folks were
creating their own custom macro packages for TeX, ones to make slides or
articles for math journals and so on.
In fact, LaTeX is quite an extensive language in its own right! Users around
the world have been creating their own add-ons for LaTeX beyond the standard
ones.
-\layout Standard
+\end_layout
+\begin_layout Standard
There are two ways to extend LaTeX: classes and styles.
A
-\emph on
+\emph on
class
-\emph default
+\emph default
is a set of LaTeX (and TeX) macros describing a new type of document, like
a book, 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
-\emph on
+\emph on
style
-\emph default
+\emph default
differs from a class in that it doesn't define a new type of document,
but a different type of
-\emph on
+\emph on
behavior
-\emph default
+\emph default
that any document can use.
For example, LyX controls page margins and line spacing using two different
LaTeX style-files designed for these purposes.
designing fancy page headings, customizing bibliographies, altering the
location and appearance of footnotes, tables, and figures, customizing
lists, et cetera.
-\layout Standard
+\end_layout
+\begin_layout Standard
Here's a summary:
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
-TeX: Typesetting language with macro capability.
-\layout List
+\begin_layout List
\labelwidthstring 00.00.0000
+TeX: Typesetting language with macro capability.
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
LaTeX: Macro package built upon TeX\SpecialChar \@.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
classes: Descriptions of a type of document, using LaTeX\SpecialChar \@.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
-styles: Alters the default behavior of LaTeX in some way.
-\layout List
+\begin_layout List
\labelwidthstring 00.00.0000
+styles: Alters the default behavior of LaTeX in some way.
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
LyX: Visual, WYSIWYM word-processor that uses LaTeX in all its glory to
do its printing.
-\layout Standard
+\end_layout
+\begin_layout Standard
The idea of this section was to try and explain
-\emph on
+\emph on
why
-\emph default
+\emph default
LyX works somewhat differently from other word processors.
The reason is simple: LyX uses LaTeX as its printing backend.
Just like LaTeX, LyX focuses on the context of your writing ---
-\emph on
+\emph on
what
-\emph default
+\emph default
you are typing.
The computer then handles how it should look.
-\layout Standard
+\end_layout
+\begin_layout Standard
Oh --- one last thing.
LaTeX is pronounced like TeX is.
It rhymes with
\begin_inset Quotes eld
-\end_inset
+\end_inset
hey blech.
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
or
\begin_inset Quotes eld
-\end_inset
+\end_inset
ha blech
\begin_inset Quotes erd
-\end_inset
+\end_inset
, depending on how you pronounce your
\begin_inset Quotes eld
-\end_inset
+\end_inset
a
\begin_inset Quotes erd
-\end_inset
+\end_inset
s\SpecialChar \ldots{}
-\end_inset
+\end_layout
+
+\end_inset
Usually.
Lamport says in his book, though, that
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\emph on
+\emph on
lay
-\emph default
+\emph default
-tecks is also possible
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
\begin_inset Quotes eld
-\end_inset
+\end_inset
LyX,
\begin_inset Quotes erd
-\end_inset
+\end_inset
on the other hand, is pronounced
\begin_inset Quotes eld
-\end_inset
+\end_inset
licks.
\begin_inset Quotes erd
-\end_inset
+\end_inset
Or
\begin_inset Quotes eld
-\end_inset
+\end_inset
lucks,
\begin_inset Quotes erd
-\end_inset
+\end_inset
or
\begin_inset Quotes eld
-\end_inset
+\end_inset
looks,
\begin_inset Quotes erd
-\end_inset
+\end_inset
depending on what country you're from \SpecialChar \ldots{}
but numerous holy wars and flame
just pronounce it however you please.
Just don't pronounce it
\begin_inset Quotes eld
-\end_inset
+\end_inset
word
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
-\family typewriter
+\family typewriter
:-)
-\layout Chapter
+\end_layout
+\begin_layout Chapter
Navigating the Documentation
-\layout Standard
+\end_layout
+\begin_layout Standard
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
and commentary that can save you some time.
-\layout Standard
+\end_layout
+\begin_layout Standard
Although LyX is now well past the
\begin_inset Quotes eld
-\end_inset
+\end_inset
version 1.0
\begin_inset Quotes erd
-\end_inset
+\end_inset
mark, some of the documentation may be incomplete or a bit out of date,
though we try to keep up.
Like the rest of LyX, the manuals are the work of a group of volunteers
who have
\begin_inset Quotes eld
-\end_inset
+\end_inset
Real Jobs
\begin_inset Quotes erd
-\end_inset
+\end_inset
, families, dishes to clean, kitty litter to dispose of, et cetera.
- If you want to help out, be sure to read Section\SpecialChar ~
+ If you want to help out, be sure to read Chapter\InsetSpace ~
-\begin_inset LatexCommand \ref{sec:Contrib}
+\begin_inset LatexCommand \ref{chp:Contrib}
-\end_inset
+\end_inset
in addition to the rest of this document.)
-\layout Standard
+\end_layout
+\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
-\family typewriter
+\family typewriter
lyx-docs@lists.lyx.org
-\family default
+\family default
.
If you have questions which are not obviously answered in the documentation,
and need help fast, there is an active users' mailing list which you can
reach at
-\family typewriter
+\family typewriter
lyx-users@lists.lyx.org
-\family default
+\family default
.
-\layout Section
+\end_layout
+\begin_layout Section
The Format of the Manuals
-\layout Standard
+\end_layout
+\begin_layout Standard
Some of you may have printed out the manual(s).
Others may be reading it online, within LyX as a file.
For those reading online, there are some differences from the printed version.
Nor are any of the footnotes or the Table of Contents visible.
To open a footnote, which looks like this,
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
Hi!
-\layout Standard
+\end_layout
+\begin_layout Standard
To close me, click on the grey box on the top left of this box, the one
with the word
\begin_inset Quotes eld
-\end_inset
+\end_inset
foot
\begin_inset Quotes erd
-\end_inset
+\end_inset
in it.
-\end_inset
+\end_layout
+
+\end_inset
click on it with the left mouse button.
For the Table of Contents, either click on the grey box, or click on the
-\family sans
-\bar under
+\family sans
+\bar under
N
-\bar default
+\bar default
avigate
-\family default
+\family default
menu, where the contents are displayed automatically\SpecialChar \@.
(Try it!)
-\layout Standard
+\end_layout
+\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 grey box like the following:
-\begin_inset LatexCommand \ref{sec:Contrib}
+\begin_inset LatexCommand \ref{chp:Contrib}
-\end_inset
+\end_inset
.
(The printed manuals show a number instead.) If you click on that box with
the cross-references in the document.
This introduction has only one named
\begin_inset Quotes eld
-\end_inset
+\end_inset
-sec:Contrib
+chp:Contrib
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
You can go to the section the referred to by clicking the button labeled
Going back to where you came from is just as easy.
Clicking on
\begin_inset Quotes eld
-\end_inset
+\end_inset
Go back
\begin_inset Quotes erd
-\end_inset
+\end_inset
or typing
-\family sans
+\family sans
C-<
-\family default
+\family default
will take you back to your earlier location.
(What does
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
C-<
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
mean? See below.)
-\layout Standard
+\end_layout
+\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
document.
You'll occasionally notice things in different fonts:
-\layout Itemize
+\end_layout
+\begin_layout Itemize
-\emph on
+\emph on
Emphasized Style
-\emph default
+\emph default
is used for general emphasis, generic arguments, book titles, names of
sections of other manuals, and notes from the authors.
-\layout Itemize
+\end_layout
+\begin_layout Itemize
-\family typewriter
+\family typewriter
Typewriter
-\family default
+\family default
is used for program and file names, LaTeX code, and LyX code and functions.
-\layout Itemize
+\end_layout
+\begin_layout Itemize
-\family sans
+\family sans
Sans Serif
-\family default
+\family default
is used for menu, button, or dialog box names, and the names of keyboard
keys.
-\layout Itemize
+\end_layout
+\begin_layout Itemize
-\noun on
+\noun on
Noun Style
-\noun default
+\noun default
is used for people's names.
-\layout Standard
+\end_layout
+\begin_layout Standard
For menu accelerator keys and other more obscure keybindings, you'll probably
get referred to the
-\emph on
+\emph on
Key Bindings
-\emph default
+\emph default
section of the
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\emph on
+\emph on
Extended Features Manual
-\emph default
+\emph default
\begin_inset Quotes erd
-\end_inset
+\end_inset
(the file
-\family typewriter
+\family typewriter
Extended.lyx
-\family default
+\family default
).
When we do need to reference keys, we'll use the following prefixing convention
:
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
C-
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
indicates the
-\family sans
+\family sans
Control-
-\family default
+\family default
key.
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
S-
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
indicates the
-\family sans
+\family sans
Shift-
-\family default
+\family default
key.
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
M-
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
indicates the
-\family sans
+\family sans
Meta-
-\family default
+\family default
key, which on some keyboards will be the
-\family sans
+\family sans
Alt-
-\family default
+\family default
key.
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
F1
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\SpecialChar \ldots{}
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
F12
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
are the function keys.
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Esc
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
is the escape key.
-\layout Itemize
-
+\end_layout
+\begin_layout Itemize
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Left
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Right
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Up
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Down
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
: self-explanatory.
-\layout Itemize
-
+\end_layout
-\family sans
+\begin_layout Itemize
+\family sans
\begin_inset Quotes eld
-\end_inset
+\end_inset
Insert
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Delete
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Home
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
End
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
PageUp
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
PageDown
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
: these are the 6 keys that appear above the cursor keys on many PC keyboards.
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
PageUp
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
and
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
PageDown
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
are called
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Prior
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
and
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family sans
+\family sans
Next
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
on some keyboards.
-\layout Itemize
+\end_layout
+\begin_layout Itemize
-\family sans
+\family sans
Return
-\family default
+\family default
and
-\family sans
+\family sans
Enter
-\family default
+\family default
both refer to the same key.
Some keyboards label the
-\family sans
+\family sans
Return
-\family default
+\family default
key as
\begin_inset Quotes eld
-\end_inset
+\end_inset
Return,
\begin_inset Quotes erd
-\end_inset
+\end_inset
others as
\begin_inset Quotes eld
-\end_inset
+\end_inset
Enter,
\begin_inset Quotes erd
-\end_inset
+\end_inset
still others have two keys.
LyX treats all of them as the same key, so we'll use
-\family sans
+\family sans
Return
-\family default
+\family default
and
-\family sans
+\family sans
Enter
-\family default
+\family default
interchangeably.
-\layout Standard
+\end_layout
+\begin_layout Standard
You'll also see something like
\begin_inset Quotes eld
-\end_inset
+\end_inset
(See
-\emph on
+\emph on
\begin_inset Quotes els
-\end_inset
+\end_inset
Extended
-\emph default
+\emph default
\begin_inset Quotes ers
-\end_inset
+\end_inset
)
\begin_inset Quotes erd
-\end_inset
+\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
+\end_inset
-\emph on
+\emph on
Extended Features Manual
-\emph default
+\emph default
,
\begin_inset Quotes erd
-\end_inset
+\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
+\end_inset
CUA
\begin_inset Quotes erd
-\end_inset
+\end_inset
style which is the default and familiar to those coming from the PC world,
and the
\begin_inset Quotes eld
-\end_inset
+\end_inset
emacs
\begin_inset Quotes erd
-\end_inset
+\end_inset
style, which is common with those who
\begin_inset Quotes eld
-\end_inset
+\end_inset
grew up
\begin_inset Quotes erd
-\end_inset
+\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.
-\layout Section
+\end_layout
+\begin_layout Section
The Manuals
-\layout Standard
+\end_layout
+\begin_layout Standard
The following list describes the contents of each of the files in the documentat
ion:
-\layout Description
+\end_layout
+\begin_layout Description
-\emph on
+\emph on
Introduction
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
This file.
-\end_deeper
-\layout Description
+\end_layout
+\end_deeper
+\begin_layout Description
-\emph on
+\emph on
Tutorial
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
If you are new to LyX, and have never used LaTeX before, you should start
here.
If you think LaTeX is the stuff they make condoms out of, then you definitely
need to reread Chapter 1, then read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
.
Note that after you read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
, you'll probably still think LaTeX is some stretchy substance --- but you
-\emph on
+\emph on
will
-\emph default
+\emph default
know how to use LyX.
-\layout Standard
+\end_layout
+\begin_layout Standard
If you
-\emph on
+\emph on
have
-\emph default
+\emph default
used LaTeX before, you should still read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
, starting with the section on
\begin_inset Quotes eld
-\end_inset
+\end_inset
LyX for LaTeX users.
\begin_inset Quotes erd
-\end_inset
+\end_inset
(Skimming the rest of the document wouldn't hurt, either.)
-\layout Standard
+\end_layout
+\begin_layout Standard
If, at any time, you find yourself feeling a bit clueless with respect to
LyX, try perusing the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
before diving into any of the other manuals.
It's a good springboard.
-\end_deeper
-\layout Description
+\end_layout
+\end_deeper
+\begin_layout Description
-\emph on
-User's\SpecialChar ~
+\emph on
+User's\InsetSpace ~
Guide
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
The primary documentation.
We'll cover
-\emph on
+\emph on
most
-\emph default
+\emph default
of the basic operation and available features of LyX here.
The main manual assumes that you've read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
.
-\end_deeper
-\layout Description
+\end_layout
+\end_deeper
+\begin_layout Description
-\emph on
-Extended\SpecialChar ~
+\emph on
+Extended\InsetSpace ~
Features
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
Extension of the
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
.
Documents how to use raw LaTeX commands, additional layouts, and special-purpos
e editing features, and includes some of the (rather bizarre, but nifty)
tricks of the LaTeX masters.
-\end_deeper
-\layout Description
+\end_layout
+\end_deeper
+\begin_layout Description
-\emph on
+\emph on
Customization
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
A description of advanced LyX features, including how to customize the overall
behavior of LyX\SpecialChar \@.
This includes such things as keybindings, internationalization,
and configuration files.
Don't even think of going in here until you read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
.
-\end_deeper
-\layout Description
+\end_layout
+\end_deeper
+\begin_layout Description
-\emph on
-LaTeX\SpecialChar ~
+\emph on
+LaTeX\InsetSpace ~
configuration
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
LyX investigates your system upon installation.
This file contains info on what LyX learned about your installation.
Check it to see if you're missing something you might like to have.
-\end_deeper
-\layout Standard
+\end_layout
+\end_deeper
+\begin_layout Standard
These files will reference one another as necessary.
For example, the
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
contains
-\emph on
+\emph on
some
-\emph default
+\emph default
information on installation and customization, but refers the reader to
the
-\emph on
+\emph on
Customization Manual
-\emph default
+\emph default
for more information.
-\layout Standard
+\end_layout
+\begin_layout Standard
We'll state again an important point:
-\layout Standard
-\added_space_top bigskip \added_space_bottom bigskip \align center
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\align center
If you are new to LyX, read the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
.
Now\SpecialChar \@.
-\layout Standard
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\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.
-\layout Chapter
+\end_layout
+\begin_layout Chapter
+\begin_inset LatexCommand \label{chp:Contrib}
-\begin_inset LatexCommand \label{sec:Contrib}
-
-\end_inset
+\end_inset
Contributing to the LyX Project
-\layout Section
+\end_layout
+\begin_layout Section
Contributing to LyX
-\layout Standard
+\end_layout
-LyX is mostly written in C++ (the LaTeX importer is written in Perl).
+\begin_layout Standard
+LyX is mostly written in C++.
It is a large project, and as a result it is not free from bugs, or the
need for improvements in the source code.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Reporting a bug
-\layout Standard
+\end_layout
+\begin_layout Standard
While using LyX, you may find behaviour which you consider a bug.
Crashes, though rare, can happen.
User interface problems are considered major bugs by the LyX team: especially
helpful are indications of parts of the LyX interface you find confusing,
or unclear.
-\layout Standard
+\end_layout
+\begin_layout Standard
LyX has a bug tracking system, which you can find at
-\family typewriter
+\family typewriter
\begin_inset LatexCommand \htmlurl[LyX bug tracker]{http://bugzilla.lyx.org/}
-\end_inset
+\end_inset
-\family default
+\family default
.
You should check the bug tracker before reporting any bugs, in case it
has already been reported.
If you have a comment on an existing bug, or wish to report a new bug,
you may either use the bug tracker, or send an e-mail to the development
mailing list,
-\family typewriter
+\family typewriter
lyx-devel@lists.lyx.org
-\family default
+\family default
.
Archives of this list are linked from the main LyX website,
-\family typewriter
+\family typewriter
\begin_inset LatexCommand \htmlurl[LyX website]{http://www.lyx.org/}
-\end_inset
+\end_inset
-\family default
+\family default
.
-\layout Standard
+\end_layout
+\begin_layout Standard
A good (useful) bug report will at a minimum include the version of LyX
you are having the problem with.
Accurate, detailed descriptions are preferred - the more time developers
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
-\family typewriter
+\family typewriter
config.log
-\family default
+\family default
, and mention which compiler you are using.
-\layout Standard
+\end_layout
+\begin_layout Standard
If you can make LyX crash, please take the time to produce a backtrace with
a non-stripped lyx executable.
The one built in the source directory is per default not stripped, while
the installed binary is stripped.
So, run LyX from gdb by typing, for example,
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family typewriter
-\size small
+\family typewriter
+\size small
gdb /users/steve/lyx-1.0.x/src/lyx
-\family default
-\size default
+\family default
+\size default
\begin_inset Quotes erd
-\end_inset
+\end_inset
and then
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family typewriter
-\size small
+\family typewriter
+\size small
run
-\family default
-\size default
+\family default
+\size default
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
Make LyX crash and you'll return to gdb.
Use
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family typewriter
-\size small
+\family typewriter
+\size small
bt
-\family default
-\size default
+\family default
+\size default
\begin_inset Quotes erd
-\end_inset
+\end_inset
to produce a backtrace and include the output in the bug report
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
if you want to be thorough, use the
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family typewriter
+\family typewriter
info locals
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
and
\begin_inset Quotes eld
-\end_inset
+\end_inset
-\family typewriter
+\family typewriter
up
-\family default
+\family default
\begin_inset Quotes erd
-\end_inset
+\end_inset
commands to print out the values of local variables at a few stack levels.
-\end_inset
+\end_layout
+
+\end_inset
.
If possible, then a description of a way to reproduce the bug is more important
backtrace.
If the bug is not easily reproducible, a backtrace is essential, because
then that might be all we've got.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Contributing fixes and new features
-\layout Standard
+\end_layout
+\begin_layout Standard
If you have made changes to LyX's source that you think should become part
of LyX, send your changes as a diff file (in unified format) to the development
list referenced above, along with a change log, and a description of what
your patch does.
-\layout Section
+\end_layout
+\begin_layout Section
Contributing to the Documentation
-\layout Standard
+\end_layout
+\begin_layout Standard
LyX's documentation is extensive; however LyX is under constant development,
and each new release adds new features.
You may find some documentation needs improvement.
This section describes what to do if you find an error, or have some suggestion
s for improving the documentation.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Reporting Errors in the Manuals
-\layout Standard
+\end_layout
+\begin_layout Standard
If you find a problem with the documentation, send a message to the mailing
list
-\family typewriter
+\family typewriter
lyx-docs@lists.lyx.org
-\family default
+\family default
.
The documentation team will make any necessary fixes.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Joining the Documentation Team.
-\layout Standard
+\end_layout
+\begin_layout Standard
The LyX Documentation Project, like anything else in the LyX project, can
always use assistance! If you're interested in contributing to the Documentatio
n Project, you need to do the following assignment
-\emph on
+\emph on
first
-\emph default
+\emph default
:
-\layout Enumerate
+\end_layout
+\begin_layout Enumerate
Get the latest LyX source code.
Untar it.
\begin_inset Foot
-collapsed true
-
-\layout Standard
+status collapsed
+\begin_layout Standard
The more adventurous can grab the latest documentation anonymously from
the LyX CVS repository - it is contained in the
-\family typewriter
+\family typewriter
lyxdoc
-\family default
+\family default
module.
-\end_inset
+\end_layout
+
+\end_inset
You will find a directory inside the main tree called
-\family typewriter
+\family typewriter
lib/doc/
-\family default
+\family default
.
Inside that directory is a file called
-\family typewriter
+\family typewriter
DocStyle.lyx
-\family default
+\family default
.
Read it; it's the style sheet for the documentation.
-\layout Enumerate
+\end_layout
+\begin_layout Enumerate
Next, read the
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
and the
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
.
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
The point of this exercise is to give you ideas.
The
-\emph on
+\emph on
Tutorial
-\emph default
+\emph default
and
-\emph on
+\emph on
User's Guide
-\emph default
+\emph default
is 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_deeper
-\layout Enumerate
+\end_layout
+\end_deeper
+\begin_layout Enumerate
Contact the team at:
-\begin_deeper
-\layout Standard
+\end_layout
+\begin_deeper
+\begin_layout Standard
-\family typewriter
+\family typewriter
lyx-docs@lists.lyx.org
-\layout Standard
+\end_layout
+\begin_layout Standard
to discuss your intended changes, and get some feedback on them.
-\end_deeper
-\layout Standard
+\end_layout
+\end_deeper
+\begin_layout Standard
The changes you wish to make may range from improving clarity of the text,
to doing major re-structuring of the documentation.
Any and all improvements are gladly received.
-\the_end
+\end_layout
+
+\end_body
+\end_document
projects / lyx.git / blobdiff