The conversion to HTML creates proper XHTML.

[xmldoc.git] / doc / guide.xml

diff --git a/doc/guide.xml b/doc/guide.xml
index f314395..60fa01d 100644 (file)
--- a/doc/guide.xml
+++ b/doc/guide.xml
@@ -1,12 +1,13 @@
 <?xml version="1.0"?>
 <!DOCTYPE doc SYSTEM "../doc.dtd">
 <?xml-stylesheet type="text/xsl" href="../html.xsl"?>
-<doc style="main.css">
+<doc style="main.css"
+     xmlns:xi="http://www.w3.org/2001/XInclude">
 
 <!--
       XML documentation system
       Original author :  Arjen Baart - arjen@andromeda.nl
-      Version         : $Revision: 1.2 $
+      Version         : $Revision: 1.3 $
 
       This document is prepared for XMLDoc. Transform to HTML,
       LaTeX, Postscript or plain text with XMLDoc utilities and
@@ -19,9 +20,9 @@
    <subtitle>Document preparation and conversion in XML</subtitle>
 
    <author>Arjen Baart <code>&lt;arjen@andromeda.nl&gt;</code></author>
-   <date>Aug 18, 2003</date>
+   <date>Oct 17, 2007</date>
    <docinfo>
-      <infoitem label="Version">0.5</infoitem>
+      <infoitem label="Version">0.6</infoitem>
       <infoitem label="Organization">Andromeda Technology &amp; Automation</infoitem>
    </docinfo>
    <abstract>
@@ -34,13 +35,13 @@
 
 <toc/>
 
-<include href="intro.xml"/>
+<xi:include href="intro.xml"/>
 
-<include href="overall.xml"/>
+<xi:include href="overall.xml"/>
 
-<include href="block.xml"/>
+<xi:include href="block.xml"/>
 
-<include href="inline.xml"/>
+<xi:include href="inline.xml"/>
 
 <chapter>
 <heading>References</heading>
@@ -51,6 +52,8 @@ adheres to the <emph>XLink</emph> syntax.
 We need to add one more attribute to the usual <strong>href</strong>
 attribute.
 For example:
+</para>
+
 <verbatim>
 &lt;reference xml:link="simple"
     href="http://www.andromeda.nl/project/xmldoc/xmldoc.html"&gt;
@@ -58,6 +61,8 @@ The XMLDoc website
 &lt;/reference&gt;
 provide the installation instructions.
 </verbatim>
+
+<para>
 <reference xml:link="simple"
     href="http://www.andromeda.nl/projects/xmldoc/xmldoc.html">
 The XMLDoc website
@@ -77,11 +82,13 @@ the <code>name</code> of the label.
 Each <code>label</code> must have a <code>name</code> that is unique
 throughout the document.
 Here is an example of a label:
+</para>
 
 <verbatim>
    &lt;label name='example'/&gt;
 </verbatim>
 
+<para>
 You can refer to a label from any other place in the document by using a
 <code>ref</code> or a <code>page</code> element.
 The <code>page</code> element creates a reference to the page number on which
@@ -89,10 +96,13 @@ the <code>label</code> is printed.
 This is of course only usefull on printed media, such as LaTeX.
 The <code>ref</code> and <code>page</code> elements also require one
 attribute:
+</para>
 
 <verbatim>
    &lt;ref to='example'&gt;example reference&lt;/ref&gt;
 </verbatim>
+
+<para>
 The required attribute <code>to</code> holds the name of the
 label to which the reference refers.
 The <code>ref</code> element is usually not empty.
@@ -104,15 +114,66 @@ The content of the <code>page</code> element is only renedered in LaTeX output.
 </para>
 </chapter>
 
-<include href="multifiles.xml"/>
+<xi:include href="multifiles.xml"/>
+
+<xi:include href="glossary.xml"/>
 
-<include href="glossary.xml"/>
+<chapter>
+
+<heading>Other XML applications</heading>
+<section>
+<heading>MathML</heading>
+</section>
+<math>
+  <mrow>
+    <msup>
+      <mfenced open="[" close="]">
+        <mrow>
+          <mi>&theta;</mi>
+          <mo>+</mo>
+
+          <mi>b</mi>
+        </mrow>
+      </mfenced>
+      <mn>260</mn>
+    </msup>
+    <mo>+</mo>
+    <msub>
+
+      <mfenced open="{" close="}">
+        <mrow>
+          <mi>a</mi>
+          <mo>+</mo>
+          <mi>b</mi>
+        </mrow>
+      </mfenced>
+
+      <mi>i</mi>
+    </msub>
+  </mrow>
+</math>
+<section>
+<heading>SVG</heading>
+
+<svg>
+   <clipPath id="a">
+      <circle cy="90" cx="100" r="60"/>
+   </clipPath>
+   <circle fill="#AAAAAA" cy="90" cx="190"
+              r="60" style="clip-path:url(#a)"/>
+   <circle stroke="black" fill="none" cy="90" cx="100" r="60"/>
+   <circle stroke="black" fill="none" cy="90" cx="190" r="60"/>
+</svg>
+
+
+</section>
+</chapter>
 
 <chapter>
 
 <heading>Things to do</heading>
 <itemize>
-<item>Math</item>
+<item>MathML and SVG conversion to LaTeX</item>
 <item>XML Schema definition and validation</item>
 <item>Font sizes</item>
 <item>Center environment</item>