-#LyX 1.5.3svn created this file. For more info see http://www.lyx.org/
-\lyxformat 276
+#LyX 1.6.0rc1 created this file. For more info see http://www.lyx.org/
+\lyxformat 340
\begin_document
\begin_header
-\textclass book
+\textclass scrbook
\begin_preamble
-\usepackage{multicol}
-\newcommand{\extratablespace}[1]{\noalign{\vskip#1}}
+% DO NOT ALTER THIS PREAMBLE!!!
+%
+% This preamble is designed to ensure that the User's Guide prints
+% out as advertised. If you mess with this preamble,
+% parts of the User's Guide may not print out as expected. If you
+% have problems LaTeXing this file, please contact
+% the documentation team
+% email: lyx-docs@lists.lyx.org
% if pdflatex is used
\usepackage{ifpdf}
\ifpdf
-% set fonts for nicer pdf view
-\IfFileExists{lmodern.sty}
- {\usepackage{lmodern}} % if it exists
- {% if it exists not
- \usepackage[scaled=0.92]{helvet}
- \usepackage{mathptmx}
- \usepackage{courier}
- } % end if it exists not
-
-% link all cross references and URLs
-% in pdf output
- \usepackage[colorlinks=true, bookmarks, bookmarksnumbered, bookmarksopen, bookmarksopenlevel=1,
- linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,
- pdfpagelayout=OneColumn, pdfnewwindow=true,
- pdfstartview=XYZ, plainpages=false, pdfpagelabels,
- pdfauthor={LyX Team}, pdftex,
- pdftitle={LyX's Extended manual},
- pdfsubject={LyX's extended documentation},
- pdfkeywords={LyX, Documentation, Extended}]{hyperref}
-
-\else % if dvi or ps is produced
-
- % link all cross references and URLs in DVI output
- \usepackage[ps2pdf, colorlinks=true,
- linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue]{hyperref}
+ % set fonts for nicer pdf view
+ \IfFileExists{lmodern.sty}
+ {\usepackage{lmodern}}{}
\fi % end if pdflatex is used
+% the pages of the TOC are 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}}
+
% redefine the \LyX macro for PDF bookmarks
\def\LyX{\texorpdfstring{%
L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
{LyX }}
+
+% used for multi-column text
+\usepackage{multicol}
+
+% extra space for tables
+\newcommand{\extratablespace}[1]{\noalign{\vskip#1}}
\end_preamble
+\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage,tablecaptionabove
+\begin_modules
+logicalmkup
+theorems-ams
+theorems-ams-extended
+\end_modules
\language english
\inputencoding latin1
\font_roman default
\font_osf false
\font_sf_scale 100
\font_tt_scale 100
+
\graphics default
-\paperfontsize default
+\paperfontsize 12
\spacing single
+\use_hyperref true
+\pdf_title "LyX's Extended manual"
+\pdf_author "LyX Team"
+\pdf_subject "LyX's extended documentation"
+\pdf_keywords "LyX, Documentation, Extended"
+\pdf_bookmarks true
+\pdf_bookmarksnumbered true
+\pdf_bookmarksopen false
+\pdf_bookmarksopenlevel 1
+\pdf_breaklinks false
+\pdf_pdfborder false
+\pdf_colorlinks true
+\pdf_backref false
+\pdf_pagebackref false
+\pdf_pdfusetitle false
+\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, pdfpagelabels"
\papersize default
\use_geometry false
\use_amsmath 0
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\noindent
Principal maintainer of this file is
\noun on
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand tableofcontents
+\begin_inset CommandInset toc
+LatexCommand tableofcontents
\end_inset
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:lyxandlatex"
\end_inset
V
\bar default
iew\SpecialChar \menuseparator
-View\InsetSpace ~
+View
+\begin_inset space ~
+\end_inset
+
\emph on
Format
\begin_layout Standard
If you've run LaTeX using
\family sans
-View\InsetSpace ~
+View
+\begin_inset space ~
+\end_inset
+
DVI
\family default
, LyX then executes
on the DVI-file.
If you've used
\family sans
-View\InsetSpace ~
+View
+\begin_inset space ~
+\end_inset
+
PostScript
\family default
or
\begin_layout Itemize
For
\family sans
-View\InsetSpace ~
+View
+\begin_inset space ~
+\end_inset
+
PostScript
\family default
, the output file has the extension
\bar default
rint
\family default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
, the output file has the extension
\family typewriter
.ps
\begin_layout Section
Translating LaTeX files into LyX
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:Translating-LaTeX-files"
\end_inset
\end_layout
\begin_layout Standard
-If you just want to put a piece of LaTeX code into a LyX file, see Section\InsetSpace ~
+If you just want to put a piece of LaTeX code into a LyX file, see Section
+\begin_inset space ~
+\end_inset
-\begin_inset LatexCommand ref
+
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:latexcodes"
\end_inset
\begin_layout Section
Inserting LaTeX Code into LyX Documents
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:Inserting-LaTeX-Code"
\end_inset
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:latexcodes"
\end_inset
short sections of LaTeX commands.
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
% like this
\end_layout
\backslash
begin{tabular}{ll}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
begin{minipage}{5cm}
-\newline
+\begin_inset Newline newline
+\end_inset
+
This is an example for a minipage environment.
You
-\newline
+\begin_inset Newline newline
+\end_inset
+
can put nearly everything in it, even (non-floating)
-\newline
+\begin_inset Newline newline
+\end_inset
+
figures and tables.
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
end{minipage}
-\newline
+\begin_inset Newline newline
+\end_inset
+
&
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
begin{minipage}{5cm}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
begin{verbatim}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
begin{minipage}{5cm}
-\newline
+\begin_inset Newline newline
+\end_inset
+
This ...
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
end{minipage}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
end{verbatim}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
end{minipage}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
end{tabular}
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
begin{tabular}{ll}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
This is an example for a minipage environment.
You can put nearly everything in it, even (non-floating) figures and tables.
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
&
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
begin{verbatim}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
This ...
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
end{verbatim}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\bar under
d
\bar default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
Document
\family default
to include your file (you should select the type
\begin_inset Foot
status open
-\begin_layout Standard
+\begin_layout Plain Layout
Note from
\noun on
John Weiss
\end_layout
\begin_layout Standard
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:preamble"
\end_inset
\bar under
L
\bar default
-aTeX\InsetSpace ~
+aTeX
+\begin_inset space ~
+\end_inset
+
\bar under
P
\backslash
voffset
\family default
- are both 0 pt.,\InsetSpace ~
-i.\InsetSpace ~
-e.\InsetSpace ~
+ are both 0 pt.,
+\begin_inset space ~
+\end_inset
+
+i.
+\begin_inset space ~
+\end_inset
+
+e.
+\begin_inset space ~
+\end_inset
+
the page isn't shifted.
\end_layout
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Note from
\noun on
John Weiss
\begin_inset Quotes erd
\end_inset
- given in Chapter\InsetSpace ~
+ given in Chapter
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "cha:secrets"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
LyX will occasionally misguess where the error was.
This will typically happen with tables, figures, math, and the preamble.
\end_layout
\bar under
L
\bar default
-aTeX\InsetSpace ~
-Log\InsetSpace ~
+aTeX
+\begin_inset space ~
+\end_inset
+
+Log
+\begin_inset space ~
+\end_inset
+
File
\family default
.
\emph default
any of them, like trying to manually insert lots of
\family sans
-Protected\InsetSpace ~
+Protected
+\begin_inset space ~
+\end_inset
+
Blank
\family default
s,
\begin_layout Section
Preparing a Bibliography with BibTeX
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:Preparing-a-Bibliography"
\end_inset
STOP! If you don't know what BibTeX is, or have a reasonably good idea of
how to use it (
\emph on
-e.\InsetSpace \thinspace{}
+e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.
\emph default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
setting up your own bibliographic databases),
\emph on
run
\end_layout
\begin_layout Standard
-Standard BibTeX uses numbers (e.\InsetSpace \thinspace{}
-g.\InsetSpace \space{}
+Standard BibTeX uses numbers (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
\begin_inset Quotes eld
\end_inset
) to refer to a cited work.
However, in many scientific disciplines, other citation styles are in use.
- The most common one is the author-year style (e.\InsetSpace \thinspace{}
-g.\InsetSpace \space{}
+ The most common one is the author-year style (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
\begin_inset Quotes eld
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
See
-\begin_inset LatexCommand url
-target "ftp://ctan.tug.org/tex-archive/macros/latex/contrib/custom-bib/"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+ftp://ctan.tug.org/tex-archive/macros/latex/contrib/custom-bib/
+\end_layout
\end_inset
\begin_layout Subsection
Sectionated Bibliographies
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sub:Sectionated-Bibliographies"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Available from
-\begin_inset LatexCommand url
-target "ftp://ctan.tug.org/tex-archive/macros/latex/contrib/bibtopic/"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+ftp://ctan.tug.org/tex-archive/macros/latex/contrib/bibtopic/
+\end_layout
\end_inset
\begin_inset Quotes erd
\end_inset
-, you first need to create two bibliographic databases, e.\InsetSpace \thinspace{}
-g.\InsetSpace \space{}
+, you first need to create two bibliographic databases, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
\family typewriter
sources.bib
tab).
Check
\family sans
-Sectionated\InsetSpace ~
+Sectionated
+\begin_inset space ~
+\end_inset
+
bibliography
\family default
.
- Now you can insert multiple BibTeX references (as described in section\InsetSpace ~
+ Now you can insert multiple BibTeX references (as described in section
+\begin_inset space ~
+\end_inset
-\begin_inset LatexCommand ref
+
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:Preparing-a-Bibliography"
\end_inset
\end_layout
\begin_layout Standard
-Multiple bibliographies, e.\InsetSpace \thinspace{}
-g.\InsetSpace \space{}
-a bibliography for each section or chapter of
- the document, are not supported by BibTeX itself.
+Multiple bibliographies, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+a bibliography for each section or chapter of the document, are not supported
+ by BibTeX itself.
But the
\family typewriter
bibtopic
\family default
package, which is used for the creation of sectionated bibliographies in
- LyX (cf.\InsetSpace ~
-section\InsetSpace ~
+ LyX (cf.
+\begin_inset space ~
+\end_inset
+
+section
+\begin_inset space ~
+\end_inset
-\begin_inset LatexCommand ref
+
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sub:Sectionated-Bibliographies"
\end_inset
), provides an easy way to solve this task, if you are willing to use some
- LaTeX-Code (ERT, cf.\InsetSpace ~
-section\InsetSpace ~
+ LaTeX-Code (ERT, cf.
+\begin_inset space ~
+\end_inset
+
+section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:Inserting-LaTeX-Code"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
An alternative approach is to use the
\family typewriter
chapterbib
tab).
Check
\family sans
-Sectionated\InsetSpace ~
+Sectionated
+\begin_inset space ~
+\end_inset
+
bibliography
\family default
.
(those commands have to be inserted as ERT).
The bibliography will contain all references which have been cited in the
current btUnit.
- N.\InsetSpace \thinspace{}
+ N.
+\begin_inset space \thinspace{}
+\end_inset
+
B.: If you are using this approach, then
\emph on
every
\bar under
d
\bar default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
Document
\family default
.
\family sans
Don't
\family default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
\family sans
typeset
\end_inset
included file allows you to include a file typeset exactly as it appears
- in the file, i.e.\InsetSpace ~
-verbatim mode, with the characters set in a fixed-width
- typewriter font.
+ in the file, i.e.
+\begin_inset space ~
+\end_inset
+
+verbatim mode, with the characters set in a fixed-width typewriter font.
Normally, spaces in this file are invisible, though two consecutive spaces
are conserved, unlike LyX's normal treatment of spaces.
However, setting the
\bar under
M
\bar default
-ark\InsetSpace ~
-spaces\InsetSpace ~
-in\InsetSpace ~
+ark
+\begin_inset space ~
+\end_inset
+
+spaces
+\begin_inset space ~
+\end_inset
+
+in
+\begin_inset space ~
+\end_inset
+
output
\family default
checkbox typesets a mark to unambiguously define the presence of a space.
, as mentioned in the
\family sans
-User\InsetSpace ~
+User
+\begin_inset space ~
+\end_inset
+
Guide
\family default
.
You will now see your name in the upper left.
If a field has a default entry that you would like to get rid of (often
the page number appears in the central footer, simply include a command
- with a blank argument, e.\InsetSpace \thinspace{}
+ with a blank argument, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.
\end_layout
\begin_inset Quotes erd
\end_inset
- (e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-Section 3) in the upper left, the page number (e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-Page 4) in the upper
- right, your name in the lower left, and the date in the lower right.
+ (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space ~
+\end_inset
+
+Section 3) in the upper left, the page number (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space ~
+\end_inset
+
+Page 4) in the upper right, your name in the lower left, and the date in
+ the lower right.
The following commands should now appear in the preamble:
\end_layout
the footer can also be modified.
If you don't want one of the headers, set its thickness to 0.
The header rule has a default thickness of 0.4pt, the footer rule is 0pt.
- Use the commands, e.\InsetSpace \thinspace{}
+ Use the commands, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.
\family typewriter
\begin_layout Section
Itemize Bullet Selection
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:bullet"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Well, actually you can but you'll have to do it by hand.
\end_layout
\begin_inset Tabular
<lyxtabular version="3" rows="7" columns="2">
<features>
-<column alignment="center" valignment="top" leftline="true" width="0pt">
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0pt">
-<row topline="true" bottomline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top" width="0pt">
+<row>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family roman
\series medium
\end_inset
</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family roman
\series medium
\end_inset
</cell>
</row>
-<row topline="true">
+<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\series medium
\shape up
\end_inset
</cell>
</row>
-<row topline="true">
+<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family typewriter
\series medium
\end_inset
</cell>
</row>
-<row topline="true">
+<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family typewriter
\series medium
\end_inset
</cell>
</row>
-<row topline="true">
+<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family typewriter
\series medium
\end_inset
</cell>
</row>
-<row topline="true">
+<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family typewriter
\series medium
\end_inset
</cell>
</row>
-<row topline="true" bottomline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+<row>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family sans
\series medium
\end_inset
</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
-\begin_layout Standard
+\begin_layout Plain Layout
\family typewriter
\series medium
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
again afterwards.
In this itemized list the following LaTeX code was used to change the bullet
used for the first depth.
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family typewriter
\family typewriter
-\newline
+\begin_inset Newline newline
+\end_inset
+
\backslash
renewcommand
sharp
\backslash
)}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Note that the itemize depth is specified in Roman numerals as part of the
\begin_layout Itemize
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
[
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
You'll also need to revert the labelitem back to its previous setting for
the global bullet shape settings to remain in effect.
The way used here was:
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family typewriter
\end_layout
\begin_layout Section
+\begin_inset CommandInset label
+LatexCommand label
+name "sec:AMS-LaTeX"
+
+\end_inset
+
AMS LaTeX
\end_layout
\begin_layout Standard
by
\noun on
-David Johnson
+David Johnson; updated by Richard Heck
\end_layout
\begin_layout Standard
each journal (usually it will entail only changing a single line in the
TeX output).
That documentation is available on the Web at
-\begin_inset LatexCommand url
-target "http://www.ams.org"
+\begin_inset Flex URL
+status open
+
+\begin_layout Plain Layout
+
+http://www.ams.org
+\end_layout
\end_inset
or by ftp at
-\begin_inset LatexCommand url
-target "ftp://ftp.ams.org/pub/tex/amslatex/"
+\begin_inset Flex URL
+status open
-\end_inset
+\begin_layout Plain Layout
-.These layouts are appropriate, and useful, for any mathematical writing.
- There are currently 4 distinct AMS LaTeX layouts:
+ftp://ftp.ams.org/pub/tex/amslatex/
\end_layout
-\begin_layout Enumerate
-amsart: The standard AMS-article format.
- All results and similar statements are numbered as
-\begin_inset Formula $(n.m)$
\end_inset
-, where the first number refers to the section, and the second refers to
- the total number of results (Theorems, Corollaries, Propositions, Definitions
- and Remarks, etc.) in that section.
- There are also many (but not all) environments available unnumbered, which
- is occasionally needed.
- Unnumbered environments indicated by an asterisk at the end.
+.
+ These layouts are appropriate, and useful, for any mathematical writing.
+
\end_layout
-\begin_layout Enumerate
-amsart-seq: Here, numbering for each type of statement is in its own sequence,
- with no reference to the section number.
- There are also many (but not all) environments available unnumbered, which
- is occasionally needed.
- Unnumbered environments indicated by an asterisk at the end.
+\begin_layout Standard
+There are two basic AMS LaTeX layouts:
\end_layout
\begin_layout Enumerate
-amsart-plain: This one is even more terse, since all the environments are
- unnumbered.
+amsart: The standard AMS article format.
\end_layout
\begin_layout Enumerate
amsbook: the standard AMS book (really, monograph) format.
- Numbering is similar to the amsart layout, except that all numbering is
- by
-\begin_inset Formula $(n.m.p)$
-\end_inset
-
-, where the first number refers to the chapter, the second to the section,
- and the third is the number of the results (Theorems, Corollaries, Propositions
-, Definitions and Remarks, etc.) in that section.
- There are also many (but not all) environments available unnumbered, which
- is occasionally needed.
- Unnumbered environments indicated by an asterisk at the end.
+
\end_layout
\begin_layout Standard
-Any AMS LyX file can be converted to either of the numbering schemes by
- simply changing the document class in the
-\family sans
-\bar under
-D
-\bar default
-ocument\SpecialChar \menuseparator
+These layouts themselves contain only the minimum necessary to use the AMS
+ classes.
+ They do not, in particular, contain any of the `theorem' environments used
+ for setting theorems, lemmas, and the like.
+ These are contained, instead, in the
+\begin_inset Flex CharStyle:Code
+status collapsed
-\bar under
-S
-\bar default
-ettings
-\family default
- dialog.
-
+\begin_layout Plain Layout
+Theorems (AMS)
\end_layout
-\begin_layout Subsection
-What these layouts provide
+\end_inset
+
+ module, which you will need to load separately when you selected one of
+ the AMS classes.
+ Less commonly used environments are in the
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (AMS-Extended)
\end_layout
-\begin_layout Standard
-There is a long list of included environments provided by these layouts.
- Most mathematical papers or books will set as special statements most of
- these environments, in AMS-LaTeX there is an opportunity to define an unlimited
- variety of such declarations.
- However, the AMS recommends the environments that are available in LyX.
- The list of environments (not counting the standard environments such as
-
-\family sans
-sections, bibliography, title, author, date
-\family default
-), is:
+\end_inset
+
+ module.
+
+\end_layout
+
+\begin_layout Standard
+By default, theorems and the like are numbered consecutively throughout
+ the document, but this may be modified by loading the module
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (Order by Section)
\end_layout
-\begin_layout Description
-Theorem This is typically used for the statements of major results.
- The word
-\begin_inset Quotes eld
\end_inset
+ or, if you are using
+\begin_inset Flex CharStyle:Code
+status collapsed
-\family sans
-Theorem
-\family default
+\begin_layout Plain Layout
+book (AMS)
+\end_layout
-\begin_inset Quotes erd
\end_inset
- appears in bold type, along with an automatically-determined number (an
- unnumbered version,
-\family sans
-Theorem*
-\family default
-, is also available).
- The text is italicized.
-\end_layout
+, the module
+\begin_inset Flex CharStyle:Code
+status collapsed
-\begin_layout Description
-Corollary This is used for statements which follow fairly directly from
- previous statements.
- Again, these can be major results.
- Unnumbered version
-\family sans
-Corollary*
-\family default
- is available.
+\begin_layout Plain Layout
+Theorems (Order by Chapter)
\end_layout
-\begin_layout Description
-Lemma These are smaller results needed to prove other statements.
-\end_layout
+\end_inset
-\begin_layout Description
-Proposition These are less major results which (hopefully) add to the general
- theory being discussed.
-\end_layout
+.
+ These will number the results as
+\begin_inset Formula $n.m$
+\end_inset
-\begin_layout Description
-Conjecture These are statements provided without justification, which the
- author does not know how to prove, but which seem to be true (to the author,
- at least).
-\end_layout
+, where the first number refers to the section (or chapter) and the second
+ refers to the total number of results so far in that section (or chapter).
+ Many environments are also available unnumbered.
+ These are indicated by an asterisk at the end.
+ If you happen to want
+\emph on
+only
+\emph default
+ unnumbered results, the the module
+\begin_inset Flex CharStyle:Code
+status collapsed
-\begin_layout Description
-Criterion A required condition.
+\begin_layout Plain Layout
+Theorems (Starred)
\end_layout
-\begin_layout Description
-Algorithm A general procedure to be used.
+\end_inset
+
+ provides that option.
\end_layout
-\begin_layout Description
-Axiom This is a property or statement taken as true within the system being
- discussed.
+\begin_layout Standard
+Note that these modules do not
+\emph on
+have
+\emph default
+ to be used with the AMS classes.
+ It is perfectly possible to use the
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (AMS)
\end_layout
-\begin_layout Description
-Definition Guess what this is for.
- The font, both on-screen and in the output, is different for this environment
- than for the previous ones.
- The heading (
-\begin_inset Quotes eld
\end_inset
-definition
-\begin_inset Quotes erd
-\end_inset
+ module, and the others mentioned, with other classes, such as
+\begin_inset Flex CharStyle:Code
+status collapsed
-) is still set in boldface, along with the number, if any, but the rest
- is set upright.
+\begin_layout Plain Layout
+article
\end_layout
-\begin_layout Description
-Example Typeset similarly to Definition.
-\end_layout
+\end_inset
-\begin_layout Description
-Condition
-\end_layout
+,
+\begin_inset Flex CharStyle:Code
+status collapsed
-\begin_layout Description
-Problem
+\begin_layout Plain Layout
+report
\end_layout
-\begin_layout Description
-Exercise
+\end_inset
+
+,
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+book (KOMA-script)
\end_layout
-\begin_layout Description
-Remark This environment is also a new type of theorem.
- This is set with the word Remark in italics, and the rest upright.
+\end_inset
+
+, and so forth.
\end_layout
-\begin_layout Description
-Note Set similarly to the Remark environment.
+\begin_layout Subsection
+What these layouts provide
\end_layout
-\begin_layout Description
-Notation
+\begin_layout Standard
+There is a long list of included environments provided by these layouts.
+ In AMS-LaTeX, there is, in fact, an opportunity to define an unlimited
+ variety of `theorem' environments.
+ However, the AMS recommends the environments that are available in LyX.
+
\end_layout
-\begin_layout Description
-Claim
+\begin_layout Standard
+The following environments---as well as the standard environments, such
+ as
+\begin_inset Flex CharStyle:Noun
+status collapsed
+
+\begin_layout Plain Layout
+section
\end_layout
-\begin_layout Description
-Summary
+\end_inset
+
+,
+\begin_inset Flex CharStyle:Noun
+status collapsed
+
+\begin_layout Plain Layout
+bibliography
\end_layout
-\begin_layout Description
-Acknowledgement
+\end_inset
+
+,
+\begin_inset Flex CharStyle:Noun
+status collapsed
+
+\begin_layout Plain Layout
+title
\end_layout
-\begin_layout Description
-Case Generally, these are used to break up long arguments, using specific
- instances of some condition.
- The numbering scheme for cases is on its own, not together with other numbered
- statements.
-
+\end_inset
+
+,
+\begin_inset Flex CharStyle:Noun
+status collapsed
+
+\begin_layout Plain Layout
+author
\end_layout
-\begin_layout Description
-Conclusion
+\end_inset
+
+, and
+\begin_inset Flex CharStyle:Noun
+status collapsed
+
+\begin_layout Plain Layout
+date
\end_layout
-\begin_layout Description
-Fact
+\end_inset
+
+---are provided by
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+article (AMS)
\end_layout
-\begin_layout Description
-Proof The word
-\begin_inset Quotes eld
\end_inset
+ and
+\begin_inset Flex CharStyle:Code
+status collapsed
-\shape italic
-Proof
-\shape default
+\begin_layout Plain Layout
+book (AMS)
+\end_layout
-\begin_inset Quotes erd
\end_inset
- is set in italics, but the rest is set upright.
- At the end of this environment (other environments can be nested within
- this one, of course) a QED symbol (usually a square, but it can vary with
- different styles) is placed.
+:
\end_layout
\begin_layout Description
\end_layout
\begin_layout Description
-Current\InsetSpace ~
-Address This should be the author's temporary address at the time
- of submission, if different from the Address.
+Current
+\begin_inset space ~
+\end_inset
+
+Address This should be the author's temporary address at the time of submission,
+ if different from the Address.
\end_layout
\begin_layout Description
\end_layout
\begin_layout Standard
-In addition, these environments automatically provide the AMS LaTeX and
- AMS fonts packages.
+The following environments are provided by both the
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems
+\end_layout
+
+\end_inset
+
+ and
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (AMS)
+\end_layout
+
+\end_inset
+
+ modules, in the latter case in both starred (unnumbered) and unstarred
+ (numbered) versions.
+ These same environments are provided only in the starred versions by the
+
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (Starred)
+\end_layout
+
+\end_inset
+
+ module:
+\end_layout
+
+\begin_layout Theorem
+This is typically used for the statements of major results.
+
+\end_layout
+
+\begin_layout Corollary*
+This is used for statements which follow fairly directly from previous statement
+s.
+ Again, these can be major results.
+
+\end_layout
+
+\begin_layout Lemma
+These are smaller results needed to prove other statements.
+\end_layout
+
+\begin_layout Proposition
+These are less major results which (hopefully) add to the general theory
+ being discussed.
+\end_layout
+
+\begin_layout Conjecture
+These are statements provided without justification, which the author does
+ not know how to prove, but which seem to be true (to the author, at least).
+\end_layout
+
+\begin_layout Definition*
+Guess what this is for.
+ The font is different for this environment than for the previous ones.
+
+\end_layout
+
+\begin_layout Example*
+Used for examples illustrating proven results.
+\end_layout
+
+\begin_layout Problem
+It's not really known what this is for.
+ You should figure it out.
+\end_layout
+
+\begin_layout Exercise*
+Write a description for this one.
+\end_layout
+
+\begin_layout Remark
+This environment is also a type of theorem, usually a lesser sort of observation.
+\end_layout
+
+\begin_layout Claim*
+Often used in the course of giving a proof of a larger result.
+\end_layout
+
+\begin_layout Case
+Generally, these are used to break up long arguments, using specific instances
+ of some condition.
+
+\end_layout
+
+\begin_layout Case
+The numbering scheme for cases is on its own, not together with other numbered
+ statements.
+
+\end_layout
+
+\begin_layout Proof
+At the end of this environment , a QED symbol (usually a square, but it
+ can vary with different styles) is placed.
+ If you want to have other environments within this one---for example, Case
+ environments---and have the QED symbol appear only after them, then the
+ other environments need to be nested within the proof environment.
+ See section
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Nesting"
+
+\end_inset
+
+ of the
+\emph on
+User's Guide
+\emph default
+ for information on nesting.
+\end_layout
+
+\begin_layout Standard
+And these are provided by
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Theorems (AMS-Extended)
+\end_layout
+
+\end_inset
+
+:
+\end_layout
+
+\begin_layout Criterion*
+A required condition.
+\end_layout
+
+\begin_layout Algorithm*
+A general procedure to be used.
+\end_layout
+
+\begin_layout Axiom*
+This is a property or statement taken as true within the system being discussed.
+\end_layout
+
+\begin_layout Condition*
+Sometimes used to state a condition assumed within the present context of
+ discussion.
+\end_layout
+
+\begin_layout Note*
+Similar to a Remark.
+\end_layout
+
+\begin_layout Notation*
+Used for the explanation of, yes, notation.
+\end_layout
+
+\begin_layout Summary
+Do we really need to tell you?
+\end_layout
+
+\begin_layout Acknowledgement*
+Acknowledgement.
+\end_layout
+
+\begin_layout Conclusion*
+Sometimes used at the end of a long train of argument.
+\end_layout
+
+\begin_layout Fact
+Used in a way similar to Proposition, though perhaps lower on the scale.
+\end_layout
+
+\begin_layout Standard
+In addition, the AMS classes automatically provide the AMS LaTeX and AMS
+ fonts packages.
They need to be available on your system in order to use these environments.
\end_layout
\emph on
Astronomy and Astrophysics
\emph default
- (
-\begin_inset LatexCommand url
-name "www.edpsciences.fr/aa/"
-target "http://www.edpsciences.fr/aa/"
+ (www.edpsciences.fr/aa/
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.edpsciences.fr/aa/
+\end_layout
\end_inset
\begin_layout Standard
\align center
-\begin_inset LatexCommand url
-target "ftp://ftp.edpsciences.org/pub/aa/readme.html"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+ftp://ftp.edpsciences.org/pub/aa/readme.html
+\end_layout
\end_inset
\begin_layout Itemize
Don't change the option
\family sans
-Page\InsetSpace ~
+Page
+\begin_inset space ~
+\end_inset
+
style
\family default
: Leave it set to
\end_layout
\begin_layout Standard
-If you want to place footnotes in the header block, e.\InsetSpace \thinspace{}
-g.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
+If you want to place footnotes in the header block, e.
+\begin_inset space \thinspace{}
+\end_inset
-
-\backslash
-
-\end_layout
-
-\end_inset
+g.
+\begin_inset space ~
+\end_inset
to state your present address, just use the standard footnote via
\family sans
, therefore we won't tell much about it here.
Refer to the
\emph on
-User's\InsetSpace ~
+User's
+\begin_inset space ~
+\end_inset
+
Guide
\emph default
.
\bar under
P
\bar default
-aragraph\InsetSpace ~
+aragraph
+\begin_inset space ~
+\end_inset
+
Settings.
\end_layout
\bar under
S
\bar default
-pan\InsetSpace ~
+pan
+\begin_inset space ~
+\end_inset
+
columns
\family default
.
\bar under
S
\bar default
-pecial\InsetSpace ~
+pecial
+\begin_inset space ~
+\end_inset
+
Character
\bar under
\SpecialChar \menuseparator
H
\bar default
-orizontal\InsetSpace ~
+orizontal
+\begin_inset space ~
+\end_inset
+
Fill
\family default
.
\begin_layout Enumerate
Switch to LaTeX mode:
\family sans
-M-c\InsetSpace ~
+M-c
+\begin_inset space ~
+\end_inset
+
t
\family default
.
Position the cursor behind the caption text, switch to LaTeX mode and insert
the closing brace:
\family sans
-M-c\InsetSpace ~
+M-c
+\begin_inset space ~
+\end_inset
+
t
\family default
\begin_layout Standard
\align center
-\begin_inset LatexCommand url
-target "http://www.journals.uchicago.edu/AAS/AASTeX"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.journals.uchicago.edu/AAS/AASTeX
+\end_layout
\end_inset
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\bar under
d
\bar default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
Document
\family default
to include it in your LyX document.
\bar under
P
\bar default
-aragraph\InsetSpace ~
+aragraph
+\begin_inset space ~
+\end_inset
+
Settings
\family default
, then set the
\begin_layout Subsubsection
References
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "cite"
\end_inset
space between the last author and the parenthesis setting off the year;
\emph on
-e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
+e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space ~
+\end_inset
+
\emph default
type
\backslash
plotone
\family default
-, etc.\InsetSpace ~
-commands as ERT into a Figure Float box if you desire, but I never
- have much luck getting the layout right.
+, etc.
+\begin_inset space ~
+\end_inset
+
+commands as ERT into a Figure Float box if you desire, but I never have
+ much luck getting the layout right.
With the standard graphics, LyX will insert a
\family typewriter
, respectively.
These files, together with instructions for the authors, can be downloaded
from the sites
-\begin_inset LatexCommand url
-target "http://www.worldscinet.com/ijmpc/mkt/guidelines.shtml"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.worldscinet.com/ijmpc/mkt/guidelines.shtml
+\end_layout
\end_inset
and
-\begin_inset LatexCommand url
-target "http://www.worldscinet.com/ijmpd/mkt/guidelines.shtml"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.worldscinet.com/ijmpd/mkt/guidelines.shtml
+\end_layout
\end_inset
\family typewriter
refcite
\family default
- command, e.\InsetSpace \thinspace{}
+ command, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.,
\begin_inset Quotes eld
\end_inset
-See Ref.\InsetSpace ~
+See Ref.
+\begin_inset space ~
+\end_inset
+
\family typewriter
\bar under
d
\bar default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
Document
\family default
).
\begin_inset Foot
status open
-\begin_layout Standard
+\begin_layout Plain Layout
Actually you have the choice between LaTeX (plain) and pdflatex.
If you intend to use pdflatex to prepare the paper, you should use the
pdflatex option so that included graphics are converted to PDF format,
submission to the journals published by the Institute of Physics.
Instructions for the authors how to create a paper using the iopart class
can be downloaded together with the iopart package from the site
-\begin_inset LatexCommand url
-target "ftp://ftp.iop.org/pub/journals/latex2e"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+ftp://ftp.iop.org/pub/journals/latex2e
+\end_layout
\end_inset
Solar Physics
\emph default
, but there are many others (see a complete list at
-\begin_inset LatexCommand url
-target "http://www.wkap.nl/jrnllist.htm/JRNLHOME"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.wkap.nl/jrnllist.htm/JRNLHOME
+\end_layout
\end_inset
).
The Kluwer package may be downloaded from the site
-\begin_inset LatexCommand url
-target "http://www.wkap.nl/kaphtml.htm/STYLEFILES"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.wkap.nl/kaphtml.htm/STYLEFILES
+\end_layout
\end_inset
\begin_inset Quotes erd
\end_inset
- commands of the package (see\InsetSpace ~
+ commands of the package (see
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "subsec:kluwer_peculiarities"
\end_inset
\family typewriter
.dvi
\family default
- document using, e.\InsetSpace \thinspace{}
+ document using, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.,
\family sans
xdvi
\end_inset
of the Kluwer package
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "subsec:kluwer_peculiarities"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
I can't imagine any good reason to do this.
\end_layout
\end_inset
.
- This is not implemented in LyX, so you must enter title, subtitle etc.\InsetSpace ~
-between
- two ERT lines (
+ This is not implemented in LyX, so you must enter title, subtitle etc.
+\begin_inset space ~
+\end_inset
+
+between two ERT lines (
\family typewriter
\backslash
\family typewriter
scrlettr.cls
\family default
-, resp.\InsetSpace ~
+, resp.
+\begin_inset space ~
+\end_inset
+
of the Koma-Script family.
They are replacements for the standard document classes
\family typewriter
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
There is a big difference between the bold sans serif old cm fonts and new
ec fonts, especially in the appearance of headings.
In comparison, the ec bold sans serif fonts look a bit thin.
\bar under
x
\bar default
-tra\InsetSpace ~
+tra
+\begin_inset space ~
+\end_inset
+
Options
\family default
of the dialog
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
There is an English translation
\emph on
screnggu
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
There is also an
\family typewriter
Dictum
\family default
: can be used to set a bonmot, e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+\begin_inset space \thinspace{}
\end_inset
g.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
at the beginning of a chapter.
I
\bar default
nsert\SpecialChar \menuseparator
-Short\InsetSpace ~
+Short
+\begin_inset space ~
+\end_inset
+
Title
\family default
), you can insert the dictum's author there.
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The corresponding LaTeX commands must appear before the
\family typewriter
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
For example, the standard appearance of the letter`s heading, consisting
of name and address, is quite self-willed.
An
\shape italic
O
\shape default
-, resp.\InsetSpace ~
+, resp.
+\begin_inset space ~
+\end_inset
+
in the left margin.
It is possible to write any number of letters in one file.
An
\begin_inset Foot
status open
-\begin_layout Standard
+\begin_layout Plain Layout
It could be seen as a matter of inconsequence, that the types
\family sans
Letter
\begin_layout Standard
The input types can also be used as empty paragraphs.
- This makes sense e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
+ This makes sense e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space ~
+\end_inset
+
for the
\family sans
Signature
NextAddress
\family default
will start a new letter (i.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+\begin_inset space \thinspace{}
\end_inset
e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
you can write several letters per document).
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The KOMA package comes with some default
\family typewriter
*.lco
\bar under
T
\bar default
-able\InsetSpace ~
-of\InsetSpace ~
+able
+\begin_inset space ~
+\end_inset
+
+of
+\begin_inset space ~
+\end_inset
+
Contents
\family default
).
\begin_layout Standard
These are the layout files for some of the journal formats used by Springer
Verlag and listed on
-\begin_inset LatexCommand url
-target "http://www.springer.de/author/tex/help-journals.html"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.springer.de/author/tex/help-journals.html
+\end_layout
\end_inset
\family typewriter
svjour.inc
\family default
-, which journal-specific layout files (such as, e.\InsetSpace \thinspace{}
+, which journal-specific layout files (such as, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.,
\family typewriter
svjog.layout
\end_layout
\begin_layout Standard
-Limitations e.\InsetSpace \thinspace{}
-g.: does not display the number for theorem-like layouts, just
- #.
+Limitations e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.: does not display the number for theorem-like layouts, just #.
\end_layout
\begin_layout Section
Society.
It is assumed that you have both the AGU's own class files and AGUplus
installed (everything to be found at
-\begin_inset LatexCommand url
-target "ftp://ftp.agu.org/journals/latex/journals"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+ftp://ftp.agu.org/journals/latex/journals
+\end_layout
\end_inset
egs.cls
\family default
can be downloaded from the web site of the EGS under
-\begin_inset LatexCommand url
-target "www.copernicus.org"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+www.copernicus.org
+\end_layout
\end_inset
Sli
\noun default
TeX]
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:slitex"
\end_inset
\begin_inset Quotes erd
\end_inset
-, check out section\InsetSpace ~
+, check out section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:foiltex"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\SpecialChar \ldots{}
or so I've been told repeatedly by its advocates.
Having never used it, I have no idea if this claim is true or not.
\begin_layout Subsection
Getting Started
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:slidesetup"
\end_inset
\bar under
P
\bar default
-age\InsetSpace ~
+age
+\begin_inset space ~
+\end_inset
+
style
\family default
behaves a bit differently for this class.
Note
\family default
s.
- See section\InsetSpace ~
+ See section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:slideNote"
\end_inset
F
\bar default
ile\SpecialChar \menuseparator
-New\InsetSpace ~
-from\InsetSpace ~
+New
+\begin_inset space ~
+\end_inset
+
+from
+\begin_inset space ~
+\end_inset
+
\bar under
T
in the
\family sans
-Sans\InsetSpace ~
+Sans
+\begin_inset space ~
+\end_inset
+
Serif
\family default
font.
\begin_layout Subsubsection
Quirks of the New Environments
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:slideQuirk"
\end_inset
\family sans
Slide
\family default
- environment [in the manner described in section\InsetSpace ~
+ environment [in the manner described in section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:slideQuirk"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Presumably, mutliple
\family sans
Overlay
\begin_inset Quotes erd
\end_inset
-, etc.\InsetSpace ~
+, etc.
+\begin_inset space ~
+\end_inset
+
appended to the page number of the parent
\family sans
Slide
\family default
are two command-like paragraph environments that make all subsequent text
invisible and visible, respectively.
- Note from section\InsetSpace ~
+ Note from section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:slideQuirk"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The commands of interest are:
\end_layout
}
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\SpecialChar \ldots{}
and need to be marked as TeX.
The text whose
Slide
\family default
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:slideNote"
\end_inset
\begin_inset Quotes erd
\end_inset
- [see section\InsetSpace ~
+ [see section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:slidesetup"
\end_inset
F
\bar default
ile\SpecialChar \menuseparator
-New\InsetSpace ~
-from\InsetSpace ~
+New
+\begin_inset space ~
+\end_inset
+
+from
+\begin_inset space ~
+\end_inset
+
\bar under
T
onlyslides{
\backslash
slides}
-\newline
+\begin_inset Newline newline
+\end_inset
+
\end_layout
\family sans
Foils
\family default
- class [see section\InsetSpace ~
+ class [see section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:foiltex"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Perhaps you can take on the task\SpecialChar \ldots{}
\end_layout
TeX
\noun default
]
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:foiltex"
\end_inset
\begin_inset Quotes erd
\end_inset
-, check out section\InsetSpace ~
+, check out section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:slitex"
\end_inset
\family default
entry in the
\family sans
-Document\InsetSpace ~
+Document
+\begin_inset space ~
+\end_inset
+
Layout
\family default
dialog.
There are some settings in the
\family sans
-Document\InsetSpace ~
+Document
+\begin_inset space ~
+\end_inset
+
Layout
\family default
dialog that you should know about that are specific to this class:
\family default
on the
\family sans
-Document\InsetSpace ~
+Document
+\begin_inset space ~
+\end_inset
+
Layout
\family default
dialog.
\family default
TeX provides extensive footer and header capabilities including a user-defined
logo.
- See section\InsetSpace ~
+ See section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:foilfoot"
\end_inset
\end_layout
\begin_deeper
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMM
\family sans
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMM
\family sans
No other headings or footers (other than footnotes).
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMM
\series bold
This is also the default.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMM
\series bold
dialog.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
this medium.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
title page.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
title page.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
foils.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
environments (don't worry these are described in the next section).
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
Equation numbers on the left.
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Itemize
\family sans
-My\InsetSpace ~
+My
+\begin_inset space ~
+\end_inset
+
Logo
\end_layout
\begin_layout Itemize
\family sans
-Right\InsetSpace ~
+Right
+\begin_inset space ~
+\end_inset
+
Footer
\end_layout
\begin_layout Itemize
\family sans
-Right\InsetSpace ~
+Right
+\begin_inset space ~
+\end_inset
+
Header
\end_layout
\begin_layout Itemize
\family sans
-Left\InsetSpace ~
+Left
+\begin_inset space ~
+\end_inset
+
Header
\end_layout
\begin_deeper
\begin_layout Standard
-\InsetSpace ~
+\begin_inset space ~
+\end_inset
+
\end_layout
\end_deeper
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
Foil
\family default
TeX that aren't directly supported by LyX but I'll tell you what they do
- and how to use them in section\InsetSpace ~
+ and how to use them in section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:unsuppfoils"
\end_inset
If you intend to use itemized lists you might also want to read about the
\family sans
-Itemize\InsetSpace ~
-Bullet\InsetSpace ~
+Itemize
+\begin_inset space ~
+\end_inset
+
+Bullet
+\begin_inset space ~
+\end_inset
+
Selection
\family default
- dialog described above in section\InsetSpace ~
+ dialog described above in section
+\begin_inset space ~
+\end_inset
-\begin_inset LatexCommand ref
+
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:bullet"
\end_inset
\begin_layout Subsubsection
Page Headers and Footers
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:foilfoot"
\end_inset
\begin_layout Standard
\family sans
-My\InsetSpace ~
+My
+\begin_inset space ~
+\end_inset
+
Logo
\family default
and
While the second is meant to provide a classification for the audience,
\emph on
-e.\InsetSpace \thinspace{}
+e.
+\begin_inset space \thinspace{}
+\end_inset
+
g.
\emph default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
Confidential.
It is empty by default.
\end_layout
\begin_layout Standard
The remaining page corners can be filled by
\family sans
-Right\InsetSpace ~
+Right
+\begin_inset space ~
+\end_inset
+
Footer
\family default
(which defaults to page numbers),
\family sans
-Right\InsetSpace ~
+Right
+\begin_inset space ~
+\end_inset
+
Header
\family default
(top right) and
\family sans
-Left\InsetSpace ~
-Header
+Left
+\begin_inset space ~
+\end_inset
+
+Header
\family default
(top left).
\end_layout
Foil
\family default
TeX Goodies
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sec:unsuppfoils"
\end_inset
The spacings around floats can be adjusted by setting these lengths:
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
Separation between the text and the top of the float
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
Separation between the float and the caption
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
Separation between the caption and the following text
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
if you have a long title or several authors:
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
Title
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
environments
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
lines
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
Date
\end_layout
-\begin_layout List
+\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\family default
page style setting in the
\family sans
-Document\InsetSpace ~
+Document
+\begin_inset space ~
+\end_inset
+
Layout
\family default
dialog you should probably add
\family sans
Standard
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Used where nothing else works.
FADE_IN
\family default
:
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
\family sans
M-z S-I
\family default
-\newline
+\begin_inset Newline newline
+\end_inset
+
Usually followed by something like
\begin_inset Quotes eld
\end_inset
\family sans
INT:
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z i
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Introduces a new INTERIOR camera set-up.
\family sans
EXT:
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z e
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Introduces a new EXTERIOR camera set-up.
\family sans
Speaker
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z s
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
The character speaking.
\family sans
Parenthetical
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z p
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Instructions to the speaker.
\family sans
Dialogue
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z d
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
What the
\family sans
Transition
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z t
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Camera movement instruction.
- e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
+ e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space ~
+\end_inset
+
CUT TO:
\end_layout
\family sans
FADE OUT:
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-I
\end_layout
\family sans
Author
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-A
\end_layout
\family sans
Title
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-T
\end_layout
\family sans
Right_Address
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z r
\end_layout
\family sans
Standard
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
You should not have to use this, but it is here for anything that does not
\family sans
Narrative
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z n
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Used to describe stage setting and the action.
\family sans
ACT
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z a
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Automatically numbered.
\family sans
ACT*
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S at
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Subtitle for
\family sans
SCENE
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-S
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Not automatically numbered.
\family sans
AT_RISE:
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-R
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
A special case of Narrative to describe the setting and action as the curtain
\family sans
Speaker
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z s
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
The speaker's (actor's) title, centered in all CAPS.
\family sans
Parenthetical
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z p
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
Instructions to the speaker.
\family sans
Dialogue
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z d
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
What the Speaker says.
\family sans
CURTAIN
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-C
-\newline
+\begin_inset Newline newline
+\end_inset
+
\family default
The curtain comes down.
\family sans
Title
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-T
\end_layout
\family sans
Author
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z S-A
\end_layout
\family sans
Right_Address
-\hfill
+\begin_inset space \hfill{}
+\end_inset
+
M-z r
\end_layout
\noindent
The
\family sans
-Revtex\InsetSpace ~
+Revtex
+\begin_inset space ~
+\end_inset
+
4
\family default
textclass works with the American Physical Sociey's RevTeX 4.0 (the
Since RevTeX 4.0 has been designed to work much more cleanly with LaTeX2e,
LyX with the
\family sans
-RevTeX\InsetSpace ~
+RevTeX
+\begin_inset space ~
+\end_inset
+
4
\family default
textclass should also be pretty easy to use.
\begin_layout Standard
All you need to do is install RevTeX 4, as described in the package's README
file.
- The package can be found at
-\begin_inset LatexCommand url
-name "The RevTeX 4 Web Site"
-target "http://publish.aps.org/revtex4/"
+ The package can be found at The RevTeX 4 Web Site
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://publish.aps.org/revtex4/
+\end_layout
\end_inset
\family default
, or to use the
\family sans
-Revtex\InsetSpace ~
+Revtex
+\begin_inset space ~
+\end_inset
+
4
\family default
template, found in the templates directory.
\bar under
x
\bar default
-tra\InsetSpace ~
+tra
+\begin_inset space ~
+\end_inset
+
Options
\family default
field in the
\family sans
-Document\InsetSpace ~
+Document
+\begin_inset space ~
+\end_inset
+
Layout
\family default
dialog, as usual.
\backslash
draft
\family default
- etc.\InsetSpace ~
+ etc.
+\begin_inset space ~
+\end_inset
+
goes in the
\family sans
La
\family default
T
\family sans
-eX\InsetSpace ~
+eX
+\begin_inset space ~
+\end_inset
+
Preamble
\family default
dialog, also as usual.
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
In case you're curious, both were included so that
\family typewriter
tex2lyx
\begin_layout Standard
Also, the
\family sans
-Author\InsetSpace ~
+Author
+\begin_inset space ~
+\end_inset
+
Email
\family default
,
\family sans
-Author\InsetSpace ~
+Author
+\begin_inset space ~
+\end_inset
+
URL
\family default
, and
to the Section layouts either.) This means that after you export that file
to LaTeX (which you'll need to do eventually to send it in to APS), you'll
need to edit the LaTeX file with a text editor to add the optional arguments
- to set, e.\InsetSpace \thinspace{}
+ to set, e.
+\begin_inset space \thinspace{}
+\end_inset
+
g., the running title for the page headers.
Lacking these layouts makes the
\family typewriter
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\emph on
Note from JMarc:
\begin_inset OptArg
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The
\family typewriter
mw
\family default
) for submitting articles to their various journals.
The style file can be downloaded directly from their web site:
-\begin_inset LatexCommand url
-target "http://authors.elsevier.com/"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://authors.elsevier.com/
+\end_layout
\end_inset
\begin_inset Quotes erd
\end_inset
- a
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-LaTeX
-\end_layout
-
-\end_inset
-
- file as possible, as their intention is to take the supplied file and replace
- the class file with one for the particular journal to which the paper has
- been submitted.
+ a LaTeX file as possible, as their intention is to take the supplied file
+ and replace the class file with one for the particular journal to which
+ the paper has been submitted.
This also means that not too much time should be spent on the formating
of the document.
When it comes to be published, this will change anyway.
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
You are invited to send suggestions to
-\begin_inset LatexCommand url
-target "lyx-devel@lists.lyx.org"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+lyx-devel@lists.lyx.org
+\end_layout
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Cf.
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\end_inset
-section\InsetSpace ~
+section
+\begin_inset space ~
+\end_inset
+
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:Inserting-LaTeX-Code"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Cf.
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\end_inset
-\begin_inset LatexCommand url
-target "CTAN:/macros/latex/memoir/memman.pdf"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+CTAN:/macros/latex/memoir/memman.pdf
+\end_layout
\end_inset
\end_layout
\begin_layout Description
-Font\InsetSpace ~
-sizes: Memoir has a broader range of font sizes: 9, 10, 11, 12, 14,
- 17
+Font
+\begin_inset space ~
+\end_inset
+
+sizes: Memoir has a broader range of font sizes: 9, 10, 11, 12, 14, 17
\end_layout
\begin_layout Description
-Page\InsetSpace ~
-style: The fancy page style is not supported, due to a command clash
- between Memoir and the fancyhdr package (they are both defining a command
- with the same name, which confuses LaTeX).
+Page
+\begin_inset space ~
+\end_inset
+
+style: The fancy page style is not supported, due to a command clash between
+ Memoir and the fancyhdr package (they are both defining a command with
+ the same name, which confuses LaTeX).
Instead, Memoir comes with a bunch of own page styles (see
\family sans
Layout\SpecialChar \menuseparator
Document\SpecialChar \menuseparator
-Page\InsetSpace ~
+Page
+\begin_inset space ~
+\end_inset
+
Style
\family default
).
chapterstyle
\family default
in the main text or in preamble (e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+\begin_inset space \thinspace{}
\end_inset
g.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
In LyX, you can do this via
\family sans
Insert\SpecialChar \menuseparator
-Short\InsetSpace ~
+Short
+\begin_inset space ~
+\end_inset
+
Title
\family default
at the beginning of a chapter/section.
\begin_inset Quotes erd
\end_inset
-, i.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+, i
+\begin_inset space \thinspace{}
\end_inset
e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
without pagina).
\family sans
Layout\SpecialChar \menuseparator
Document\SpecialChar \menuseparator
-Extra\InsetSpace ~
+Extra
+\begin_inset space ~
+\end_inset
+
Options
\family default
), you can emulate article style.
\begin_layout Description
Oldfontcommands: By default, Memoir does not allow the use of the deprecated
font commands, which have been used in the old LaTeX version 2.09 (e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+\begin_inset space \thinspace{}
\end_inset
g.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Cf.
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\end_inset
-\begin_inset LatexCommand url
-target "CTAN:/macros/latex/memoir/memman.pdf"
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+CTAN:/macros/latex/memoir/memman.pdf
+\end_layout
\end_inset
Chapterprecis: You may know this from belletristic: The contents of a chapter
is shortly described below the title and also in the table of contents
(e.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-,
-\end_layout
-
+\begin_inset space \thinspace{}
\end_inset
g.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-
-\end_layout
-
+\begin_inset space ~
\end_inset
\end_layout
\begin_layout Chapter
-Importing and Exporting Alternate File Formats
-\begin_inset OptArg
-status collapsed
+LyX Features needing Extra Software
+\end_layout
+
+\begin_layout Section
+Checking TeX
+\end_layout
\begin_layout Standard
-Importing and Exporting
+by
+\noun on
+Asger Alstrup
+\end_layout
+
+\begin_layout Subsection
+Introduction
\end_layout
+\begin_layout Standard
+When you to have the
+\family typewriter
+chktex
+\family default
+ program installed, you'll find in the
+\family sans
+Tools
+\family default
+ menu the entry
+\family sans
+Check
+\begin_inset space ~
\end_inset
+TeX
+\family default
+ command.
+ You can get
+\family typewriter
+chktex
+\family default
+ it from CTAN,
+\begin_inset CommandInset href
+LatexCommand href
+target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html"
+
+\end_inset
+.
\end_layout
-\begin_layout Section
-Considerations
+\begin_layout Standard
+The
+\family sans
+ChkTeX
+\family default
+ package is a program that was written by
+\noun on
+Jens T.
+ Berger Thielemann
+\noun default
+ in frustration because some constructs in LaTeX are sometimes non-intuitive,
+ and easy to forget.
+ The program runs over your LaTeX file and checks the integrity of the file,
+ and flags some common errors.
+ In other technical words, it is
+\family typewriter
+Lint
+\family default
+ for LaTeX.
\end_layout
\begin_layout Standard
-Importing and exporting LyX documents from/to other formats has been touched
- on briefly in the
+Well, what is a syntax checker doing in LyX which is supposed to produce
+ correct LaTeX anyways? The answer is simple: Just as
+\family typewriter
+Lint
+\family default
+ not only checks the
\emph on
-User Guide
+syntax
\emph default
-.
- Here we describe more of the gory details needed to understand just what
- is going on when you click on the
+ of C programs, but also does
+\emph on
+semantic
+\emph default
+ checks for type-errors,
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-I
-\bar default
-mport
+ChkTeX
\family default
- and
+ catches some common
+\emph on
+typographic
+\emph default
+ errors, in addition to the syntactical ones.
+ Specifically,
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-E
-\bar under
-x
-\bar default
-port
+ChkTeX
\family default
- menu items.
-
+ is capable of detecting several common errors, such as
\end_layout
-\begin_layout Section
-Importing Other Formats
+\begin_layout Itemize
+Ellipsis detection:
+\begin_inset Newline newline
+\end_inset
+
+Use \SpecialChar \ldots{}
+ instead of ...
\end_layout
-\begin_layout Subsection
-LaTeX
+\begin_layout Itemize
+No space in front of/after parenthesis:
+\begin_inset Newline newline
+\end_inset
+
+( wrong spacing )
\end_layout
-\begin_layout Standard
-Translating from LaTeX into LyX is performed by a converter program called
+\begin_layout Itemize
+Enforcement of normal space after common abbreviations:
+\begin_inset Newline newline
+\end_inset
+
+e.
+ g.
+ is too wide spacing.
+\end_layout
+
+\begin_layout Itemize
+Enforcement of end-of-sentence space when the last sentence ends with a
+ capital letter:
+\begin_inset Newline newline
+\end_inset
+
+This is a TEST.
+ And this is wrong spacing.
+\end_layout
+
+\begin_layout Itemize
+Space in front of labels and similar commands:
+\begin_inset Newline newline
+\end_inset
+
+The label should stick right up to the text to avoid falling to a wrong
+ page.
-\family typewriter
-tex2lyx
-\family default
-.
- Although it is a standalone program which can be called from the command
- line, LyX will call it automatically when a LaTeX document is imported.
- See section\InsetSpace ~
+\begin_inset CommandInset label
+LatexCommand label
+name "sec:chktex"
+
+\end_inset
+
+
+\begin_inset Foot
+status collapsed
-\begin_inset LatexCommand ref
-reference "sec:Translating-LaTeX-files"
+\begin_layout Plain Layout
+This footnote is in danger of falling off to a wrong page
+\end_layout
\end_inset
- for a complete description.
+ The label is separated too much.
\end_layout
-\begin_layout Subsection
-ASCII Text
+\begin_layout Itemize
+Space in front of references, instead of hard spaces:
+\begin_inset Newline newline
+\end_inset
+
+In you are in bad luck, the text will break right between the referenced
+ text and reference number, and that's a pity.
+ See section
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:chktex"
+
+\end_inset
+
+.
\end_layout
-\begin_layout Standard
-When importing plain ASCII text, there are two methods of reading the file.
- Importing
+\begin_layout Itemize
+Use of
\begin_inset Quotes eld
\end_inset
-as lines
+x
\begin_inset Quotes erd
\end_inset
- preserves all the linebreaks in the ASCII; to LyX, then, each line looks
- like a paragraph.
- Importing
-\begin_inset Quotes eld
+ instead of
+\begin_inset Formula $\times$
\end_inset
-as paragraphs
-\begin_inset Quotes erd
+ between numbers:
+\begin_inset Newline newline
\end_inset
- assumes that consecutive lines separated by only a single linebreak form
- a single paragraph.
- Successive linebreaks with no intervening text are thus assumed to be paragraph
- delimiters.
-\end_layout
+2x2 looks cheap compared to
+\begin_inset Formula $2\times2$
+\end_inset
-\begin_layout Subsection
-Noweb
+.
\end_layout
\begin_layout Standard
+and more \SpecialChar \ldots{}
+ It is an invaluable tool when you are
+\begin_inset Quotes eld
+\end_inset
-\emph on
-[Editor's note: Needs to be written, obviously - any volunteers? --- mer]
-\end_layout
-
-\begin_layout Section
-Exporting Other Formats
-\end_layout
+finishing up
+\begin_inset Quotes erd
+\end_inset
-\begin_layout Standard
-The output formats listed here in the following are also explained concerning
- possible graphics formats in the
-\emph on
-Embedded Objects
-\emph default
- manual.
+ your document before printing, and you should run it right after the obligatory
+ spelling check, and before you go fine tuning the typesetting.
\end_layout
\begin_layout Subsection
-LaTeX
+How to use it
\end_layout
\begin_layout Standard
-LyX generates two types of LaTeX files: stripped down versions for the normal
- processing (
-\family sans
-View DVI
-\family default
-, etc.) which one normally never sees
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-The resulting file is a perfectly valid LaTeX file, though the preamble
- might look a bit strange since it includes some definitions used by LyX
- which wouldn't show up in most human-written files.
-\end_layout
-
-\end_inset
-
-, and human readable forms which are suitable for exchanging with your colleague
-s.
- The only settable option for the translation is the line length of the
- output file.
- The default is 65 characters, but it can be set in
+If you have the program installed, usage is as simple as choosing
\family sans
\bar under
T
\bar default
-ools
-\family default
-\SpecialChar \menuseparator
+ools\SpecialChar \menuseparator
-\family sans
\bar under
-P
+C
\bar default
-references
+heck
+\begin_inset space ~
+\end_inset
+
+TeX
\family default
- using the
+.
+ This will make LyX generate a LaTeX file of your document, start
\family sans
-\bar under
-A
-\bar default
-scii\InsetSpace ~
-line\InsetSpace ~
-length
+ChkTeX
\family default
- field.
-
-\end_layout
-
-\begin_layout Subsection
-Device Independent Files
-\end_layout
-
-\begin_layout Standard
-Device Independent files (DVI files) are produced by running LaTeX on your
- document.
- There are no user settable options.
-\end_layout
+ to check it, and then make LyX insert
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Subsection
-PostScript
-\end_layout
+error boxes
+\begin_inset Quotes erd
+\end_inset
-\begin_layout Standard
-The next step in the conversion chain is converting a DVI file into Postscript.
- You can either use
+ with the warnings from
+\family sans
+ChkTeX
+\family default
+, if there were any.
+ The warnings will be placed close to the point of the mistake, and you
+ can quickly find them by using the
\family sans
\bar under
-F
+N
\bar default
-ile
-\family default
-\SpecialChar \menuseparator
+avigate\SpecialChar \menuseparator
-\family sans
\bar under
E
\bar default
-xport
-\family default
-\SpecialChar \menuseparator
-
-\family sans
-Pos
-\bar under
-t
-\bar default
-script
-\family default
- or, if you need more control on the result,
-\family sans
-\bar under
-F
-\bar default
-ile
-\family default
-\SpecialChar \menuseparator
-
-\family sans
-\bar under
-P
-\bar default
-rint
-\family default
-.
- If you use the later, note that it is possible to configure, in
-\family sans
-\bar under
-T
-\bar default
-ools
-\family default
-\SpecialChar \menuseparator
-
-\family sans
-\bar under
-P
-\bar default
-references
-\family default
-, the options passed to the dvips program to achieve different effects.
-\end_layout
-
-\begin_layout Subsection
-ASCII text
-\end_layout
-
-\begin_layout Standard
-Exporting as ASCII attempts to preserve the
-\begin_inset Quotes eld
-\end_inset
-
-shape
-\begin_inset Quotes erd
-\end_inset
-
- of the document as well as possible, but things like centering and indentation
- are thrown out; paragraphs are separated by blank lines.
- Section numbering and cross-references are done correctly, so the resulting
- text files is remarkably readable.
- The only changeable option is the length of lines, as for LaTeX output.
-\end_layout
-
-\begin_layout Subsection
-HTML
-\end_layout
-
-\begin_layout Standard
-LyX documents can be converted to hypertext markup, usually by converting
- to LaTeX first, then converting that to HTML\SpecialChar \@.
- Four LaTeX
-\begin_inset Formula $\rightarrow$
-\end_inset
-
-HTML converters are currently known to LyX:
-\family typewriter
-tth
-\family default
-,
-\family typewriter
-latex2html
-\family default
-,
-\family typewriter
-hevea
-\family default
- and
-\family typewriter
-htlatex
-\family default
-.
- Though they are autodetected, you can overide the selection in preferences.
- You can also include further command line options in this dialog.
-
-\end_layout
-
-\begin_layout Subsection
-PDF
-\end_layout
-
-\begin_layout Standard
-by
-\noun on
-Dekel Tsur
-\noun default
- (mostly)
-\end_layout
-
-\begin_layout Standard
-\begin_inset VSpace bigskip
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-The fastest way to generate a basic PDF file (no tags, links, etc.) with
- any version of LyX is to save the document as a Postscript file, then run
- the
-\family typewriter
-ps2pdf
-\family default
- command on it.
- Starting with version 1.1.6, the menu item
-\family sans
-File->Export->PDF
-\family default
- will do all this for you.
- There are some issues with fonts that you need to pay attention to: see
- Section\InsetSpace ~
-
-\begin_inset LatexCommand ref
-reference "sec:badfonts"
-
-\end_inset
-
-.
- Also, as of version 1.1.6, there is a better method that will generate much
- more sophisticated files.
-\end_layout
-
-\begin_layout Subsubsection
-Use pdfLaTeX
-\end_layout
-
-\begin_layout Standard
-With pdfLaTeX you cannot use pstricks.
- On the other hand, with pdfLaTeX it is possible to insert directly images
- in JPEG, PDF or PNG format, use TrueType fonts, and more.
-\end_layout
-
-\begin_layout Subsubsection
-Why does the text look so bad when viewed with Acrobat Reader?
-\begin_inset LatexCommand label
-name "sec:badfonts"
-
-\end_inset
-
-
-\begin_inset OptArg
-status collapsed
-
-\begin_layout Standard
-Bad Fonts in Acrobat Reader
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-The problem is that bitmap fonts are displayed poorly by Acrobat Reader.
- When creating a PDF from the LyX file, you need to use outline font instead
- of the default bitmap fonts (in fact, you should also use outline fonts
- for Postscript files).
- Recent LaTeX distributions come with Postscript Type 1 version of the standard
- (Computer Modern) fonts.
- pdfLaTeX uses these font by default.
- Dvips doesn't use these fonts by default, so to make it use them, add the
- following to lines to your
-\family typewriter
-~/.dvipsrc
-\family default
- file
-\end_layout
-
-\begin_layout LyX-Code
-p+ psfonts.cmz
-\end_layout
-
-\begin_layout LyX-Code
-p+ psfonts.amz
-\end_layout
-
-\begin_layout Standard
-If the default LaTeX font encoding (OT1) is used, nothing else need to be
- done.
- However, if the T1 font encoding is used, then LaTeX uses the newer EC
- fonts, for which there are no Type1 version.
- The solution is to use the ae package which emulates T1 coded fonts using
- the standard CM fonts.
- This is done by adding
-\family typewriter
-
-\backslash
-usepackage{ae,aecompl}
-\family default
- to the preamble of the LyX file.
- However, some glyphs are missing from the CM fonts (e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-eth, thorn), and
- they are taken from the EC fonts.
- Therefore you get these glyphs as bitmaps.
-\end_layout
-
-\begin_layout Standard
-Note: LyX uses by default the T1 font encoding.
- If you wish to use the default font encoding (this is not recommended,
- unless you only write English documents), clear the field
-\family sans
-\bar under
-T
-\bar default
-eX\InsetSpace ~
-encoding
-\family default
- in preferences (tabs
-\family sans
-Outputs
-\family default
-,
-\family sans
-Misc
-\family default
-).
-
-\end_layout
-
-\begin_layout Standard
-An alternate option is to use the standard Postscript fonts instead of the
- Computer Modern fonts.
- To do that, you need to select
-\family sans
-pslatex
-\family default
- as the global font in the document layout dialog.
- When using the Postscript fonts, the result PDF file is smaller as the
- fonts are not saved into the file.
- Furthermore, the Postscript fonts include all T1 glyphs.
- On the other hand, the Postscript fonts have no bold symbol font, so poor
- man's bold must be used (see Section\InsetSpace ~
-
-\begin_inset LatexCommand ref
-reference "sec:pdfbold"
-
-\end_inset
-
-).
- The Postscript fonts also look different from the Computer Modern fonts.
-\end_layout
-
-\begin_layout Standard
-To sum up, both the Computer Modern and the Postscript fonts gives good
- results (with few exceptions).
- The decision of which one to use is a matter of taste.
-\end_layout
-
-\begin_layout Subsubsection
-Why doesn't the
-\backslash
-boldsymbol{} command work when I use pslatex?
-\begin_inset LatexCommand label
-name "sec:pdfbold"
-
-\end_inset
-
-
-\begin_inset OptArg
-status collapsed
-
-\begin_layout Standard
-
-\family typewriter
-
-\backslash
-boldsymbol{}
-\family default
- and
-\family typewriter
-pslatex
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-The Postscript fonts do not have a bold symbol font.
- The solution is to use the
-\family typewriter
-
-\backslash
-pmb{}
-\family default
- (poor man's bold) command.
-\end_layout
-
-\begin_layout Standard
-It is possible to redefine the
-\family typewriter
-
-\backslash
-boldsymbol
-\family default
- command to use
-\family typewriter
-
-\backslash
-pmb
-\family default
- by putting
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-renewcommand{
-\backslash
-boldsymbol}[1]{
-\backslash
-pmb{#1}}
-\end_layout
-
-\begin_layout Standard
-in the preamble.
-\end_layout
-
-\begin_layout Subsubsection
-Is it possible to do write LaTeX-code which is processed only when running
- pdfLaTeX?
-\begin_inset OptArg
-status collapsed
-
-\begin_layout Standard
-Conditionals with pdfLaTeX
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Yes you can do this with the
-\family typewriter
-ifpdf.sty
-\family default
- package.
- Here is an example:
-\end_layout
-
-\begin_layout LyX-Code
-
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-usepackage{ifpdf}
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-ifpdf
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-pdfinfo { /Author (your name and e-mail address)
-\end_layout
-
-\begin_layout LyX-Code
- /Title (official title -- i.e., title element)
-\end_layout
-
-\begin_layout LyX-Code
- /Subject (one line description of the document)
-\end_layout
-
-\begin_layout LyX-Code
- }
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-pdfcatalog { /PageMode (/UseNone)
-\end_layout
-
-\begin_layout LyX-Code
- % /OpenAction (fitbh)
-\end_layout
-
-\begin_layout LyX-Code
- }
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-usepackage[pdftex]{hyperref}
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-else
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-usepackage[ps2pdf]{hyperref}
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-fi
-\end_layout
-
-\begin_layout Subsubsection
-How can I make URLs clickable?
-\end_layout
-
-\begin_layout Standard
-See the references here:
-\end_layout
-
-\begin_layout Standard
-\begin_inset LatexCommand url
-target "http://wiki.lyx.org/pmwiki.php/FAQ/PDF"
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Subsection
-Custom
-\end_layout
-
-\begin_layout Standard
-Custom exports are possible if you have some particularly weird format you
- wish to convert to, assuming you have the relevant converter, of course.
- The format of the
-\emph on
-input
-\emph default
- file can be chosen in the
-\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-E
-\bar default
-xport\SpecialChar \menuseparator
-
-\bar under
-C
-\bar default
-ustom
-\family default
- dialog; LyX will automatically convert the file to this point, then feed
- it to your custom converter.
- The possible values are all formats that LyX can produce from its own documents.
-
-\end_layout
-
-\begin_layout Standard
-The converter command is also specified in the dialog.
- It should be a completely qualified command line which uses the variable
-
-\family typewriter
-$$FName
-\family default
- to specify the name of the file.
- If this variable is not given, then the file will be sent to the standard
- input of your command.
- You may have to apply a bit of ingenuity to escape this sequence correctly
- so that it is compatible with your shell.
-
-\end_layout
-
-\begin_layout Standard
-While it is not possible to save this command using the
-\family sans
-Preferences
-\family default
- dialog, you can manually edit your
-\family typewriter
-.lyx/preferences
-\family default
- to add a line like
-\end_layout
-
-\begin_layout LyX-Code
-
-\backslash
-custom_export_command "mycommand $$FName"
-\end_layout
-
-\begin_layout Chapter
-LyX Features needing Extra Software
-\end_layout
-
-\begin_layout Section
-Checking TeX
-\end_layout
-
-\begin_layout Standard
-by
-\noun on
-Asger Alstrup
-\end_layout
-
-\begin_layout Subsection
-Introduction
-\end_layout
-
-\begin_layout Standard
-Under the
-\family sans
-\bar under
-T
-\bar default
-ools
-\family default
- menu, you'll find a
-\family sans
-\bar under
-C
-\bar default
-heck\InsetSpace ~
-TeX
-\family default
- command.
- This feature requires you to have the
-\family typewriter
-chktex
-\family default
- program installed, and is grayed out if you don't have it.
- You can get it from your nearest CTAN mirror, or over the Web from
-\begin_inset LatexCommand url
-target "http://www.ifi.uio.no/~jensthi/chktex/"
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Standard
-The
-\family sans
-ChkTeX
-\family default
- package is a program that was written by
-\noun on
-Jens T.
- Berger Thielemann
-\noun default
- in frustration because some constructs in LaTeX are sometimes non-intuitive,
- and easy to forget.
- The program runs over your LaTeX file and checks the integrity of the file,
- and flags some common errors.
- In other technical words, it is
-\family typewriter
-Lint
-\family default
- for LaTeX.
-\end_layout
-
-\begin_layout Standard
-Well, what is a syntax checker doing in LyX which is supposed to produce
- correct LaTeX anyways? The answer is simple: Just as
-\family typewriter
-Lint
-\family default
- not only checks the
-\emph on
-syntax
-\emph default
- of C programs, but also does
-\emph on
-semantic
-\emph default
- checks for type-errors,
-\family sans
-ChkTeX
-\family default
- catches some common
-\emph on
-typographic
-\emph default
- errors, in addition to the syntactical ones.
- Specifically,
-\family sans
-ChkTeX
-\family default
- is capable of detecting several common errors, such as
-\end_layout
-
-\begin_layout Itemize
-Ellipsis detection:
-\newline
-Use \SpecialChar \ldots{}
- instead of ...
-\end_layout
-
-\begin_layout Itemize
-No space in front of/after parenthesis:
-\newline
-( wrong spacing )
-\end_layout
-
-\begin_layout Itemize
-Enforcement of normal space after common abbreviations:
-\newline
-e.
- g.
- is too wide spacing.
-\end_layout
-
-\begin_layout Itemize
-Enforcement of end-of-sentence space when the last sentence ends with a
- capital letter:
-\newline
-This is a TEST.
- And this is wrong spacing.
-\end_layout
-
-\begin_layout Itemize
-Space in front of labels and similar commands:
-\newline
-The label should stick right
- up to the text to avoid falling to a wrong page.
-
-\begin_inset LatexCommand label
-name "sec:chktex"
-
-\end_inset
-
-
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-This footnote is in danger of falling off to a wrong page
-\end_layout
-
-\end_inset
-
- The label is separated too much.
-\end_layout
-
-\begin_layout Itemize
-Space in front of references, instead of hard spaces:
-\newline
-In you are in bad luck,
- the text will break right between the referenced text and reference number,
- and that's a pity.
- See section
-\begin_inset LatexCommand ref
-reference "sec:chktex"
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Itemize
-Use of
-\begin_inset Quotes eld
-\end_inset
-
-x
-\begin_inset Quotes erd
-\end_inset
-
- instead of
-\begin_inset Formula $\times$
-\end_inset
-
- between numbers:
-\newline
-2x2 looks cheap compared to
-\begin_inset Formula $2\times2$
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Standard
-and more \SpecialChar \ldots{}
- It is an invaluable tool when you are
-\begin_inset Quotes eld
-\end_inset
-
-finishing up
-\begin_inset Quotes erd
-\end_inset
-
- your document before printing, and you should run it right after the obligatory
- spelling check, and before you go fine tuning the typesetting.
-\end_layout
-
-\begin_layout Subsection
-How to use it
-\end_layout
-
-\begin_layout Standard
-If you have the program installed, usage is as simple as choosing
-\family sans
-\bar under
-T
-\bar default
-ools\SpecialChar \menuseparator
-
-\bar under
-C
-\bar default
-heck\InsetSpace ~
-TeX
-\family default
-.
- This will make LyX generate a LaTeX file of your document, start
-\family sans
-ChkTeX
-\family default
- to check it, and then make LyX insert
-\begin_inset Quotes eld
-\end_inset
-
-error boxes
-\begin_inset Quotes erd
-\end_inset
-
- with the warnings from
-\family sans
-ChkTeX
-\family default
-, if there were any.
- The warnings will be placed close to the point of the mistake, and you
- can quickly find them by using the
-\family sans
-\bar under
-N
-\bar default
-avigate\SpecialChar \menuseparator
-
-\bar under
-E
-\bar default
-rror
+rror
\family default
menu item, or the shortcut key
\family sans
\bar under
R
\bar default
-emove\InsetSpace ~
-All\InsetSpace ~
-Error\InsetSpace ~
+emove
+\begin_inset space ~
+\end_inset
+
+All
+\begin_inset space ~
+\end_inset
+
+Error
+\begin_inset space ~
+\end_inset
+
Boxes
\family default
, which will get rid of all warnings instantly.
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
You can inspect the specific output from
\family sans
chktex
by using
\family sans
Edit\SpecialChar \menuseparator
-View\InsetSpace ~
-LaTeX\InsetSpace ~
+View
+\begin_inset space ~
+\end_inset
+
+LaTeX
+\begin_inset space ~
+\end_inset
+
Log
\family default
right after a
".
\end_layout
-\begin_layout Standard
-Notice that you should only use the options that enable and disable warnings,
- because LyX relies on some of the other command line parameters to be set
- in a specific way to have a chance to communicate with
+\begin_layout Standard
+Notice that you should only use the options that enable and disable warnings,
+ because LyX relies on some of the other command line parameters to be set
+ in a specific way to have a chance to communicate with
+\family typewriter
+chktex
+\family default
+.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+\emph on
+Command terminated with space.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Non-breaking space (
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+~
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) should have been used.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+\emph on
+You should enclose the previous parenthesis with
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+{}
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Italic correction (
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+
+\backslash
+/
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) found in non-italic buffer.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Italic correction (
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+
+\backslash
+/
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) found more than once.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+\emph on
+No italic correction (
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+
+\backslash
+/
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) found.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Accent command
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+cmd
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ needs use of
+\begin_inset Quotes eld
+\end_inset
+
+
\family typewriter
-chktex
+cmd
\family default
+
+\begin_inset Quotes erd
+\end_inset
+
.
\end_layout
\begin_layout Enumerate
+\size small
+Wrong length of dash may have been used.
+\end_layout
+
+\begin_layout Enumerate
+
\size small
\emph on
-Command terminated with space.
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+%s
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ expected, found
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+%s
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
\end_layout
\begin_layout Enumerate
\size small
-Non-breaking space (
+Solo
\begin_inset Quotes eld
\end_inset
\family typewriter
-~
+%s
\family default
\begin_inset Quotes erd
\end_inset
-) should have been used.
+ found.
\end_layout
\begin_layout Enumerate
\size small
-\emph on
-You should enclose the previous parenthesis with
+You should use
\begin_inset Quotes eld
\end_inset
\family typewriter
-{}
+%s
\family default
\begin_inset Quotes erd
\end_inset
-.
+ to achieve an ellipsis.
\end_layout
\begin_layout Enumerate
\size small
-Italic correction (
+Inter-word spacing (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
-/
-\family default
-\begin_inset Quotes erd
+\family default
+
+\begin_inset Quotes eld
\end_inset
-) found in non-italic buffer.
+) should perhaps be used.
\end_layout
\begin_layout Enumerate
\size small
-Italic correction (
+Inter-sentence spacing (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
-/
+@
\family default
\begin_inset Quotes erd
\end_inset
-) found more than once.
+) should perhaps be used.
\end_layout
\begin_layout Enumerate
\size small
-\emph on
-No italic correction (
+Could not find argument for command.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+No match found for
\begin_inset Quotes eld
\end_inset
\family typewriter
-
-\backslash
-/
+%s
\family default
\begin_inset Quotes erd
\end_inset
-) found.
+.
\end_layout
\begin_layout Enumerate
\size small
-Accent command
+Math mode still on at end of LaTeX file.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Number of
\begin_inset Quotes eld
\end_inset
\family typewriter
-cmd
+char
\family default
\begin_inset Quotes erd
\end_inset
- needs use of
+ doesn't match the number of
\begin_inset Quotes eld
\end_inset
\family typewriter
-cmd
+char
\family default
\begin_inset Quotes erd
\begin_layout Enumerate
\size small
-Wrong length of dash may have been used.
+You should use either
+\family typewriter
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\family default
+ or
+\family typewriter
+
+\begin_inset Quotes erd
+\end_inset
+
+
+\family default
+ as an alternative to
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+"
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+You should use "
+\family typewriter
+'
+\family default
+" (ASCII 39) instead of "
+\family typewriter
+´
+\family default
+" (ASCII 180).
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+User-specified pattern found.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+This command might not be intended.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+\emph on
+Comment displayed.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Either
+\family typewriter
+''
+\backslash
+,'
+\family default
+ or
+\family typewriter
+'
+\backslash
+,''
+\family default
+ will look better.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Delete this space to maintain correct page references.
\end_layout
\begin_layout Enumerate
\size small
\emph on
+You might wish to put this between a pair of
\begin_inset Quotes eld
\end_inset
\family typewriter
-%s
+{}
\family default
\begin_inset Quotes erd
\end_inset
- expected, found
-\begin_inset Quotes eld
-\end_inset
+.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+You ought to remove spaces in front of punctuation.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Could not execute LaTeX command.
+\end_layout
+\begin_layout Enumerate
+\size small
+Don't use
\family typewriter
-%s
+
+\backslash
+/
\family default
+ in front of small punctuation.
+\end_layout
-\begin_inset Quotes erd
+\begin_layout Enumerate
+
+\family typewriter
+\size small
+$
+\backslash
+times$
+\family default
+ may look prettier here.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+\emph on
+Multiple spaces detected in output.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+This text may be ignored.
+\end_layout
+
+\begin_layout Enumerate
+
+\size small
+Use
+\family typewriter
+
+\begin_inset Quotes eld
\end_inset
+
+\family default
+ to begin quotation, not
+\family typewriter
+'
+\family default
.
\end_layout
\begin_layout Enumerate
\size small
-Solo
+Use
+\family typewriter
+'
+\family default
+ to end quotation, not
+\family typewriter
+
\begin_inset Quotes eld
\end_inset
-\family typewriter
-%s
\family default
+.
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Enumerate
- found.
+\size small
+Don't mix quotes.
\end_layout
\begin_layout Enumerate
\size small
-You should use
+You should perhaps use
\begin_inset Quotes eld
\end_inset
\family typewriter
-%s
+cmd
\family default
\begin_inset Quotes erd
\end_inset
- to achieve an ellipsis.
+ instead.
\end_layout
\begin_layout Enumerate
\size small
-Inter-word spacing (
-\begin_inset Quotes eld
-\end_inset
-
-
-\family typewriter
-
-\backslash
+You should put a space in front of/after parenthesis.
+\end_layout
-\family default
-
-\begin_inset Quotes eld
-\end_inset
+\begin_layout Enumerate
-) should perhaps be used.
+\size small
+You should avoid spaces in front of/after parenthesis.
\end_layout
\begin_layout Enumerate
\size small
-Inter-sentence spacing (
-\begin_inset Quotes eld
-\end_inset
-
+\emph on
+You should not use punctuation in front of/after quotes.
+\end_layout
-\family typewriter
+\begin_layout Enumerate
-\backslash
-@
-\family default
+\size small
+Double space found.
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Enumerate
-) should perhaps be used.
+\size small
+You should put punctuation outside inner/inside display math mode.
\end_layout
\begin_layout Enumerate
\size small
-Could not find argument for command.
+You ought to not use primitive TeX in LaTeX code.
\end_layout
\begin_layout Enumerate
\size small
-No match found for
+You should remove spaces in front of
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
-.
-\end_layout
-
-\begin_layout Enumerate
-\size small
-Math mode still on at end of LaTeX file.
\end_layout
\begin_layout Enumerate
\size small
-Number of
\begin_inset Quotes eld
\end_inset
\family typewriter
-char
+%s
\family default
\begin_inset Quotes erd
\end_inset
- doesn't match the number of
+ is normally not followed by
\begin_inset Quotes eld
\end_inset
\family typewriter
-char
+%c
\family default
\begin_inset Quotes erd
.
\end_layout
-\begin_layout Enumerate
-
-\size small
-You should use either
+\begin_layout Standard
+In later versions of LyX, we hope to provide a more complete interface to
+ this tool (and it's smaller cousin
\family typewriter
+lacheck
+\family default
+) to exploit the full power of it.
+ But it's not exactly useless as it is now: go try it on one of your existing
+ documents of a certain length and be surprised.
+\end_layout
-\begin_inset Quotes eld
-\end_inset
-
+\begin_layout Section
+Version Control in LyX
+\end_layout
-\family default
- or
-\family typewriter
+\begin_layout Standard
+by
+\noun on
+ Lars Gullik Bjønnes,
+\noun default
+updated by
+\noun on
+Pavel Sanda
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Subsection
+Introduction
+\end_layout
+\begin_layout Standard
+A friend of mine wanted to try LyX for a group project.
+ When he didn't find support for version control or file locking, he dropped
+ it.
+ This angered me a bit, so I thought that I should at least make support
+ for RCS (with the possibility of CVS and/or SCCS as a future improvement.)
+ This has now been done.
+ LyX now supports some of the most basic RCS commands.
+ If you need to something a bit more sophisticated you will have to do that
+ manually in an xterm.
+\end_layout
-\family default
- as an alternative to
+\begin_layout Standard
+Before you begin to use the version control features in LyX, you should
+ read
\begin_inset Quotes eld
\end_inset
-
-\family typewriter
-"
-\family default
-
+rcsintro
\begin_inset Quotes erd
\end_inset
-.
-\end_layout
-
-\begin_layout Enumerate
-
-\size small
-You should use "
+ (a man file, read it with
\family typewriter
-'
+man rcsintro
\family default
-" (ASCII 39) instead of "
+).
+ This file describes all the basic features of RCS.
+ You should especially notice the comment about a RCS directory, and the
+ notion of a master RCS file (the file ending in
\family typewriter
-´
+,v
\family default
-" (ASCII 180).
+).
\end_layout
-\begin_layout Enumerate
-
-\size small
-User-specified pattern found.
+\begin_layout Standard
+Later basic CVS/SVN support was added.
+ You should be familiar with CVS/SVN usage before start using it under LyX.
+ Most of the log messages are not currently displayed after operations -
+ you can check them in terminal window if unsure.
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+The implementation in LyX assumes a recent version of the GNU RCS or CVS/SVN
+ package---no guarantees are made for older versions.
+\end_layout
-\size small
-This command might not be intended.
+\begin_layout Subsection
+RCS commands in LyX
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+The following sections describe the RCS commands supported by LyX.
+ You can find them in the
+\family sans
+\bar under
+F
+\bar default
+ile\SpecialChar \menuseparator
-\size small
-\emph on
-Comment displayed.
+\bar under
+V
+\bar default
+ersion
+\begin_inset space ~
+\end_inset
+
+Control
+\family default
+ submenu.
\end_layout
-\begin_layout Enumerate
+\begin_layout Subsubsection
-\size small
-Either
-\family typewriter
-''
-\backslash
-,'
-\family default
- or
-\family typewriter
-'
-\backslash
-,''
+\family sans
+Register
+\end_layout
+
+\begin_layout Standard
+If your document is not under revision control, this is the only item shown
+ in the menu.
+ And if it is under revision control, the
+\family sans
+\bar under
+R
+\bar default
+egister
\family default
- will look better.
+ item is not visible.
+
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+This command registers your document with RCS (unless you are under the
+ directory managed by CVS)\SpecialChar \@.
+ You are asked interactively to supply an initial
+ description of the document.
+ The document is now set in Read-Only mode and you have to
+\family sans
+Check
+\begin_inset space ~
+\end_inset
-\size small
-Delete this space to maintain correct page references.
-\end_layout
+Out
+\begin_inset space ~
+\end_inset
-\begin_layout Enumerate
+For
+\begin_inset space ~
+\end_inset
-\size small
-\emph on
-You might wish to put this between a pair of
+Edit
+\family default
+, before making any changes to it.
+ A document under revision control has a
\begin_inset Quotes eld
\end_inset
+[RCS:<version> <locker>]
+\begin_inset Quotes erd
+\end_inset
+
+ item tagged to the filename in the minibuffer.
+\end_layout
+
+\begin_layout Standard
+RCS command that is run:
+\family typewriter
+ci -q -u -i -t-"<initial description>" <file-name>
+\end_layout
+\begin_layout Standard
+Read
\family typewriter
-{}
+man ci
\family default
+ to understand the switches.
+
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Subsubsection
-.
+\family sans
+Check In Changes
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+When you are finished editing a file, you check in your changes.
+ When you do this, you are asked for a description of the changes.
+ This is stored in the history log.
+ The version number is bumped, your changes are applied to the master RCS
+ file, the document is unlocked and set to Read-Only mode.
+
+\end_layout
-\size small
-You ought to remove spaces in front of punctuation.
+\begin_layout Standard
+RCS command:
+\family typewriter
+ci -q -u -m"<description>" <file-name>
\end_layout
-\begin_layout Enumerate
+\begin_layout Subsubsection
-\size small
-Could not execute LaTeX command.
+\family sans
+Check Out For Edit
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+By doing this you lock the document so that only you can edit it.
+ This will also make the document Read-Write only for you.
+ You will usually continue editing for a while and when you are finished
+ you check in your changes.
+ The status line is changed to reflect that you have locked the file.
+
+\end_layout
-\size small
-Don't use
+\begin_layout Standard
+RCS command:
\family typewriter
-
-\backslash
-/
-\family default
- in front of small punctuation.
+co -q -l <file-name>
\end_layout
-\begin_layout Enumerate
+\begin_layout Subsubsection
-\family typewriter
-\size small
-$
-\backslash
-times$
-\family default
- may look prettier here.
+\family sans
+Revert To Repository Version
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+This will discard all changes made to the document since the last check
+ in.
+ You get a warning before changes are discarded.
+\end_layout
-\size small
-\emph on
-Multiple spaces detected in output.
+\begin_layout Standard
+RCS command:
+\family typewriter
+co -f -u<version> <file-name>
\end_layout
-\begin_layout Enumerate
+\begin_layout Subsubsection
-\size small
-This text may be ignored.
+\family sans
+Undo Last Checkin
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+This makes as if the last check in never happened.
+ No changes are made to the document loaded into LyX, but the last version
+ is removed from the master RCS file.
+
+\end_layout
-\size small
-Use
+\begin_layout Standard
+RCS command:
\family typewriter
+rcs -o<version> <file-name>
+\end_layout
-\begin_inset Quotes eld
-\end_inset
-
+\begin_layout Subsubsection
-\family default
- to begin quotation, not
-\family typewriter
-'
-\family default
-.
+\family sans
+Show History
\end_layout
-\begin_layout Enumerate
-
-\size small
-Use
+\begin_layout Standard
+This show the complete history of the RCS document.
+ The output of
\family typewriter
-'
+rlog <file-name>
\family default
- to end quotation, not
+ is shown in a browser.
+ See
\family typewriter
-
-\begin_inset Quotes eld
-\end_inset
-
-
+man rlog
\family default
-.
+ for more info.
\end_layout
-\begin_layout Enumerate
-
-\size small
-Don't mix quotes.
+\begin_layout Subsection
+CVS commands in LyX
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+CVS is now partially supported by LyX.
+ You can find the commands in the
+\family sans
+\bar under
+F
+\bar default
+ile\SpecialChar \menuseparator
-\size small
-You should perhaps use
-\begin_inset Quotes eld
+\bar under
+V
+\bar default
+ersion
+\begin_inset space ~
\end_inset
-
-\family typewriter
-cmd
+Control
\family default
-
-\begin_inset Quotes erd
-\end_inset
-
- instead.
-\end_layout
-
-\begin_layout Enumerate
-
-\size small
-You should put a space in front of/after parenthesis.
-\end_layout
-
-\begin_layout Enumerate
-
-\size small
-You should avoid spaces in front of/after parenthesis.
+ submenu.
\end_layout
-\begin_layout Enumerate
+\begin_layout Subsubsection
-\size small
-\emph on
-You should not use punctuation in front of/after quotes.
+\family sans
+Register
\end_layout
-\begin_layout Enumerate
-
-\size small
-Double space found.
+\begin_layout Standard
+If your document is not under revision control, this is the only item shown
+ in the menu.
+ And if it is under revision control, the
+\family sans
+\bar under
+R
+\bar default
+egister
+\family default
+ item is not visible.
+
\end_layout
-\begin_layout Enumerate
-
-\size small
-You should put punctuation outside inner/inside display math mode.
+\begin_layout Standard
+This command registers in CVS your document ONLY in case you have already
+ the documents directory under CVS control (in particular
+\family typewriter
+CVS/Entries
+\family default
+ file exists).
+ This means you have to checkout the archive by yourself.
+
\end_layout
-\begin_layout Enumerate
-
-\size small
-You ought to not use primitive TeX in LaTeX code.
+\begin_layout Standard
+Then you are asked interactively to supply an initial description of the
+ document.
+ Don't forget that registered file is not yet commited.
\end_layout
-\begin_layout Enumerate
+\begin_layout Standard
+CVS command that is run:
+\family typewriter
+cvs -q add -m
+\begin_inset Quotes erd
+\end_inset
-\size small
-You should remove spaces in front of
+<entered message>"
\begin_inset Quotes eld
\end_inset
-
-\family typewriter
-%s
-\family default
-
+<file-name>
\begin_inset Quotes erd
\end_inset
\end_layout
-\begin_layout Enumerate
-
-\size small
-\begin_inset Quotes eld
-\end_inset
-
-
+\begin_layout Standard
+Read
\family typewriter
-%s
+man svn
\family default
+ to understand the switches.
+
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Subsubsection
- is normally not followed by
-\begin_inset Quotes eld
-\end_inset
+\family sans
+Check In Changes
+\end_layout
+\begin_layout Standard
+When you are finished editing a file, you commit your changes.
+ When you do this, you are asked for a description of the changes.
+ After that changes are commited.
+\end_layout
+\begin_layout Standard
+CVS command:
\family typewriter
-%c
-\family default
+cvs -q commit -m"<description>" <file-name>
+\end_layout
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Subsubsection
-.
+\family sans
+Revert To Repository Version
\end_layout
\begin_layout Standard
-In later versions of LyX, we hope to provide a more complete interface to
- this tool (and it's smaller cousin
-\family typewriter
-lacheck
-\family default
-) to exploit the full power of it.
- But it's not exactly useless as it is now: go try it on one of your existing
- documents of a certain length and be surprised.
+This will discard all changes made to the document since the last check
+ in.
+ You get a warning before changes are discarded.
+ Firstly the file is deleted, secondly CVS update command is run.
\end_layout
-\begin_layout Section
-Version Control in LyX
-\end_layout
+\begin_layout Standard
+CVS command:
+\family typewriter
+cvs update
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
-\begin_layout Standard
-by
-\noun on
- Lars Gullik Bjønnes
\end_layout
-\begin_layout Subsection
-Introduction
-\end_layout
+\begin_layout Subsubsection
-\begin_layout Standard
-A friend of mine wanted to try LyX for a group project.
- When he didn't find support for version control or file locking, he dropped
- it.
- This angered me a bit, so I thought that I should at least make support
- for RCS (with the possibility of CVS and/or SCCS as a future improvement.)
- This has now been done.
- LyX now supports some of the most basic RCS commands.
- If you need to something a bit more sophisticated you will have to do that
- manually in an xterm.
+\family sans
+Show History
\end_layout
\begin_layout Standard
-Before you begin to use the version control features in LyX, you should
- read
+This show the complete history of the CVS document.
+ The output of
+\family typewriter
+cvs log
\begin_inset Quotes eld
\end_inset
-rcsintro
+<file-name>
\begin_inset Quotes erd
\end_inset
- (a man file, read it with
-\family typewriter
-man rcsintro
-\family default
-).
- This file describes all the basic features of RCS.
- You should especially notice the comment about a RCS directory, and the
- notion of a master RCS file (the file ending in
-\family typewriter
-,v
-\family default
-).
-\end_layout
-\begin_layout Standard
-The implementation in LyX assumes a recent version of the GNU RCS package---no
- guarantees are made for older versions.
+\family default
+ is shown in a browser.
\end_layout
\begin_layout Subsection
-RCS commands in LyX
+SVN commands in LyX
\end_layout
\begin_layout Standard
-The following sections describe the RCS commands supported by LyX.
- You can find them in the
+SVN is now partially supported by LyX.
+ You can find the commands in the
\family sans
\bar under
F
\bar under
V
\bar default
-ersion\InsetSpace ~
+ersion
+\begin_inset space ~
+\end_inset
+
Control
\family default
submenu.
+ Please note that if you use password protected access to repository via
+ ssh, you will be asked in terminal window.
\end_layout
\begin_layout Subsubsection
\bar default
egister
\family default
- item is grayed out.
+ item is not visible.
\end_layout
\begin_layout Standard
-This command registers your document with RCS\SpecialChar \@.
- You are asked interactively
- to supply an initial description of the document.
- The document is now set in Read-Only mode and you have to
-\family sans
-Check\InsetSpace ~
-Out\InsetSpace ~
-For\InsetSpace ~
-Edit
+This command registers in SVN your document ONLY in case you have already
+ the documents directory under SVN control (in particular
+\family typewriter
+.svn/entries
\family default
-, before making any changes to it.
- A document under revision control has a
+ file exists).
+ This means you have to checkout the archive by yourself.
+
+\end_layout
+
+\begin_layout Standard
+Then you are asked interactively to supply an initial description of the
+ document.
+ Don't forget that registered file is not yet commited.
+\end_layout
+
+\begin_layout Standard
+SVN command that is run:
+\family typewriter
+snv add -q
\begin_inset Quotes eld
\end_inset
-[RCS:<version> <locker>]
+<file-name>
\begin_inset Quotes erd
\end_inset
- item tagged to the filename in the minibuffer.
-\end_layout
-\begin_layout Standard
-RCS command that is run:
-\family typewriter
-ci -q -u -i -t-"<initial description>" <file-name>
\end_layout
\begin_layout Standard
Read
\family typewriter
-man ci
+man svn
\family default
to understand the switches.
\end_layout
\begin_layout Standard
-When you are finished editing a file, you check in your changes.
+When you are finished editing a file, you commit your changes.
When you do this, you are asked for a description of the changes.
- This is stored in the history log.
- The version number is bumped, your changes are applied to the master RCS
- file, the document is unlocked and set to Read-Only mode.
-
+ After that changes are commited.
\end_layout
\begin_layout Standard
-RCS command:
+SVN command:
\family typewriter
-ci -q -u -m"<description>" <file-name>
+svn commit -q -m"<description>" <file-name>
\end_layout
\begin_layout Subsubsection
\end_layout
\begin_layout Standard
-By doing this you lock the document so that only you can edit it.
- This will also make the document Read-Write only for you.
- You will usually continue editing for a while and when you are finished
- you check in your changes.
- The status line is changed to reflect that you have locked the file.
-
+Updates the changes of this file from the repository.
+ Be sure you understand SVN merging and conflicts resolving before using
+ this function, because all conflicts has to be done manually by you!
\end_layout
\begin_layout Standard
-RCS command:
+SVN command:
\family typewriter
-co -q -l <file-name>
+svn update
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
+
\end_layout
\begin_layout Subsubsection
\family sans
-Revert To Last Version
+Revert To Repository Version
\end_layout
\begin_layout Standard
This will discard all changes made to the document since the last check
in.
You get a warning before changes are discarded.
+
\end_layout
\begin_layout Standard
-RCS command:
+SVN command:
\family typewriter
-co -f -u<version> <file-name>
-\end_layout
-
-\begin_layout Subsubsection
+svn revert -q
+\begin_inset Quotes eld
+\end_inset
-\family sans
-Undo Last Checkin
-\end_layout
+<file-name>
+\begin_inset Quotes erd
+\end_inset
-\begin_layout Standard
-This makes as if the last check in never happened.
- No changes are made to the document loaded into LyX, but the last version
- is removed from the master RCS file.
-
-\end_layout
-\begin_layout Standard
-RCS command:
-\family typewriter
-rcs -o<version> <file-name>
\end_layout
\begin_layout Subsubsection
\end_layout
\begin_layout Standard
-This show the complete history of the RCS document.
+This show the complete history of the SVN document.
The output of
\family typewriter
-rlog <file-name>
+svn log
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
+
\family default
is shown in a browser.
- See
-\family typewriter
-man rlog
-\family default
- for more info.
\end_layout
\begin_layout Section
\end_layout
\begin_layout Quote
-\begin_inset LatexCommand url
-name "Literate Programming FAQ"
-target "http://shelob.ce.ttu.edu/daves/lpfaq/faq.html"
+Literate Programming FAQ
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://shelob.ce.ttu.edu/daves/lpfaq/faq.html
+\end_layout
\end_inset
\end_layout
\begin_layout Quote
-\begin_inset LatexCommand url
-name "Noweb home page"
-target "http://www.cs.virginia.edu/~nr/noweb/"
+Noweb home page
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.cs.virginia.edu/~nr/noweb/
+\end_layout
\end_inset
\end_layout
\begin_layout Subsection
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "sub:LyX-and-Literate"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
It is very simple, it involves the creation of a file with four lines, and
re-running of the auto configuration.
\end_layout
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The equivalent Noweb term is
\begin_inset Quotes eld
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
If you have a printed version of this document you will not see any difference
between the previous example and this one.
\end_layout
\begin_layout LyX-Code
<<My scrap>>=
-\newline
+\begin_inset Newline newline
+\end_inset
+
code
-\newline
+\begin_inset Newline newline
+\end_inset
+
more code
-\newline
+\begin_inset Newline newline
+\end_inset
+
even more code
-\newline
+\begin_inset Newline newline
+\end_inset
+
@
\end_layout
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
It is in my list of
\begin_inset Quotes eld
\end_inset
\begin_layout LyX-Code
<<My scrap>>=
-\newline
+\begin_inset Newline newline
+\end_inset
+
def some_function(args):
-\newline
- "This is the doc string for this
- function."
-\newline
+\begin_inset Newline newline
+\end_inset
+
+ "This is the doc string for this function."
+\begin_inset Newline newline
+\end_inset
+
print "My args: ", args
\end_layout
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
The converters are defined in the
\family sans
\bar under
tab.
See section
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sub:converters"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
See section
-\begin_inset LatexCommand ref
+\begin_inset CommandInset ref
+LatexCommand ref
reference "sec:converters-etc"
\end_inset
\begin_layout LyX-Code
<<build-script>>=
-\newline
+\begin_inset Newline newline
+\end_inset
+
#!/bin/sh
-\newline
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
-\newline
if [ -z "${NOWEB_SOURCE}" ]
-\newline
+\begin_inset Newline newline
+\end_inset
+
then
-\newline
+\begin_inset Newline newline
+\end_inset
+
NOWEB_SOURCE=myfile.nw
-\newline
+\begin_inset Newline newline
+\end_inset
fi
-\newline
+\begin_inset Newline newline
+\end_inset
+
[...
code to extract files ...]
-\newline
+\begin_inset Newline newline
+\end_inset
+
[...
code to compile files ...]
-\newline
+\begin_inset Newline newline
+\end_inset
+
@
\end_layout
\end_layout
\begin_layout Description
-the\InsetSpace ~
+the
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
format Set up via the Formats tab, this is where the Noweb-specific pieces
are set up.
The
\end_layout
\begin_layout Description
-the\InsetSpace ~
+the
+\begin_inset space ~
+\end_inset
+
\family sans
Program
\family default
-\InsetSpace ~
+
+\begin_inset space ~
+\end_inset
+
format This is an empty format whose sole purpose is to be the endpoint
of a conversion (which then allows us to set up a converter for it).
\end_layout
\begin_layout Chapter
Secrets of the LaTeX Masters
-\begin_inset LatexCommand label
+\begin_inset CommandInset label
+LatexCommand label
name "cha:secrets"
\end_inset
\begin_inset Foot
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Editor's note: Lars' original chapter was a masterful description of how
to use the
\family typewriter
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
The Adventure of the Empty House
\series default
-\newline
+\begin_inset Newline newline
+\end_inset
+
by
\noun on
Sir Arthur Conan Doyle
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_inset OptArg
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
Numbering in Enumerate
\end_layout
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
-,\InsetSpace ~
+,
+\begin_inset space ~
+\end_inset
+
\begin_inset Quotes eld
\end_inset
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\noindent
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status open
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_layout Standard
\begin_inset ERT
-status inlined
+status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
\begin_inset ERT
status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.40
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.35
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.30
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.25
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.20
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.15
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.10
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.05
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.00
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.05
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.10
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.15
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.20
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.25
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.30
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.35
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.40
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
0.45
\backslash
varunit
\end_layout
-\begin_layout Standard
+\begin_layout Plain Layout
\end_layout
\begin_layout Standard
\begin_inset ERT
-status inlined
+status collapsed
-\begin_layout Standard
+\begin_layout Plain Layout
\backslash
projects / lyx.git / blobdiff