WikiXml

(2006-02015: for an updated diskussion see also XmlWiki)

As many people have said, it would be nice to have an xml representation of wiki pages and wiki sites.

There is a new (incomplete) wiki2xml converter as part of wiki2pdf.py (see: PdfReport).
It produces xml like this:

<?xml version="1.0" encoding="iso8859-1"?>
<wikireport name="WikiSchulung">
    <!-- Demo file, same as the generated Wikischulung.xml, but
    with better pretty printing (indentation) -->
    <page name="WikiSchulung">
        <h2>Wikischulung I am 12.11.2003</h2>
        <h3>Anwesend:</h3>
        <p>VZ, IM, UK, NA, VB, RS</p>
        <h3>Schulungsinhalt:</h3>
        <ul>
            <li>Anwendung des BergWiki für die Dokumentation des BlauerBerg Systems</li>
            <li>speziell:</li>
            <ul>
                <li>Anmeldung</li>
                <li>wo bekomme ich Hilfe</li>
                <ul>
                    <li>hier vielleicht?</li>
                    <li>oder eher da?</li>
                </ul>
                <li>Erstellen neuer Seiten</li>
                <li>Überschriften</li>
                <li>Inhaltsverzeichnis</li>
                <li>Aufzählungen</li>
                <li>Web-Links</li>
                <li>Einfügen von Dokumenten als attachments</li>
            </ul>
        </ul>
        <p/>
        <h3>Hausaufgabe:</h3>
        <p>Jede/r möge für seinen Bereich (Wiesen, Felder etc.) eine Gliederung anlegen und mit Beispieldaten füttern.</p>
        <h3>Nächster Termin:</h3>
        <p>in ca. 2 Wochen</p>
        <p>-- UweFechner [[DateTime(2004-04-08T09:35:59Z)]]</p>
    </page>
</wikireport>

I think, that it is important to define an "official" dtd (document type definition) for the xml represetation of wiki pages and wiki sites.

Here is a very simple first suggestion:

<!ELEMENT h1 (#PCDATA)>
<!ELEMENT h2 (#PCDATA)>
<!ELEMENT h3 (#PCDATA)>
<!ELEMENT h4 (#PCDATA)>
<!ELEMENT h5 (#PCDATA)>
<!ELEMENT ul (#PCDATA | li | ul)*>
<!ELEMENT wikireport (#PCDATA | page)*>
<!ATTLIST wikireport name CDATA #IMPLIED>
<!ELEMENT page (#PCDATA | h1 | h2 | h3 | h4 | h5 | p | ul)*>
<!ATTLIST page name CDATA #IMPLIED>
<!ELEMENT li (#PCDATA)>
<!ELEMENT p (#PCDATA)>

The basic idea is, to use the needed parts of the xhtml dtd and add attributes and elements,
that are needed to keep specific wiki information.

I think we should have a dtd, that allows it, to put any number of wikipages into one xml document,
and not just one.

2006-7-14

We could use gentoo lightweight syntax.

http://www.gentoo.org/doc/en/xml-guide.xml http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml

The gentoo DTD and wikixml DTD should merge and agree. When this happens there will be no limit of what we can do with online documentation.

-- UweFechner 2004-10-10 11:29:31

MoinMoin: WikiXml

WikiXml