The conversion to HTML creates proper XHTML.
[xmldoc.git] / doc / inline.xml
index 304846a..10cd5f9 100644 (file)
@@ -5,13 +5,14 @@
 <!--
       XML documentation system
       Original author :  Arjen Baart - arjen@andromeda.nl
-      Version         : $Revision: 1.2 $
+      Version         : $Revision: 1.3 $
 -->
 
 <chapter>
 <heading><label name='inline'/>Type styles and special characters</heading>
 <para>
 There are six type styles:
+</para>
 <enumerate>
    <item><code>emph</code> : <emph>Emphasized text</emph></item>
    <item><code>strong</code> : <strong>Usually bold face</strong></item>
@@ -20,7 +21,60 @@ There are six type styles:
    <item><code>sub</code> : For <sub>subscript</sub> text.</item>
    <item><code>sup</code> : For <sup>superscript</sup> text.</item>
 </enumerate>
+
+<section>
+<heading><label name='color'/>Color and size</heading>
+<para>
+Normally, if not redefined by additional style sheets, the text is
+printed in black on a white background.
+You can create text in other colors with the <strong>color</strong> element.
+Which color the output text should become is specified in the
+<strong>colorname</strong> attribute, for example:
+</para>
+
+<verbatim>
+  &lt;color colorname='red'&gt;Red text&lt;/color&gt;
+</verbatim>
+
+<para>
+It is not possible to create any color; there are just a few predefined
+colors available:
+<color colorname='red'>red</color>,
+<color colorname='green'>green</color>,
+<color colorname='blue'>blue</color>,
+<color colorname='cyan'>cyan</color>,
+<color colorname='magenta'>magenta</color>,
+<color colorname='yellow'>yellow</color>,
+<color colorname='orange'>orange</color>,
+<color colorname='violet'>violet</color>,
+<color colorname='purple'>purple</color>,
+<color colorname='brown'>brown</color>,
+<color colorname='pink'>pink</color>,
+<color colorname='olive'>olive</color>,
+<color colorname='black'>black</color>,
+<color colorname='darkgray'>darkgray</color>,
+<color colorname='gray'>gray</color>,
+<color colorname='lightgray'>lightgray</color> and
+<color colorname='white'>white</color>.
+The last, color (white) is probably invisible :-).
+</para>
+
+<para>
+NOTE: To make colored text work with LaTeX, you probably need to install
+the <emph>latex-xcolor</emph> package.
+</para>
+<para>
+Apart from the normal font size, there are two other sizes available:
+<strong>big</strong>and <strong>small</strong>.
+These element will make the text slightly bigger or smaller, like this:
 </para>
+<verbatim>
+Here is &lt;small&gt;some small text&lt;/small&gt; and &lt;big&gt;a big phrase&lt;/big&gt;.
+</verbatim>
+<para>
+Here is <small>some small text</small> and <big>a big phrase</big>.
+</para>
+</section>
 
 <section>
 <heading><label name='break'/>Line and page breaking</heading>
@@ -48,11 +102,13 @@ The content of its <code>command</code> attribute is copied literally
 into the output.
 One of the applications of the <code>LaTeX</code> escape element is to
 control the first line indent of a paragraph in LaTeX:
+</para>
 
 <verbatim>
 &lt;LaTeX command='\setlength{\parindent}{0cm}'/&gt;
 </verbatim>
 
+<para>
 Note that it is not possible to create HTML tags in this manner.
 </para>