[LyX/master] Add documentation for the new layout attributes.

Pavel Sanda sanda at lyx.org
Wed Jul 8 07:17:12 UTC 2020


commit 7989ebca85ddf95d58dfb86e234a17e5470d62c2
Author: Thibaut Cuvelier <cuvelier.thibaut at gmail.com>
Date:   Fri May 10 02:54:44 2019 +0200

    Add documentation for the new layout attributes.
---
 lib/doc/Customization.lyx | 1870 ++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 1865 insertions(+), 5 deletions(-)

diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx
index 0a90aae..abc4f7f 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 at 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
@@ -9637,6 +9655,143 @@ Standard
 \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
+<abstract>
+\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
+<tag attr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+Contents of the paragraph.
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+</tag>
+\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
+<tag attr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+<itemtag>First paragraph.</itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+<itemtag>Second paragraph.</itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+</tag>
+\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
+<tag attr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+<itemtag attr>First item.</itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+<itemtag attr>Second item.</itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+</tag>
+\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
+<wrappertag wrapperattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+  <tag attr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+    <innertag innerattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      Contents of the inset.
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+    </innertag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+  </tag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+</wrappertag>
+\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
+<wrappertag wrapperattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+  <tag attr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+    <innertag innerattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      <itemwrappertag itemwrapperattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        <itemlabeltag itemattr>
+\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
+        </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        <itemtag itemattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+          <itemtag itemattr>
+\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
+          </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      </itemwrappertag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      <itemwrappertag itemwrapperattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        <itemlabeltag itemattr>
+\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
+        </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        <itemtag itemattr>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+          <itemtag itemattr>
+\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
+          </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+        </itemtag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      </itemwrappertag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+      ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+    </innertag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+  </tag>
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -547414922 1557448766
+</wrappertag>
+\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
+<info>
+\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
+<info>
+\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
+<info>
+\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
+<info>
+\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
+<info>
+\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
+<info>
+\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
+<tag attr>
+\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
+</tag>
+\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


More information about the lyx-cvs mailing list