== 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). <<BR>>
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, <<BR>>
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, <<BR>>
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.

Related pages:

 * [[http://www.usemod.org/cgi-bin/mb.pl?WikiXmlDtd|WikiXmlDtd]]
 * WikiDomFormatter


-- UweFechner <<DateTime(2004-10-10T11:29:31Z)>>