patrick@0: patrick@0:
patrick@0: Noteworthy elements patrick@0: patrick@0: In DocBook 5 (see DocBook 5.0: The Definitive patrick@0: Guide), two elements with the same name having patrick@0: the same parent element may have different patrick@0: content models. This is the case for indexterm and imagedata. patrick@0: patrick@0: Other elements are less exotic because their content models are patrick@0: contextual, that is, they depend on their parent elements. patrick@0: patrick@0: Example 1: this paragraph contains the usual, full-fledged, patrick@0: emphasis child element (called patrick@0: "emphasis (db.emphasis)" in DocBook 5.0: The Definitive patrick@0: Guide). patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Please click inside word patrick@0: "emphasis" in the above example and use patrick@0: Help patrick@0: patrick@0: Show Content Model patrick@0: ( patrick@0: Shift patrick@0: patrick@0: F1 patrick@0: ) to display the content model of the full-fledged emphasis element. patrick@0: patrick@0: Example 2: patrick@0: this inlineequation contains a mathphrase which contains patrick@0: a limited emphasis child element patrick@0: (called "emphasis (db._emphasis)" in patrick@0: DocBook 5.0: The Definitive patrick@0: Guide). patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Please click inside word patrick@0: "emphasis" in the above example and use patrick@0: Help patrick@0: patrick@0: Show Content Model patrick@0: ( patrick@0: Shift patrick@0: patrick@0: F1 patrick@0: ) to display the content model of the limited emphasis element. patrick@0: patrick@0:
patrick@0: Element <tag class="element">indexterm</tag> patrick@0: patrick@0: DocBook 5 has three kinds of indexterm patrick@0: elements: patrick@0: patrick@0: patrick@0: patrick@0: indexterm(singular) patrick@0: patrick@0: patrick@0: (Called "indexterm (db.indexterm.singular)" patrick@0: in DocBook 5.0: The patrick@0: Definitive Guide.) A wrapper for an indexed term. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: indexterm(startofrange) patrick@0: patrick@0: patrick@0: (Called patrick@0: "indexterm (db.indexterm.startofrange)" in DocBook 5.0: The patrick@0: Definitive Guide.) A wrapper for an indexed term that covers patrick@0: a range. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: indexterm(endofrange) patrick@0: patrick@0: patrick@0: (Called patrick@0: "indexterm (db.indexterm.endofrange)" in DocBook 5.0: The patrick@0: Definitive Guide.) Identifies the end of a range associated patrick@0: with an indexed term. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Example 1 (indexterm(singular)): The Tiger patrick@0: patrick@0: Big Cats patrick@0: patrick@0: Tigers patrick@0: is a very large cat indeed. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Please click on the above indexterm element, use patrick@0: Edit patrick@0: patrick@0: Replace patrick@0: ( patrick@0: Ctrl patrick@0: patrick@0: R patrick@0: ), then type "in" (autocompletion) to see patrick@0: what is suggested in the element list of the Edit patrick@0: tool. patrick@0: patrick@0: Example 2 (indexterm(singular)): patrick@0: Network Configuration patrick@0: patrick@0: patrick@0:
patrick@0: patrick@0: Configuring Your Network patrick@0: patrick@0: Everything you need to know about configuring your patrick@0: network. patrick@0: patrick@0:
patrick@0: patrick@0: Example 3 patrick@0: (indexterm(startofrange)/indexterm(endofrange) patrick@0: pair): patrick@0: Example formalpara patrick@0: patrick@0: patrick@0:
patrick@0: patrick@0: Example formalpara patrick@0: patrick@0: Some content. patrick@0: patrick@0:
patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Please click on any of the above indexterm elements and then use patrick@0: Help patrick@0: patrick@0: Show Content Model patrick@0: ( patrick@0: Shift patrick@0: patrick@0: F1 patrick@0: ) to display their content models. patrick@0:
patrick@0: patrick@0:
patrick@0: Element <tag class="element">imagedata</tag> patrick@0: patrick@0: DocBook 5 has three kinds of imagedata patrick@0: elements: patrick@0: patrick@0: patrick@0: patrick@0: imagedata(fileref) patrick@0: patrick@0: patrick@0: (Called "imagedata (db.imagedata)" in DocBook 5.0: The patrick@0: Definitive Guide.) Pointer to external image data. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: imagedata(svg) patrick@0: patrick@0: patrick@0: (Called "imagedata (db.imagedata.svg)" in patrick@0: DocBook 5.0: The patrick@0: Definitive Guide.) An SVG drawing in a media object. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: imagedata(mathml) patrick@0: patrick@0: patrick@0: (Called "imagedata (db.imagedata.mathml)" patrick@0: in DocBook 5.0: The patrick@0: Definitive Guide.) A MathML expression in a media patrick@0: object. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Examples: patrick@0: patrick@0:
patrick@0: ``Normal'' <tag class="element">imagedata</tag> (this <tag patrick@0: class="element">imagedata</tag> element has no attributes other than patrick@0: <tag class="attribute">fileref</tag>) patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: Please click on the above image and use patrick@0: patrick@0: Edit patrick@0: patrick@0: Replace patrick@0: ( patrick@0: Ctrl patrick@0: patrick@0: R patrick@0: ) to see what is suggested in the element list of the patrick@0: Edit tool. patrick@0:
patrick@0: patrick@0:
patrick@0: SVG <tag class="element">imagedata</tag> (the attributes of this patrick@0: <tag class="element">imagedata</tag> element are: <tag patrick@0: class="attribute">align</tag>=<tag class="attvalue">right</tag>, <tag patrick@0: class="attribute">depth</tag>=<tag class="attvalue">10cm</tag>, <tag patrick@0: class="attribute">scale</tag>=<tag class="attvalue">25</tag>, <tag patrick@0: class="attribute">valign</tag>=<tag class="attvalue">top</tag>, <tag patrick@0: class="attribute">width</tag>=<tag class="attvalue">10cm</tag>). patrick@0: Requires installing the Batik image toolkit plug-in<footnote> patrick@0: <para>Please use <menuchoice> patrick@0: <guimenu>Options</guimenu> patrick@0: patrick@0: <guimenuitem>Install Add-ons</guimenuitem> patrick@0: </menuchoice> to download and install the add-on called "Apache patrick@0: Batik image toolkit plug-in".</para> patrick@0: </footnote>. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0:
patrick@0: patrick@0:
patrick@0: MathML <tag class="element">imagedata</tag>. Requires installing patrick@0: the JEuclid image toolkit plug-in and/or the MathML add-on<footnote> patrick@0: <para>Please use <menuchoice> patrick@0: <guimenu>Options</guimenu> patrick@0: patrick@0: <guimenuitem>Install Add-ons</guimenuitem> patrick@0: </menuchoice> to download and install the add-on called "JEuclid patrick@0: image toolkit plug-in" and/or the add-on called "MathML patrick@0: support".</para> patrick@0: </footnote>. patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: x patrick@0: patrick@0: = patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: - patrick@0: patrick@0: b patrick@0: patrick@0: patrick@0: ± patrick@0: patrick@0: patrick@0: patrick@0: b patrick@0: patrick@0: 2 patrick@0: patrick@0: patrick@0: - patrick@0: patrick@0: patrick@0: 4 patrick@0: patrick@0: ⁢ patrick@0: patrick@0: a patrick@0: patrick@0: ⁢ patrick@0: patrick@0: c patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: 2 patrick@0: patrick@0: ⁢ patrick@0: patrick@0: a patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0:
patrick@0: patrick@0: Examples of inline images: ``normal'' inlinemediaobject patrick@0: patrick@0: patrick@0: patrick@0: (the attributes of the imagedata child element of this inlinemediaobject are: scale=50), SVG inlinemediaobject patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: (the attributes of the imagedata child element of this inlinemediaobject are: scale=10), MathML inlinemediaobject patrick@0: patrick@0: patrick@0: patrick@0: x patrick@0: patrick@0: = patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: - patrick@0: patrick@0: b patrick@0: patrick@0: patrick@0: ± patrick@0: patrick@0: patrick@0: patrick@0: b patrick@0: patrick@0: 2 patrick@0: patrick@0: patrick@0: - patrick@0: patrick@0: patrick@0: 4 patrick@0: patrick@0: ⁢ patrick@0: patrick@0: a patrick@0: patrick@0: ⁢ patrick@0: patrick@0: c patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: 2 patrick@0: patrick@0: ⁢ patrick@0: patrick@0: a patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: patrick@0: . patrick@0:
patrick@0: