Nun gibts von mir mal wieder ein kleines Freeware Tool, welches ich heute geschrieben habe um die XML Struktur einer Konfigurationsdatei für andere zu dokumentieren.
Wie funktioniert das ganze? Man nehme eine normale XML Datei, welche keine Werte enthalten muss, und füge ein paar sinnvolle Kommentare hinzu. Das ganze jagt man dann durch XML2Doc und fertig ist die HTML Dokumentation.
Hier ein Beispiel für eine solche XML (liegt auch dem Download bei):
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20:
21:
22:
23:
24:
25:
26:
27:
28:
29:
30:
31:
| <?xml version="1.0" encoding="UTF-8" ?>
<!--
@title XML2Doc Beispieldatei
@author Andreas "Pr0g" Droesch
@version 1.0.0
@comment Dieses Beispiel soll die Nutzung der XML2Doc Syntax erläutern. Die Tagnamen in XML Baum lassen sich anklicken.
@desc Rootnode
-->
<root>
<!-- @desc Diese Sektion enthält einige Unterelemente. -->
<first_section>
<!--
@desc Name eines Users
@value STRING Username
-->
<name />
<!--
@desc Status ob der User aktiv ist
@attr active BOOL 0 -> gesperrt | 1 -> aktiv
-->
<userstatus />
</first_section>
<!--
@desc Dieser Tag hat mehrere Attribute und einen Wert.
@value STRING Ein Text
@attr name STRING Username
@attr alter INT Alter des Users
-->
<second_section />
</root> |
und hier das Ergebnis:
Klick mich!
In der
readme.txt (liegt auch dem Download bei) ist erklärt wie die recht simpel gehaltene Syntax funktioniert.
Noch ein Screenshot des Tools:
Klick mich!
Und zu guter letzt der Download:
[url=
pr0g.net/klickcounter.php?id=77]
[/url]
