<?xml version="1.0" encoding="iso-8859-1"?>
<appendix id="appendix_docbook">
  <title>Using DocBook XML for documentation</title>
  
  <section id='appendix_docbook_intro'> 
    <title>Introduction</title> 
    
    <para>DocBook XML is a XML application, and is derived from SGML
      DocBook. It can be used to generate HTML, plain text, PDF and even
      more formats of output from a single source.
    </para>
    
    <para>We use DocBook XML to write the complete documentation for
      moregroupware, so if you want to help, you should just go ahead and
      have a look at the XML files in the <filename>docs/docbook/</filename>
      directory of the moregroupware distribution. The central place for
      more information is <ulink
      url="http://www.docbook.org/">http://www.docbook.org/
    </ulink>
    .
  </para>
  
</section>

<section id='appendix_docbook_compile'> 
  <title>Compiling XML to HTML, PDF, ...</title> 
  
  <para>The XML source can be transformed using various tools. For the
    time being the "official" way is to use the
    <command>convert.sh</command> script. It uses
    <command>xsltproc</command> for the hard work, along with
    <filename>mgw-manual.xsl</filename> that sets some variables that
    influence the resulting HTML.
  </para>
  
  <para>So to compile the sources, just do this:<programlisting>
      cd docs/
      convert.sh
    </programlisting>
    to generate HTML output in the HTML directory under
    <filename>docs/</filename>.
  </para>
  
</section>
</appendix>
