Update documentation regarding converters, etc.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@18491 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Richard Heck 2007-05-24 16:42:40 +00:00
parent 93baf8eb9b
commit 9879a1a185
2 changed files with 522 additions and 358 deletions

View File

@ -1,5 +1,5 @@
#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/ #LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
\lyxformat 263 \lyxformat 271
\begin_document \begin_document
\begin_header \begin_header
\textclass book \textclass book
@ -39,6 +39,7 @@
\paperpagestyle headings \paperpagestyle headings
\tracking_changes false \tracking_changes false
\output_changes false \output_changes false
\author "Richard Heck"
\author "Jean-Marc Lasgouttes" \author "Jean-Marc Lasgouttes"
\author "usti" \author "usti"
\end_header \end_header
@ -1698,63 +1699,23 @@ s.
\end_layout \end_layout
\begin_layout Section \begin_layout Section
Converters, Formats, Viewers, Editors and Copiers Converters, Formats, and Copiers
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
LyX has a powerful mechanism to convert to and from any file format using LyX has a powerful mechanism to convert to and from any file format using
external programs. external programs.
Define a pair of formats, e.g.
\family typewriter
LaTeX
\family default
and
\family typewriter
PDF
\family default
.
Now define a converter from one format to the other.
In our example, two possible mechanisms exist.
\end_layout \end_layout
\begin_layout Enumerate \begin_layout Subsection
A direct conversion, from LaTeX to PDF using pdflatex Formats
\end_layout
\begin_layout Enumerate
A more convoluted route using intermediate formats and converters: LaTeX
to DVI (using latex) to PostScript® (using dvips) to PDF (using ps2pdf).
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
LyX will always choose the shortest possible route, so you must specify The first step is to define your file formats, e.g.
two different Format names for PDF, if they are not already defined.
\family typewriter To do so, open the
.pdf
\family default
files to be able to use either.
Both are included by default in the
\family sans
Preferences
\family default
dialog.
Have a look and then invent your own!
\end_layout
\begin_layout Standard
Moreover, each Format can have a Viewer associated with it.
For example, you might want to use
\family typewriter
ghostview
\family default
to examine PostScript® files, or
\family typewriter
xdvi
\family default
to preview the LaTeX output.
You can alter the viewer to use (and what options to pass to it) via the
\family sans \family sans
\bar under \bar under
T T
@ -1764,112 +1725,18 @@ ools\SpecialChar \menuseparator
\bar under \bar under
P P
\bar default \bar default
references:Conversion references:Converters
\family default \family default
dialog. dialog.
For example, to change the Enter a new format name; a new GUI name (used in, e.g., the View and Export
\family typewriter menus); and a file extension.
dvi These are required.
\family default
viewer, select the
\family typewriter
DVI
\family default
format in the dialog, change the viewer to be
\family typewriter
kdvi
\family default
(or whatever), and hit
\family sans
\bar under
M
\bar default
odify
\family default
.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
If the operating system has a default viewer associated to a format it is There are also two flags that can be set using the checkboxes in the dialog.
used instead of the one you can define via the The
\family sans
\bar under
T
\bar default
ools\SpecialChar \menuseparator
\bar under
P
\bar default
references:Conversion
\family default
dialog.
This does currently only work in the Windows® and Mac OS X ports of LyX,
but it is planned to implement this feature on all other ports that can
support it, too.
\end_layout
\begin_layout Standard
Editors are like viewers: Each Format can have an Editor associated to it,
and they can be altered via the
\family sans
\bar under
T
\bar default
ools\SpecialChar \menuseparator
\bar under
P
\bar default
references:Conversion
\family default
dialog.
LyX uses them whenever an included file
\begin_inset Foot
status collapsed
\begin_layout Standard
This can be an included
\family typewriter
.tex
\family default
file, a verbatim included text file, external material or an included graphics
file.
\end_layout
\end_inset
needs to be edited.
\end_layout
\begin_layout Standard
Finally, each Format can have a Copier associated to it.
Since all conversions from one Format to another take place in a temporary
directory, it is sometimes necessary to modify a file before copying it
to the temporary directory
\begin_inset Foot
status collapsed
\begin_layout Standard
For example, the file may reference other files with relative filenames,
which will become invalid in the temporary directory
\end_layout
\end_inset
.
This is done by the Copier: It copies a file to (or from) the temporary
directory and may modify it in the process.
\end_layout
\begin_layout Standard
Sometimes LyX needs to know a bit more about the properties of a format.
These bits can be specified with flags.
Currently there are two of them:
\end_layout
\begin_layout Standard
The
\family typewriter \family typewriter
document document
\family default \family default
@ -1895,19 +1762,19 @@ V
\bar default \bar default
iew iew
\family default \family default
menu if it has a viewer associated to it. menu if it has a viewer associated with it.
Pure image formats (e.g.\InsetSpace ~ (See below.) Pure image formats (e.g.\InsetSpace ~
\family typewriter \family typewriter
png png
\family default \family default
) do not have this flag set, formats that can both represent images and ) should not have this flag set; formats that can both represent vector
documents (e.g.\InsetSpace ~ graphics and documents (e.g.\InsetSpace ~
\family typewriter \family typewriter
pdf pdf
\family default \family default
) do have it set. ) should have it set.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -1951,7 +1818,7 @@ png
\family typewriter \family typewriter
jpg jpg
\family default \family default
format it is converted to format, it is converted to
\family typewriter \family typewriter
pdf pdf
\family default \family default
@ -1966,6 +1833,302 @@ png
. .
\end_layout \end_layout
\begin_layout Standard
A Format can have a Viewer associated with it.
For example, you might want to use
\family typewriter
ghostview
\family default
to look at PostScript® files, or
\family typewriter
xdvi
\family default
to preview the LaTeX output.
You can enter the program to use as a viewer (and what options to pass
to it) in the Viewer field.
You can also modify the viewer associated with a pre-defined format simply
by changing what you find in this field, clicking the
\family sans
Modify
\family default
button, and then (if you're sure you want to do this) clicking the
\family sans
Apply
\family default
or
\family sans
Save
\family default
button.
\begin_inset Foot
status collapsed
\begin_layout Standard
Changes to the formats are kept in the
\family typewriter
preferences
\family default
file in you local LyX directory (for example,
\family typewriter
$HOME/.lyx/
\family default
).
If you want to restore the defaults, edit this file and delete the lines
in the Formats and Converters sections.
\end_layout
\end_inset
For example, to change the
\family typewriter
dvi
\family default
viewer, select the
\family typewriter
DVI
\family default
format in the dialog, change the viewer to be
\family typewriter
kdvi
\family default
(or whatever), and hit
\family sans
\bar under
M
\bar default
odify
\family default
.
\end_layout
\begin_layout Standard
If the operating system has a default viewer associated to a format, this
viewer is used instead of the one defined here in the Windows® and OS X
versions of LyX.
(It is planned to implement this feature on other platforms.)
\end_layout
\begin_layout Standard
Editors are like viewers: Each Format can have an Editor associated to it,
entered in the Editor field, and the editor associated with a format can
be altered via the
\family sans
\bar under
T
\bar default
ools\SpecialChar \menuseparator
\bar under
P
\bar default
references:Converters
\family default
dialog.
LyX will launch the associated editor whenever an included file
\begin_inset Foot
status collapsed
\begin_layout Standard
This can be an included
\family typewriter
.tex
\family default
file, a verbatim included text file, external material or an included graphics
file.
\end_layout
\end_inset
needs to be edited.
\end_layout
\begin_layout Subsection
Copiers
\end_layout
\begin_layout Standard
Each Format can have a Copier associated with it.
These are defined in the
\family sans
\bar under
T
\bar default
ools\SpecialChar \menuseparator
\bar under
P
\bar default
references:Copiers
\family default
dialog.
Since all conversions from one Format to another take place in a temporary
directory, it is sometimes necessary to modify a file before copying it
to the temporary directory in order that the conversion may be performed.
\begin_inset Foot
status collapsed
\begin_layout Standard
For example, the file may refer to other files---images, for example---using
relative filenames, and these may become invalid when the file is copied
to the temporary directory.
\end_layout
\end_inset
This is done by the Copier: It copies a file to (or from) the temporary
directory and may modify it in the process.
\end_layout
\begin_layout Subsection
Converters
\end_layout
\begin_layout Standard
To define a converter from one format to another---e.g., LaTeX to PDF---select
the Converters panel.
Choose the `From' and `To' formats, and then enter the program to be used
in the conversion in the Converter field.
\end_layout
\begin_layout Standard
You do not have to define converters between all the Formats between which
you want to convert.
For example, you will note that there is no `LyX to PostScript®' converter,
but LyX will export PostScript®.
It does so by first creating a LaTeX file (no converter needs to be defined
for this) which it then converts to DVI using the `LaTeX to DVI' converter,
and then it converts the resulting DVI file to PostScript®.
LyX finds such `chains' of converters automatically, and it will always
choose the shortest chain possible.
You can, though, still define multiple conversion methods between file
formats.
For example, the standard LyX configuration provides three ways to convert
LaTeX to PDF: Directly, using pdflatex; via (DVI and) PostScript®, using
ps2pdf; or via DVI, using dvipdfm.
To define such alternate chains, you must define multiple target `file
formats'.
In the standard configuration, for example, formats named `pdf', `pdf2',
and `pdf3' are defined, all of which share the extension `pdf'.
\end_layout
\begin_layout Standard
Several variables can be used in the definition of converters:
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
$$s The LyX system directory (e.g.,
\family typewriter
/usr/share/lyx
\family default
).
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
$$i The input file
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
$$o The output file
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
$$b The base filename of the input file
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
$$p The path to the input file
\end_layout
\begin_layout Standard
In the `Extra Flag' field you can enter as many of the following flags as
you wish, separated by commas:
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
latex This converter runs some form of LaTeX.
(This will make LyX's LaTeX error logs available.)
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
needaux Needs the LaTeX .aux file for the conversion.
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
xml Output is XML.
\end_layout
\begin_layout Standard
The following three variables are not really flags at all but take an argument
in the
\family sans
key\InsetSpace ~
= value
\family default
format.
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
parselog If set, the converter's standard error will be redirected to a
file
\family typewriter
infile.out
\family default
, and the script given as argument will be run as:
\family typewriter
script <infile.out >infile.log
\family default
.
The argument may contain $$s.
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
resultdir The name of the directory in which the
\emph on
converter
\emph default
will dump the generated files.
LyX will not create this directory, and it does not copy anything into
it, though it will copy this directory to the destination.
The argument may contain $$b, which will be replaced by the basename of
the input and output files, respectively, when the directory is copied.
\newline
Note
that resultdir and usetempdir make no sense together.
The latter will be ignored if the former is given.
\end_layout
\begin_layout List
\labelwidthstring 00.00.0000
resultfile Determines the output filename and may, again, contain $$b.
Sensible only with resultdir, and optional even then; if not given, it
defaults to `index'.
\end_layout
\begin_layout Standard
None of these last three are presently used in any of the converters that
are installed with LyX.
But see section
\begin_inset LatexCommand ref
reference "sub:LyX-and-Literate"
\end_inset
of the Extended Features guide for some examples of how you might use parselog.
\end_layout
\begin_layout Section \begin_layout Section
BibTeX and makeindex BibTeX and makeindex
\end_layout \end_layout

View File

@ -1,5 +1,5 @@
#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/ #LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
\lyxformat 256 \lyxformat 271
\begin_document \begin_document
\begin_header \begin_header
\textclass book \textclass book
@ -36,7 +36,8 @@
\papersides 2 \papersides 2
\paperpagestyle headings \paperpagestyle headings
\tracking_changes false \tracking_changes false
\output_changes true \output_changes false
\author "Richard Heck"
\author "usti" \author "usti"
\end_header \end_header
@ -137,7 +138,7 @@ If you haven't read the
\emph on \emph on
Introduction Introduction
\emph default \emph default
yet, you are definitely in the wrong manual. yet, you are definitely in the wrong manual.
The The
\emph on \emph on
Introduction Introduction
@ -163,12 +164,8 @@ In this document, many sections are independent articles contributed by
\begin_layout Standard \begin_layout Standard
Since all the topics in this manual depend heavily on LyX's interaction Since all the topics in this manual depend heavily on LyX's interaction
with LaTeX, this first chapter covers with LaTeX, this first chapter covers the inner workings of LyX and how
\emph on to direct LyX to generate exactly the LaTeX code you want.
\emph default
the inner workings of LyX and how to direct LyX to generate exactly the
LaTeX code you want.
It is obviously for more seasoned LyX users. It is obviously for more seasoned LyX users.
\end_layout \end_layout
@ -906,7 +903,7 @@ The LaTeX preamble comes at the very beginning of a document,
\emph on \emph on
before before
\emph default \emph default
the text. the text.
It serves to: It serves to:
\end_layout \end_layout
@ -932,11 +929,7 @@ Customization Manual
declare the usage of packages. declare the usage of packages.
LaTeX packages provide special commands, which are only available within LaTeX packages provide special commands, which are only available within
a document when the package has been declared in the preamble. a document when the package has been declared in the preamble.
For example, the For example, the package
\family typewriter
\family default
package
\family typewriter \family typewriter
indentfirst indentfirst
\family default \family default
@ -966,7 +959,7 @@ declare user defined commands [with
\backslash \backslash
newcommand newcommand
\family default \family default
or or
\family typewriter \family typewriter
\backslash \backslash
@ -1215,7 +1208,7 @@ First, make sure you're using the
\family sans \family sans
article article
\family default \family default
document class. document class.
Next, you need to put the following in your preamble: Next, you need to put the following in your preamble:
\end_layout \end_layout
@ -1455,7 +1448,6 @@ open
\begin_layout Standard \begin_layout Standard
Some folks also like to look at the log file directly, accessible from Some folks also like to look at the log file directly, accessible from
\family sans \family sans
\bar under \bar under
D D
\bar default \bar default
@ -2146,7 +2138,7 @@ S
\bar default \bar default
ettings ettings
\family default \family default
and select the and select the
\family sans \family sans
Bibliography Bibliography
\family default \family default
@ -2323,7 +2315,7 @@ S
\bar default \bar default
ettings ettings
\family default \family default
and select the and select the
\family sans \family sans
Bibliography Bibliography
\family default \family default
@ -2482,7 +2474,7 @@ S
\bar default \bar default
ettings ettings
\family default \family default
and select the and select the
\family sans \family sans
Bibliography Bibliography
\family default \family default
@ -2548,12 +2540,14 @@ status collapsed
\noun off \noun off
\color none \color none
In the In the
\family sans \family default
\series default \series default
\shape default \shape default
\size default
\emph default \emph default
\bar default \bar default
\family sans
\size default
\noun default \noun default
Outputs\SpecialChar \menuseparator Outputs\SpecialChar \menuseparator
LaT\SpecialChar \textcompwordmark{} LaT\SpecialChar \textcompwordmark{}
@ -2567,12 +2561,14 @@ eX
\noun off \noun off
section of the preferences dialog, however, you can customize the index section of the preferences dialog, however, you can customize the index
command, if you prefer an alternative program like command, if you prefer an alternative program like
\family typewriter \family default
\series default \series default
\shape default \shape default
\size default
\emph default \emph default
\bar default \bar default
\family typewriter
\size default
\noun default \noun default
xindy xindy
\family roman \family roman
@ -2674,9 +2670,7 @@ Glossaries
\begin_layout Standard \begin_layout Standard
by by
\noun on \noun on
Özgür U\i \~{g} Özgür Ug̃raş Baran
ra\i \c{s}
Baran
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -2791,7 +2785,7 @@ a
\family typewriter \family typewriter
sigma sigma
\family default \family default
correspondingly. correspondingly.
Then, these entries will be effective in the sort ordering and Then, these entries will be effective in the sort ordering and
\begin_inset Formula $a$ \begin_inset Formula $a$
\end_inset \end_inset
@ -3150,8 +3144,6 @@ output
\family default \family default
checkbox typesets a mark to unambiguously define the presence of a space. checkbox typesets a mark to unambiguously define the presence of a space.
\emph on
\end_layout \end_layout
\begin_layout Subsection \begin_layout Subsection
@ -3854,11 +3846,7 @@ How to use it
\begin_layout Standard \begin_layout Standard
Select which bullet depth you want to change then select the bullet shape Select which bullet depth you want to change then select the bullet shape
and size. and size.
Any changes will not be visible in LyX, but are visible when viewing the
\family sans
\family default
Any changes will not be visible in LyX, but are visible when viewing the
document using xdvi or ghostview. document using xdvi or ghostview.
\end_layout \end_layout
@ -4436,15 +4424,7 @@ target "http://www.edpsciences.fr/aa/"
\end_inset \end_inset
) ) using Version 5.01 of the document class
\emph on
\emph default
using
\emph on
\emph default
Version 5.01 of the document class
\family typewriter \family typewriter
aa.cls aa.cls
\family default \family default
@ -4655,7 +4635,7 @@ F
ootnote. ootnote.
\family default \family default
LyX will automagically use the term LyX will automagically use the term
\family typewriter \family typewriter
\backslash \backslash
@ -4907,7 +4887,7 @@ LyX provides support for the necessary float environments
\family sans \family sans
figure, figure*, table figure, figure*, table
\family default \family default
and and
\family sans \family sans
table* table*
\family default \family default
@ -4934,11 +4914,7 @@ Settings.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
There is There is only one special thing: the figures with caption besides the figure.
\family sans
\family default
only one special thing: the figures with caption besides the figure.
To create such a figure, you have to do the following: To create such a figure, you have to do the following:
\end_layout \end_layout
@ -4958,7 +4934,6 @@ Figure
\family default \family default
, then right click in the figure and select , then right click in the figure and select
\family sans \family sans
\bar under \bar under
S S
\bar default \bar default
@ -5035,6 +5010,8 @@ Position the cursor behind the caption text, switch to LaTeX mode and insert
\family sans \family sans
M-c\InsetSpace ~ M-c\InsetSpace ~
t t
\family default
\family typewriter \family typewriter
} }
\family default \family default
@ -5169,6 +5146,9 @@ F
\bar default \bar default
ile\SpecialChar \menuseparator ile\SpecialChar \menuseparator
New from New from
\family default
\family sans
\bar under \bar under
T T
\bar default \bar default
@ -6146,7 +6126,7 @@ g.\InsetSpace ~
\emph default \emph default
type type
\family typewriter \family typewriter
Ressler(1992) Ressler(1992)
\family default \family default
, not , not
\family typewriter \family typewriter
@ -6323,6 +6303,9 @@ F
\bar default \bar default
ile\SpecialChar \menuseparator ile\SpecialChar \menuseparator
New from New from
\family default
\family sans
\bar under \bar under
T T
\bar default \bar default
@ -6899,6 +6882,9 @@ The easiest way to write a paper is to start with the Kluwer template file.
\family sans \family sans
File\SpecialChar \menuseparator File\SpecialChar \menuseparator
New from New from
\family default
\family sans
\bar under \bar under
T T
\bar default \bar default
@ -7202,7 +7188,7 @@ Overview
\begin_layout Standard \begin_layout Standard
The LyX document classes The LyX document classes
\emph on \emph on
article (koma-script) article (koma-script)
\emph default \emph default
, ,
\emph on \emph on
@ -7288,7 +7274,7 @@ Headings, labels of the description environment, and a number of elements
\emph on \emph on
letter (koma-script) letter (koma-script)
\emph default \emph default
document class are set in a bold sans serif font. document class are set in a bold sans serif font.
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
@ -7300,6 +7286,7 @@ There is a big difference between the bold sans serif old cm fonts and new
\family typewriter \family typewriter
cmsd.sty by cmsd.sty by
\family default \family default
\shape smallcaps \shape smallcaps
Walter Schmidt Walter Schmidt
\shape default \shape default
@ -7528,9 +7515,9 @@ Section*
\family sans \family sans
Addpart Addpart
\family default \family default
and and
\family sans \family sans
Addchap Addchap
\family default \family default
are not contained in are not contained in
\emph on \emph on
@ -7559,7 +7546,7 @@ Addsec
, resp., additionally clearing running heads. , resp., additionally clearing running heads.
\family sans \family sans
Addchap* Addchap*
\family default \family default
is not contained in is not contained in
\emph on \emph on
@ -7614,8 +7601,8 @@ Captionabove
\family sans \family sans
Captionbelow Captionbelow
\family default \family default
are special captions which respect the different space settings needed for are special captions which respect the different space settings needed
captions placed above or below an element (if you follow strict typographic for captions placed above or below an element (if you follow strict typographic
rules, you might want to place table captions always above the table). rules, you might want to place table captions always above the table).
You can also use the class option You can also use the class option
\family typewriter \family typewriter
@ -8113,7 +8100,7 @@ The types
\family sans \family sans
Letter Letter
\family default \family default
and and
\family sans \family sans
Opening Opening
\family default \family default
@ -8224,7 +8211,7 @@ Address
\family default \family default
, ,
\family sans \family sans
Telephone Telephone
\family default \family default
, ,
\family sans \family sans
@ -8803,7 +8790,7 @@ D
ocument\SpecialChar \menuseparator ocument\SpecialChar \menuseparator
Extra Options Extra Options
\family default \family default
field. field.
\end_layout \end_layout
\end_inset \end_inset
@ -9037,7 +9024,7 @@ Journal of Geodesy
\family typewriter \family typewriter
svjog.layout svjog.layout
\family default \family default
--- Martin Vermeer --- Martin Vermeer
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -9232,7 +9219,7 @@ Journal of Geophysical Research
\family typewriter \family typewriter
jgrga.layout jgrga.layout
\family default \family default
--- Martin Vermeer --- Martin Vermeer
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -9464,7 +9451,7 @@ reference "sec:foiltex"
\family sans \family sans
foils foils
\family default \family default
class [ class [
\begin_inset Quotes eld \begin_inset Quotes eld
\end_inset \end_inset
@ -9685,7 +9672,7 @@ slides.lyx
\family sans \family sans
slides slides
\family default \family default
class [using class [using
\family sans \family sans
\bar under \bar under
F F
@ -9718,7 +9705,7 @@ The first thing you'll notice when you start up a new
\family sans \family sans
slides slides
\family default \family default
document is the font size and type: it's the equivalent of the size document is the font size and type: it's the equivalent of the size
\begin_inset Quotes eld \begin_inset Quotes eld
\end_inset \end_inset
@ -10131,7 +10118,7 @@ Slide
\family default \family default
, ,
\family sans \family sans
Overlay Overlay
\family default \family default
and and
\family sans \family sans
@ -10240,7 +10227,7 @@ Note
\family sans \family sans
Slide Slide
\family default \family default
environment. environment.
They both create an They both create an
\begin_inset Quotes eld \begin_inset Quotes eld
\end_inset \end_inset
@ -11272,7 +11259,7 @@ Overlay
\family default \family default
-- --
\family sans \family sans
Note Note
\family default \family default
triplet. triplet.
The The
@ -11489,7 +11476,7 @@ reference "sec:slitex"
\family sans \family sans
foils foils
\family default \family default
class [ class [
\begin_inset Quotes eld \begin_inset Quotes eld
\end_inset \end_inset
@ -12446,7 +12433,7 @@ The two new list styles,
\family sans \family sans
TickList TickList
\family default \family default
and and
\family sans \family sans
CrossList CrossList
\family default \family default
@ -12529,7 +12516,7 @@ Confidential.
\begin_layout Standard \begin_layout Standard
The remaining page corners can be filled by The remaining page corners can be filled by
\family sans \family sans
Right\InsetSpace ~ Right\InsetSpace ~
Footer Footer
\family default \family default
(which defaults to page numbers), (which defaults to page numbers),
@ -12662,7 +12649,7 @@ The spacings around floats can be adjusted by setting these lengths:
\backslash \backslash
abovefloatskip abovefloatskip
\family default \family default
Separation between the text and the top of the float Separation between the text and the top of the float
\end_layout \end_layout
\begin_layout List \begin_layout List
@ -12673,7 +12660,7 @@ Separation between the text and the top of the float
\backslash \backslash
abovecaptionskip abovecaptionskip
\family default \family default
Separation between the float and the caption Separation between the float and the caption
\end_layout \end_layout
\begin_layout List \begin_layout List
@ -12684,7 +12671,7 @@ Separation between the float and the caption
\backslash \backslash
belowcaptionskip belowcaptionskip
\family default \family default
Separation between the caption and the following text Separation between the caption and the following text
\end_layout \end_layout
\begin_layout List \begin_layout List
@ -13365,7 +13352,7 @@ Subtitle for
ACT. ACT.
\family default \family default
It is just centered text. It is just centered text.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -13841,7 +13828,7 @@ Tomasz Luczak
\begin_layout Standard \begin_layout Standard
The LyX document classes The LyX document classes
\emph on \emph on
article (mwart) article (mwart)
\emph default \emph default
, ,
\emph on \emph on
@ -14304,7 +14291,7 @@ without pagina).
\backslash \backslash
aliaspagestyle{title}{empty} aliaspagestyle{title}{empty}
\family default \family default
in the preamble. in the preamble.
\end_layout \end_layout
\begin_layout Description \begin_layout Description
@ -14312,7 +14299,7 @@ Article: With the class option
\emph on \emph on
article article
\emph default \emph default
(to be inserted in (to be inserted in
\family sans \family sans
Layout\SpecialChar \menuseparator Layout\SpecialChar \menuseparator
Document\SpecialChar \menuseparator Document\SpecialChar \menuseparator
@ -15204,7 +15191,7 @@ C
\bar default \bar default
ustom ustom
\family default \family default
dialog; LyX will automatically convert the file to this point, then feed dialog; LyX will automatically convert the file to this point, then feed
it to your custom converter. it to your custom converter.
The possible values are all formats that LyX can produce from its own documents. The possible values are all formats that LyX can produce from its own documents.
@ -15230,7 +15217,7 @@ While it is not possible to save this command using the
\family sans \family sans
Preferences Preferences
\family default \family default
dialog, you can manually edit your dialog, you can manually edit your
\family typewriter \family typewriter
.lyx/preferences .lyx/preferences
\family default \family default
@ -15328,11 +15315,7 @@ S
ettings ettings
\family default \family default
dialog. dialog.
Then you will find that there are fewer paragraph environments than for
\family sans
\family default
Then you will find that there are fewer paragraph environments than for
most other classes. most other classes.
You can see them on the pull down box on the left of the tool bar. You can see them on the pull down box on the left of the tool bar.
How to use them is described in section\InsetSpace ~ How to use them is described in section\InsetSpace ~
@ -15382,7 +15365,6 @@ You can print and save these documents in the normal way.
the basic sgml tags. the basic sgml tags.
Use Use
\family sans \family sans
\bar under \bar under
F F
\bar default \bar default
@ -15464,8 +15446,10 @@ Here is a list of all the tags you will find listed on the layout bar in
\family sans \family sans
Standard: Standard:
\family default
\family roman \family roman
works as described in [cross reference] works as described in [cross reference]
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -15515,8 +15499,13 @@ User's Guide
\family sans \family sans
Itemize: Itemize:
\family default
\family roman \family roman
Again much the same as in the other classes: see the Again much the same as in the other classes: see the
\family default
\family roman
\emph on \emph on
User's Guide User's Guide
\emph default \emph default
@ -15544,15 +15533,17 @@ User's Guide
\family sans \family sans
Verbatim: Verbatim:
\family default \family default
As usual. As usual.
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
\family sans \family sans
Code: similar to the LyX-Code Code: similar to the LyX-Code
\family default
\family roman \family roman
environment environment
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -15594,7 +15585,7 @@ status collapsed
Author's note. Author's note.
\emph default \emph default
This needs checking --- This needs checking ---
\emph on \emph on
pe. pe.
\end_layout \end_layout
@ -15618,7 +15609,7 @@ status collapsed
\emph on \emph on
Author's note: Author's note:
\emph default \emph default
I have not yet checked this --- I have not yet checked this ---
\emph on \emph on
pe. pe.
\end_layout \end_layout
@ -15637,7 +15628,7 @@ You can also use the
\family sans \family sans
Layout Layout
\family default \family default
menu to set fonts or to emphasis words. menu to set fonts or to emphasis words.
You can also use the table of contents as usual; see the corresponding You can also use the table of contents as usual; see the corresponding
section of the section of the
\emph on \emph on
@ -15656,9 +15647,9 @@ status collapsed
\emph on \emph on
Author's note: Author's note:
\emph default \emph default
Again still checking to see whether this is my system Again still checking to see whether this is my system
\emph on \emph on
---pe. ---pe.
\end_layout \end_layout
\end_inset \end_inset
@ -15673,7 +15664,7 @@ Cross references and HTML
\begin_layout Standard \begin_layout Standard
On the On the
\family sans \family sans
Insert Insert
\family default \family default
menu you will find two new options relating to the inclusion of URL addresses. menu you will find two new options relating to the inclusion of URL addresses.
If you use either option you will find some highlighted TeX code inserted If you use either option you will find some highlighted TeX code inserted
@ -15735,7 +15726,7 @@ Then y
\family roman \family roman
ou ou
\family default \family default
insert some description between the second and third blocks. insert some description between the second and third blocks.
The differences are: The differences are:
\end_layout \end_layout
@ -15743,8 +15734,10 @@ insert some description between the second and third blocks.
\family sans \family sans
URL: URL:
\family default
\family roman \family roman
both the HTML tag and the description will appear in the document both the HTML tag and the description will appear in the document
\end_layout \end_layout
\begin_layout Itemize \begin_layout Itemize
@ -15752,6 +15745,8 @@ URL:
\family sans \family sans
HTML\InsetSpace ~ HTML\InsetSpace ~
URL: URL:
\family default
\family roman \family roman
only the description appears in the printed version only the description appears in the printed version
\end_layout \end_layout
@ -15786,11 +15781,11 @@ Linux Documentation Project Howto
. .
\family default \family default
To do the document translation you need to get and install the To do the document translation you need to get and install the
\family typewriter \family typewriter
sgml-tools-1.0.x.tar.gz sgml-tools-1.0.x.tar.gz
\family default \family default
(with (with
\begin_inset Formula $x\geq3$ \begin_inset Formula $x\geq3$
\end_inset \end_inset
@ -15886,6 +15881,8 @@ E
xport\SpecialChar \menuseparator xport\SpecialChar \menuseparator
as\InsetSpace ~ as\InsetSpace ~
LinuxDoc LinuxDoc
\family default
\family roman \family roman
option. option.
\end_layout \end_layout
@ -17419,6 +17416,11 @@ Starting from there you can reach many other interesting links and even
\end_layout \end_layout
\begin_layout Subsection \begin_layout Subsection
\begin_inset LatexCommand label
name "sub:LyX-and-Literate"
\end_inset
LyX and Literate Programming LyX and Literate Programming
\end_layout \end_layout
@ -17650,7 +17652,7 @@ For an example of this usage and the resulting cross-reference output, look
\emph on \emph on
LIBDIR/examples/listerrors.lyx LIBDIR/examples/listerrors.lyx
\emph default \emph default
which should make this all clear. which should make this all clear.
\end_layout \end_layout
\begin_layout Paragraph \begin_layout Paragraph
@ -17694,7 +17696,7 @@ D
\bar default \bar default
VI VI
\family default \family default
menu option is chosen, a LaTeX file is generated. menu option is chosen, a LaTeX file is generated.
\end_layout \end_layout
@ -17714,7 +17716,7 @@ literate
\family typewriter \family typewriter
.tex .tex
\family default \family default
extension. extension.
\end_layout \end_layout
\end_deeper \end_deeper
@ -17793,7 +17795,7 @@ When the build menu option is chosen or the corresponding button in the
toolbar is pressed, a LaTeX file is generated just like step 1 above. toolbar is pressed, a LaTeX file is generated just like step 1 above.
Next, LyX invokes the Next, LyX invokes the
\family typewriter \family typewriter
Noweb->Program Noweb->Program
\family default \family default
converter. converter.
Typically, this converter (like any other converter), has two parts: Typically, this converter (like any other converter), has two parts:
@ -17918,11 +17920,11 @@ The converter code looks in
\emph on \emph on
MYLYXDIR/scripts MYLYXDIR/scripts
\emph default \emph default
first, then in first, then in
\emph on \emph on
LIBDIR/scripts LIBDIR/scripts
\emph default \emph default
then on the path for the then on the path for the
\begin_inset Quotes eld \begin_inset Quotes eld
\end_inset \end_inset
@ -18010,7 +18012,7 @@ Look in
\emph on \emph on
LIBDIR/examples/listerrors.lyx LIBDIR/examples/listerrors.lyx
\emph default \emph default
or in or in
\emph on \emph on
LIBDIR/examples/Literate.lyx LIBDIR/examples/Literate.lyx
\emph default \emph default
@ -18028,7 +18030,7 @@ listerrors
LIBDIR/examples/noweb2lyx.lyx. LIBDIR/examples/noweb2lyx.lyx.
\emph default \emph default
Interestingly, these three files show off the language-indepence of the Interestingly, these three files show off the language-indepence of the
LyX literate programming support since they are written in Python, C and LyX literate programming support since they are written in Python, C and
Perl respectively. Perl respectively.
\end_layout \end_layout
@ -18204,7 +18206,6 @@ When debugging code with ddd/gdb, it is possible to invoke a text editor
It happens that you can define the editor command line invocation in ddd It happens that you can define the editor command line invocation in ddd
by accessing the by accessing the
\family sans \family sans
\bar under \bar under
E E
\bar default \bar default
@ -18220,7 +18221,7 @@ H
\bar default \bar default
elpers elpers
\family default \family default
dialog and changing the "Edit Sources" entry. dialog and changing the "Edit Sources" entry.
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard