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