#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 258
+\lyxformat 276
\begin_document
\begin_header
\textclass scrbook
% speed up the longtable calculation
\setcounter{LTchunksize}{100}
-% define a new reference format
-\newrefformat{fig}
- {Figure~float~\ref{#1} printed on page~\pageref{#1}}
-
% used for colored tables
\@ifundefined{textcolor}
{\usepackage{color}}{}
% used for book-style tables
\usepackage{booktabs}
-% used to have extra space in table cells,
+% used to have extra space in table cells
+\@ifundefined{extrarowheight}
+ {\usepackage{array}}{}
\setlength{\extrarowheight}{2pt}
% used for customized tables
\newcolumntype{W}{!{\color{green}\vline}}
% ---
-% To be able to enter the characters ° and · directly in LyX
-\DeclareInputText{176}{\ifmmode^\circ\else\textdegree\fi}
-\DeclareInputText{183}{\ifmmode\cdot\else\textperiodcentered\fi}
-
% insert additional vertical space of
% 1.5 mm between footnotes
\let\myFoot\footnote
\setboolean{marginnote}{true}}
{\setboolean{marginnote}{false}}
\end_preamble
-\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage
+\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage,tablecaptionabove
\language english
\inputencoding auto
\font_roman default
\bullet 2 2 35 -1
\bullet 3 2 7 -1
\tracking_changes false
-\output_changes true
+\output_changes false
+\author ""
\author ""
\end_header
\begin_body
\begin_layout Title
-LyX's detailed Figure, Table, Floats, Notes, and Boxes manual
+LyX's detailed Figure, Table, Floats, Notes, Boxes and External Material
+ manual
\end_layout
\begin_layout Author
\begin_inset LatexCommand index
-name "Figure"
+name "Figures"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Graphics|see{Figures}"
\end_inset
\begin_layout Section
Graphics Dialog
\begin_inset LatexCommand index
-name "Figure ! Graphics Dialog"
+name "Figures ! Graphics Dialog"
+
+\end_inset
+
+
+\begin_inset LatexCommand label
+name "sec:Graphics-Dialog"
\end_inset
\begin_inset Graphics
filename ../images/dialog-show-new-inset_graphics.xpm
scale 85
+ scaleBeforeRotation
\end_inset
You can rotate images counter-clockwise by setting a rotation angle and
a rotation origin.
The image will also be rotated inside LyX.
+\newline
+Images can be scaled by using
+ a percentage value or by setting the width and height explicitly.
+ If you set only the width or only the height, the other size will be determined
+ automatically.
+ If you set both, then the image will be transformed to the given size,
+ possibly distorting it.
+ To prevent the image from distortion, use the option
+\family sans
+Maintain aspect ratio
+\family default
+.
+ The image will then be scaled so that its width and height don't exceed
+ the specified dimensions.
+\newline
+Images can be opened in a program of your choice
+ when pressing the
+\family sans
+Edit
+\family default
+ button.
+ The program can be set for every image format in the file format settings
+ in LyX's preferences.
\end_layout
\begin_layout Description
\end_layout
\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
-\newpage
+
+\end_layout
+
+\begin_layout Standard
This is an example image in EPS format
\begin_inset Foot
status collapsed
\begin_layout Standard
\align center
\begin_inset Graphics
- filename mobius.eps
+ filename clipart/mobius.eps
display color
scale 70
+ scaleBeforeRotation
rotateOrigin center
\end_inset
\begin_layout Standard
\align center
\begin_inset Graphics
- filename mobius.eps
+ filename clipart/mobius.eps
display color
scale 70
draft
+ scaleBeforeRotation
rotateOrigin center
\end_inset
\begin_inset LatexCommand index
-name "Floats ! Figure Floats"
+name "Floats ! Figures"
\end_inset
\begin_inset LatexCommand index
-name "Figure ! Floats"
+name "Figures ! Floats"
\end_inset
\begin_inset Graphics
filename ../images/float-insert_figure.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\family sans
Insert\SpecialChar \menuseparator
Float\SpecialChar \menuseparator
-Figure
+Figure
\family default
-inserts a float with the label
+ inserts a float with a caption that has the label
\begin_inset Quotes eld
\end_inset
-
-\series bold
Figure\InsetSpace ~
#:
-\series default
-
\begin_inset Quotes erd
\end_inset
-.
- Set the cursor behind this label, press Enter and insert the image as described
- above to get the caption printed below the image.
- This was done for Figure\InsetSpace ~
+ (# is the actual number).
+ You can insert the image above the caption, like in Figure\InsetSpace ~
\begin_inset LatexCommand ref
reference "fig:kill-plat"
\end_inset
-.
- If you want the caption to be above the image, set the cursor at the end
- of the caption, press enter and insert the image.
- This was done in Figure\InsetSpace ~
+ or below the caption, like in Figure\InsetSpace ~
\begin_inset LatexCommand ref
reference "fig:escher"
\begin_layout Standard
\align center
\begin_inset Graphics
- filename platypus.eps
+ filename clipart/platypus.eps
display color
width 50col%
+ scaleBeforeRotation
rotateOrigin center
\end_inset
\begin_layout Standard
\align center
\begin_inset Graphics
- filename escher-lsd.eps
+ filename clipart/escher-lsd.eps
display color
scale 80
+ scaleBeforeRotation
rotateOrigin center
\end_inset
\end_inset
- are examples of cross-referenced figures.
- Figures can be cross-referenced in the text by referencing their label.
+ are examples of referenced figures.
+ Figures can be referenced in the text by referencing their label.
To do this insert a label in the caption using the menu
\family sans
Insert\SpecialChar \menuseparator
\begin_inset Graphics
filename ../images/label-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\begin_inset Graphics
filename ../images/dialog-show-new-inset_ref.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\end_inset
at all.
+\newline
+Referencing is explained in detail in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sec:Referencing-Floats"
+
+\end_inset
+
+.
\end_layout
\begin_layout Standard
Normally only one image is inserted to a figure float, but sometimes you
might want to use two images with separate subcaptions.
- This can be set in the tab
+ This can be set in the tab
\family sans
- Extra\InsetSpace ~
+Extra\InsetSpace ~
options
\family default
of the graphics dialog.
\family default
and enter the subcaption for the image in the caption field.
Note that only the main caption of the float is added to the List of Figures.
+\newline
+Ref
+erencing subfigures is explained in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sub:Referencing-Subfigures"
+
+\end_inset
+
+.
\end_layout
\begin_layout Standard
\hfill
\begin_inset Graphics
- filename escher-lsd.eps
+ filename clipart/escher-lsd.eps
width 45col%
+ scaleBeforeRotation
subcaption
subcaptionText "Undefinable structure"
\hfill
\begin_inset Graphics
- filename platypus.eps
+ filename clipart/platypus.eps
lyxscale 60
width 45col%
+ scaleBeforeRotation
subcaption
- subcaptionText "Platypus"
+ subcaptionText "\label{fig:Platypus} Platypus"
\end_inset
\begin_inset LatexCommand index
-name "Figure ! Image Formats"
+name "Figures ! Image Formats"
\end_inset
only vice versa.
Only the image formats PDF and EPS can directly be embedded to PDF and
PostScript output files, respectively.
- SVG and WMF-images are currently recalculated to bitmaps when the output
- file is generated because there is currently no adequate WMF/SVG
+ SVG and WMF-images are recalculated to bitmaps when the output file is
+ generated because there is currently no adequate WMF/SVG
\begin_inset Formula $\to$
\end_inset
\begin_inset Graphics
filename ../images/tabular-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
Table\InsetSpace ~
Settings
\family default
- Here you can set the horizontal alignment for the current row and the width
- of the current column.
+ Here you can set the horizontal alignment and the width of the current
+ column.
When you have set a width you can also adjust the vertical alignment of
- the current column.
+ the current row.
A given width will allow the cell to have line breaks and multiple paragraphs
of text, see section\InsetSpace ~
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_append-row.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_append-column.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_delete-row.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_delete-column.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_toggle-line-top.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_toggle-line-bottom.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_toggle-line-left.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_toggle-line-right.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_set-all-lines.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_unset-all-lines.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_align-left.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_align-center.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_align-right.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_valign-top.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_valign-middle.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_valign-bottom.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_set-rotate-cell.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_set-rotate-tabular.xpm
+ scaleBeforeRotation
\end_inset
\labelwidthstring 00.00.0000
\begin_inset Graphics
filename ../images/tabular-feature_multicolumn.xpm
+ scaleBeforeRotation
\end_inset
sets the current cell or selection as a multicolumn
\end_layout
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ For the output the vertical alignment of the first cell in a row is used
+ for all following cells in the row.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
\begin_layout Section
Edit Table Menu
\begin_inset LatexCommand index
\begin_inset Graphics
filename ../images/float-insert_table.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\end_layout
\begin_layout Standard
-The float appears as a collapsible box with the label
+The float appears as a collapsible box with a caption that has the label
+
\begin_inset Quotes eld
\end_inset
-
-\series bold
Table\InsetSpace ~
#:
-\series default
-
\begin_inset Quotes erd
\end_inset
- inside it.
- The text following the label is the caption of the table.
- To insert a table to the the float set the cursor at the end of the caption
- text, press enter and insert the table.
- The caption is now printed above the table.
+ (# is the actual table number).
+ You can insert tables to the float above or below the caption.
\end_layout
\begin_layout Standard
\begin_inset Graphics
filename ../images/label-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\begin_inset Graphics
filename ../images/dialog-show-new-inset_ref.xpm
scale 85
+ scaleBeforeRotation
\end_inset
.
-\end_layout
+\newline
+Referencing is explained in detail in section\InsetSpace ~
-\begin_layout Standard
+\begin_inset LatexCommand ref
+reference "sec:Referencing-Floats"
+
+\end_inset
+.
\end_layout
\begin_layout Section
\emph default
.
In this context, first means first in this order:
-\family sans
-Footer, Last\InsetSpace ~
-footer,
-\family default
-
\family sans
Header,
\family default
\family sans
First\InsetSpace ~
-header.
+header, Footer, Last\InsetSpace ~
+footer.
\family default
-\emph on
-
-\emph default
-See the following longtable to see how it works:
+ See the following longtable to see how it works:
\end_layout
\begin_layout Standard
status collapsed
\begin_layout Standard
-See greyed-out note in section 2.6.2 for an explanation of this command.
+See greyed-out note in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sub:Longtable-Captions"
+
+\end_inset
+
+ for an explanation of this command.
\end_layout
\end_inset
\end_inset
+\begin_inset LatexCommand label
+name "sub:Longtable-Captions"
+
+\end_inset
+
+
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Enumerate
-Mark the first row an disable its upper line.
+Mark the first row and disable its upper line.
\end_layout
\begin_layout Enumerate
Insert\SpecialChar \menuseparator
Caption
\family default
-\series bold
-
-\series default
-into the first table cell.
+ into the first table cell.
\newline
You can also add a short title for the caption.
\end_layout
\begin_layout Standard
\begin_inset ERT
-status collapsed
+status open
\begin_layout Standard
\end_inset
+\end_layout
+
+\begin_layout Standard
\begin_inset ERT
status collapsed
\end_layout
\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ When the LaTeX-package
+\series bold
+caption
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! caption"
+
+\end_inset
+
+ is used, as in this document, the full page width is used for the caption
+ when you use the default value of 4\InsetSpace \thinspace{}
+in for
+\series bold
+
+\backslash
+LTcapwidth
+\series default
+.
+ To get in this case exactly a 4\InsetSpace \thinspace{}
+in wide caption, you can either use a value
+ slightly different from 4.0\InsetSpace \thinspace{}
+in, e.g.
+ 3.99\InsetSpace \thinspace{}
+in, or the LaTeX-command
+\series bold
+
+\backslash
+captionsetup{width=value}
+\series default
+ that is provided by the
+\series bold
+caption
+\series default
+-package.
+\end_layout
+
+\end_inset
+
\end_layout
\begin_layout Standard
\begin_inset ERT
-status collapsed
+status open
\begin_layout Standard
must be inserted as ERT at the beginning of the cell.
This assures that the part of the cell that will be displayed on the new
page appears with the full width.
-
\end_layout
\begin_layout Standard
\begin_inset Text
\begin_layout Standard
-
+
\series bold
- Example Phone List
+Example Phone List
\end_layout
\end_inset
placement H
wide false
sideways false
-status collapsed
+status open
\begin_layout Standard
\begin_inset Caption
<lyxtabular version="3" rows="3" columns="3">
<features>
<column alignment="center" valignment="middle" leftline="true" width="2.5cm">
-<column alignment="center" valignment="middle" leftline="true" width="0.5cm">
-<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0.5cm">
+<column alignment="center" valignment="middle" leftline="true" width="0">
+<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
In the appearing table dialog we set a cell width of 2.5\InsetSpace \thinspace{}
cm and choose centered
for the vertical and horizontal alignment.
+ The vertical alignment is used for all cells of the row.
As our text is smaller than than 2.5\InsetSpace \thinspace{}
cm, only one line will appear.
To get two lines, we add a line break with the command
to several lines.
\end_layout
-\begin_layout Standard
-To center the text inside the two other cells of the first row vertically,
- right-click in the second cell, adjust a fixed width of 0.5\InsetSpace \thinspace{}
-cm and choose
- centered alignments.
- Then do the same for the third cell of the row.
-\end_layout
-
\begin_layout Standard
If you have a long word in a cell with a fixed width, it cannot be hyphenated
by LaTeX if it is the first entry.
\begin_layout Standard
\begin_inset Float table
+placement h
wide false
sideways false
status open
<lyxtabular version="3" rows="3" columns="3">
<features>
<column alignment="center" valignment="middle" leftline="true" width="2.5cm">
-<column alignment="center" valignment="middle" leftline="true" width="0.5cm">
-<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0.5cm">
+<column alignment="center" valignment="middle" leftline="true" width="0">
+<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
<lyxtabular version="3" rows="3" columns="3">
<features>
<column alignment="center" valignment="middle" leftline="true" width="2.5cm">
-<column alignment="center" valignment="middle" leftline="true" width="0.5cm">
-<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0.5cm">
+<column alignment="center" valignment="middle" leftline="true" width="0">
+<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_inset Graphics
filename ../images/tabular-feature_multicolumn.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\begin_inset Text
\begin_layout Standard
-def
-\lang ngerman
-
-\lang english
-ghi
+def ghi
\end_layout
\end_inset
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="3">
<features>
-<column alignment="center" valignment="middle" leftline="true" width="0" special="|>{\centering}m{1.25cm-6.2pt}">
+<column alignment="center" valignment="middle" leftline="true" width="0" special=">{\centering}m{1.25cm-6.2pt}">
<column alignment="center" valignment="middle" leftline="true" width="0">
<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
<row topline="true">
-<cell multicolumn="1" alignment="center" valignment="middle" topline="true" leftline="true" usebox="none" special="|>{\centering}m{2.5cm}|">
+<cell multicolumn="1" alignment="center" valignment="middle" topline="true" leftline="true" usebox="none" special=">{\centering}m{2.5cm}">
\begin_inset Text
\begin_layout Standard
\end_inset
-, mark the first two cells in the first row a 3×3 table and right-click
+, mark the first two cells in the first row of a 3×3 table and right-click
on them.
Now choose for this cell
\emph on
\emph on
n
\emph default
- columns are spanned columns can be calculated, so that each column has
- a total width of
+ columns are spanned can be calculated, so that each column has a total
+ width of
\begin_inset Formula $W_{\mathrm{tot\, multicolumn}}/n$
\end_inset
:
\begin_inset Formula \begin{equation}
-W_{g\, n}=(W_{g\,\mathrm{multicolumn}}+(1-n)·(12.4\,\mathrm{pt}))/n\label{eq:Wgn}\end{equation}
+W_{g\, n}=(W_{g\,\mathrm{multicolumn}}+(1-n)\cdot(12.4\,\mathrm{pt}))/n\label{eq:Wgn}\end{equation}
\end_inset
\end_layout
\begin_layout Standard
-By entering a LaTeX-argument, all cell properties set in the table dialog
+By entering a LaTeX-argument, all cell settings set in the table dialog
are overwritten.
-
+\end_layout
+
+\begin_layout Standard
\begin_inset Note Greyedout
status open
\series bold
Note:
\series default
- Due to a bug, LyX shows the overwritten properties anyway.
+ Due to a bug, LyX shows the overwritten settings anyway.
\end_layout
\end_inset
- As the text should be horizontally centered, the command
+
+\end_layout
+
+\begin_layout Standard
+As the text should be horizontally centered, the command
\series bold
\backslash
\begin_layout Standard
\series bold
-|>{
+>{
\backslash
centering}m{1.25cm-6.2pt}
\end_layout
\begin_layout Standard
-The bar
-\begin_inset Quotes eld
-\end_inset
-
-
-\series bold
-|
-\series default
-
-\begin_inset Quotes erd
-\end_inset
-
- at the beginning draws the border line and the command
+The command
\series bold
>{ }
\series default
\begin_layout Standard
\series bold
-|>{
+>{
\backslash
-centering}m{2.5cm}|
+centering}m{2.5cm}
\end_layout
\begin_layout Subsection
\end_layout
\begin_layout Standard
-This example is for the first line, the so called toprule.
+This example is for the first line, the so called
+\series bold
+toprule
+\series default
+.
If you want to change the width for the last line, replace
\series bold
toprule
in the sixth row.
\end_layout
-\begin_layout Standard
-
-\end_layout
-
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\begin_layout Standard
\series bold
-Note:
+Note:
\series default
-The alignment of the table row content to the surrounding text line is not
- exact.
+ The alignment of the table row content to the surrounding text line is
+ not exact.
The needed factor of the
\series bold
ERT will cause LaTeX-errors.
\end_layout
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ Not all DVI-viewers are able to display self-defined colors.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="3">
<features>
-<column alignment="center" valignment="top" leftline="true" width="0" special=">{\columncolor{darkgreen}\centering}c">
+<column alignment="center" valignment="top" width="0" special=">{\columncolor{darkgreen}\centering}c">
<column alignment="center" valignment="top" width="0">
<column alignment="center" valignment="top" width="0">
<row>
\end_inset
the LaTeX-argument
-\end_layout
-
-\begin_layout Standard
-
\series bold
-WcW
-\end_layout
-
-\begin_layout Standard
-was used for the last column and
-\end_layout
-
-\begin_layout Standard
-
+ WcW
+\series default
+ was used for the last column and
\series bold
-Wc
-\end_layout
-
-\begin_layout Standard
-for the other columns.
+ Wc
+\series default
+ for the other columns.
\end_layout
\begin_layout Standard
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="3">
<features>
-<column alignment="center" valignment="top" leftline="true" width="0" special="Wc">
<column alignment="center" valignment="top" width="0" special="Wc">
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0" special="WcW">
+<column alignment="center" valignment="top" width="0" special="Wc">
+<column alignment="center" valignment="top" width="0" special="WcW">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\backslash
renewcommand{
\backslash
-hline}{
+hline}
+\newline
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hphantom{ }
+\end_layout
+
+\end_inset
+
+{
\backslash
arrayrulecolor{red}
\backslash
\backslash
renewcommand{
\backslash
-hline}{
+hline}
+\end_layout
+
+\begin_layout Standard
+
+ {
\backslash
arrayrulecolor{red}
\backslash
\begin_layout Standard
\begin_inset Float table
+placement h
wide false
sideways false
status open
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="3">
<features>
-<column alignment="center" valignment="top" leftline="true" width="0" special="Wc">
<column alignment="center" valignment="top" width="0" special="Wc">
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0" special="WcW">
+<column alignment="center" valignment="top" width="0" special="Wc">
+<column alignment="center" valignment="top" width="0" special="WcW">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
LyX will insert as default 0.5\InsetSpace \thinspace{}
em space.
For normal tables the inserted space will unfortunately destroy the vertical
- table lines as in the following table:
-\begin_inset Tabular
-<lyxtabular version="3" rows="3" columns="1">
-<features>
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-
+ table lines as in the following table:
+\begin_inset VSpace medskip
+\end_inset
+
+
+\newline
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hspace*{0pt}
+\end_layout
+
+\end_inset
+
+
+\hfill
+
+\begin_inset Tabular
+<lyxtabular version="3" rows="3" columns="1">
+<features>
+<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
\begin_layout Standard
A
\end_layout
\end_inset
+\hfill
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hspace*{0pt}
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace medskip
+\end_inset
+
+
\newline
So inserting space to the top of row for normal tables is only useful when
you don't have vertical lines.
\begin_layout Description
Between\InsetSpace ~
-rows only has an effect when you have selected the whole table row
- before.
- The space is added between the current and the following row.
+rows adds space between the current and the following row.
If the table is a formal table LyX will insert as default 0.5\InsetSpace \thinspace{}
em space.
For normal tables the inserted space will unfortunately destroy the vertical
- table lines as in the following table:
+ table lines as in the following table:
+\begin_inset VSpace medskip
+\end_inset
+
+
+\newline
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hspace*{0pt}
+\end_layout
+
+\end_inset
+
+
+\hfill
+
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="1">
<features>
\end_inset
+\hfill
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hspace*{0pt}
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace medskip
+\end_inset
+
+
\newline
-So inserting space to the top of row for normal tables is only useful when
- you don't have vertical lines.
+So inserting space between rows for normal tables is only useful when you
+ don't have vertical lines.
\end_layout
\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
When you want to add extra height to all cells of all tables, you can do
- this with the following preamble line:
+ this with the following preamble lines:
\end_layout
\begin_layout Standard
\series bold
+\backslash
+@ifundef\SpecialChar \textcompwordmark{}
+ined{extrarowheight}
+\newline
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+hphantom{ }
+\end_layout
+
+\end_inset
+
+{
+\backslash
+usepackage{array}}{}
+\newline
+
\backslash
setlength{
\backslash
\begin_layout Standard
But this has the disadvantage that the cell texts are no longer exactly
vertically centered.
+ (The package
+\series bold
+array
+\series default
+ will be loaded automatically by LyX when you use self defined table formats.
+ To avoid that it is loaded twice the command
+\series bold
+
+\backslash
+@ifundef\SpecialChar \textcompwordmark{}
+ined
+\series default
+ is used in the above command.)
\end_layout
\begin_layout Subsection
@{}l
\end_layout
-\begin_layout Standard
-If you need a vertical line right beside the second column, use this LaTeX-argum
-ent instead:
-\series bold
-@{}l|
-\end_layout
-
\begin_layout Standard
Table\InsetSpace ~
<lyxtabular version="3" rows="4" columns="6">
<features>
<column alignment="right" valignment="top" width="0">
-<column alignment="left" valignment="top" rightline="true" width="0" special="@{}l|">
-<column alignment="right" valignment="top" width="0">
-<column alignment="left" valignment="top" rightline="true" width="0" special="@{}l|">
+<column alignment="left" valignment="top" rightline="true" width="0" special="@{}l">
<column alignment="right" valignment="top" width="0">
<column alignment="left" valignment="top" rightline="true" width="0" special="@{}l">
+<column alignment="right" valignment="top" width="0">
+<column alignment="left" valignment="top" width="0" special="@{}l">
<row bottomline="true">
<cell multicolumn="1" alignment="center" valignment="top" bottomline="true" rightline="true" usebox="none">
\begin_inset Text
\end_inset
Alignments when LaTeX-package dcolumn is used.
- For the second and third alignment some tricks were used.
+ For all column alignments tricks have to be used to get the output.
\end_layout
\end_inset
\begin_inset Tabular
<lyxtabular version="3" rows="4" columns="3">
<features>
-<column alignment="center" valignment="top" rightline="true" width="0" special="D{×}{\times}{-1}|">
-<column alignment="center" valignment="top" width="0" special="D{×}{\times}{4.9}|">
-<column alignment="center" valignment="top" rightline="true" width="0" special="D{~}{\,}{9.7}">
+<column alignment="center" valignment="top" rightline="true" width="0" special="D{x}{\times}{-1}">
+<column alignment="center" valignment="top" rightline="true" width="0" special="D{x}{\times}{4.9}">
+<column alignment="center" valignment="top" width="0" special="D{~}{\,}{9.7}">
<row bottomline="true">
<cell multicolumn="1" alignment="center" valignment="top" bottomline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_inset Text
\begin_layout Standard
-12×24\InsetSpace \thinspace{}
+12x24\InsetSpace \thinspace{}
bottles
\end_layout
\begin_inset Text
\begin_layout Standard
-12×24\InsetSpace \thinspace{}
+12x24\InsetSpace \thinspace{}
\begin_inset Formula $\mbox{bottles}$
\end_inset
\begin_inset Text
\begin_layout Standard
-12×24~
+12
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+times
+\end_layout
+
+\end_inset
+
+24~
\begin_inset Formula $\mbox{bottles}$
\end_inset
\begin_inset Text
\begin_layout Standard
-1024×768\InsetSpace \thinspace{}
+1024x768\InsetSpace \thinspace{}
Pixels
\end_layout
\begin_inset Text
\begin_layout Standard
-1024×768\InsetSpace \thinspace{}
+1024x768\InsetSpace \thinspace{}
\begin_inset Formula $\mbox{Pixels}$
\end_inset
\begin_inset Text
\begin_layout Standard
-1024×768~
+1024
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+times
+\end_layout
+
+\end_inset
+
+768~
\begin_inset Formula $\mbox{Pixels}$
\end_inset
\begin_inset Text
\begin_layout Standard
-32×6\InsetSpace \thinspace{}
+32x6\InsetSpace \thinspace{}
cm
\end_layout
\begin_inset Text
\begin_layout Standard
-32×6\InsetSpace \thinspace{}
+32x6\InsetSpace \thinspace{}
\begin_inset Formula $\mbox{cm}$
\end_inset
\begin_inset Text
\begin_layout Standard
-32×6~
+32
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+times
+\end_layout
+
+\end_inset
+
+6~
\begin_inset Formula $\mbox{cm}$
\end_inset
\begin_layout Standard
\series bold
-|M{width}
+M{width}
\end_layout
\begin_layout Standard
\begin_layout Standard
\series bold
-|S{width of multicolumn cell}{number of spanned columns}
+S{width of multicolumn cell}{number of spanned columns}
\end_layout
\begin_layout Standard
\begin_layout Standard
\series bold
-|M{2.5cm}
+M{2.5cm}
\end_layout
\begin_layout Standard
\begin_layout Standard
\series bold
-|K{red}|
+K{red}
\end_layout
\begin_layout Standard
\begin_layout Standard
\series bold
-|S{2.5cm}{2}
+S{2.5cm}{2}
\end_layout
\begin_layout Standard
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="4">
<features>
-<column alignment="center" valignment="middle" leftline="true" width="2.5cm" special="|M{2.5cm}">
-<column alignment="center" valignment="middle" leftline="true" width="0" special="|S{2.5cm}{2}">
+<column alignment="center" valignment="middle" leftline="true" width="2.5cm" special="M{2.5cm}">
+<column alignment="center" valignment="middle" leftline="true" width="0" special="S{2.5cm}{2}">
<column alignment="center" valignment="middle" leftline="true" width="0">
-<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0" special="|K{red}|">
+<column alignment="center" valignment="middle" leftline="true" rightline="true" width="0" special="K{red}">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\end_inset
</cell>
-<cell multicolumn="1" alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none" special="M{2.5cm}|">
+<cell multicolumn="1" alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none" special="M{2.5cm}">
\begin_inset Text
\begin_layout Standard
\backslash
arrayrulewidth 1.5pt}
\newline
-
+
\backslash
myHline
\backslash
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="3">
<features>
-<column alignment="center" valignment="top" leftline="true" width="0" special="Vc">
-<column alignment="center" valignment="top" leftline="true" width="0" special="Vc">
-<column alignment="center" valignment="top" leftline="true" width="0" special="VcV">
+<column alignment="center" valignment="top" width="0" special="Vc">
+<column alignment="center" valignment="top" width="0" special="Vc">
+<column alignment="center" valignment="top" width="0" special="VcV">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
To insert a float, use the menu
\family sans
Insert\SpecialChar \menuseparator
-Floats
+Float
\family default
.
- This inserts a box with a label in the
-\family sans
-Caption
-\family default
- environment
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-The
+ This inserts the
\family sans
Caption
\family default
- environment is described in LyX's
-\emph on
-Userguide
-\emph default
-.
-\end_layout
-
-\end_inset
-
- into your document.
- Every label ends with the character
-\begin_inset Quotes eld
-\end_inset
-
-#
-\begin_inset Quotes erd
-\end_inset
-
- as placeholder for the float number in the output.
+ inset, a box with a label.
The label will automatically be translated to the document language in
the output.
Behind the label you can insert the caption text.
by left-clicking on the box label.
A closed float box looks like this:
\begin_inset Graphics
- filename ../clipart/floatQt4.png
+ filename clipart/floatQt4.png
scale 70
+ scaleBeforeRotation
\end_inset
\begin_layout Subsection
Algorithm Floats
\begin_inset LatexCommand index
-name "Floats ! Algorithm Floats"
+name "Floats ! Algorithms"
\end_inset
\begin_layout LyX-Code
for I in 1..N loop
\newline
- Sum:= Sum + A(I); /*senseless comment*/
+ Sum:= Sum + A(I); /*comment*/
\newline
end loop
\begin_inset VSpace -4mm
\begin_layout Standard
The float label is not automatically translated into the document language.
If your document is not in English, you have to do this manually by adding
- the following line
-\series bold
-
-\series default
-to the document preamble
+ the following line to the document preamble
\series bold
:
\end_layout
\end_inset
-\series default
-
-\newline
-Where
-\family sans
-your\InsetSpace ~
-name
-\family default
- is the word
-\begin_inset Quotes eld
-\end_inset
-
-
-\emph on
-algorithm
-\emph default
-
-\begin_inset Quotes erd
-\end_inset
-
- in your language.
\end_layout
\begin_layout Standard
\begin_layout Standard
\begin_inset Graphics
- filename mobius.eps
+ filename clipart/mobius.eps
display color
width 40col%
+ scaleBeforeRotation
rotateOrigin center
\end_inset
\family default
if the LaTeX-package
\series bold
-floatflt
+f\SpecialChar \textcompwordmark{}
+loatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand index
\begin_layout Standard
The LaTeX-package
\series bold
-floatflt
+f\SpecialChar \textcompwordmark{}
+loatf\SpecialChar \textcompwordmark{}
+lt
\series default
also supports table wrap floats, but they are not yet supported by LyX.
If you need this, read the documentation of
\series bold
-floatflt
+f\SpecialChar \textcompwordmark{}
+loatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand cite
instead of
\series bold
-floatf\SpecialChar \textcompwordmark{}
+f\SpecialChar \textcompwordmark{}
+loatf\SpecialChar \textcompwordmark{}
lt
\series default
, but it is currently not supported by LyX.
\begin_layout Itemize
Wrap floats should not be placed in paragraphs that run over a page break.
That means that wrap floats should better be inserted to the exact place
- when the document is nearly ready and you are able to estimate where page
- breaks will appear.
+ when the document is nearly finished and you are able to estimate where
+ page breaks will appear.
\end_layout
\begin_layout Itemize
\end_layout
\begin_layout Section
-Referencing Floats
+Float Numbering
\begin_inset LatexCommand label
-name "sec:Referencing-Floats"
-
-\end_inset
-
-
-\begin_inset LatexCommand index
-name "Floats ! References"
+name "sec:Float-Numbering"
\end_inset
\begin_inset LatexCommand index
-name "References"
+name "Floats ! Numbering"
\end_inset
\end_layout
\begin_layout Standard
-To reference a float, insert a label into its caption using the menu
-\family sans
-Insert\SpecialChar \menuseparator
-Label
-\family default
- or the toolbar button
-\begin_inset Graphics
- filename ../images/label-insert.xpm
- scale 85
+Floats are usually numbered either independent from the sections the floats
+ are in, or in the scheme
+\begin_inset Quotes eld
+\end_inset
+chapter.number
+\begin_inset Quotes erd
\end_inset
-.
- A grey label box like this one:
-\begin_inset Graphics
- filename ../clipart/labelQt4.png
- scale 85
+ or
+\begin_inset Quotes eld
+\end_inset
+section.number
+\begin_inset Quotes erd
\end_inset
- will be inserted and the label window pops up asking for the label text.
- LyX offers as text the first words of the caption with a prefix.
- The prefix depends on the float type, e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-for figure floats the prefix will
- be "
-\family sans
-fig:
-\family default
-".
+.
+ This depends on the used document class.
+\end_layout
+
+\begin_layout Standard
+To change the section independent numbering, you can use this command in
+ the document preamble:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+renewcommand{
+\backslash
+thetable}{
+\backslash
+roman{table}}
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+thetable
+\series default
+ is the command that prints the table number, for figure floats, the command
+ would be
+\series bold
+
+\backslash
+thefigure
+\series default
+.
+ The command
+\series bold
+
+\backslash
+roman
+\series default
+ prints in the command above the table number as small roman number.
+\end_layout
+
+\begin_layout Standard
+To change the numbering scheme for example to
+\begin_inset Quotes eld
+\end_inset
+
+subsection.number
+\begin_inset Quotes erd
+\end_inset
+
+, use this command in the preamble:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+numberwithin{table}{subsection}
+\end_layout
+
+\begin_layout Standard
+To be able to use the command
+\series bold
+
+\backslash
+numberwithin
+\series default
+, set in the tab
+\family sans
+Math\InsetSpace ~
+Options
+\family default
+ in the document settings the option
+\family sans
+Use\InsetSpace ~
+AMS\InsetSpace ~
+math\InsetSpace ~
+package
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+Please also have a look at section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sub:Footnote-Numbering"
+
+\end_inset
+
+ for the details and important notes about the numbering commands.
+\end_layout
+
+\begin_layout Section
+Referencing Floats
+\begin_inset LatexCommand label
+name "sec:Referencing-Floats"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Floats ! References"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "References"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To reference a float, insert a label into its caption using the menu
+\family sans
+Insert\SpecialChar \menuseparator
+Label
+\family default
+ or the toolbar button
+\begin_inset Graphics
+ filename ../images/label-insert.xpm
+ scale 85
+ scaleBeforeRotation
+
+\end_inset
+
+.
+ A grey label box like this one:
+\begin_inset Graphics
+ filename clipart/labelQt4.png
+ scale 85
+ scaleBeforeRotation
+
+\end_inset
+
+ will be inserted and the label window pops up asking for the label text.
+ LyX offers as text the first words of the caption with a prefix.
+ The prefix depends on the float type, e.\InsetSpace \thinspace{}
+g.\InsetSpace ~
+for figure floats the prefix will
+ be "
+\family sans
+fig:
+\family default
+".
\end_layout
\begin_layout Standard
\begin_inset Graphics
filename ../images/dialog-show-new-inset_ref.xpm
scale 85
+ scaleBeforeRotation
\end_inset
.
A grey cross-reference box like this one:
\begin_inset Graphics
- filename ../clipart/referenceQt4.png
+ filename clipart/referenceQt4.png
scale 85
+ scaleBeforeRotation
\end_inset
\end_layout
\begin_layout Subsection
-Cross-reference formats
+Cross-Reference Formats
\begin_inset LatexCommand label
-name "sub:Cross-reference-formats"
+name "sub:Cross-Reference-Formats"
\end_inset
\begin_layout Description
Formatted\InsetSpace ~
-reference: prints a self defined cross-reference format:
-\newline
+reference: prints a self defined cross-reference format.
+
+\begin_inset Note Greyedout
+status open
-\begin_inset LatexCommand prettyref
-reference "fig:Two-distorted-images"
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ This feature is only available when you have the LaTeX-package
+\series bold
+prettyref
+\series default
+ installed.
+\end_layout
\end_inset
\family default
of the cross-reference window, that appear when you click on the cross-referenc
e box.
-\begin_inset VSpace bigskip
+\end_layout
+
+\begin_layout Subsection
+Referencing Subfigures
+\begin_inset LatexCommand label
+name "sub:Referencing-Subfigures"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "References ! to Subfigures"
+
\end_inset
\end_layout
\begin_layout Standard
-To define a format for the
-\family sans
-Formatted\InsetSpace ~
-reference
-\family default
- style, you have to use the following command in the document preamble:
+Currently referencing subfigures is not supported by LyX, so you have to
+ use LaTeX-commands.
+ The label is the created with the command
\end_layout
\begin_layout Standard
\series bold
\backslash
-newrefformat{prefix}{text}
+label{fig:YourLabelName}
\end_layout
\begin_layout Standard
-This formatting command affects all references to labels with the same prefix.
- To get the format of the
-\family sans
-Formatted\InsetSpace ~
-reference
-\family default
- example above, this command was used:
+that is directly inserted into the subfigure caption field.
+ To reference the label add this command in ERT
\end_layout
\begin_layout Standard
\series bold
\backslash
-newrefformat{fig}
-\newline
+ref{fig:YourLabelName}
+\end_layout
+
+\begin_layout Standard
+to the position in your document where the reference should be placed.
+ Here is a reference to a subfigure: Subfigure\InsetSpace ~
\begin_inset ERT
status collapsed
\backslash
-hphantom{ }
+ref{fig:Platypus}
\end_layout
\end_inset
-{Figure~float~
-\backslash
-ref{#1} printed on page~
-\backslash
-pageref{#1}}
-\end_layout
-
-\begin_layout Standard
-The tilde "~" is the LaTeX equivalent for the protected space.
- The command
-\series bold
-
-\backslash
-ref{#1}
-\series default
- refers to the float number, the command
-\series bold
-
-\backslash
-pageref{#1}
-\series default
- to the page number.
+.
\end_layout
\begin_layout Subsection
style, described in section\InsetSpace ~
\begin_inset LatexCommand ref
-reference "sub:Cross-reference-formats"
+reference "sub:Cross-Reference-Formats"
\end_inset
.
- That is the reason why it is not used in this document.
\end_layout
\end_inset
\end_inset
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+
+\series bold
+hypcap
+\series default
+ has no effect for references to subfigures.
+\end_layout
+
+\end_inset
+
+
\end_layout
\begin_layout Section
\begin_layout Description
Here\InsetSpace ~
if\InsetSpace ~
-possible: try to place the float on the position where it is inserted
+possible try to place the float on the position where it is inserted
\end_layout
\begin_layout Description
Top\InsetSpace ~
of\InsetSpace ~
-page: try to place the float on the top of the current page
+page try to place the float on the top of the current page
\end_layout
\begin_layout Description
Bottom\InsetSpace ~
of\InsetSpace ~
-page: try to place the float on the bottom of the current page
+page try to place the float on the bottom of the current page
\end_layout
\begin_layout Description
Page\InsetSpace ~
of\InsetSpace ~
-floats: try to place the float on an own page
+floats try to place the float on an own page
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-By default, each options has its own rules:
+By default, each option has its own rules:
\end_layout
\begin_layout Labeling
\series bold
\backslash
-floatpagefraction
+f\SpecialChar \textcompwordmark{}
+loatpagefraction
\series default
)
\end_layout
a two-column document).
They are normally rotated so that you can read them from the outside margin
-- to the left on even pages, to the right on odd pages.
+ To force a certain rotation direction for all pages, you can add either
+ the option
+\series bold
+f\SpecialChar \textcompwordmark{}
+iguresleft
+\series default
+ or
+\series bold
+f\SpecialChar \textcompwordmark{}
+iguresright
+\series default
+ to the document class options.
\end_layout
\begin_layout Standard
\end_inset
followed by the caption text.
- The number sign
+
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
- is substituted in the printed output by the actual reference number.
+ is the actual reference number.
By default the label and the number are in the same font as the caption
- text and a colon follows the number to divide then label from the text.
+ text and a colon follows the number to divide the label from the text.
This caption format is not suitable for all document formats.
\end_layout
captionsetup[table]{labelfont={bf,sf}}
\end_layout
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ The option
+\series bold
+tableposition=top
+\series default
+ has no effect when a
+\series bold
+koma-script
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! koma-script"
+
+\end_inset
+
+ document class is used.
+ In this case the document class option
+\series bold
+tablecaptionabove
+\series default
+ must be used.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
For more information about the package
\series bold
\end_layout
\begin_layout Standard
-\begin_inset VSpace bigskip
+To change the label name from e.g.
+
+\begin_inset Quotes eld
\end_inset
-If you are using a
-\series bold
-koma-script
-\series default
+Figure
+\begin_inset Quotes erd
+\end_inset
+
+ to
+\begin_inset Quotes eld
+\end_inset
+
+Image
+\begin_inset Quotes erd
+\end_inset
+
+ use this preamble command:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+renewcommand{
+\backslash
+fnum@figure}{Image~
+\backslash
+thefigure}
+\end_layout
+
+\begin_layout Standard
+where
+\series bold
+
+\backslash
+thefigure
+\series default
+ inserts the figure number and
+\series bold
+
+\begin_inset Quotes eld
+\end_inset
+
+~
+\series default
+
+\begin_inset Quotes erd
+\end_inset
+
+ creates a protected space.
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+If you are using a
+\series bold
+koma-script
+\series default
\begin_inset LatexCommand index
name "LaTeX-packages ! koma-script"
\begin_layout Standard
\align center
\begin_inset Graphics
- filename mobius.eps
+ filename clipart/mobius.eps
lyxscale 50
scale 50
+ scaleBeforeRotation
\end_inset
\series bold
tablecaptionabove
\series default
-, or you can use the environment
-\family sans
-caption\InsetSpace ~
-above
-\family default
- instead of the
-\family sans
-caption
-\family default
- environment.
+.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-\begin_inset VSpace defskip
+\begin_inset VSpace medskip
\end_inset
For more information about the package
\begin_layout Standard
\begin_inset Graphics
- filename escher-lsd.eps
+ filename clipart/escher-lsd.eps
scale 75
+ scaleBeforeRotation
\end_inset
\begin_layout Standard
\begin_inset Graphics
- filename escher-lsd.eps
+ filename clipart/escher-lsd.eps
scale 75
+ scaleBeforeRotation
\end_inset
\begin_inset LatexCommand index
-name "Floats ! Listings"
+name "Floats ! Float Lists"
\end_inset
\begin_inset Graphics
filename ../images/note-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
Note
\family default
.
- There are three types of notes:
+ There are five types of notes:
\end_layout
\begin_layout Description
\newline
\begin_inset Graphics
- filename ../clipart/LyXNoteImageQt4.png
+ filename clipart/LyXNoteImageQt4.png
display none
scale 85
+ scaleBeforeRotation
\end_inset
\newline
\begin_inset Graphics
- filename ../clipart/CommentNoteImageQt4.png
+ filename clipart/CommentNoteImageQt4.png
display none
scale 85
+ scaleBeforeRotation
\end_inset
\newline
\begin_inset Graphics
- filename ../clipart/GreyedOutNoteImageQt4.png
+ filename clipart/GreyedOutNoteImageQt4.png
display none
scale 85
+ scaleBeforeRotation
\end_inset
\newline
\begin_inset Graphics
- filename ../clipart/FramedNoteImageQt4.png
+ filename clipart/FramedNoteImageQt4.png
display none
scale 85
+ scaleBeforeRotation
\end_inset
\newline
\begin_inset Graphics
- filename ../clipart/ShadedNoteImageQt4.png
+ filename clipart/ShadedNoteImageQt4.png
display none
scale 85
+ scaleBeforeRotation
\end_inset
\begin_inset VSpace bigskip
\end_inset
-When you use the toolbar button to insert notes, a
+When you use the toolbar button
+\begin_inset Graphics
+ filename ../images/note-insert.xpm
+ scale 85
+ scaleBeforeRotation
+
+\end_inset
+
+ to insert notes, a
\family sans
LyX\InsetSpace ~
Note
\family default
is inserted.
- You can switch between the three note types by right-clicking on the note-box.
+ You can switch between the five note types by right-clicking on the note-box.
\family roman
\series medium
\bar no
If you want to turn existing text into a note, mark it and click on the
- note
+ note
\family default
\series default
\bar default
-toolbar
+ toolbar
\family roman
\series medium
\bar no
\begin_layout Standard
\color yellow
-This is yellow text in a
+This is yellow text in a
+\color none
+
\family sans
+\color yellow
Shaded
\family default
- note with darkgreen background.
+\color none
+
+\color yellow
+note with darkgreen background.
\end_layout
\end_inset
\begin_inset Graphics
filename ../images/footnote-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\family roman
\series medium
\bar no
-You'll see
+You'll see
\family default
\series default
\bar default
-then the following footnote-box:
+ then the following footnote-box:
\begin_inset Graphics
- filename ../clipart/footnoteQt4.png
+ filename clipart/footnoteQt4.png
scale 80
+ scaleBeforeRotation
\end_inset
-
+
\family roman
\series medium
\bar no
- where you can enter the footnote text.
+where you can enter the footnote text.
If you want to turn existing text into a footnote, mark it and click on
- the footnote
+ the footnote
\family default
\series default
\bar default
-toolbar
+ toolbar
\family roman
\series medium
\bar no
\newline
This is a cross-reference of Footnote\InsetSpace ~
-\begin_inset LatexCommand prettyref
+\begin_inset LatexCommand ref
reference "foot:This-is-an"
\end_inset
.
-\newline
-
-\begin_inset Note Greyedout
-status open
-
-\begin_layout Standard
-
-\series bold
-Note:
-\series default
- LyX doesn't provide a prefix for labels in footnotes, so you have to insert
- e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-the prefix
-\family sans
-
-\begin_inset Quotes eld
-\end_inset
-
-foot:
-\family default
-
-\begin_inset Quotes erd
-\end_inset
-
- manually when you want to use the reference style
-\family sans
-Formatted\InsetSpace ~
-reference
-\family default
-.
-\end_layout
-
-\end_inset
-
-
\end_layout
\begin_layout Standard
\end_inset
-\end_layout
-
-\begin_layout Standard
-If you want to have footnotes numbered in the scheme
-\begin_inset Quotes eld
-\end_inset
-
-chapter.footnote
-\begin_inset Quotes erd
-\end_inset
-
-, add the following command to your document preamble:
-\end_layout
-
-\begin_layout Standard
-
-\series bold
-
-\backslash
-numberwithin{footnote}{chapter}
-\end_layout
-
-\begin_layout Standard
-To be able to use the command
-\series bold
-
-\backslash
-numberwithin
-\series default
-, set in the tab
-\family sans
-Math\InsetSpace ~
-Options
-\family default
- in the document settings the option
-\family sans
-Use\InsetSpace ~
-AMS\InsetSpace ~
-math\InsetSpace ~
-package
-\family default
-.
-\end_layout
-
-\begin_layout Standard
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-numberwithin{footnote}{chapter}
-\end_layout
-
-\end_inset
-
-This is another example footnote:
-\series bold
-
-\begin_inset Foot
-status open
-
-\begin_layout Standard
-This is a footnote numbered in the scheme
-\begin_inset Quotes eld
-\end_inset
-
-chapter.footnote
-\begin_inset Quotes erd
-\end_inset
-
-.
-\end_layout
-
-\end_inset
-
-
-\series default
-
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-numberwithin{footnote}{part}
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-\begin_inset VSpace bigskip
-\end_inset
-
-
\end_layout
\begin_layout Standard
\end_inset
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-renewcommand{
-\backslash
-thefootnote}{
-\backslash
-arabic{footnote}}
-\end_layout
-
-\end_inset
-
-
\end_layout
\begin_layout Standard
\series bold
Note:
-\series medium
-
\series default
-You can only number 26 footnotes with Latin letters, because this numbering
+ You can only number 26 footnotes with Latin letters, because this numbering
is limited to single letters.
\end_layout
roman
\series default
in the command above.
-\end_layout
+\begin_inset ERT
+status collapsed
-\begin_layout Subsection
-Footnote Placement
-\begin_inset LatexCommand index
-name "Footnotes ! Placement"
+\begin_layout Standard
+
+
+\backslash
+renewcommand{
+\backslash
+thefootnote}{
+\backslash
+arabic{footnote}}
+\end_layout
\end_inset
\end_layout
\begin_layout Standard
-If you have several footnotes in one page, they appear without vertical
- space between them at the bottom of the page.
- To make them better readable you can e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-add 1.5\InsetSpace \thinspace{}
-mm space with the following
- preamble command:
+\begin_inset VSpace bigskip
+\end_inset
+
+
\end_layout
\begin_layout Standard
+If you want to have footnotes numbered in the scheme
+\begin_inset Quotes eld
+\end_inset
-\series bold
+chapter.footnote
+\begin_inset Quotes erd
+\end_inset
+
+, add the following command to your document preamble:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+numberwithin{footnote}{chapter}
+\end_layout
+
+\begin_layout Standard
+To be able to use the command
+\series bold
+
+\backslash
+numberwithin
+\series default
+, set in the tab
+\family sans
+Math\InsetSpace ~
+Options
+\family default
+ in the document settings the option
+\family sans
+Use\InsetSpace ~
+AMS\InsetSpace ~
+math\InsetSpace ~
+package
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+numberwithin{footnote}{chapter}
+\end_layout
+
+\end_inset
+
+This is another example footnote:
+\series bold
+
+\begin_inset Foot
+status open
+
+\begin_layout Standard
+This is a footnote numbered in the scheme
+\begin_inset Quotes eld
+\end_inset
+
+chapter.footnote
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
+\series default
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+renewcommand{
+\backslash
+thefootnote}{
+\backslash
+arabic{footnote}}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+
+\series bold
+
+\backslash
+numberwithin
+\series default
+ always prints out the footnote number as arabic number; previous redefinitions
+ to get non-arabic numbers are overwritten.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+So to get for example the scheme
+\begin_inset Quotes eld
+\end_inset
+
+chapter.
+\backslash
+Roman{footnote}
+\begin_inset Quotes erd
+\end_inset
+
+, use this command instead of
+\series bold
+
+\backslash
+numberwithin
+\series default
+:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+renewcommand{
+\backslash
+thefootnote}{
+\backslash
+thechapter.
+\backslash
+Roman{footnote}}
+\end_layout
+
+\begin_layout Subsection
+Footnote Placement
+\begin_inset LatexCommand index
+name "Footnotes ! Placement"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+If you have several footnotes in one page, they appear without vertical
+ space between them at the bottom of the page.
+ To make them better readable you can e.\InsetSpace \thinspace{}
+g.\InsetSpace ~
+add 1.5\InsetSpace \thinspace{}
+mm space with the following
+ preamble command:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
\backslash
let
\begin_inset Graphics
- filename ../clipart/without_fntright.pdf
+ filename clipart/without_fntright.pdf
width 100col%
+ scaleBeforeRotation
\end_inset
\begin_inset Graphics
- filename ../clipart/with_fntright.pdf
+ filename clipart/with_fntright.pdf
width 100col%
+ scaleBeforeRotation
\end_inset
\begin_inset Graphics
- filename ../clipart/endnotes.pdf
+ filename clipart/endnotes.pdf
+ scaleBeforeRotation
\end_inset
\end_layout
\begin_layout Standard
-\begin_inset VSpace defskip
+\begin_inset VSpace medskip
\end_inset
The paragraph heading for the endnotes isn't automatically translated into
\end_layout
\begin_layout Standard
-\begin_inset VSpace defskip
+\begin_inset VSpace medskip
\end_inset
The numbering of endnotes can be changed like the footnote numbering as
\series bold
\backslash
-@addtoreset
+@addtoreset
\series default
-as described in section\InsetSpace ~
+ as described in section\InsetSpace ~
\begin_inset LatexCommand ref
reference "sub:Footnote-Numbering"
\begin_inset Graphics
filename ../images/marginalnote-insert.xpm
scale 85
+ scaleBeforeRotation
\end_inset
.
- A
-\family roman
-\series medium
-
-\family default
-\series default
-grey
+ A grey
\family roman
\series medium
- box with the
+box with the
\family default
\series default
-red
+ red
\family roman
\series medium
label
\end_layout
\begin_layout Standard
-\begin_inset ERT
-status collapsed
+To return to the default placement insert the command
+\end_layout
\begin_layout Standard
+\series bold
\backslash
-normalmarginpar
+normalmarginpar
\end_layout
-\end_inset
-
-To return to the default placement insert the command
-\end_layout
+\begin_layout Standard
+in ERT.
+\begin_inset ERT
+status collapsed
\begin_layout Standard
-\series bold
\backslash
-normalmarginpar
+normalmarginpar
\end_layout
-\begin_layout Standard
-in ERT.
+\end_inset
+
\begin_inset Note Greyedout
status open
.
A negative value shifts the note up, a positive value shifts it down.
-
+
\family roman
\series medium
- For example the margin note beside this text line is shifted up 1.5\InsetSpace \thinspace{}
+For example the margin note beside this text line is shifted up 1.5\InsetSpace \thinspace{}
cm with
the ERT-command
\begin_inset Quotes eld
\end_layout
\begin_layout Standard
-\begin_inset VSpace defskip
+\begin_inset VSpace medskip
\end_inset
With
\end_inset
-
+
\family default
\series default
-The default is
+ The default is
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-\begin_inset VSpace defskip
+\begin_inset VSpace medskip
\end_inset
For the other features of
\begin_inset VSpace bigskip
\end_inset
-You can change the layout of margin notes by redefining its definition.
+You can adjust the layout of margin notes by changing its definition.
To create for example a header for all margin notes with the underlined,
sans-serif, and bold header text
\begin_inset Quotes eld
\family default
:
\begin_inset Graphics
- filename ../clipart/BoxInsetDefaultQt4.png
+ filename clipart/BoxInsetDefaultQt4.png
scale 85
+ scaleBeforeRotation
\end_inset
\end_layout
\begin_layout Standard
-This line is an example to show how you can prevent the hyphenation of e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-veryver
-ylongwords.
+This line is an example to show how you can prevent the hyphenation of
+\begin_inset Quotes eld
+\end_inset
+
+veryverylongword
+\begin_inset Quotes erd
+\end_inset
+
+.
\end_layout
\begin_layout Standard
\begin_inset Quotes eld
\end_inset
-veryverylongwords
+veryverylongword
\begin_inset Quotes erd
\end_inset
\end_layout
\begin_layout Standard
-This line is an example to show how you can prevent the hyphenation of e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
-
+This line is an example to show how you can prevent the hyphenation of
\begin_inset ERT
status collapsed
\end_inset
-veryverylongwords.
+
+\begin_inset Quotes eld
+\end_inset
+
+veryverylongword
+\begin_inset Quotes erd
+\end_inset
+
+.
\begin_inset ERT
status collapsed
\end_layout
\begin_layout Standard
-Of course the word now protrudes over the side margin.
- To avoid this, add via the menu
-\family sans
-Insert\SpecialChar \menuseparator
-Special\InsetSpace ~
-Formatting\SpecialChar \menuseparator
-Line\InsetSpace ~
-Break
-\family default
- (shortcut
+You can alternatively set the command
+\begin_inset Quotes eld
+\end_inset
+
+
\series bold
-Ctrl-Return
+
+\backslash
+-
\series default
-) a line break before the word:
+
+\begin_inset Quotes grd
+\end_inset
+
+ as ERT directly before the word:
\end_layout
\begin_layout Standard
-This line is an example to show how you can prevent the hyphenation of e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
+This line is an example to show how you can prevent the hyphenation of
+\begin_inset Quotes eld
+\end_inset
-\newline
\begin_inset ERT
status collapsed
\backslash
-mbox{
+-
\end_layout
\end_inset
-veryverylongwords.
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
+veryverylongword
+\begin_inset Quotes erd
+\end_inset
-}
+.
\end_layout
-\end_inset
+\begin_layout Standard
+Of course the word now protrudes over the side margin.
+ To avoid this, add via the menu
+\family sans
+Insert\SpecialChar \menuseparator
+Special\InsetSpace ~
+Formatting\SpecialChar \menuseparator
+Line\InsetSpace ~
+Break
+\family default
+ (shortcut
+\series bold
+Ctrl-Return
+\series default
+) a line break before the word:
+\end_layout
+
+\begin_layout Standard
+This line is an example to show how you can prevent the hyphenation of
+\newline
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+mbox{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes eld
+\end_inset
+
+veryverylongword
+\begin_inset Quotes erd
+\end_inset
+
+.
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
\end_layout
\end_layout
\begin_layout Standard
-To color the background of text the text must be put into a so called colorbox.
+To color the background of text the text must be put into a so called
+\begin_inset Quotes eld
+\end_inset
+
+colorbox
+\begin_inset Quotes erd
+\end_inset
+
+.
This requires that the LaTeX-package
\series bold
color
cyan
\family default
\series bold
-,
-\family sans
+,
\series default
+
+\family sans
green
\family default
,
Generate\InsetSpace ~
hyperlink
\family default
- in the URL dialog has only an affect when you export your document to the
- format
+ in the URL dialog has only an affect when you export your document to the
+ format
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+LinuxDoc
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+You cannot change the style of the link text.
+ The text of the
+\family sans
+Name
+\family default
+ field will have the default text style of the document while the text of
+ the
+\family sans
+URL
+\family default
+ field will have the style
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+Typewriter
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+When you use the LaTeX-package
+\series bold
+hyperref
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! hyperref"
+
+\end_inset
+
+ to link cross-references in the output, URLs will automatically become
+ clickable hyperlinks in DVI and PDF-output.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ When you use the following characters: "%", "#", "^", you have to write
+ them with a preceding backslash, e.\InsetSpace \thinspace{}
+g.\InsetSpace ~
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\backslash
+#
+\begin_inset Quotes erd
+\end_inset
+
+.
+ URLs must not end with a backslash.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+To create real hyperlinks without the force to write the link location to
+ the text, you can use the command
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+href{link location}{link text}
+\end_layout
+
+\begin_layout Standard
+in ERT.
+ To get for example a link to LyX's web page, write the command
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+href{http://www.lyx.org}{
+\end_layout
+
+\begin_layout Standard
+in ERT.
+ Insert after the command the link text
+\begin_inset Quotes eld
+\end_inset
+
+LyX's homepage
+\begin_inset Quotes erd
+\end_inset
+
+ as normal text followed by a closing brace
+\begin_inset Quotes eld
+\end_inset
+
+
+\series bold
+}
+\series default
+
+\begin_inset Quotes erd
+\end_inset
+
+ in ERT.
+ This is the result:
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{http://www.lyx.org}{
+\end_layout
+
+\end_inset
+
+LyX's homepage
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To link to email addresses, add the prefix
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+mailto:
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ to the link location:
+\newline
+Email to
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{mailto:lyx-docs@lists.lyx.org?subject=LyX's documentation}{
+\end_layout
+
+\end_inset
+
+lyx-docs mailing list
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Using
+\series bold
+
+\backslash
+href
+\series default
+ instead of LyX's URL box has the advantage that you can specify the text
+ style of the link text like for all other text parts.
+ You can then set hyphenation points and forced linebreaks to have long
+ link text broken at the page margin.
+ You are furthermore able to change the text style for all URLs in your
+ document with an option in
+\series bold
+hyperref
+\series default
+'s load command and the restrictions mentioned above doesn't apply for
+\series bold
+
+\backslash
+href
+\series default
+.
+\end_layout
+
+\begin_layout Chapter
+External Stuff
+\begin_inset LatexCommand index
+name "External Stuff"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+With the menu
+\family sans
+Insert\SpecialChar \menuseparator
+File
+\family default
+ you can insert external material to your document.
+ This can be:
+\end_layout
+
+\begin_layout Description
+LyX\InsetSpace ~
+Document Another LyX document; its content is directly inserted to your
+ document.
+\end_layout
+
+\begin_layout Description
+Plain\InsetSpace ~
+Text A text document; every of its text lines is inserted to your document
+ as own paragraph.
+\end_layout
+
+\begin_layout Description
+Plain\InsetSpace ~
+Text,\InsetSpace ~
+Join\InsetSpace ~
+Lines A text document; its text lines are inserted as they
+ are.
+ Empty text lines creates a new paragraph in your document.
+\end_layout
+
+\begin_layout Description
+External\InsetSpace ~
+Material Files in various formats.
+\end_layout
+
+\begin_layout Description
+Child\InsetSpace ~
+Document LyX or LaTeX-documents.
+\end_layout
+
+\begin_layout Section
+External Material
+\begin_inset LatexCommand index
+name "External Stuff ! External Material"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The external material feature allows you to insert files to your document
+ without converting them previously to a format that can be read by the
+ document output format because LyX takes care of needed conversions.
+ This is similar to images that can be inserted in various image formats
+ to LyX documents.
+\end_layout
+
+\begin_layout Standard
+External material can be inserted via the
+\family sans
+External Material
+\family default
+ dialog that is accessible with the menu
+\family sans
+Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+External\InsetSpace ~
+Material
+\family default
+.
+ Currently the following file types (
+\family sans
+Templates
+\family default
+) are allowed:
+\end_layout
+
+\begin_layout Description
+ChessDiagram This template supports chess position diagrams made with the
+ program
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{http://en.wikipedia.org/wiki/XBoard}{
+\end_layout
+
+\end_inset
+
+
+\series bold
+XBoard
+\series default
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+Date This inserts the date in the form
+\emph on
+Day-Month-Year
+\emph default
+.
+ This is a date inserted as external material:
+\begin_inset External
+ template Date
+ filename .
+
+\end_inset
+
+
+\newline
+The date is not shown within LyX, only in the output.
+ There are two other methods of inserting a date: Via menu
+\family sans
+Insert\SpecialChar \menuseparator
+Date
+\family default
+ and with the LaTeX command
+\series bold
+
+\backslash
+today
+\series default
+ as ERT.
+ The different methods are compared in Table\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "tab:Comparison-of-the"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+LilyPond This template is used for music notation typeset with the program
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+linebreak
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{http://en.wikipedia.org/wiki/LilyPond}{
+\end_layout
+
+\end_inset
+
+
+\series bold
+LilyPond
+\series default
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+.
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Standard
+The command
+\series bold
+
+\backslash
+linebreak
+\series default
+ breaks the line while the remaining text in the line is stretched to the
+ page margin.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+RasterImage This can be used for bitmap images.
+ Nearly all popular image formats are supported.
+ The image can be treated in the
+\family sans
+External material
+\family default
+ dialog like the images that are usually included via the
+\family sans
+Graphics
+\family default
+ dialog as described in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sec:Graphics-Dialog"
+
+\end_inset
+
+.
+ The difference is that only raster images are allowed, that means that
+ PDF and EPS-images are not supported.
+\end_layout
+
+\begin_layout Description
+XFig This template supports images created with the program
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{http://en.wikipedia.org/wiki/Xfig}{
+\end_layout
+
+\end_inset
+
+
+\series bold
+Xfig
+\series default
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Float table
+placement h
+wide false
+sideways false
+status open
+
+\begin_layout Standard
+\begin_inset Caption
+
+\begin_layout Standard
+\begin_inset LatexCommand label
+name "tab:Comparison-of-the"
+
+\end_inset
+
+Comparison of the date input methods.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\align center
+\begin_inset Tabular
+<lyxtabular version="3" rows="4" columns="4">
+<features>
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Document format
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+
+\family sans
+External Material\SpecialChar \menuseparator
+Date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+
+\family sans
+Insert\SpecialChar \menuseparator
+Date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+command
+\series bold
+
+\backslash
+today
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+LyX
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as inset box
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as ERT inset box
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+LaTeX
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as command
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true" bottomline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+DVI, PDF, PS
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+as date
+\end_layout
+
+\end_inset
+</cell>
+</row>
+</lyxtabular>
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+When you use the option
+\family sans
+Draft
+\family default
+ in the
+\family sans
+File
+\family default
+ tab of the
+\family sans
+External Material
+\family default
+ dialog, only the path to the inserted file is shown in the output.
+\newline
+External
+ material is displayed in LyX either as box like this:
+\begin_inset Graphics
+ filename clipart/ExternalMaterialQt4.png
+ scale 85
+ scaleBeforeRotation
+
+\end_inset
+
+ or as image, depending on the setting in the
+\family sans
+LyX\InsetSpace ~
+View
+\family default
+ tab of the
+\family sans
+External Material
+\family default
+ dialog.
+\end_layout
+
+\begin_layout Standard
+The
+\family sans
+\emph on
+Customization
+\family default
+\emph default
+ manual explains how you can define your own templates.
+\end_layout
+
+\begin_layout Section
+Child Documents
+\begin_inset LatexCommand label
+name "sec:Child-Documents"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "External Stuff ! Child Documents"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Files ! Include"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Child documents are used when you have a long document consisting of several
+ larger parts or sections.
+ For maintenance it is often useful and sometimes even required to split
+ the document in several files that can be revised separately.
+ The different documents are then the so called child documents and a master
+ document connects them to print the full document or parts of it.
+\end_layout
+
+\begin_layout Standard
+Included documents are displayed in LyX as a box like this:
+\begin_inset Graphics
+ filename clipart/ChildDocumentQt4.png
+ scale 85
+ scaleBeforeRotation
+
+\end_inset
+
+ To include child documents to a master document use the menu
+\family sans
+Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+Child\InsetSpace ~
+Documents
+\family default
+.
+ A dialog pops up where you can choose between four include methods:
+\end_layout
+
+\begin_layout Description
+Include You can include LyX and LaTeX-documents.
+ When you press the
+\family sans
+Load
+\family default
+ button in the
+\family sans
+Child Document
+\family default
+ dialog, the included documents will be opened in LyX in a new file tab
+ so that you can modify it.
+\newline
+
+\end_layout
+
+\begin_layout Standard
+Here is a child document inserted using
+\family sans
+Include
+\family default
+:
+\begin_inset Include \include{DummyDocument1.lyx}
+preview false
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The section numbering includes the sections of the included files in the
+ order they are inserted in the master document.
+ The included example document has for example a subsection that is numbered
+ as subsection of this section.
+ Labels of included documents can be referenced: Subsection\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sub:External-Subsection-1"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The preamble of the child document is ignored, only the preamble of the
+ master document is used.
+ Included documents are inserted starting on a new page and end with a pagebreak.
+\end_layout
+
+\begin_layout Standard
+With the LaTeX-command
+\series bold
+
+\backslash
+includeonly
+\series default
+you can specify which included child documents are processed when the output
+ is generated.
+ This is useful when you are perhaps only working on a certain chapter of
+ your large document as this saves compiling time.
+
+\series bold
+
+\backslash
+includeonly
+\series default
+ is inserted to the master document preamble.
+ It takes a comma-separated list of the filenames as argument, e.g.
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+includeonly{chapter1,chapter5}
+\end_layout
+
+\begin_layout Standard
+will only process the included files named
+\begin_inset Quotes eld
+\end_inset
+
+chapter1.lyx
+\begin_inset Quotes erd
+\end_inset
+
+ (or
+\begin_inset Quotes eld
+\end_inset
+
+chapter1.tex
+\begin_inset Quotes erd
+\end_inset
+
+) and
+\begin_inset Quotes eld
+\end_inset
+
+chapter5.lyx
+\begin_inset Quotes erd
+\end_inset
+
+ .
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ When you have included a LyX- or LaTeX-file, you are warned when you export/vie
+w the document in case that the child document uses another document class
+ than the master document as this will lead to unexpected outputs.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Input This method is very similar to the Include method.
+ The differences are:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+Input files don't start with a new page and don't end with a pagebreak.
+\end_layout
+
+\begin_layout Itemize
+Input files can be previewed in LyX when
+\family sans
+Instant\InsetSpace ~
+Preview
+\family default
+ is enabled in LyX's preferences under
+\family sans
+Look\InsetSpace ~
+and\InsetSpace ~
+feel\SpecialChar \menuseparator
+Graphics
+\family default
+.
+\end_layout
+
+\begin_layout Itemize
+The LaTeX-command
+\series bold
+
+\backslash
+includeonly
+\series default
+ cannot be used.
+\end_layout
+
+\end_deeper
+\begin_layout Standard
+Here is a child document inserted using
+\family sans
+Input
+\family default
+:
+\begin_inset Include \input{DummyDocument2.lyx}
+preview false
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Verbatim With this method every text file can be included.
+ The file is shown in the output with its source code, no command used in
+ the text is invoked.
+ You can use the option
+\family sans
+Mark spaces in output
+\family default
+ that displays the character
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+textvisiblespace
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+ for every space character in the source code.
+ The difference to the method via the menu
+\family sans
+Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+Plain\InsetSpace ~
+Text
+\family default
+ is that the document content is not shown in LyX.
+\end_layout
+
+\begin_layout Standard
+Here is a child document inserted as Verbatim:
+\begin_inset Include \verbatiminput{DummyTextDocument.txt}
+preview false
+
+\end_inset
+
+
+\begin_inset VSpace bigskip
+\end_inset
+
+Here is a child document inserted as Verbatim using the
+\family sans
+Mark spaces in output
+\family default
+ option:
+\begin_inset Include \verbatiminput*{DummyTextDocument.txt}
+preview false
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ As you can see in the examples above, the text of the documents included
+ as
+\family sans
+verbatim
+\family default
+ is not broken at the end of the document lines.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Listings This type is described in chapter\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "cha:Program-Code-Listings"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ Including the same document twice in a document using different methods
+ could cause LaTeX-problems.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Chapter
+Program Code Listings
+\begin_inset LatexCommand label
+name "cha:Program-Code-Listings"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Listings"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Program Code"
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Floats ! Listings"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To include and typeset program code you can use the
+\family sans
+Listings
+\family default
+ inset that can be inserted via the menu
+\family sans
+Insert\SpecialChar \menuseparator
+Program Listing
+\family default
+.
+ The LaTeX-package
+\series bold
+listings
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! listings"
+
+\end_inset
+
+ provides a powerful and flexible way to insert program source code to your
+ document.
+\end_layout
+
+\begin_layout Standard
+When right-clicking on a listings inset a dialog pops up where you can set
+ the listings format.
+\end_layout
+
+\begin_layout Standard
+By default, a listing starts a new paragraph in the output.
+ The placement option
+\family sans
+Inline\InsetSpace ~
+listing
+\family default
+ prints the listing inline like this:
+\begin_inset listings
+lstparams "language={C++}"
+inline true
+status open
+
+\begin_layout Standard
+
+int a=5;
+\end_layout
+
+\end_inset
+
+
+\newline
+The option
+\family sans
+Float
+\family default
+ creates a listings float where you can specify the placement options
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+h
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+,
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+t
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+,
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+b
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+, and
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+p
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ corresponding to the float placement options described in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sec:Float-Placement"
+
+\end_inset
+
+.
+ The placement options can be mixed and are inserted without any separation,
+ e.\InsetSpace \thinspace{}
+g.\InsetSpace ~
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+htbp
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The option
+\begin_inset Quotes eld
+\end_inset
+
+h
+\begin_inset Quotes erd
+\end_inset
+
+ has sometimes no effect, but you don't need to use the
+\family sans
+Float
+\family default
+ option in this case as also non-float listings can have captions and be
+ referenced.
+\end_layout
+
+\begin_layout Standard
+You can add captions to listings with the menu
+\family sans
+Insert\SpecialChar \menuseparator
+Caption
+\family default
+.
+ Listings can be referenced like floats: Listing\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "lst:Example-Listing"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+lstparams "language=Python"
+inline false
+status open
+
+\begin_layout Standard
+
+\begin_inset Caption
+
+\begin_layout Standard
+\begin_inset LatexCommand label
+name "lst:Example-Listing"
+
+\end_inset
+
+Example Listing float
+\end_layout
+
+\end_inset
+
+# Example listing float
+\end_layout
+
+\begin_layout Standard
+
+def func(param):
+\end_layout
+
+\begin_layout Standard
+
+ 'this is a python function'
+\end_layout
+
+\begin_layout Standard
+
+ pass
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+When you have set a programming language in the listings dialog, the keywords
+ of this language will be recognized and specially typeset in the output.
+ In the example listings the Python keyword
+\begin_inset Quotes eld
+\end_inset
+
+def
+\begin_inset Quotes erd
+\end_inset
+
+ is recognized and printed bold in the output.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ If you don't get bold keywords when using typewriter fonts, your typewriter
+ font probably doesn't provide a bold shape.
+ In this case select a different one in the menu
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Fonts
+\family default
+.
+ (The fonts
+\emph on
+LuxiMono, BeraMono
+\emph default
+ and
+\emph on
+Courier
+\emph default
+ provide bold shapes.)
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+In section
+\family sans
+Line\InsetSpace ~
+numbering
+\family default
+ of the listings dialog you can specify the line numbering style.
+ You can insert a number to specify which lines are numbered to the field
+
+\family sans
+Step
+\family default
+.
+ When you insert e.g.
+
\begin_inset Quotes eld
\end_inset
-
-\family sans
-LinuxDoc
-\family default
-
+3
\begin_inset Quotes erd
\end_inset
-.
+, only every 3rd line will be numbered.
\end_layout
\begin_layout Standard
-You cannot change the style of the link text.
- The text of the
-\family sans
-Name
-\family default
- field will have the default text style of the document while the text of
- the
+You can furthermore specify a range of lines, only these will then appear
+ in the output.
+ The option
\family sans
-URL
+Extended\InsetSpace ~
+chars
\family default
- field will have the style
+ should be used when you use national characters like the German umlauts
+ in the listing.
+\newline
+Here is an example listing with left line numbering, step
+
\begin_inset Quotes eld
\end_inset
+3
+\begin_inset Quotes erd
+\end_inset
-\family sans
-Typewriter
-\family default
+, language
+\begin_inset Quotes eld
+\end_inset
+Python
\begin_inset Quotes erd
\end_inset
-.
-\end_layout
+, options
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Standard
-When you use the LaTeX-package
-\series bold
-hyperref
-\series default
+Extended\InsetSpace ~
+chars
+\begin_inset Quotes erd
+\end_inset
-\begin_inset LatexCommand index
-name "LaTeX-packages ! hyperref"
+ and
+\begin_inset Quotes eld
+\end_inset
+Space\InsetSpace ~
+as\InsetSpace ~
+Symbol
+\begin_inset Quotes erd
\end_inset
- to link cross-references in the output, URLs will automatically become
- clickable hyperlinks in DVI and PDF-output.
+, range lines 3\InsetSpace \thinspace{}
+-\InsetSpace \thinspace{}
+8:
\end_layout
\begin_layout Standard
-\begin_inset Note Greyedout
+\begin_inset listings
+lstparams "extendedchars=true,firstline=3,language=Python,lastline=8,numbers=left,showspaces=true,stepnumber=3"
+inline false
status open
\begin_layout Standard
-\series bold
-Note:
-\series default
-When you use the following characters: "%", "#", "^", you have to write
- them with a preceding backslash, e.\InsetSpace \thinspace{}
-g.\InsetSpace ~
+def func(param):
+\end_layout
-\begin_inset Quotes eld
-\end_inset
+\begin_layout Standard
+ 'this is a python function'
+\end_layout
-\backslash
-#
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Standard
-.
- URLs must not end with a backslash.
+ pass
\end_layout
-\end_inset
-
+\begin_layout Standard
+def func(param):
\end_layout
\begin_layout Standard
-\begin_inset VSpace bigskip
-\end_inset
-To create real hyperlinks without the force to write the link location to
- the text, you can use the command
+'This is a German word: Tschüß'
\end_layout
\begin_layout Standard
-\series bold
-
-\backslash
-href{link location}{link text}
+pass
\end_layout
\begin_layout Standard
-in ERT.
- To get for example a link to LyX's web page, write the command
+
+def func(param):
\end_layout
\begin_layout Standard
-\series bold
-
-\backslash
-href{http://www.lyx.org}{
+'this is a python function'
\end_layout
\begin_layout Standard
-in ERT.
- Insert after the command the link text
-\begin_inset Quotes eld
-\end_inset
-LyX's homepage
-\begin_inset Quotes erd
-\end_inset
+pass
+\end_layout
- as normal text followed by a closing brace
-\begin_inset Quotes eld
\end_inset
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
\series bold
-}
+Note:
+\series default
+ Due to a bug in the
+\series bold
+listings
\series default
+ package the line numbering is shifted by a line by every previous listing.
+ That's the reason why the lines 2 and 5 are numbered in the above listing
+ and not the lines 3 and 6.
+\end_layout
-\begin_inset Quotes erd
\end_inset
- in ERT.
- This is the result:
-\begin_inset ERT
-status collapsed
+
+\end_layout
\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
-\backslash
-href{http://www.lyx.org}{
\end_layout
-\end_inset
-
-LyX's homepage
-\begin_inset ERT
+\begin_layout Standard
+It is also possible to print lines from a file as listing.
+ To do this, use the menu
+\family sans
+Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+Child Document
+\family default
+ and choose the type
+\family sans
+Listings
+\family default
+.
+\begin_inset Foot
status collapsed
\begin_layout Standard
+The other child document types are described in section\InsetSpace ~
-}
-\end_layout
+\begin_inset LatexCommand ref
+reference "sec:Child-Documents"
\end_inset
-
+.
\end_layout
-\begin_layout Standard
-To link to email addresses, add the prefix
+\end_inset
+
+ In the child document dialog you can specify the listing parameters in
+ a text box.
+ To show a list of all available parameters, type in a question mark
\begin_inset Quotes eld
\end_inset
+?
+\begin_inset Quotes erd
+\end_inset
+
+ in the text box.
+\end_layout
+\begin_layout Standard
+To reference child document listings, write a label text into the corresponding
+ field of the child document dialog.
+ The label can then be referenced using the menu
\family sans
-mailto:
+Insert\SpecialChar \menuseparator
+Cross-Reference
\family default
+.
+\end_layout
+
+\begin_layout Standard
+Listing\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "lst:file-listing"
-\begin_inset Quotes erd
\end_inset
- to the link location:
-\newline
-Email to
-\begin_inset ERT
-status collapsed
+ is an example for a listing of a file; there the lines 10\InsetSpace \thinspace{}
+-\InsetSpace \thinspace{}
+15 of this LyX
+ file are listed.
+\end_layout
\begin_layout Standard
+\begin_inset Include \lstinputlisting{EmbeddedObjects.lyx}[breaklines=true,caption={Lines 10 - 15 of this LyX file},firstline=10,label={lst:file-listing},language={[LaTeX]TeX},lastline=15]
+preview false
+
+\end_inset
-\backslash
-href{mailto:lyx-docs@lists.lyx.org?subject=LyX's documentation}{
\end_layout
+\begin_layout Standard
+\begin_inset VSpace bigskip
\end_inset
-lyx-docs mailing list
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-}
\end_layout
+\begin_layout Standard
+Global listings settings can be set in the
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Text Layout
+\family default
+ dialog.
+ To get there a list of available options, type in a question mark
+\begin_inset Quotes eld
+\end_inset
+
+?
+\begin_inset Quotes erd
\end_inset
-.
+ in the
+\family sans
+Listings\InsetSpace ~
+settings
+\family default
+ field.
\end_layout
\begin_layout Standard
-Using
-\series bold
-
-\backslash
-href
-\series default
- instead of LyX's URL box has the advantage that you can specify the text
- style of the link text like for all other text parts.
- You can therefore set hyphenation points and forced linebreaks to have
- long link text broken at the page margin.
- You are furthermore able to change the text style for all URLs in your
- document with an option in
+For more information about the
\series bold
-hyperref
+listings
\series default
-'s load command and the restrictions mentioned above doesn't apply for
-\series bold
+ package, we refer to its documentation
+\begin_inset LatexCommand cite
+key "listings"
+
+\end_inset
-\backslash
-href
-\series default
.
\end_layout
\begin_inset Text
\begin_layout Standard
-didot (72\InsetSpace \thinspace{}
+didot (1\InsetSpace \thinspace{}
dd
\begin_inset Formula $\approx$
\end_inset
- 37.6\InsetSpace \thinspace{}
+ 0.376\InsetSpace \thinspace{}
mm)
\end_layout
DVI
\family default
.
- You can view your document as PostScript via the
+ You can view your document as DVI via the
\family sans
View
\family default
\begin_inset Graphics
filename ../images/buffer-view_dvi.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\begin_inset LatexCommand index
-name "File Formats ! PostScript\\protect\\pagebreak"
+name "File Formats ! PostScript"
\end_inset
\begin_inset Graphics
filename ../images/buffer-view_ps.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\end_inset
).
- You can although use any other image format, because LyX converts them
+ Nevertheless you can use any other image format, because LyX converts them
in the background to one of these formats.
But as described in the section about PostScript, the image conversion
will slow down your work flow.
\end_layout
\begin_layout Description
-PDF This uses the program
+PDF\InsetSpace ~
+(ps2pdf) This uses the program
\family typewriter
ps2pdf
\family default
\begin_inset Graphics
filename ../images/buffer-view_pdf2.xpm
scale 85
+ scaleBeforeRotation
\end_inset
\begin_layout Standard
\begin_inset Formula \begin{equation}
-W_{\mathrm{tot}\, n}=n·(W_{g\, n}+2·\backslash\mbox{tabcolsep})+(n+1)·\backslash\mbox{arrayrulewidth}\label{eq:Wtot_n}\end{equation}
+W_{\mathrm{tot}\, n}=n\cdot(W_{g\, n}+2\cdot\backslash\mbox{tabcolsep})+(n+1)\cdot\backslash\mbox{arrayrulewidth}\label{eq:Wtot_n}\end{equation}
\end_inset
\begin_layout Standard
\begin_inset Formula \begin{equation}
-W_{\mathrm{tot\, mult}}=W_{g\,\mathrm{mult}}+2·\backslash\mbox{tabcolsep}+2·\backslash\mbox{arrayrulewidth}\label{eq:Wtot_mult}\end{equation}
+W_{\mathrm{tot\, mult}}=W_{g\,\mathrm{mult}}+2\cdot\backslash\mbox{tabcolsep}+2\cdot\backslash\mbox{arrayrulewidth}\label{eq:Wtot_mult}\end{equation}
\end_inset
\begin_layout Standard
\begin_inset Formula \begin{equation}
-W_{g\, n}=(W_{g\,\mathrm{mult}}+(1-n)·(2·\backslash\mbox{tabcolsep}+\backslash\mbox{arrayrulewidth}))/n\end{equation}
+W_{g\, n}=(W_{g\,\mathrm{mult}}+(1-n)\cdot(2\cdot\backslash\mbox{tabcolsep}+\backslash\mbox{arrayrulewidth}))/n\end{equation}
\end_inset
Frank Mittelbach and Michel Goossens:
\emph on
The LaTeX Companion Second Edition.
-
+
\emph default
-Addison-Wesley, 2004
+ Addison-Wesley, 2004
\end_layout
\begin_layout Bibliography
Daly:
\emph on
A Guide to LaTeX Fourth Edition.
-
+
\emph default
-Addison-Wesley, 2003
+ Addison-Wesley, 2003
\end_layout
\begin_layout Bibliography
Leslie Lamport:
\emph on
LaTeX: A Document Preparation System.
-
+
\emph default
-Addison-Wesley, second edition, 1994
+ Addison-Wesley, second edition, 1994
\end_layout
\begin_layout Bibliography
of the LaTeX-package
\series bold
-floatf\SpecialChar \textcompwordmark{}
+f\SpecialChar \textcompwordmark{}
+loatf\SpecialChar \textcompwordmark{}
lt
\series default
\end_inset
+\end_layout
+
+\begin_layout Bibliography
+\begin_inset LatexCommand bibitem
+key "listings"
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+href{ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/listings/listings.pdf}
+{
+\end_layout
+
+\end_inset
+
+Documentation
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}
+\end_layout
+
+\end_inset
+
+ of the LaTeX-package
+\series bold
+listings
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-packages ! listings"
+
+\end_inset
+
+
\end_layout
\begin_layout Bibliography
\family sans
LyX 1.5
\family default
-.
+.0.
\end_layout
\begin_layout Standard
projects / lyx.git / blobdiff