#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 376
+\lyxformat 387
\begin_document
\begin_header
\textclass scrbook
\papercolumns 1
\papersides 2
\paperpagestyle default
-\tracking_changes false
+\tracking_changes true
\output_changes false
-\html_use_mathml true
+\html_math_output 0
\html_be_strict true
+\html_math_img_scale 1
+\html_latex_start "<span class='latex'>"
+\html_latex_end "</span>"
\author 1 "Richard Heck"
\end_header
\end_layout
\begin_layout Standard
-Note that there is no horizontal scroll bar.
+Note that there is no horizontal scrollbar.
This is not a bug or an oversight, but intentional.
When you read a book, you expect the end of a line to wrap around to the
next line.
\end_layout
\begin_layout Standard
-LyX needs several LaTeX packages to work properly.
- The packages found on the system by LyX are listed in the file
-\emph on
-LaT
-\emph default
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
-
-{}
+\change_inserted 1 1269457017
+You can edit documents in LyX without having LaTeX installed, but you will
+ not to able to create PDFs or print your documents unless you do have it
+ installed.
+ Actually, that isn't quite true.
+ Some LyX documents use DocBook as the `backend' that produces PDFs and
+ the like, and any LyX document can be outupt as plain text or as XHTML.
+ Still, most of the documents people edit in LyX use LaTeX as the backend,
+ and so exporting these documents to PDF, or printing them, requires you
+ to have LaTeX properly installed.
\end_layout
-\end_inset
-
+\begin_layout Standard
-\emph on
-eX
-\begin_inset space ~
-\end_inset
+\change_inserted 1 1269457113
+Moreover, specific document classes may depend upon specific LaTeX or DocBook
+ classes or packages.
+ Again, such document classes can be used even if you do not have the required
+ files installed, but you will not be able to produce certain kinds of output.
+\end_layout
-Configuration
-\emph default
- that will be created when using the menu
+\begin_layout Standard
+The
+\change_inserted 1 1269457161
+LaTeX
+\change_unchanged
+packages that LyX has found on your system are listed in a file you can
+ view from the menu
\family sans
Help\SpecialChar \menuseparator
LaT
Configuration
\family default
.
- You should install the required missing packages and then reconfigure LyX.
+
+\change_inserted 1 1269457187
+ If you are missing packages you need, then
+\change_unchanged
+
+\change_deleted 1 1269457188
+Y
+\change_inserted 1 1269457189
+y
+\change_unchanged
+ou should install the required missing packages and then reconfigure LyX.
\begin_inset Note Note
status collapsed
\begin_inset Quotes erd
\end_inset
- is printed with sub- and superscript letters.
+ from being printed with sub- and superscript letters.
More about TeX Code is described in section
\begin_inset space ~
\end_inset
\end_inset
+\change_inserted 1 1269457202
+ See section 5.1 of the
+\emph on
+Customization
+\emph default
+ manual for more information on installing additional LaTeX packages.
+\change_unchanged
+
\end_layout
\begin_layout Chapter
\end_layout
\begin_layout Standard
-In the preferences dialog, that is opened with the menu
+In the preferences dialog, which is opened with the menu
\family sans
Tools\SpecialChar \menuseparator
Preferences
\family sans
Document\SpecialChar \menuseparator
Settings
+\change_inserted 1 1269457473
+\SpecialChar \menuseparator
+Document Class
+\change_unchanged
+
\begin_inset Index idx
status collapsed
\begin_layout Standard
There are also some non-standard classes, which LyX only uses if you have
- installed them.
- Here are some of the classes, the full list with detailed explanations
- can be found in chapter
+ installed the corresponding LaTeX class files, though most LaTeX distributions
+ will include many of these.
+ Here are some of the classes.
+ The full list with detailed explanations can be found in chapter
\emph on
Special Document Classes
\emph default
\end_layout
\begin_layout Description
-koma-script a replacement for the standard classes, offers many useful features
+KOMA-Script a replacement for the standard classes, offers many useful features
like caption formatting, automatic print space calculation etc.
\end_layout
\begin_layout Standard
We won't go into any detail about how to use these different document classes
here.
- You can find all the details about the non-standard classes in the
+ You can find all the details about the non-standard classes in Chapter
+ 6 of the
\emph on
Additional Features
\emph default
manual.
Here, we will settle with a list of some of the common properties of all
of the document classes.
+\change_inserted 1 1269457401
+
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 1 1269457704
+Why Is My Document Class `Unavailable'?
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 1 1269458954
+New users are sometimes puzzled by the fact that many of the document classes
+ listed under
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Document Class
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 1 1269457484
+Document ! Settings
+\end_layout
+
+\end_inset
+
+
+\family default
+are marked as
+\begin_inset Quotes eld
+\end_inset
+
+Unavailable
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Or they are surprised that, when they try to open the
+\family sans
+hollywood
+\family default
+ template, they receive a message saying that the document class requires
+ external files to produce output, files that are not installed.
+ Surely something is wrong.
+ Right?
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 1 1269458991
+Nothing is wrong.
+ LyX includes many more document classes than you will ever need to use,
+ and some of them, like
+\family sans
+hollywood
+\family default
+ (which is used for screenplays), are highly specialized.
+ Indeed, we want LyX to support as many different types of documents as
+ possible, and, as of LyX 2.0, it includes almost one hundred different layout
+ files, with the number growing all the time.
+ No sensible LaTeX distribution will install all of the different files
+ that might be needed by some LyX document class by default.
+ There are too many, and they are too various.
+ That is why some of the document classes are unavailable.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 1 1269459048
+So, if there is a document class you would like to use that is marked as
+ `Unavailable', all you need to do is install the appropriate class or package
+ files.
+ The easiest way to find out which files you need to install is to try selecting
+ that document class.
+ LyX will display a dialog that, among other things, will list the missing
+ files.
+ Most TeX distributions now include a See section 5.1 of the
+\emph on
+Customization
+\emph default
+ manual for information on how to install them.
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 1 1269458726
+I Need a Document Class That Isn't Even Listed
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 1 1269459092
+Although, as said, LyX provides support for many different sorts of documents,
+ it does not include support for every document class people might want
+ to use.
+ For example, many universities provide LaTeX class files to be used for
+ dissertations submitted to those universities.
+ For example, the LaTeX document class
+\family sans
+ucthesis
+\family default
+ is used for dissertations at the University of California.
+ The LyX team cannot write `layout files' to support every one of these.
+ There are too many.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 1 1269459143
+Fortunately, however, users can write their own layout files, and many users
+ have done so.
+ Sometimes, this is quite easy, but sometimes it can be quite hard.
+ Chapter 5 of the
+\emph on
+Customization
+\emph default
+ manual contains information on how to add support for your favorite document
+ type.
+\change_unchanged
+
\end_layout
\begin_layout Subsubsection
\end_layout
\begin_layout Standard
-Modules load additional features to a document that are not by default available
- in the chosen document class.
- For example you might want to use write Braille (embossed printing) in
- a document.
- This is of course not available in any document class, so you have to load
- the corresponding module in the
+Modules load additional features that are not by default available in the
+ chosen document class.
+ For example you might want to write Braille (embossed printing) in a document.
+ This is not available in any document class, so you have to load the correspond
+ing module in the
\family sans
Modules
\family default
dialog.
Highlighting a module in the dialog will bring up a description of the
module.
+\change_inserted 1 1269456873
+
\end_layout
\begin_layout Standard
-\begin_inset Note Greyedout
-status open
+
+\change_inserted 1 1269456922
+Some modules require LaTeX packages that are not always installed by default.
+ LyX will warn you if you do not have the needed package.
+ You can still use the module while editing your file, but you will not
+ be able to export PDF or print your document, since LyX will not be able
+ to compile the LaTeX file without the missing package.
+ If you want to be able to produce output, then you need to install the
+ missing package and then reconfigure LyX by selecting
+\family sans
+Tools\SpecialChar \menuseparator
+Reconfigure
+\family default
+.
+\begin_inset Index idx
+status collapsed
\begin_layout Plain Layout
-\series bold
-Note:
-\series default
- Some modules require LaTeX packages that are not always installed by default.
- LyX will warn you if you do not have the needed package.
+\change_inserted 1 1269456873
+Reconfiguration of LyX
\end_layout
\end_inset
+ See section 5.1 of the
+\emph on
+Customization
+\emph default
+ manual for more information on installing needed packages.
+\change_unchanged
\end_layout
Note also:
\series default
Some modules require other modules, and some pairs of modules are incompatible.
+ LyX will advise you about these things.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-If you use a koma-script document class, you can use the default settings.
- Because koma-script calculates then the printspace automatically by taking
+If you use a KOMA-Script document class, you can use the default settings.
+ Because KOMA-Script calculates then the printspace automatically by taking
the paper format and the font size into account.
\end_layout
\emph default
into the new class.
That includes the paragraph environments.
- Some paragraph environments are standard; all of the document classes have
- them; but some classes have special paragraph environments.
- If this is the case, and you change the document class, LyX sets the missing
- paragraph environments to
-\family sans
-Standard
-\family default
- and places an error box at the beginning of the paragraph.
- Just click on them and you'll get a message dialog that tells you about
- the conversion and why it failed.
+ Some paragraph environments are standard, in so far as all of the document
+ classes have them; but some classes have special paragraph environments.
+ If this is the case, and you change the document class, LyX will mark the
+ paragraphs whose styles it no longer understands as
+\begin_inset Quotes eld
+\end_inset
+
+unknown
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The name of the style is retained, in case you should want to go back to
+ the old class.
+ But these paragraphs will be output with no special formatting, so you
+ will either need to create a new style yourself or else to convert these
+ paragraphs manually to a style present in your new document class.
\end_layout
\begin_layout Section
status collapsed
\begin_layout Plain Layout
-Document !Title
+Document ! Title
\end_layout
\end_inset
\family typewriter
ec
\family default
- are bitmap fonts, they often looks pixeled in PDF output, especially when
- you read the PDF in a zoomed size.
+ are bitmap fonts, they often looks pixelated in PDF output, especially
+ when you read the PDF in a zoomed size.
\begin_inset Foot
status collapsed
\end_inset
- To get rid of pixeled fonts, you have to use a vector font.
+ To get rid of pixelated fonts, you have to use a vector font.
There are three ways to use one:
\end_layout
\end_layout
\begin_layout Standard
-DVI files doen't contain images, they only link them.
+DVI files do not contain images, they only link them.
So don't forget to deliver the images together with your DVIs.
Because the DVI-viewer has to convert the image in the background to make
it visible when you scroll the DVI, this can slow down your computer when
status collapsed
\begin_layout Plain Layout
-FileFormats! XHTML
+FileFormats ! XHTML
\end_layout
\end_inset
, every output document format allows only a few image formats.
LyX uses therefore the program
\family typewriter
-Imagemagick
+ImageMagick
\family default
in the background to convert the images to the right format.
To increase your workflow by avoiding these conversions in the background,
\end_inset
images consist of pixel values, often in a compressed form.
- They are therefore not fully scalable and look pixeled in large zooms.
+ They are therefore not fully scalable and look pixelated in large zooms.
Well-known bitmap image formats are
\begin_inset Quotes eld
\end_inset
\bar no
\noun off
\color none
-This is a multiline entry in a table.
+This is a multi-line entry in a table.
\end_layout
\end_inset
\bar no
\noun off
\color none
-This is a multiline entry in a table.
+This is a multi-line entry in a table.
This is longer now.
\end_layout
\begin_layout Standard
Rotated floats are always placed on their own pages (or columns, when you
- have a multi-column document).
+ have a multicolumn document).
You can let them span several columns using the float settings option
\family sans
Span
\end_layout
\begin_layout Standard
-Note that the style <page> won't print the page number if the label is on
- the previous, the same, or the next page.
+
+\family sans
+<page>
+\family default
+ will not print the page number if the label is on the previous, the same,
+ or the next page.
You will e.
\begin_inset space \thinspace{}
\end_inset
\end_inset
instead.
+ The style
+\family sans
+<reference> on page <page>
+\family default
+ will not print anything about the page if the label is on the same page.
\end_layout
\begin_layout Standard
Format
\family default
of the cross-reference window, that appear when you click on the cross-referenc
-e box.
+e.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-If you want to reference a section, put the label in the section heading,
- to reference a float, put the label in the caption.
- For footnotes you can put the label somewhere in it.
+If you want to reference a section, put the label in the section heading;
+ for floats put the label in the caption; for footnotes put the label in
+ it.
Referencing formulas is explained in section
\begin_inset space ~
\end_inset
\end_layout
\begin_layout Standard
-The button
+Right-clicking on a cross-reference opens a context menu.
+ The entry
\family sans
Go
\begin_inset space ~
Label
\family default
- in the cross-reference window sets the the cursor before the referenced
- label.
- The button text changes then to
+ sets the the cursor before the referenced label.
+ This entry will be renamed in the context menu of the label to
\family sans
Go
\begin_inset space ~
Back
\family default
- and you can use it to set the cursor back to the cross-reference.
- Right-clicking on a cross-reference box also sets the cursor before the
- referred label and you can go back with the toolbar button
+ so that you can use it to set the cursor back to the cross-reference.
+ You can also go back with the toolbar button
\begin_inset Graphics
filename ../images/bookmark-goto_0.png
BoundingBox 0bp 5bp 20bp 25bp
\end_layout
\begin_layout Standard
-You can change labels at any time by clicking on the label box.
- References to the changed label will automatically change its link to the
- new label text, so that you don't need to take care about this.
+You can change labels at any time.
+ References to the changed label will automatically be updated so that you
+ do not need to take care about this.
\end_layout
\begin_layout Standard
-If a cross-reference refers to a non-existent label, you'll see two question
+If a cross-reference refers to a non-existent label, you will see two question
marks in the output instead of the reference.
\end_layout
.
If you want anything other than numerical citations that are used in this
- document, like author-year cituations, then you must
+ document, like author-year citations, then you must
\emph on
\emph default
\begin_layout Standard
If you need specific options or an alternative index program only for a
- given document, you can define the programm and\SpecialChar \slash{}
+ given document, you can define the program and\SpecialChar \slash{}
or the options in
\family sans
Document\SpecialChar \menuseparator
like your case.
For example if you use a
\family sans
-koma-script
+KOMA-Script
\family default
class, you don't need the package
\series bold
\family typewriter
ispell
\family default
-, so that it is recommended to use aspell.
+, and contrary to
+\family typewriter
+ispell
+\family default
+, it supports multiple languages in parallel, so it is recommended to use
+ aspell.
\family typewriter
hspell
\family default
is a Hebrew spell-checker.
- The used spell checker ind its settings are specified in LyX's preferences
+ The used spell checker and its settings are specified in LyX's preferences
under
\family sans
Language Settings
\end_layout
\begin_layout Standard
-Here is a list of all available entries
-\change_deleted 1 1262887786
-; they are explained in detail in section
+Here is a list of all available entries; some of them are explained in detail
+ in section
\begin_inset space ~
\end_inset
\end_inset
:
-\change_inserted 1 1262887786
-:
-\change_unchanged
-
\end_layout
\begin_layout Description
\family default
format of the special LyX 1.4.x versions for Chinese, Japanese, and Korean
(CJK)
-\change_deleted 1 1262887560
-;
-\change_inserted 1 1262887561
-
\begin_inset Newline newline
\end_inset
-
-\change_unchanged
-
-\change_deleted 1 1262887562
-(
-\change_unchanged
-Since LyX 1.5.0 CJK support is fully integrated to LyX.
-\change_deleted 1 1262887564
-)
-\change_unchanged
-
+ Since LyX 1.5.0 CJK support is fully integrated to LyX.
\end_layout
\begin_layout Description
DVI
\family default
DVI-format
-\change_inserted 1 1262887797
- (see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
\end_layout
\begin_layout Description
-HTML HTML-format
-\change_inserted 1 1262887568
-
-\begin_inset Newline newline
-\end_inset
-
-
-\change_deleted 1 1262887572
- (t
-\change_inserted 1 1262887573
-T
-\change_unchanged
-he HTML
-\change_inserted 1 1262887602
-
-\change_deleted 1 1262887603
--
-\change_unchanged
-conver
-\change_inserted 1 1262887606
-sion
-\change_deleted 1 1262887609
-ter
-\change_unchanged
- is
-\change_inserted 1 1262887612
-performed by
-\change_unchanged
-a third-party product and
-\change_inserted 1 1262887674
-may
-\change_deleted 1 1262887617
-doesn't
-\change_unchanged
-work in all cases
-\change_inserted 1 1262887618
-.
-\change_deleted 1 1262887618
-)
-\change_unchanged
-
+HTML HTML-format (the HTML-converter is a third-party product and may not
+ work in all cases)
\end_layout
\begin_layout Description
\end_inset
is replaced by the version number)
-\change_inserted 1 1262887695
-
\end_layout
\begin_layout Description
-
-\change_inserted 1 1262887844
-LyXHTML HTML-format, using LyX's internal XHTML engine (see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
+LyXHTML HTML-format, using LyX's internal XHTML engine
\end_layout
\begin_layout Description
Abiword
\family default
, etc.
-\change_inserted 1 1262887646
-
-\begin_inset Newline newline
-\end_inset
-
-
-\change_deleted 1 1262887649
- (t
-\change_inserted 1 1262887649
-T
-\change_unchanged
-he OpenDocument
-\change_inserted 1 1262887652
-
-\change_deleted 1 1262887652
--
-\change_unchanged
-conver
-\change_inserted 1 1262887656
-sion
-\change_deleted 1 1262887654
-ter
-\change_unchanged
- is
-\change_inserted 1 1262887659
-performed by
-\change_unchanged
-a third-party product and
-\change_inserted 1 1262887665
-may not
-\change_deleted 1 1262887667
-doesn't
-\change_unchanged
-work in all cases
-\change_inserted 1 1262887669
-.
-\change_deleted 1 1262887670
-)
-\change_unchanged
-
+ (The OpenDocument-converter is a third-party product and may not work in
+ all cases)
\end_layout
\begin_layout Description
PDF-format using the program
\family typewriter
dvipdfm
-\change_inserted 1 1262887911
-
-\family default
-(see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
\end_layout
\begin_layout Description
PDF-format using the program
\family typewriter
pdflatex
-\change_inserted 1 1262887913
-
-\family default
-(see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
\end_layout
\begin_layout Description
PDF-format using the program
\family typewriter
ps2pdf
-\change_inserted 1 1262887914
-
-\family default
-(see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
\end_layout
\begin_layout Description
PostScript format using the program
\family typewriter
dvips
-\change_inserted 1 1262887921
-
-\family default
-(see
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
\end_layout
\begin_layout Description