From 7989ebca85ddf95d58dfb86e234a17e5470d62c2 Mon Sep 17 00:00:00 2001 From: Thibaut Cuvelier Date: Fri, 10 May 2019 02:54:44 +0200 Subject: [PATCH] Add documentation for the new layout attributes. --- lib/doc/Customization.lyx | 1870 ++++++++++++++++++++++++++++++++++++- 1 file changed, 1865 insertions(+), 5 deletions(-) diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx index 0a90aaefb5..abc4f7f136 100644 --- a/lib/doc/Customization.lyx +++ b/lib/doc/Customization.lyx @@ -1,5 +1,5 @@ #LyX 2.4 created this file. For more info see https://www.lyx.org/ -\lyxformat 587 +\lyxformat 595 \begin_document \begin_header \save_transient_properties true @@ -133,7 +133,7 @@ logicalmkup \html_math_output 0 \html_css_as_file 0 \html_be_strict true -\author -712698321 "Jürgen Spitzmüller" +\author -547414922 "thibaut" \author -495245474 "Jean-Marc Lasgouttes" \author 731793113 "Richard Kimberly Heck" rikiheck@lyx.org \end_header @@ -624,7 +624,11 @@ status collapsed \end_inset - which define the diverse citation possibilities (natbib, biblatex etc.). + which define the diverse citation possibilities (natbib, biblatex +\change_inserted -547414922 1557448396 +, +\change_inserted -712698321 1483874001 + etc.). See \begin_inset CommandInset ref LatexCommand ref @@ -7078,8 +7082,12 @@ status collapsed Supporting a style file is usually fairly easy. Supporting a new class file is a bit harder. We'll discuss the former in this section and the latter in the next. + +\change_deleted -547414922 1557448430 Similar remarks apply, of course, if you want to support a new DocBook DTD. +\change_unchanged + \end_layout \begin_layout Standard @@ -8337,18 +8345,24 @@ foo.sty \end_inset package. - Finally, it is also possible to declare classes for DocBook code. + +\change_deleted -547414922 1557448415 +Finally, it is also possible to declare classes for DocBook code. Typical declarations will look like: \end_layout \begin_layout LyX-Code +\change_deleted -547414922 1557448415 + \size small #% Do not delete the line below; configure depends on this \end_layout \begin_layout LyX-Code +\change_deleted -547414922 1557448415 + \size small # \backslash @@ -8357,10 +8371,14 @@ DeclareDocBookClass[article]{SGML (DocBook Article)} \begin_layout LyX-Code +\change_deleted -547414922 1557448415 + \size small # \backslash DeclareCategory{Articles (DocBook)} +\change_unchanged + \end_layout \begin_layout Standard @@ -9636,6 +9654,143 @@ Standard encouraged to use this directive. \end_layout +\begin_layout Description + +\change_inserted -547414922 1557448445 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448445 +DocBookRoot +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448445 +string +\end_layout + +\end_inset + +] The root element (at the top of the document) to use when outputting documents + with this class in DocBook. + The default value is +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448445 +article +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448316 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448220 +DocBookForceAbstract +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448191 +boolean +\end_layout + +\end_inset + +] If +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448254 +true +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +, the root element will always have an +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448303 + +\end_layout + +\end_inset + + tag. + The default value is +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448318 +false +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. + +\change_unchanged + +\end_layout + \begin_layout Description \begin_inset Flex Code status collapsed @@ -11598,6 +11753,8 @@ $$s \end_layout \begin_layout Description + +\change_deleted -547414922 1557448472 \begin_inset Flex Code status collapsed @@ -18658,7 +18815,17 @@ name "subsec:Flex-insets-and" \end_layout \begin_layout Standard -Flex insets come in three different kinds: +Flex insets come in +\change_deleted -547414922 1557448731 +three +\change_inserted -547414922 1557448731 +two +\change_unchanged + different kinds: +\change_deleted -547414922 1557448728 + +\change_unchanged + \end_layout \begin_layout Itemize @@ -18725,9 +18892,13 @@ endnote \end_inset module. +\change_deleted -547414922 1557448736 + \end_layout \begin_layout Itemize + +\change_deleted -547414922 1557448736 XML elements ( \begin_inset Flex Code status collapsed @@ -18739,6 +18910,8 @@ Element \end_inset ): For use with DocBook classes. +\change_unchanged + \end_layout \begin_layout Standard @@ -26716,6 +26889,1693 @@ src/FontInfo.cpp \end_inset for the details. +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Section + +\change_inserted -547414922 1557448766 +\begin_inset CommandInset label +LatexCommand label +name "sec:Tags-for-DocBook" + +\end_inset + +Tags for DocBook output +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +As with \SpecialChar LaTeX + or XHTML, the format of \SpecialChar LyX +'s DocBook output is also controlled by + layout information. + In general, \SpecialChar LyX + provides sensible defaults; however, much of the styling is + lost during the conversion, as DocBook is strictly semantic and does not + allow formatting. + When possible, information from \SpecialChar LyX + will be rendered in +\family typewriter +role +\family default + attributes. + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +In many cases, then, you may not have to do anything at all to get acceptable + DocBook output for your own environments, custom insets, and so forth. + But in some cases you will, and so \SpecialChar LyX + provides a number of layout tags that + can be used to customize the DocBook that is generated. +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557449304 +Labels are rarely output (such as the number of a section), as they are + redundant in DocBook: this information is carried by the tags themselves, + and whether labels appear in the final documents (after processing of DocBook + files) is controlled by the stylesheets. + However, sometimes, labels are not redundant content, such as definition + lists: in this case, the term being defined will be the label. + +\end_layout + +\begin_layout Subsection + +\change_inserted -547414922 1557448766 +\begin_inset CommandInset label +LatexCommand label +name "subsec:Paragraph-Style-XHTML-1" + +\end_inset + +Paragraph styles +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The sort of DocBook \SpecialChar LyX + outputs for a paragraph depends upon whether we are + dealing with a normal paragraph, a command, or an environment, where this + is itself determined by the contents of the corresponding +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +\SpecialChar LaTeX +Type +\end_layout + +\end_inset + + tag. + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +For a command or normal paragraph, the output DocBook has the following + form: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 +Contents of the paragraph. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +For an environment that is not some sort of list, the generated DocBook + takes this form: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 +First paragraph. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 +Second paragraph. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +For a list, the resulting DocBook takes this form: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 +First item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 +Second item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The specific tags and roles output for each paragraph type can be controlled + by means of the layout tags we are about to describe. + Please note that, due to the very nature of DocBook, no sensible defaults + really exist, and the values must always be carefully chosen. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557449427 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the main tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +attr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the examples above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for this inset, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +tag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is the name of the float and always needs to be changed, as + DocBook provides no generic tag. +\end_layout + +\begin_layout Subsection + +\change_inserted -547414922 1557448766 +InsetLayout DocBook +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The DocBook output of insets can also be controlled by information in layout + files. +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The DocBook \SpecialChar LyX + outputs for an inset has the following form: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Contents of the inset. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +For an itemising inset, it rather looks like this: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Label of the first item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Contents of the first item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Label of the second item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Contents of the second item. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + ... +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557449488 +If the inset permits multiple paragraphs—that is, if +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +MultiPar +\end_layout + +\end_inset + + is set to true—then the contents of the inset will itself be output as + paragraphs formatted according to the styles used for those paragraphs + (standard, quote, and the like). + The inner tag is optional and, by default, does not appear. +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The specific tags and attributes output for each inset can be controlled + by means of the following layout tags. +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the main tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +attr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookInInfo +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +never, always, maybe +\end_layout + +\end_inset + +] Specifies whether this tag goes into the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + tag at the beginning of the parent layout. + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +never +\end_layout + +\end_inset + + indicates that the tag never goes into +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + (this is default value, and corresponds to usual content). + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +always +\end_layout + +\end_inset + + indicates that the tag always goes into +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + (this corresponds to usual metadata): if there is no +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + tag for the parent, one +\series bold +will +\series default + be generated. + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +maybe +\end_layout + +\end_inset + + indicates that the tag may go into +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + (this is only the case for titles): if there is no +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 + +\end_layout + +\end_inset + + tag for the parent, +\series bold +none +\series default + will be generated, the corresponding tag will be output directly as content. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the item tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemInnerAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the item inner tag, + replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +iteminnerattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemInnerTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the item inner tag within the inset, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +iteminnertag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +NONE +\end_layout + +\end_inset + +, indicating that there is no item inner tag: content is directly output + without it for each itemised element. + This parameter only makes sense when itemising layouts are used, such as + lists. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemLabelAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the item label tag, + replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemlabelattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemLabelTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the item label tag within the inset, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemlabeltag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This parameter only makes sense when itemising layouts are used with a + notion of labels, such as definition lists. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the item tag within the inset, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemtag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +NONE +\end_layout + +\end_inset + +, indicating that there is no item tag. + This parameter only makes sense when itemising layouts are used, such as + lists. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemWrapperAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the item wrapper tag, + replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemwrapperattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookItemWrapperTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the item wrapper tag within the inset, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +itemwrappertag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +NONE +\end_layout + +\end_inset + +, indicating that there is no item wrapper tag: tag and content are directly + output without it for each itemised element. + This parameter only makes sense when itemising layouts are used, such as + lists. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookInnerAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the inner tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +innerattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookInnerTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the inner tag within the inset, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +innertag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +NONE +\end_layout + +\end_inset + +, indicating that there is no inner tag: content is directly output without + it. +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookSectionTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies the tag that corresponds to this kind of section. + This parameter only makes sense for sectioning elements (part, chapter, + section, etc.). + The default value is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +section +\end_layout + +\end_inset + +, and is only overridden when DocBook uses something else for sectioning + (parts and chapters of a book). + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for this inset, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +tag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is the name of the float and always needs to be changed, as + DocBook provides no generic inset tag. +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookWrapperAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the outer tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +wrapperattr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookWrapperTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for the wrapper tag around the inset, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +wrappertag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +NONE +\end_layout + +\end_inset + +, indicating that there is no wrapper tag: tag and content are directly + output without it.Float DocBook +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The DocBook output for floats too can be controlled by layout information. + The output has the following form: +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + Contents of the float as DocBook. +\end_layout + +\begin_layout LyX-Code + +\change_inserted -547414922 1557448766 + +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The caption, if there is one, is a separate inset and will be output as + a title. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookAttr +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] Specifies attribute information to be output with the main tag, replacing + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +attr +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + This information can be used in further processing of the DocBook files. + +\end_layout + +\begin_layout Description + +\change_inserted -547414922 1557448766 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +DocBookTag +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +string +\end_layout + +\end_inset + +] The tag to be used for this float, replacing +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -547414922 1557448766 +tag +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + + in the example above. + The default is the name of the float and always needs to be changed, as + DocBook provides no generic float tag. +\end_layout + +\begin_layout Subsection + +\change_inserted -547414922 1557448766 +Bibliography formatting +\end_layout + +\begin_layout Standard + +\change_inserted -547414922 1557448766 +The bibliography cannot be formatted: all fields are always output in the + database-like DocBook format (equivalent to a BibTeX file). +\change_unchanged + \end_layout \begin_layout Chapter