mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-12-24 13:48:59 +00:00
a15303b938
Especially after the change to use semantic linefeeds (7b23c76b),
the diffs are large and it's hard to figure out what diff is the
result of the linefeed change and which diff is the result of an
edit.
By updating the docs, it will make the edits easier to understand
from the diff.
This commit used the LyX binary to write the new .lyx files since
lyx2lyx does not apply semantic linefeeds.
I used the following command:
./development/tools/updatedocs.py [path to 'lyx' binary]
A few documents were not updated (e.g., the command sequence used
failed because a dialog about a missing dependency was shown).
I did not update Additional.lyx for any language since it is
undergoing changes. I also didn't change anything in doc/fr since JP
is working on some of those. I also didn't change doc/ru since it
appears Yuriy already updated those.
2498 lines
46 KiB
Plaintext
2498 lines
46 KiB
Plaintext
#LyX 2.4 created this file. For more info see https://www.lyx.org/
|
|
\lyxformat 612
|
|
\begin_document
|
|
\begin_header
|
|
\save_transient_properties true
|
|
\origin /systemlyxdir/doc/
|
|
\textclass article
|
|
\begin_preamble
|
|
% DO NOT ALTER THIS PREAMBLE!!!
|
|
%
|
|
%This preamble is designed to ensure that the document prints
|
|
% out as advertised. If you mess with this preamble,
|
|
% parts of the document may not print out as expected. If you
|
|
% have problems LaTeXing this file, please contact
|
|
% the documentation team
|
|
% email: lyx-docs@lists.lyx.org
|
|
|
|
% the pages of the TOC is numbered roman
|
|
% and a pdf-bookmark for the TOC is added
|
|
\pagenumbering{roman}
|
|
\let\myTOC\tableofcontents
|
|
\renewcommand\tableofcontents{%
|
|
\pdfbookmark[1]{\contentsname}{}
|
|
\myTOC
|
|
\cleardoublepage
|
|
\pagenumbering{arabic} }
|
|
\end_preamble
|
|
\use_default_options false
|
|
\maintain_unincluded_children no
|
|
\language english
|
|
\language_package default
|
|
\inputencoding utf8
|
|
\fontencoding auto
|
|
\font_roman "palatino" "default"
|
|
\font_sans "helvet" "default"
|
|
\font_typewriter "courier" "default"
|
|
\font_math "auto" "auto"
|
|
\font_default_family default
|
|
\use_non_tex_fonts false
|
|
\font_sc true
|
|
\font_roman_osf false
|
|
\font_sans_osf false
|
|
\font_typewriter_osf false
|
|
\font_sf_scale 100 100
|
|
\font_tt_scale 100 100
|
|
\use_microtype false
|
|
\use_dash_ligatures false
|
|
\graphics default
|
|
\default_output_format pdf2
|
|
\output_sync 0
|
|
\bibtex_command default
|
|
\index_command default
|
|
\paperfontsize 12
|
|
\spacing single
|
|
\use_hyperref true
|
|
\pdf_title "Introduction to LyX"
|
|
\pdf_author "LyX Team"
|
|
\pdf_subject "LyX-documentation Intro"
|
|
\pdf_keywords "LyX, documentation"
|
|
\pdf_bookmarks true
|
|
\pdf_bookmarksnumbered true
|
|
\pdf_bookmarksopen true
|
|
\pdf_bookmarksopenlevel 2
|
|
\pdf_breaklinks true
|
|
\pdf_pdfborder false
|
|
\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"
|
|
\papersize a4
|
|
\use_geometry false
|
|
\use_package amsmath 1
|
|
\use_package amssymb 1
|
|
\use_package cancel 1
|
|
\use_package esint 1
|
|
\use_package mathdots 1
|
|
\use_package mathtools 1
|
|
\use_package mhchem 1
|
|
\use_package stackrel 1
|
|
\use_package stmaryrd 1
|
|
\use_package undertilde 1
|
|
\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
|
|
\use_minted 0
|
|
\use_lineno 0
|
|
\index Index
|
|
\shortcut idx
|
|
\color #008000
|
|
\end_index
|
|
\secnumdepth 3
|
|
\tocdepth 2
|
|
\paragraph_separation indent
|
|
\paragraph_indentation default
|
|
\is_math_indent 0
|
|
\math_numbering_side default
|
|
\quotes_style english
|
|
\dynamic_quotes 0
|
|
\papercolumns 1
|
|
\papersides 1
|
|
\paperpagestyle default
|
|
\tablestyle default
|
|
\tracking_changes true
|
|
\output_changes false
|
|
\change_bars false
|
|
\postpone_fragile_content false
|
|
\html_math_output 0
|
|
\html_css_as_file 0
|
|
\html_be_strict false
|
|
\docbook_table_output 0
|
|
\docbook_mathml_prefix 1
|
|
\author -584632292 "Richard Kimberly Heck"
|
|
\end_header
|
|
|
|
\begin_body
|
|
|
|
\begin_layout Title
|
|
Introduction to \SpecialChar LyX
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Author
|
|
by the \SpecialChar LyX
|
|
Team
|
|
\begin_inset Foot
|
|
status collapsed
|
|
|
|
\begin_layout Plain Layout
|
|
\noindent
|
|
If you have comments on or corrections to this documentation,
|
|
please send them to the \SpecialChar LyX
|
|
Documentation mailing list:
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "lyx-docs@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset CommandInset toc
|
|
LatexCommand tableofcontents
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
The Philosophy of \SpecialChar LyX
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
What is \SpecialChar LyX
|
|
?
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar LyX
|
|
is a document preparation system.
|
|
It excels at letting you create complex technical and scientific articles 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 advertisements (we'll explain why later),
|
|
though with some effort all these can be done,
|
|
too.
|
|
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
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar 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
|
|
|
|
typewriter concept
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
It is designed for authors who want professional output quickly with a minimum of effort and without becoming specialists in typesetting.
|
|
The job of typesetting is done mostly by the computer,
|
|
not the author;
|
|
with \SpecialChar LyX
|
|
,
|
|
the author can concentrate on the contents of his writing.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Part of the initial challenge of using \SpecialChar 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
|
|
|
|
_
|
|
\begin_inset Quotes erd
|
|
\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.
|
|
\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.
|
|
They still use tab stops for adding whitespace.
|
|
You still need to worry about exactly where on the page something will appear.
|
|
Emphasizing text means changing a font,
|
|
similar to changing the typewriter wheel.
|
|
This is the underlying philosophy of a WYSIWYG word processor:
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
What You See Is What You Get
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
Unfortunately,
|
|
that paradigm often results in
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
What You See Is All You Get
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
This is where \SpecialChar LyX
|
|
differs from an ordinary word processor.
|
|
You don't concern yourself with what character goes where.
|
|
You tell \SpecialChar LyX
|
|
|
|
\emph on
|
|
what you're doing
|
|
\emph default
|
|
and \SpecialChar LyX
|
|
takes care of the rest,
|
|
following a set of rules called a
|
|
\emph on
|
|
style
|
|
\emph default
|
|
.
|
|
\begin_inset Foot
|
|
status collapsed
|
|
|
|
\begin_layout Plain Layout
|
|
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_layout
|
|
|
|
\end_inset
|
|
|
|
Let's look at a little example:
|
|
\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
|
|
|
|
Introduction\SpecialChar endofsentence
|
|
|
|
\begin_inset Quotes erd
|
|
\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
|
|
|
|
1.
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Introduction
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
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.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
In \SpecialChar LyX
|
|
,
|
|
you go to the pull-down on the far left of the button bar and select
|
|
\family sans
|
|
Section
|
|
\family default
|
|
,
|
|
and type
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
Introduction
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
\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-reference tags),
|
|
\SpecialChar LyX
|
|
will automatically update them all throughout the file so that you never,
|
|
ever type a section number.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Now let's look at the problem of consistency.
|
|
Five days later,
|
|
you reopen your report and start Section
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
4.
|
|
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 from the one you used for Section
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
1.
|
|
That problem doesn't even exist in \SpecialChar 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.
|
|
\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.
|
|
You need to figure out where to put the label for each list item,
|
|
what that label should be,
|
|
how many blank lines to put between each item,
|
|
and so on.
|
|
Under \SpecialChar LyX
|
|
,
|
|
you have only two concerns:
|
|
what kind of list is this,
|
|
and what do I want to put in it?
|
|
That is it.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
So,
|
|
the basic idea behind \SpecialChar LyX
|
|
is:
|
|
specify
|
|
\emph on
|
|
what
|
|
\emph default
|
|
you're doing,
|
|
not
|
|
\emph on
|
|
how
|
|
\emph default
|
|
to do it.
|
|
Instead of
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
What You See Is What You Get,
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
the \SpecialChar LyX
|
|
model is
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
What You See Is What You
|
|
\emph on
|
|
Mean
|
|
\emph default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
or
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
WYSIWYM.
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
It's a powerful idea that greatly simplifies the mechanics of writing documents.
|
|
This is also why \SpecialChar LyX
|
|
isn't so good for creating posters and flyers.
|
|
In this case,
|
|
you
|
|
\emph on
|
|
do
|
|
\emph default
|
|
want to specify exactly where everything goes,
|
|
because there are no functional units like paragraphs,
|
|
sections,
|
|
etc.
|
|
This doesn't mean \SpecialChar 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.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Differences between \SpecialChar LyX
|
|
and Other Word Processors
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Here's a list of things you won't find in \SpecialChar LyX
|
|
:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
The document ruler
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Tab stops
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Extra whitespace (e.
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
g.
|
|
\begin_inset space \space{}
|
|
\end_inset
|
|
|
|
hitting
|
|
\family sans
|
|
Enter
|
|
\family default
|
|
or
|
|
\family sans
|
|
Space
|
|
\family default
|
|
two or more times)
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Tab stops,
|
|
along with a ruler showing you the position of things on the page,
|
|
are useless in \SpecialChar LyX
|
|
.
|
|
The program worries about where things go on the page,
|
|
not you.
|
|
Extra whitespace is similar;
|
|
\SpecialChar 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 Standard
|
|
Here are some things that exist in \SpecialChar LyX
|
|
,
|
|
but aren't used as you might think:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Indenting controls
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Page breaks
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Line spacing (e.
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
g.
|
|
\begin_inset space \space{}
|
|
\end_inset
|
|
|
|
single spaced,
|
|
double spaced,
|
|
etc.)
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Whitespace,
|
|
horizontal and vertical
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Fonts and font sizes
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Typefaces (bold,
|
|
italic,
|
|
underline,
|
|
etc.)
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Although they exist in \SpecialChar LyX
|
|
,
|
|
you generally don't need them.
|
|
\SpecialChar 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 and font size.
|
|
Paragraph indenting is context dependent;
|
|
different types of paragraphs get indented differently.
|
|
Page breaks get handled automatically,
|
|
as well.
|
|
In general,
|
|
the space between lines,
|
|
between words,
|
|
and between paragraphs is variable,
|
|
set by \SpecialChar LyX
|
|
.
|
|
\begin_inset Foot
|
|
status collapsed
|
|
|
|
\begin_layout Plain Layout
|
|
There are ways to adjust all of these (only some of which require knowledge of \SpecialChar LaTeX
|
|
),
|
|
either for a whole document or for a specific location in a document.
|
|
See the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
and/or the
|
|
\emph on
|
|
Additional Features
|
|
\emph default
|
|
manual for details.
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Lastly,
|
|
there are a few areas where we believe \SpecialChar LyX
|
|
(and \SpecialChar LaTeX
|
|
) surpasses many word processors:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Hyphenation
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Lists of any type
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Mathematics
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Tables
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Cross-referencing
|
|
\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 \SpecialChar LyX
|
|
is built upon the \SpecialChar LaTeX
|
|
document preparation system.
|
|
\SpecialChar LaTeX
|
|
has been around since 1985,
|
|
and
|
|
\emph on
|
|
works
|
|
\emph default
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
What is \SpecialChar LaTeX
|
|
?
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar LaTeX
|
|
is a document preparation system designed by Leslie Lamport in 1985.
|
|
\begin_inset Foot
|
|
status collapsed
|
|
|
|
\begin_layout Plain Layout
|
|
The source for the info in this section is
|
|
\emph on
|
|
A Guide to \SpecialChar LaTeX2e
|
|
|
|
\emph default
|
|
,
|
|
by Helmut Kopka and Patrick Daly,
|
|
which has an entry in the bibliography of the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
\SpecialChar endofsentence
|
|
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
It was built up from a typesetting language called \SpecialChar TeX
|
|
,
|
|
created by Donald Knuth in 1984.
|
|
\SpecialChar TeX
|
|
takes a sequence of typesetting commands,
|
|
written in a script in an ASCII file,
|
|
and executes them.
|
|
Many of the
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
tricks
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
of the printing trade were modeled by Knuth as computer algorithms and incorporated into \SpecialChar TeX
|
|
,
|
|
hence its excellent printed appearance.
|
|
What comes directly out of \SpecialChar TeX
|
|
is the portable document format
|
|
\emph on
|
|
pdf
|
|
\emph default
|
|
or the so-called
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
device independent
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
format file
|
|
\emph on
|
|
dvi
|
|
\emph default
|
|
.
|
|
The dvi format is often used for previews and can later be converted to other formats like PostScript.
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar TeX
|
|
isn't only a typesetting engine;
|
|
it also allows you to define macros.
|
|
Most people who use \SpecialChar 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 a uniform,
|
|
consistent fashion.
|
|
This is how \SpecialChar LaTeX
|
|
was born.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Now,
|
|
in parallel with the development and growth of \SpecialChar LaTeX
|
|
,
|
|
other folks were creating their own custom macro packages for \SpecialChar TeX
|
|
,
|
|
ones to make slides or articles for math journals and so on.
|
|
Some used the raw \SpecialChar TeX
|
|
facilities to do this,
|
|
others began modifying \SpecialChar LaTeX
|
|
.
|
|
To try and unify this mess,
|
|
a team of \SpecialChar LaTeX
|
|
-nicians began to work on \SpecialChar LaTeX2e
|
|
,
|
|
the current version of \SpecialChar LaTeX
|
|
,
|
|
during the late 1980's.
|
|
This new version of \SpecialChar LaTeX
|
|
has commands which provide an easier-to-use interface to \SpecialChar TeX
|
|
's macro-creating commands,
|
|
aid in the use of new fonts,
|
|
and so on.
|
|
In fact,
|
|
\SpecialChar LaTeX
|
|
is quite an extensive language in its own right!
|
|
Users around the world have been creating their own add-ons for \SpecialChar LaTeX
|
|
beyond the standard ones.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
There are two ways to extend \SpecialChar LaTeX
|
|
:
|
|
classes and styles.
|
|
A
|
|
\emph on
|
|
class
|
|
\emph default
|
|
is a set of \SpecialChar LaTeX
|
|
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
|
|
style
|
|
\emph default
|
|
differs from a class in that it doesn't define a new type of document,
|
|
but a different type of
|
|
\emph on
|
|
behavior
|
|
\emph default
|
|
that any document can use.
|
|
For example,
|
|
\SpecialChar LyX
|
|
controls page margins and line spacing using two different \SpecialChar LaTeX
|
|
style-files designed for these purposes.
|
|
There are style-files for a whole slew of things:
|
|
printing labels or envelopes,
|
|
changing indentation behavior,
|
|
adding new fonts,
|
|
manipulating graphics,
|
|
designing fancy page headings,
|
|
customizing bibliographies,
|
|
altering the location and appearance of footnotes,
|
|
tables,
|
|
and figures,
|
|
customizing lists,
|
|
etc.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Here is a summary:
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
\SpecialChar TeX
|
|
:
|
|
Typesetting language with macro capability.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
\SpecialChar LaTeX
|
|
:
|
|
Macro package built upon \SpecialChar TeX
|
|
\SpecialChar endofsentence
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
classes:
|
|
Descriptions of types of document used with \SpecialChar LaTeX
|
|
\SpecialChar endofsentence
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
styles:
|
|
Descriptions of the default behavior of particular elements of \SpecialChar LaTeX
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
\SpecialChar LyX
|
|
:
|
|
Visual,
|
|
WYSIWYM document processor that uses \SpecialChar LaTeX
|
|
to do its typesetting.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
This section attempts to explain the difference between \SpecialChar LyX
|
|
and a word processor.
|
|
Simply put,
|
|
\SpecialChar LaTeX
|
|
is the difference.
|
|
By using \SpecialChar LaTeX
|
|
as its backend,
|
|
\SpecialChar LyX
|
|
helps you to think more about
|
|
\emph on
|
|
what
|
|
\emph default
|
|
(as in the
|
|
\emph on
|
|
words
|
|
\emph default
|
|
) you write.
|
|
The computer then handles
|
|
\emph on
|
|
how
|
|
\emph default
|
|
they should look.
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
Navigating the Documentation
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
To make it easier to answer your questions and describe all of the features of \SpecialChar LyX
|
|
,
|
|
the documentation has been split up into several different files.
|
|
Each one has its own purpose,
|
|
as described below.
|
|
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
|
|
Hopefully,
|
|
the development of \SpecialChar 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 \SpecialChar LyX
|
|
,
|
|
the manuals are the work of a group of volunteers who have
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
Real Jobs
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
,
|
|
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_inset CommandInset ref
|
|
LatexCommand ref
|
|
reference "sec:Contrib"
|
|
nolink "false"
|
|
|
|
\end_inset
|
|
|
|
in addition to the rest of this document.
|
|
\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 emailing
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "lyx-docs@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
|
|
\change_inserted -584632292 1610248366
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
|
|
\change_inserted -584632292 1610248375
|
|
Where To Get Help
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
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
|
|
LatexCommand href
|
|
target "lyx-users@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
|
|
\change_inserted -584632292 1610248524
|
|
You do not have to register to post,
|
|
but you may wish to do so.
|
|
See
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
name "the LyX website"
|
|
target "https://www.lyx.org/MailingLists"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
for further information.
|
|
LyX also has a
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "http://wiki.lyx.org/"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
that will answer many questions about how to get LyX to do various things.
|
|
\change_unchanged
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
The Format of the Manuals
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Some of you may have printed out the manuals.
|
|
Others may be reading them within \SpecialChar LyX
|
|
.
|
|
There are some differences between the \SpecialChar LyX
|
|
-file and the printed version.
|
|
In \SpecialChar 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_inset Graphics
|
|
filename clipart/footnote.png
|
|
scale 95
|
|
|
|
\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
|
|
Navigate
|
|
\family default
|
|
menu,
|
|
where the contents are displayed automatically\SpecialChar endofsentence
|
|
|
|
\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.
|
|
In the \SpecialChar LyX
|
|
-file,
|
|
however,
|
|
all cross-references appear as light-grey boxes like the following:
|
|
|
|
\begin_inset Graphics
|
|
filename clipart/reference.png
|
|
scale 95
|
|
|
|
\end_inset
|
|
|
|
.
|
|
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 referenced section by right-clicking on the box or by clicking the button
|
|
\family sans
|
|
Go
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
to
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Label
|
|
\family default
|
|
in the opened dialog.
|
|
Going back to where you came from is just as easy.
|
|
Click on
|
|
\family sans
|
|
Go
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Back
|
|
\family default
|
|
to go back to your earlier location.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Now that we've cleared up some of the differences between the printed and \SpecialChar 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
|
|
|
|
\begin_layout Itemize
|
|
|
|
\emph on
|
|
Emphasized Style
|
|
\emph default
|
|
is used for general emphasis,
|
|
generic arguments,
|
|
book titles,
|
|
names of sections of other manuals,
|
|
and notes from the authors.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\family typewriter
|
|
Typewriter
|
|
\family default
|
|
is used for program and file names,
|
|
\SpecialChar LyX
|
|
code and functions.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\family sans
|
|
Sans Serif
|
|
\family default
|
|
is used for menu,
|
|
button,
|
|
or dialog box names,
|
|
and the names of keyboard keys.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\noun on
|
|
Noun Style
|
|
\noun default
|
|
is used for people's names.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\series bold
|
|
Bold
|
|
\series default
|
|
is used for \SpecialChar LaTeX
|
|
code
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
When we do need to reference keys,
|
|
we'll use the following prefixing convention:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Ctrl+
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
indicates the
|
|
\family sans
|
|
Control
|
|
\family default
|
|
key.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Shift+
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
indicates the
|
|
\family sans
|
|
Shift
|
|
\family default
|
|
key.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Alt+
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
indicates the
|
|
\family sans
|
|
Alt
|
|
\family default
|
|
(
|
|
\family sans
|
|
Meta
|
|
\family default
|
|
) key.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
F1
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
\SpecialChar ldots
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
F12
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
are the function keys.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Esc
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
is the escape key.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Left
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Right
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Up
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Down
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
:
|
|
self-explanatory.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\family sans
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
Insert
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Delete
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Home
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
End
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
PageUp
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
PageDown
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
:
|
|
these are the 6
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
keys that appear above the cursor keys on many PC keyboards.
|
|
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
PageUp
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
and
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
PageDown
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
are called
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Prior
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
and
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
|
|
\family sans
|
|
Next
|
|
\family default
|
|
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
on some keyboards.
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\family sans
|
|
Return
|
|
\family default
|
|
and
|
|
\family sans
|
|
Enter
|
|
\family default
|
|
both refer to the same key.
|
|
Some keyboards label the
|
|
\family sans
|
|
Return
|
|
\family default
|
|
key as
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
Return,
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
others as
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
Enter,
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
still others have two keys.
|
|
\SpecialChar LyX
|
|
treats all of them as the same key,
|
|
so we'll use
|
|
\family sans
|
|
Return
|
|
\family default
|
|
and
|
|
\family sans
|
|
Enter
|
|
\family default
|
|
interchangeably.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
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
|
|
Units used in the Manuals
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
To understand the units described in this documentation,
|
|
Table
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
|
|
\begin_inset CommandInset ref
|
|
LatexCommand ref
|
|
reference "tab:Units"
|
|
nolink "false"
|
|
|
|
\end_inset
|
|
|
|
explains all units available in \SpecialChar LyX
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset Float table
|
|
placement document
|
|
alignment document
|
|
wide false
|
|
sideways false
|
|
status open
|
|
|
|
\begin_layout Plain Layout
|
|
\begin_inset Caption Standard
|
|
|
|
\begin_layout Plain Layout
|
|
\begin_inset CommandInset label
|
|
LatexCommand label
|
|
name "tab:Units"
|
|
|
|
\end_inset
|
|
|
|
Units
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Plain Layout
|
|
\begin_inset VSpace medskip
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Plain Layout
|
|
\align center
|
|
\begin_inset Tabular
|
|
<lyxtabular version="3" rows="20" columns="2">
|
|
<features 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" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
unit
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
name/description
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
mm
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
millimeter
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
cm
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
centimeter
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
in
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
inch (1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
in = 2.54
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
cm)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
pt
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
point (72.27
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
pt = 1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
in)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
pc
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
pica (1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
pc = 12
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
pt)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
sp
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
scaled point (65536
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
sp = 1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
pt)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
bp
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
big point (72
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
bp = 1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
in)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
dd
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
didot (72
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
dd
|
|
\begin_inset Formula $\approx$
|
|
\end_inset
|
|
|
|
37.6
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
mm)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
cc
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
cicero (1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
cc = 12
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
dd)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
Scale%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of original image width
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
text%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of text width
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
col%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of column width
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
page%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of paper width
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
line%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of line width
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
theight%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of text height
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
pheight%
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
% of paper height
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
ex
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
height of letter
|
|
\emph on
|
|
x
|
|
\emph default
|
|
in current font
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
em
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
width of letter
|
|
\emph on
|
|
M
|
|
\emph default
|
|
in current font
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
<row>
|
|
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
mu
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
|
|
\begin_inset Text
|
|
|
|
\begin_layout Plain Layout
|
|
math unit (1
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
mu = 1/18
|
|
\begin_inset space \thinspace{}
|
|
\end_inset
|
|
|
|
em)
|
|
\end_layout
|
|
|
|
\end_inset
|
|
</cell>
|
|
</row>
|
|
</lyxtabular>
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
The Manuals
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
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
|
|
Introduction This file.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
Tutorial If you are new to \SpecialChar LyX
|
|
,
|
|
and have never used \SpecialChar LaTeX
|
|
before,
|
|
you should start here.
|
|
If you have used \SpecialChar LaTeX
|
|
before,
|
|
you should still read the
|
|
\emph on
|
|
Tutorial
|
|
\emph default
|
|
,
|
|
starting with the section on
|
|
\begin_inset Quotes eld
|
|
\end_inset
|
|
|
|
\SpecialChar LyX
|
|
for \SpecialChar LaTeX
|
|
users.
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
(Skimming through the rest of the document wouldn't hurt,
|
|
either.)
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
User's
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Guide The primary documentation.
|
|
We'll cover
|
|
\emph on
|
|
most
|
|
\emph default
|
|
of the basic operation and available features of \SpecialChar LyX
|
|
here.
|
|
The main manual assumes that you have read the
|
|
\emph on
|
|
Tutorial
|
|
\emph default
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
Embedded
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Objects Extension of the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
.
|
|
Documents in detail how to use tables,
|
|
graphics,
|
|
floats,
|
|
notes,
|
|
program listings and boxes.
|
|
It also includes many tricks of the \SpecialChar LaTeX
|
|
masters.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
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
|
|
|
|
Features Extension of the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
.
|
|
Documents how to use raw \SpecialChar LaTeX
|
|
commands,
|
|
additional layouts and special-purpose editing features.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
Customization A description of advanced \SpecialChar LyX
|
|
features,
|
|
including how to customize the overall behavior of \SpecialChar LyX
|
|
\SpecialChar endofsentence
|
|
This includes such things as keybindings,
|
|
internationalization and configuration files.
|
|
It also includes information about layout files,
|
|
which are needed to get \SpecialChar LyX
|
|
to support \SpecialChar LaTeX
|
|
classes or packages.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
Shortcuts Tables of the currently defined \SpecialChar LyX
|
|
shortcuts.
|
|
\end_layout
|
|
|
|
\begin_layout Description
|
|
\SpecialChar LaTeX
|
|
|
|
\begin_inset space ~
|
|
\end_inset
|
|
|
|
Configuration A report produced by \SpecialChar LyX
|
|
about your system.
|
|
This file contains information on what \SpecialChar LyX
|
|
learned about your installation.
|
|
Check it to see if you're missing something you might like to have.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
These files will reference one another as necessary.
|
|
For example,
|
|
the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
contains
|
|
\emph on
|
|
some
|
|
\emph default
|
|
information on installation and customization,
|
|
but refers the reader to the
|
|
\emph on
|
|
Customization Manual
|
|
\emph default
|
|
for more information.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
We'll state again an important point:
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset VSpace bigskip
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\align center
|
|
If you are new to \SpecialChar LyX
|
|
,
|
|
read the
|
|
\emph on
|
|
Tutorial
|
|
\emph default
|
|
.
|
|
Now\SpecialChar endofsentence
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset VSpace bigskip
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Otherwise,
|
|
you could needlessly frustrate yourself.
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
Contributing to the \SpecialChar LyX
|
|
Project
|
|
\begin_inset CommandInset label
|
|
LatexCommand label
|
|
name "sec:Contrib"
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Contributing to \SpecialChar LyX
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar LyX
|
|
is mostly written in C++ (the \SpecialChar LaTeX
|
|
importer is written in Python).
|
|
It is a large project,
|
|
and as a result it is not free from bugs,
|
|
or the need for improvements in the source code.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Reporting a bug
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
While using \SpecialChar LyX
|
|
,
|
|
you may find behavior which you consider a bug.
|
|
Crashes,
|
|
though rare,
|
|
can happen.
|
|
User interface problems are considered major bugs by the \SpecialChar LyX
|
|
team:
|
|
especially helpful are indications of parts of the \SpecialChar LyX
|
|
interface you find confusing,
|
|
or unclear.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar LyX
|
|
has a bug tracking system,
|
|
which you can find at
|
|
\begin_inset Newline newline
|
|
\end_inset
|
|
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "https://www.lyx.org/trac/wiki/BugTrackerHome"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
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,
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "lyx-devel@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
Archives of this list are linked from the main \SpecialChar LyX
|
|
website,
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "http://www.lyx.org"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
A useful bug report will at a minimum include the version of \SpecialChar LyX
|
|
you are having the problem with.
|
|
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 on which you are running \SpecialChar LyX
|
|
.
|
|
Give the versions of the libraries you have installed on your system,
|
|
and,
|
|
if relevant,
|
|
the versions of external programs that \SpecialChar LyX
|
|
uses.
|
|
If it's a compilation or configuration problem,
|
|
include the file
|
|
\family typewriter
|
|
config.log
|
|
\family default
|
|
,
|
|
and mention which compiler you are using.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Contributing fixes and new features
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
If you have made changes to \SpecialChar LyX
|
|
's source that you think should become part of \SpecialChar 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.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Contributing to the Documentation
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\SpecialChar LyX
|
|
's documentation is extensive;
|
|
however \SpecialChar 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 suggestions for improving the documentation.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Reporting Errors in the Manuals
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
If you find a problem with the documentation,
|
|
send a message to the mailing list
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "lyx-docs@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
.
|
|
The documentation team will make any necessary fixes.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Joining the Documentation Team.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
The \SpecialChar LyX
|
|
Documentation Project,
|
|
like anything else in the \SpecialChar LyX
|
|
project,
|
|
can always use assistance!
|
|
If you're interested in contributing to the Documentation Project,
|
|
you need to do the following:
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Get the latest \SpecialChar LyX
|
|
source code from
|
|
\begin_inset Newline newline
|
|
\end_inset
|
|
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Next,
|
|
read the
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
and the
|
|
\emph on
|
|
Tutorial
|
|
\emph default
|
|
|
|
\begin_inset Newline newline
|
|
\end_inset
|
|
|
|
The point of this exercise is to give you ideas.
|
|
The
|
|
\emph on
|
|
Tutorial
|
|
\emph default
|
|
and
|
|
\emph on
|
|
User's Guide
|
|
\emph default
|
|
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_layout Enumerate
|
|
Contact the team at:
|
|
\begin_inset Newline newline
|
|
\end_inset
|
|
|
|
|
|
\begin_inset CommandInset href
|
|
LatexCommand href
|
|
target "lyx-docs@lists.lyx.org"
|
|
type "mailto:"
|
|
literal "false"
|
|
|
|
\end_inset
|
|
|
|
|
|
\begin_inset Newline newline
|
|
\end_inset
|
|
|
|
to discuss your intended changes and to get some feedback on them.
|
|
\end_layout
|
|
|
|
\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.
|
|
\end_layout
|
|
|
|
\end_body
|
|
\end_document
|