-#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 256
+#LyX 1.5.0rc1 created this file. For more info see http://www.lyx.org/
+\lyxformat 271
\begin_document
\begin_header
\textclass book
\papersides 2
\paperpagestyle headings
\tracking_changes false
-\output_changes true
+\output_changes false
\author "usti"
+\author "Richard Heck"
\end_header
\begin_body
\begin_layout Standard
If you haven't read the
\emph on
-Introduction
+Introduction
\emph default
-yet, you are definitely in the wrong manual.
+ yet, you are definitely in the wrong manual.
The
\emph on
Introduction
\begin_layout Standard
Since all the topics in this manual depend heavily on LyX's interaction
- with LaTeX, this first chapter covers
-\emph on
-
-\emph default
-the inner workings of LyX and how to direct LyX to generate exactly the
- LaTeX code you want.
+ with LaTeX, this first chapter covers 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.
\end_layout
\begin_layout Standard
The LaTeX preamble comes at the very beginning of a document,
\emph on
-before
+before
\emph default
-the text.
+ the text.
It serves to:
\end_layout
declare the usage of packages.
LaTeX packages provide special commands, which are only available within
a document when the package has been declared in the preamble.
- For example, the
-\family typewriter
-
-\family default
-package
+ For example, the package
\family typewriter
indentfirst
\family default
\family typewriter
\backslash
-newcommand
+newcommand
\family default
-or
+ or
\family typewriter
\backslash
\begin_layout Standard
First, make sure you're using the
\family sans
-article
+article
\family default
-document class.
+ document class.
Next, you need to put the following in your preamble:
\end_layout
\end_layout
\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
-
\bar under
D
\bar default
\bar under
S
\bar default
-ettings
+ettings
\family default
-and select the
+ and select the
\family sans
Bibliography
\family default
\bar under
S
\bar default
-ettings
+ettings
\family default
-and select the
+ and select the
\family sans
Bibliography
\family default
\bar under
S
\bar default
-ettings
+ettings
\family default
-and select the
+ and select the
\family sans
Bibliography
\family default
\bar no
\noun off
\color none
-In the
-\family sans
+In the
+\family default
\series default
\shape default
-\size default
\emph default
\bar default
+
+\family sans
+\size default
\noun default
Outputs\SpecialChar \menuseparator
LaT\SpecialChar \textcompwordmark{}
\bar no
\noun off
section of the preferences dialog, however, you can customize the index
- command, if you prefer an alternative program like
-\family typewriter
+ command, if you prefer an alternative program like
+\family default
\series default
\shape default
-\size default
\emph default
\bar default
+
+\family typewriter
+\size default
\noun default
xindy
\family roman
\begin_layout Standard
by
\noun on
-Özgür U\i \~{g}
-ra\i \c{s}
- Baran
+Özgür Ug̃raş Baran
\end_layout
\begin_layout Standard
\family default
and
\family typewriter
-sigma
+sigma
\family default
-correspondingly.
+ correspondingly.
Then, these entries will be effective in the sort ordering and
\begin_inset Formula $a$
\end_inset
output
\family default
checkbox typesets a mark to unambiguously define the presence of a space.
-
-\emph on
\end_layout
\begin_layout Standard
Select which bullet depth you want to change then select the bullet shape
and size.
-
-\family sans
-
-\family default
-Any changes will not be visible in LyX, but are visible when viewing the
+ Any changes will not be visible in LyX, but are visible when viewing the
document using xdvi or ghostview.
\end_layout
\end_inset
-)
-\emph on
-
-\emph default
-using
-\emph on
-
-\emph default
-Version 5.01 of the document class
+) using Version 5.01 of the document class
\family typewriter
aa.cls
\family default
F
\bar default
ootnote.
-
+
\family default
-LyX will automagically use the term
+ LyX will automagically use the term
\family typewriter
\backslash
\begin_layout Standard
LyX provides support for the necessary float environments
\family sans
-figure, figure*, table
+figure, figure*, table
\family default
-and
+ and
\family sans
table*
\family default
\end_layout
\begin_layout Standard
-There is
-\family sans
-
-\family default
-only one special thing: the figures with caption besides the figure.
+There is only one special thing: the figures with caption besides the figure.
To create such a figure, you have to do the following:
\end_layout
t\SpecialChar \menuseparator
Figure
\family default
-, then right click in the figure and select
+, then right click in the figure and select
\family sans
-
\bar under
S
\bar default
the closing brace:
\family sans
M-c\InsetSpace ~
-t
+t
+\family default
+
\family typewriter
}
\family default
F
\bar default
ile\SpecialChar \menuseparator
-New from
+New from
+\family default
+
+\family sans
\bar under
T
\bar default
\backslash
paragraph
\family default
- (2.7),
+ (2.7),
\family typewriter
-
+
\backslash
facility
\family default
bibitem
\family default
(2.13.2), all the cite commands and their variations (2.13.2), the generic
- graphicx figure commands (2.14.1),
+ graphicx figure commands (2.14.1),
\family typewriter
-
+
\backslash
begin{table}
\family default
\backslash
objectname
\family default
-,
+,
\family typewriter
-
+
\backslash
dataset
\family default
-,
+,
\family typewriter
-
+
\backslash
url
\family default
g.\InsetSpace ~
\emph default
-type
+type
\family typewriter
- Ressler(1992)
+Ressler(1992)
\family default
, not
\family typewriter
F
\bar default
ile\SpecialChar \menuseparator
-New from
+New from
+\family default
+
+\family sans
\bar under
T
\bar default
.
\end_layout
+\begin_layout Section
+iopart
+\end_layout
+
+\begin_layout Standard
+by
+\noun on
+Uwe Stöhr
+\end_layout
+
+\begin_layout Subsection
+Overview
+\end_layout
+
+\begin_layout Standard
+The iopart package provides a document class to create electronic manuscript
+ 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"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection
+Writing a paper
+\end_layout
+
+\begin_layout Standard
+The easiest way to write a paper is to start with the file
+\emph on
+IOP-article.lyx
+\emph default
+ that is available in LyX's examples files folder.
+ Open this file, save it under a new name, and start writing.
+ The example file explains how to use the special text environments.
+ Here are the most important advices:
+\end_layout
+
+\begin_layout Itemize
+To be able to compile your document to a PDF, PS, or DVI, assure that the
+ two options
+\family sans
+Use AMS math package
+\family default
+ in the document settings under
+\family sans
+Math Options
+\family default
+ are not used!
+\end_layout
+
+\begin_layout Itemize
+
+\size normal
+The title environment defines the kind of your paper.
+ So use one of the following environments for the title:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\family sans
+\size normal
+Title
+\family default
+ for a Paper
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Review
+\family default
+ for a Review
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Topical
+\family default
+ for a Topical review
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Comment
+\family default
+ for a Comment
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Note
+\family default
+ for a Note
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Paper
+\family default
+ for a Paper (same as Title)
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Prelim
+\family default
+ for a Preliminary communication
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Rapid
+\family default
+ for a Rapid communication
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\size normal
+Letter
+\family default
+ for a Letter to the editor
+\end_layout
+
+\end_deeper
+\begin_layout Itemize
+
+\size normal
+All title environments except of
+\family sans
+Letter
+\family default
+ can have an optional short title.
+\end_layout
+
+\begin_layout Itemize
+There is a general title environment
+\family sans
+Article
+\family default
+ which is not directly supported by the LyX.
+ This can be used as ERT when your document doesn't fit into one of the
+ other title types.
+\end_layout
+
+\begin_layout Standard
+For more informations like hints for special table and formula formatting,
+ look at the IOP author guidelines.
+\end_layout
+
\begin_layout Section
Kluwer
\end_layout
Click on
\family sans
File\SpecialChar \menuseparator
-New from
+New from
+\family default
+
+\family sans
\bar under
T
\bar default
\end_layout
\begin_layout Standard
-The LyX document classes
+The LyX document classes
\emph on
- article (koma-script)
+article (koma-script)
\emph default
,
\emph on
Headings, labels of the description environment, and a number of elements
of the
\emph on
-letter (koma-script)
+letter (koma-script)
\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
status collapsed
In comparison, the ec bold sans serif fonts look a bit thin.
Here the LaTeX package
\family typewriter
-cmsd.sty by
+cmsd.sty by
\family default
+
\shape smallcaps
Walter Schmidt
\shape default
, resp., additionally inserting an entry in the table of contents.
\family sans
-Addpart
+Addpart
\family default
-and
+ and
\family sans
- Addchap
+Addchap
\family default
are not contained in
\emph on
Addsec
\family default
, resp., additionally clearing running heads.
-
+
\family sans
- Addchap*
+Addchap*
\family default
is not contained in
\emph on
\family default
and
\family sans
-Captionbelow
+Captionbelow
\family default
-are special captions which respect the different space settings needed for
- captions placed above or below an element (if you follow strict typographic
+ are special captions which respect the different space settings needed
+ 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).
You can also use the class option
\family typewriter
\begin_layout Standard
The types
\family sans
-Letter
+Letter
\family default
-and
+ and
\family sans
Opening
\family default
\family sans
Address
\family default
-,
+,
\family sans
- Telephone
+Telephone
\family default
,
\family sans
D
\bar default
ocument\SpecialChar \menuseparator
-Extra Options
+Extra Options
\family default
-field.
+ field.
\end_layout
\end_inset
\emph default
:
\family typewriter
-svjog.layout
+svjog.layout
\family default
---- Martin Vermeer
+ --- Martin Vermeer
\end_layout
\begin_layout Itemize
\emph default
:
\family typewriter
-jgrga.layout
+jgrga.layout
\family default
---- Martin Vermeer
+ --- Martin Vermeer
\end_layout
\begin_layout Standard
.
The
\family sans
-foils
+foils
\family default
-class [
+ class [
\begin_inset Quotes eld
\end_inset
to automatically set up a document to use the
\family sans
-slides
+slides
\family default
-class [using
+ class [using
\family sans
\bar under
F
\begin_layout Standard
The first thing you'll notice when you start up a new
\family sans
-slides
+slides
\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
\end_inset
\family sans
Slide
\family default
-,
+,
\family sans
- Overlay
+Overlay
\family default
and
\family sans
\family default
environments work the same way as the
\family sans
-Slide
+Slide
\family default
-environment.
+ environment.
They both create an
\begin_inset Quotes eld
\end_inset
\family sans
Overlay
\family default
- --
+ --
\family sans
- Note
+Note
\family default
triplet.
The
.
If your machine doesn't have the
\family sans
-foils
+foils
\family default
-class [
+ class [
\begin_inset Quotes eld
\end_inset
\begin_layout Standard
The two new list styles,
\family sans
-TickList
+TickList
\family default
-and
+ and
\family sans
CrossList
\family default
\end_layout
\begin_layout Standard
-The remaining page corners can be filled by
+The remaining page corners can be filled by
\family sans
- Right\InsetSpace ~
+Right\InsetSpace ~
Footer
\family default
(which defaults to page numbers),
\family typewriter
\backslash
-abovefloatskip
+abovefloatskip
\family default
-Separation between the text and the top of the float
+ Separation between the text and the top of the float
\end_layout
\begin_layout List
\family typewriter
\backslash
-abovecaptionskip
+abovecaptionskip
\family default
-Separation between the float and the caption
+ Separation between the float and the caption
\end_layout
\begin_layout List
\family typewriter
\backslash
-belowcaptionskip
+belowcaptionskip
\family default
-Separation between the caption and the following text
+ Separation between the caption and the following text
\end_layout
\begin_layout List
\begin_layout Standard
The last length related command affects all the list environments.
- If you place
+ If you place
\family typewriter
-
+
\backslash
zerolistvertdimens
\family default
Subtitle for
\family sans
ACT.
-
+
\family default
-It is just centered text.
+ It is just centered text.
\end_layout
\begin_layout Itemize
\end_layout
\begin_layout Standard
-The LyX document classes
+The LyX document classes
\emph on
- article (mwart)
+article (mwart)
\emph default
,
\emph on
\family typewriter
\backslash
-aliaspagestyle{title}{empty}
+aliaspagestyle{title}{empty}
\family default
-in the preamble.
+ in the preamble.
\end_layout
\begin_layout Description
Article: With the class option
\emph on
-article
+article
\emph default
-(to be inserted in
+ (to be inserted in
\family sans
Layout\SpecialChar \menuseparator
Document\SpecialChar \menuseparator
\bar under
C
\bar default
-ustom
+ustom
\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.
The possible values are all formats that LyX can produce from its own documents.
\begin_layout Standard
While it is not possible to save this command using the
\family sans
-Preferences
+Preferences
\family default
-dialog, you can manually edit your
+ dialog, you can manually edit your
\family typewriter
.lyx/preferences
\family default
ettings
\family default
dialog.
-
-\family sans
-
-\family default
-Then you will find that there are fewer paragraph environments than for
+ Then you will find that there are fewer paragraph environments than for
most other classes.
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 ~
To use the other features of the SGML package you need to save your document
as LinuxDoc; this is a version in which the document is translated into
the basic sgml tags.
- Use
+ Use
\family sans
-
\bar under
F
\bar default
\family sans
Standard:
+\family default
+
\family roman
- works as described in [cross reference]
+works as described in [cross reference]
\end_layout
\begin_layout Itemize
\begin_layout Itemize
\family sans
-Itemize:
+Itemize:
+\family default
+
+\family roman
+Again much the same as in the other classes: see the
+\family default
+
\family roman
-Again much the same as in the other classes: see the
\emph on
User's Guide
\emph default
\begin_layout Itemize
\family sans
-Verbatim:
+Verbatim:
\family default
-As usual.
+ As usual.
\end_layout
\begin_layout Itemize
\family sans
Code: similar to the LyX-Code
+\family default
+
\family roman
- environment
+environment
\end_layout
\begin_layout Itemize
\emph on
Author's note.
-
+
\emph default
-This needs checking ---
+ This needs checking ---
\emph on
pe.
\end_layout
\begin_layout Standard
\emph on
-Author's note:
+Author's note:
\emph default
-I have not yet checked this ---
+ I have not yet checked this ---
\emph on
pe.
\end_layout
\begin_layout Standard
You can also use the
\family sans
-Layout
+Layout
\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
section of the
\emph on
\begin_layout Standard
\emph on
-Author's note:
+Author's note:
\emph default
-Again still checking to see whether this is my system
+ Again still checking to see whether this is my system
\emph on
- ---pe.
+---pe.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-On the
+On the
\family sans
- Insert
+Insert
\family default
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
\family default
Then y
\family roman
-ou
+ou
\family default
-insert some description between the second and third blocks.
+ insert some description between the second and third blocks.
The differences are:
\end_layout
\family sans
URL:
+\family default
+
\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
\begin_layout Itemize
\family sans
HTML\InsetSpace ~
-URL:
+URL:
+\family default
+
\family roman
only the description appears in the printed version
\end_layout
\family sans
\emph 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
-sgml-tools-1.0.x.tar.gz
+sgml-tools-1.0.x.tar.gz
\family default
-(with
+ (with
\begin_inset Formula $x\geq3$
\end_inset
\bar default
xport\SpecialChar \menuseparator
as\InsetSpace ~
-LinuxDoc
+LinuxDoc
+\family default
+
\family roman
option.
\end_layout
\family typewriter
\backslash
-
-\family default
+\family default
+
\begin_inset Quotes eld
\end_inset
\end_layout
\begin_layout Subsection
+\begin_inset LatexCommand label
+name "sub:LyX-and-Literate"
+
+\end_inset
+
LyX and Literate Programming
\end_layout
For an example of this usage and the resulting cross-reference output, look
at the Literate python program in
\emph on
-LIBDIR/examples/listerrors.lyx
+LIBDIR/examples/listerrors.lyx
\emph default
-which should make this all clear.
+ which should make this all clear.
\end_layout
\begin_layout Paragraph
\bar under
D
\bar default
-VI
+VI
\family default
-menu option is chosen, a LaTeX file is generated.
+ menu option is chosen, a LaTeX file is generated.
\end_layout
format (defined in the Preferences panel), otherwise the file will have
the usual
\family typewriter
-.tex
+.tex
\family default
-extension.
+ extension.
\end_layout
\end_deeper
\begin_layout Standard
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.
- Next, LyX invokes the
+ Next, LyX invokes the
\family typewriter
- Noweb->Program
+Noweb->Program
\family default
converter.
Typically, this converter (like any other converter), has two parts:
\begin_layout Standard
The converter code looks in
\emph on
-MYLYXDIR/scripts
+MYLYXDIR/scripts
\emph default
-first, then in
+ first, then in
\emph on
- LIBDIR/scripts
+LIBDIR/scripts
\emph default
-then on the path for the
+ then on the path for the
\begin_inset Quotes eld
\end_inset
\begin_layout Standard
Look in
\emph on
-LIBDIR/examples/listerrors.lyx
+LIBDIR/examples/listerrors.lyx
\emph default
-or in
+ or in
\emph on
LIBDIR/examples/Literate.lyx
\emph default
in
\emph on
LIBDIR/examples/noweb2lyx.lyx.
-
+
\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
Perl respectively.
\end_layout
at the current execution position with a single key stroke.
The default ddd configuration for that is shift-ctrl-V.
It happens that you can define the editor command line invocation in ddd
- by accessing the
+ by accessing the
\family sans
-
\bar under
E
\bar default
\bar under
H
\bar default
-elpers
+elpers
\family default
-dialog and changing the "Edit Sources" entry.
+ dialog and changing the "Edit Sources" entry.
\end_layout
\begin_layout Standard
projects / lyx.git / blobdiff