Creating Doocbook Documents from the Moin wiki

This page notes some experiences trying to create a formal document using the Moin wiki Docbook export capability.

Contents:

1. Docbook export from Moin

This bit is easy. Onder "More actions:" select "Render as Docbook". This is provided with Moin version 1.5.3.

The XML exported is pretty straightforward, but does not contain any DTD of namespace declarations thatb allow the XML output to be definitively identified as Docbook format.

The output does not seem to include a table of contents for the exported page, even when the actual wiki page has such a table. The output is preented as a single <section>, without further wrapping.

2. About Docbook

Docbook is an OASIS-specified XML language for describing formal documents, books, articles, etc. A kind of nroff or LATeX for the XML world. See:

There's a useful page about Docbook authoring tools here:

and other Docbook tools:

3. Using the Moin wiki docbook output

I tried a couple of utilities downloaded from the Web:

4. Sample template for document with Table of Contents

This is just a starting point - not complete or optimal, but it does seem to be a valid Docbook structure.

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
                         "http://www.docbook.org/xml/4.4/docbookx.dtd">
<book>
  <article>
    <title>A title</title>
    <subtitle>A subtitle</subtitle>
    <articleinfo>
      <title>Article info</title>
    </articleinfo>
    <para>
      <emphasis>Introductory material</emphasis>
    </para>

    <section>
      <title>Section title</title>
      <para>Body content</para>
    </section>

    <Section>
      :
    </Section>

    <toc/>
  </article>
</book>

5. References


-- GrahamKlyne 2006-10-25 12:41:51

Creative Commons License
The content of this wiki is licensed under the Creative Commons Attribution-ShareAlike 2.0 England & Wales Licence.

OSS Watch is funded by the Joint Information Systems Committee (JISC) and is situated within the Research Technologies Service (RTS) of the University of Oxford.