From 1ed7f25034dfa7d5f24ca94a39b9ff9cf18be1b1 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Uwe=20St=C3=B6hr?= Date: Fri, 18 May 2007 02:16:34 +0000 Subject: [PATCH] EmbeddedObjects: new chapter about listings git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@18395 a592a061-630c-0410-9148-cb99ea01b6c8 --- lib/doc/EmbeddedObjects.lyx | 959 +++++++++++++++++++++++------- lib/doc/es/EmbeddedObjects.lyx | 1021 +++++++++++++++++++++++++++----- 2 files changed, 1602 insertions(+), 378 deletions(-) diff --git a/lib/doc/EmbeddedObjects.lyx b/lib/doc/EmbeddedObjects.lyx index f9d5b8fb9c..600cdf09c8 100644 --- a/lib/doc/EmbeddedObjects.lyx +++ b/lib/doc/EmbeddedObjects.lyx @@ -1,5 +1,5 @@ -#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 @@ -203,8 +203,9 @@ \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 @@ -596,7 +597,7 @@ name "sec:Figure-Floats" \begin_inset LatexCommand index -name "Floats ! Figure Floats" +name "Floats ! Figures" \end_inset @@ -17551,7 +17552,7 @@ Float \begin_layout Subsection Algorithm Floats \begin_inset LatexCommand index -name "Floats ! Algorithm Floats" +name "Floats ! Algorithms" \end_inset @@ -17917,7 +17918,8 @@ Float \family default if the LaTeX-package \series bold -floatflt +floatf\SpecialChar \textcompwordmark{} +lt \series default \begin_inset LatexCommand index @@ -17976,12 +17978,14 @@ ng text. \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 @@ -20961,7 +20965,7 @@ name "sec:Listings-of-Floats" \begin_inset LatexCommand index -name "Floats ! Listings" +name "Floats ! Float Lists" \end_inset @@ -22242,13 +22246,17 @@ chapter.footnote \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 @@ -23639,118 +23647,10 @@ fi \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 @@ -27562,6 +27462,12 @@ Customization \begin_layout Section Child Documents +\begin_inset LatexCommand label +name "sec:Child-Documents" + +\end_inset + + \begin_inset LatexCommand index name "External Stuff ! Child Documents" @@ -27871,6 +27777,17 @@ Note: \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 @@ -27887,163 +27804,723 @@ Note: \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 - - - - - - -\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 - - -\begin_inset Text -\begin_layout Standard -name/description -\end_layout -\end_inset - - - - -\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 - - -\begin_inset Text -\begin_layout Standard -millimeter -\end_layout -\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 +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 + + + + + + +\begin_inset Text + +\begin_layout Standard +unit +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +name/description +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +mm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +millimeter +\end_layout + +\end_inset + @@ -29481,6 +29958,50 @@ name "LaTeX-packages ! koma-script" \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 @@ -29647,7 +30168,7 @@ status collapsed \family sans LyX 1.5 \family default -. +.0. \end_layout \begin_layout Standard diff --git a/lib/doc/es/EmbeddedObjects.lyx b/lib/doc/es/EmbeddedObjects.lyx index 4cab097080..eafde2f63d 100644 --- a/lib/doc/es/EmbeddedObjects.lyx +++ b/lib/doc/es/EmbeddedObjects.lyx @@ -1,5 +1,5 @@ -#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 @@ -601,7 +601,7 @@ name "sec:Figuras-Flotantes" \begin_inset LatexCommand index -name "Flotantes ! Figuras Flotantes" +name "Flotantes ! Figuras" \end_inset @@ -17982,7 +17982,8 @@ texto \family default si está instalado el paquete LaTeX \series bold -floatflt +floatf\SpecialChar \textcompwordmark{} +lt \series default \begin_inset LatexCommand index @@ -18038,12 +18039,14 @@ reference "cha:Unidades-disponibles-en" \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 @@ -21155,7 +21158,7 @@ name "sec:Lista-de-Flotantes" \begin_inset LatexCommand index -name "Flotantes ! Lista" +name "Flotantes ! Lista Flotantes" \end_inset @@ -21852,7 +21855,7 @@ inecolor{shadecolor}{cmyk}{0.5,0,1,0.5} \begin_layout Standard \begin_inset ERT -status open +status collapsed \begin_layout Standard @@ -21865,7 +21868,7 @@ fboxsep 0.5cm \begin_inset ERT -status open +status collapsed \begin_layout Standard @@ -22229,7 +22232,7 @@ roman{footnote}} \begin_layout Standard \begin_inset ERT -status open +status collapsed \begin_layout Standard @@ -22439,7 +22442,7 @@ Esto es otro ejemplo de nota al pie: \series bold \begin_inset Foot -status collapsed +status open \begin_layout Standard Nota al pie numerada en el esquema @@ -22465,7 +22468,11 @@ status collapsed \backslash -numberwithin{footnote}{part} +renewcommand{ +\backslash +thefootnote}{ +\backslash +arabic{footnote}} \end_layout \end_inset @@ -27660,6 +27667,12 @@ Personalización \begin_layout Section Documento Hijo +\begin_inset LatexCommand label +name "sec:Documento-Hijo" + +\end_inset + + \begin_inset LatexCommand index name "Documento Hijo" @@ -28005,9 +28018,22 @@ Nota: \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 @@ -28021,233 +28047,866 @@ Nota: \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 - - - - - - -\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 - - -\begin_inset Text -\begin_layout Standard -nombre/descripción -\end_layout -\end_inset - - - - -\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 - - -\begin_inset Text -\begin_layout Standard -milímetro -\end_layout +\family sans +p +\family default + +\begin_inset Quotes erd \end_inset - - - - -\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 - - -\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 - - - - -\begin_inset Text -\begin_layout Standard -in -\end_layout +\family sans +htbp +\family default + +\begin_inset Quotes erd \end_inset - - -\begin_inset Text -\begin_layout Standard -pulgada -\end_layout +. + The option +\begin_inset Quotes eld +\end_inset +h +\begin_inset Quotes erd \end_inset - - - - -\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 - - -\begin_inset Text - \begin_layout Standard -punto (72.27\InsetSpace \thinspace{} -pt = 1\InsetSpace \thinspace{} -in) -\end_layout -\end_inset - - - - -\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 + + + + + + +\begin_inset Text + +\begin_layout Standard +unidad +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +nombre/descripción +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +mm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +milímetro +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +cm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +centímetro +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +in +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +pulgada +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +pt +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +punto (72.27\InsetSpace \thinspace{} +pt = 1\InsetSpace \thinspace{} +in) +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +pc +\end_layout \end_inset @@ -29615,6 +30274,50 @@ name "LaTeX-paquetes ! koma-script" (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" -- 2.39.2