-#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 270
+#LyX 1.5.0beta3 created this file. For more info see http://www.lyx.org/
+\lyxformat 271
\begin_document
\begin_header
\textclass scrbook
\bullet 3 2 7 -1
\tracking_changes false
\output_changes false
-\author "Bo Peng"
\author "usti"
+\author "muso"
+\author "Bo Peng"
\author "Uwe Stöhr"
\end_header
\begin_inset LatexCommand index
-name "Floats ! Figure Floats"
+name "Floats ! Figures"
\end_inset
\begin_layout Subsection
Algorithm Floats
\begin_inset LatexCommand index
-name "Floats ! Algorithm Floats"
+name "Floats ! Algorithms"
\end_inset
\family default
if the LaTeX-package
\series bold
-floatflt
+floatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand index
\begin_layout Standard
The LaTeX-package
\series bold
-floatflt
+floatf\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
+floatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand cite
\begin_inset LatexCommand index
-name "Floats ! Listings"
+name "Floats ! Float Lists"
\end_inset
\series default
\begin_inset ERT
-status collapsed
+status open
\begin_layout Standard
\backslash
-numberwithin{footnote}{part}
+renewcommand{
+\backslash
+thefootnote}{
+\backslash
+arabic{footnote}}
\end_layout
\end_inset
\end_inset
-\end_layout
-
-\begin_layout Chapter
-Program Listings
-\end_layout
-
-\begin_layout Standard
-The
-\family typewriter
-listings
-\family default
-latex package provides a powerful and flexible way to insert program source
- code into your document.
-\end_layout
-
-\begin_layout Standard
-There are three types of listings, in listings package terms:
-\end_layout
-
-\begin_layout Description
-lstinline short piece of program code like
-\begin_inset listings
-inline false
-status open
-
-\begin_layout Standard
-
-\color foreground
-int a=5;
-\end_layout
-
-\end_inset
-
- .
- To insert this listing, choose
-\family typewriter
-Insert->Program Listing
-\family default
- and choose
-\family typewriter
-inline listing
-\family default
-from the
-\family typewriter
-placement
-\family default
-section.
-\end_layout
-
-\begin_layout Description
-lstlisting long program listing in its own paragraphs and decorations, For
- example,
-\begin_inset listings
-inline false
-status open
-
-\begin_layout Standard
-
-\color foreground
-def func(param):
-\end_layout
-
-\begin_layout Standard
- 'this is a python function'
-\end_layout
-
-\begin_layout Standard
- pass
-\end_layout
-
-\end_inset
-
-To insert this listing, choose
-\family typewriter
-Insert->Program Listing
-\family default
-.
-\end_layout
-
-\begin_layout Description
-lstinputlisting read program listing from a file.
- Parameters can be given to list only given lines.
- For example, the following listings list line 10 - 15 of this lyx file.
-\end_layout
-
-\begin_layout Standard
-\begin_inset Include \lstinputlisting{EmbeddedObjects.lyx}[firstline=10,lastline=15,language=TeX,breaklines=true,caption={Line 10 - 15 of this lyx file}]
-preview false
-
-\end_inset
-
-
\end_layout
\begin_layout Standard
-To insert this listing, choose
-\family typewriter
-Insert-> File->Child Document
-\family default
-, and choose
-\family typewriter
-listings
-\family default
-type.
-\end_layout
-\begin_layout Standard
-A lot of listings parameters can be set through the listings dialog, child
- document dialog.
- Global listings settings can be set through
-\family typewriter
-Document -> Settings -> Text Layout.
\end_layout
\begin_layout Chapter
\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_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
\end_inset
-\end_layout
-
-\begin_layout Standard
-
-\newpage
-
\end_layout
\begin_layout Chapter
-\start_of_appendix
-Units available in
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-
-\backslash
-texorpdfstring{
-\end_layout
+Program Code Listings
+\begin_inset LatexCommand label
+name "cha:Program-Code-Listings"
\end_inset
-LyX
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-}{LyX}
-\end_layout
+\begin_inset LatexCommand index
+name "Listings"
\end_inset
\begin_inset LatexCommand index
-name "Units"
+name "Program Code"
\end_inset
-\begin_inset LatexCommand label
-name "cha:Units-available-in"
+\begin_inset LatexCommand index
+name "Floats ! Listings"
\end_inset
-\begin_inset Note Note
-status collapsed
+\end_layout
\begin_layout Standard
-The command
-\backslash
-texorpdfstring is provided by the LaTeX-package hyperref to avoid that ligatures
- are displayed wrongly in PDF-bookmarks.
- For more information about this, have a look at
-\begin_inset LatexCommand cite
-key "hyperref"
-
-\end_inset
-
+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
.
-\end_layout
+ The LaTeX-package
+\series bold
+listings
+\series default
-\end_inset
+\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
-To understand the units described in this documentation, Table\InsetSpace ~
-
-\begin_inset LatexCommand ref
-reference "tab:Units"
-
-\end_inset
-
- explains all units available in LyX.
+When right-clicking on a listings inset a dialog pops up where you can set
+ the listings format.
\end_layout
\begin_layout Standard
-\begin_inset Float table
-placement h
-wide false
-sideways false
+The default listing inset will appear in the output as own paragraph.
+ 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
-\begin_inset Caption
-\begin_layout Standard
-\begin_inset LatexCommand label
-name "tab:Units"
+\color foreground
+int a=5;
+\end_layout
\end_inset
-Units
-\end_layout
+\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
-\end_layout
+\family sans
+h
+\family default
-\begin_layout Standard
-\begin_inset VSpace medskip
+\begin_inset Quotes erd
\end_inset
+,
+\begin_inset Quotes eld
+\end_inset
-\end_layout
-\begin_layout Standard
-\align center
-\begin_inset Tabular
-<lyxtabular version="3" rows="20" columns="2">
-<features>
-<column alignment="center" valignment="top" leftline="true" width="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
-<row topline="true" bottomline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
+\family sans
+t
+\family default
-\begin_layout Standard
-unit
-\end_layout
+\begin_inset Quotes erd
+\end_inset
+,
+\begin_inset Quotes eld
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-name/description
-\end_layout
-\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
+\family sans
+b
+\family default
-\begin_layout Standard
-mm
-\end_layout
+\begin_inset Quotes erd
+\end_inset
+, and
+\begin_inset Quotes eld
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-millimeter
-\end_layout
-\end_inset
-</cell>
+\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
+To reference non-inline listings, you can't insert the caption via LyX's
+ Insert menu.
+ The caption is inserted in the
+\family sans
+Advanced
+\family default
+ tab of the listings dialog using the option
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+caption=YourCaptionText
+\end_layout
+
+\begin_layout Standard
+The label is inserted to the caption text using the LaTeX-command
+\series bold
+
+\backslash
+label
+\series default
+.
+ In Listing\InsetSpace ~
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+ref{lst:Example-listing}
+\end_layout
+
+\end_inset
+
+ the caption and label is inserted with the option
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+caption=
+\backslash
+label{lst:Example-listing}Example listing float
+\end_layout
+
+\begin_layout Standard
+To reference the label, this ERT command was inserted to the position where
+ the reference should appear:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+ref{lst:Example-listing}
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+lstparams "language=Python,float,floatplacement=h,caption=\label{lst:Example-listing}Example listing float"
+inline false
+status open
+
+\begin_layout Standard
+
+\color foreground
+# Example listing float
+\end_layout
+
+\begin_layout Standard
+
+\color foreground
+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
+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
+
+3
+\begin_inset Quotes erd
+\end_inset
+
+, only every 3rd line will be numbered.
+\end_layout
+
+\begin_layout Standard
+You can furthermore specify a range of lines, only these will then appear
+ in the output.
+ The option
+\family sans
+Extended\InsetSpace ~
+chars
+\family default
+ 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
+
+, language
+\begin_inset Quotes eld
+\end_inset
+
+Python
+\begin_inset Quotes erd
+\end_inset
+
+, option
+\begin_inset Quotes eld
+\end_inset
+
+Extended\InsetSpace ~
+chars
+\begin_inset Quotes erd
+\end_inset
+
+ and
+\begin_inset Quotes eld
+\end_inset
+
+Space\InsetSpace ~
+as\InsetSpace ~
+Symbol
+\begin_inset Quotes erd
+\end_inset
+
+, range lines 3\InsetSpace \thinspace{}
+-\InsetSpace \thinspace{}
+8:
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+lstparams "language=Python,numbers=left,firstline=3,lastline=8,stepnumber=3,showspaces=true,extendedchars=true"
+inline false
+status open
+
+\begin_layout Standard
+def func(param):
+\end_layout
+
+\begin_layout Standard
+ 'this is a python function'
+\end_layout
+
+\begin_layout Standard
+ pass
+\end_layout
+
+\begin_layout Standard
+def func(param):
+\end_layout
+
+\begin_layout Standard
+'This is a German word: Tschüß'
+\end_layout
+
+\begin_layout Standard
+pass
+\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
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+Note:
+\series default
+ 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
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\end_layout
+
+\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 ~
+
+\begin_inset LatexCommand ref
+reference "sec:Child-Documents"
+
+\end_inset
+
+.
+\end_layout
+
+\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.
+ To reference the label use the ERT command
+\series bold
+
+\backslash
+ref
+\series default
+ as described above.
+\end_layout
+
+\begin_layout Standard
+Listing\InsetSpace ~
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+ref{lst:file-listing}
+\end_layout
+
+\end_inset
+
+ 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}[firstline=10,lastline=15,language=TeX,breaklines=true,caption={Lines 10 - 15 of this LyX file},label={lst:file-listing}]
+preview false
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\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
+For more information about the
+\series bold
+listings
+\series default
+ package, we refer to its documentation
+\begin_inset LatexCommand cite
+key "listings"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+
+\newpage
+
+\end_layout
+
+\begin_layout Chapter
+\start_of_appendix
+Units available in
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+texorpdfstring{
+\end_layout
+
+\end_inset
+
+LyX
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}{LyX}
+\end_layout
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Units"
+
+\end_inset
+
+
+\begin_inset LatexCommand label
+name "cha:Units-available-in"
+
+\end_inset
+
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Standard
+The command
+\backslash
+texorpdfstring is provided by the LaTeX-package hyperref to avoid that ligatures
+ are displayed wrongly in PDF-bookmarks.
+ For more information about this, have a look at
+\begin_inset LatexCommand cite
+key "hyperref"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To understand the units described in this documentation, Table\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "tab:Units"
+
+\end_inset
+
+ explains all units available in LyX.
+\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:Units"
+
+\end_inset
+
+Units
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace medskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\align center
+\begin_inset Tabular
+<lyxtabular version="3" rows="20" columns="2">
+<features>
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
+<row topline="true" bottomline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+unit
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+name/description
+\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
+mm
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+millimeter
+\end_layout
+
+\end_inset
+</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\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
-#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 269
+#LyX 1.5.0beta3 created this file. For more info see http://www.lyx.org/
+\lyxformat 271
\begin_document
\begin_header
\textclass scrbook
\begin_inset LatexCommand index
-name "Flotantes ! Figuras Flotantes"
+name "Flotantes ! Figuras"
\end_inset
\family default
si está instalado el paquete LaTeX
\series bold
-floatflt
+floatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand index
\begin_layout Standard
El paquete LaTeX
\series bold
-floatflt
+floatf\SpecialChar \textcompwordmark{}
+lt
\series default
también soporta tablas adosadas a texto pero aún no es soportado por LyX.
Si lo necesitas, consulta la documentación de
\series bold
-floatflt
+floatf\SpecialChar \textcompwordmark{}
+lt
\series default
\begin_inset LatexCommand cite
\begin_inset LatexCommand index
-name "Flotantes ! Lista"
+name "Flotantes ! Lista Flotantes"
\end_inset
\begin_layout Standard
\begin_inset ERT
-status open
+status collapsed
\begin_layout Standard
\begin_inset ERT
-status open
+status collapsed
\begin_layout Standard
\begin_layout Standard
\begin_inset ERT
-status open
+status collapsed
\begin_layout Standard
\series bold
\begin_inset Foot
-status collapsed
+status open
\begin_layout Standard
Nota al pie numerada en el esquema
\backslash
-numberwithin{footnote}{part}
+renewcommand{
+\backslash
+thefootnote}{
+\backslash
+arabic{footnote}}
\end_layout
\end_inset
\begin_layout Section
Documento Hijo
+\begin_inset LatexCommand label
+name "sec:Documento-Hijo"
+
+\end_inset
+
+
\begin_inset LatexCommand index
name "Documento Hijo"
\end_layout
+\begin_layout Description
+
+\lang english
+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 collapsed
+status open
\begin_layout Standard
\end_inset
-\end_layout
-
-\begin_layout Standard
-
-\newpage
-
\end_layout
\begin_layout Chapter
-\start_of_appendix
-Unidades disponibles en
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-
-\backslash
-texorpdfstring{
-\end_layout
+\lang english
+Program Code Listings
+\begin_inset LatexCommand label
+name "cha:Program-Code-Listings"
\end_inset
-LyX
-\begin_inset ERT
-status collapsed
-
-\begin_layout Standard
-}{LyX}
-\end_layout
+\begin_inset LatexCommand index
+name "Listings"
\end_inset
\begin_inset LatexCommand index
-name "Unidades"
+name "Program Code"
\end_inset
-\begin_inset LatexCommand label
-name "cha:Unidades-disponibles-en"
+\begin_inset LatexCommand index
+name "Flotantes ! Listings"
\end_inset
-\begin_inset Note Note
-status collapsed
+\end_layout
\begin_layout Standard
-El comando
-\backslash
-texorpdfstring suministrado por el paquete LaTeX hyperref impide que los
- enlaces se muestren erróneamente en los marcadores PDF.
- Más información en
-\begin_inset LatexCommand cite
-key "hyperref"
-
-\end_inset
+\lang english
+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
.
-\end_layout
+ The LaTeX-package
+\lang spanish
+
+\series bold
+listings
+\series default
-\end_inset
+\begin_inset LatexCommand index
+name "LaTeX-paquetes ! listings"
+\end_inset
+
+\lang english
+provides a powerful and flexible way to insert program source code to your
+ document.
\end_layout
\begin_layout Standard
-Para comprender las unidades utilizadas en este manual, el cuadro\InsetSpace ~
-
-\begin_inset LatexCommand ref
-reference "tab:Unidades"
-
-\end_inset
- describe todas las unidades disponibles en LyX.
+\lang english
+When right-clicking on a listings inset a dialog pops up where you can set
+ the listings format.
\end_layout
\begin_layout Standard
-\begin_inset Float table
-placement h
-wide false
-sideways false
+
+\lang english
+The default listing inset will appear in the output as own paragraph.
+ 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
-\begin_inset Caption
-\begin_layout Standard
-\begin_inset LatexCommand label
-name "tab:Unidades"
+\color foreground
+\lang english
+int a=5;
+\end_layout
\end_inset
-Unidades
-\end_layout
+\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
-\end_layout
+\family sans
+h
+\family default
-\begin_layout Standard
-\begin_inset VSpace medskip
+\begin_inset Quotes erd
\end_inset
+,
+\begin_inset Quotes eld
+\end_inset
-\end_layout
-\begin_layout Standard
-\align center
-\begin_inset Tabular
-<lyxtabular version="3" rows="20" columns="2">
-<features>
-<column alignment="center" valignment="top" leftline="true" width="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
-<row topline="true" bottomline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
+\family sans
+t
+\family default
-\begin_layout Standard
-unidad
-\end_layout
+\begin_inset Quotes erd
+\end_inset
+,
+\begin_inset Quotes eld
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-nombre/descripción
-\end_layout
-\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
+\family sans
+b
+\family default
-\begin_layout Standard
-mm
-\end_layout
+\begin_inset Quotes erd
+\end_inset
+, and
+\begin_inset Quotes eld
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-milímetro
-\end_layout
+\family sans
+p
+\family default
+
+\begin_inset Quotes erd
\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-cm
-\end_layout
+ corresponding to the float placement options described in section\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sec:Float-Placement"
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-centímetro
-\end_layout
+.
+ The placement options can be mixed and are inserted without any separation,
+ e.\InsetSpace \thinspace{}
+g.\InsetSpace ~
+\begin_inset Quotes eld
\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-in
-\end_layout
+\family sans
+htbp
+\family default
+
+\begin_inset Quotes erd
\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-pulgada
-\end_layout
+.
+ The option
+\begin_inset Quotes eld
+\end_inset
+h
+\begin_inset Quotes erd
\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-\begin_layout Standard
-pt
+ 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
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-
\begin_layout Standard
-punto (72.27\InsetSpace \thinspace{}
-pt = 1\InsetSpace \thinspace{}
-in)
-\end_layout
-\end_inset
-</cell>
-</row>
-<row topline="true">
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
+\lang english
+To reference non-inline listings, you can't insert the caption via LyX's
+ Insert menu.
+ The caption is inserted in the
+\family sans
+Advanced
+\family default
+ tab of the listings dialog using the option
+\end_layout
\begin_layout Standard
-pc
-\end_layout
+
+\series bold
+\lang english
+caption=YourCaptionText
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+The label is inserted to the caption text using the LaTeX-command
+\series bold
+
+\backslash
+label
+\series default
+.
+ In Listing\InsetSpace ~
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+ref{lst:Example-listing}
+\end_layout
+
+\end_inset
+
+ the caption and label is inserted with the option
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+\lang english
+caption=
+\backslash
+label{lst:Example-listing}Example listing float
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+To reference the label, this ERT command was inserted to the position where
+ the reference should appear:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+\lang english
+
+\backslash
+ref{lst:Example-listing}
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+lstparams "language=Python,float,floatplacement=h,caption=\label{lst:Example-listing}Example listing float"
+inline false
+status open
+
+\begin_layout Standard
+
+\color foreground
+\lang english
+# Example listing float
+\end_layout
+
+\begin_layout Standard
+
+\color foreground
+\lang english
+def func(param):
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+ 'this is a python function'
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+ pass
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+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
+
+\lang english
+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
+
+3
+\begin_inset Quotes erd
+\end_inset
+
+, only every 3rd line will be numbered.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+You can furthermore specify a range of lines, only these will then appear
+ in the output.
+ The option
+\family sans
+Extended\InsetSpace ~
+chars
+\family default
+ 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
+
+, language
+\begin_inset Quotes eld
+\end_inset
+
+Python
+\begin_inset Quotes erd
+\end_inset
+
+, option
+\begin_inset Quotes eld
+\end_inset
+
+Extended\InsetSpace ~
+chars
+\begin_inset Quotes erd
+\end_inset
+
+ and
+\begin_inset Quotes eld
+\end_inset
+
+Space\InsetSpace ~
+as\InsetSpace ~
+Symbol
+\begin_inset Quotes erd
+\end_inset
+
+, range lines 3\InsetSpace \thinspace{}
+-\InsetSpace \thinspace{}
+8:
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+lstparams "language=Python,numbers=left,firstline=3,lastline=8,stepnumber=3,showspaces=true,extendedchars=true"
+inline false
+status open
+
+\begin_layout Standard
+
+\lang english
+def func(param):
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+ 'this is a python function'
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+ pass
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+def func(param):
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+'This is a German word: Tschüß'
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+pass
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+def func(param):
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+'this is a python function'
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+pass
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Standard
+
+\series bold
+\lang english
+Note:
+\series default
+ 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
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+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
+
+\lang english
+The other child document types are described in section
+\lang spanish
+\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "sec:Documento-Hijo"
+
+\end_inset
+
+.
+\end_layout
+
+\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
+
+\lang english
+To reference child document listings, write a label text into the corresponding
+ field of the child document dialog.
+ To reference the label use the ERT command
+\series bold
+
+\backslash
+ref
+\series default
+ as described above.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Listing\InsetSpace ~
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+ref{lst:file-listing}
+\end_layout
+
+\end_inset
+
+ 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
+
+\lang english
+\begin_inset Include \lstinputlisting{EmbeddedObjects.lyx}[firstline=10,lastline=15,language=TeX,breaklines=true,caption={Lines 10 - 15 of this LyX file},label={lst:file-listing}]
+preview false
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+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
+
+\lang english
+For more information about the
+\series bold
+listings
+\series default
+ package, we refer to its documentation
+\lang spanish
+
+\begin_inset LatexCommand cite
+key "listings"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+
+\newpage
+
+\end_layout
+
+\begin_layout Chapter
+\start_of_appendix
+Unidades disponibles en
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+
+\backslash
+texorpdfstring{
+\end_layout
+
+\end_inset
+
+LyX
+\begin_inset ERT
+status collapsed
+
+\begin_layout Standard
+
+}{LyX}
+\end_layout
+
+\end_inset
+
+
+\begin_inset LatexCommand index
+name "Unidades"
+
+\end_inset
+
+
+\begin_inset LatexCommand label
+name "cha:Unidades-disponibles-en"
+
+\end_inset
+
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Standard
+El comando
+\backslash
+texorpdfstring suministrado por el paquete LaTeX hyperref impide que los
+ enlaces se muestren erróneamente en los marcadores PDF.
+ Más información en
+\begin_inset LatexCommand cite
+key "hyperref"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Para comprender las unidades utilizadas en este manual, el cuadro\InsetSpace ~
+
+\begin_inset LatexCommand ref
+reference "tab:Unidades"
+
+\end_inset
+
+ describe todas las unidades disponibles en LyX.
+\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:Unidades"
+
+\end_inset
+
+Unidades
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace medskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\align center
+\begin_inset Tabular
+<lyxtabular version="3" rows="20" columns="2">
+<features>
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
+<row topline="true" bottomline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+unidad
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+nombre/descripción
+\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
+mm
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+milímetro
+\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
+cm
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+centímetro
+\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
+in
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+pulgada
+\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
+pt
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+punto (72.27\InsetSpace \thinspace{}
+pt = 1\InsetSpace \thinspace{}
+in)
+\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
+pc
+\end_layout
\end_inset
</cell>
(en alemán)
\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
+
+ del paquete LaTeX
+\series bold
+listings
+\series default
+
+\begin_inset LatexCommand index
+name "LaTeX-paquetes ! listings"
+
+\end_inset
+
+
+\end_layout
+
\begin_layout Bibliography
\begin_inset LatexCommand bibitem
key "marginnote"
projects / features.git / commitdiff