Christian: Dokumentationen verfassen

Beitrag lesen

Hi,

Ich kann dir nur XML ans Herz legen - Du überlegst Dir einmal alle notwendigen Elemente der Doku und kannst dann alles mögliche damit anstellen (in HTML konvertieren, als Text ausgeben, und, und, und). Und wenn Du dir die Anforderungen gut überlegt hast, ändert sich die Datei so gut wie nicht mehr - Erweiterungen natürlich jederzeit möglich.

kannst du das näher erläutern??

also ich stelle mir dein konzept etwa so vor:

<thema>
<title>Wie erstelle ich eine Doku</title>
<beschreibung>viel text</beschreibung>
<beispiel>beispiel</beispiel>
<erlaeuterung>text<erlaeuterung>
<sieheauch>verweis auf links</sieheauch>
<beachtensie>bemerkungen</beachtensie>
</thema>

wie lese ich das dann aus?? Alle <beispiel>e sollen z.B. einem bestimmten Format entsprechen. eingerückt und besondere Schrift.

wie mach ich das dann?

letzt endlich soll dann html rauskommen.

wie ist es wenn ich innerhalb von xml-tags html verwenden will:

<beachtensie>bemerkungen</beachtensie>

bemerkungen soll z.B. einige kleine Formatierungen oder Verweise haben. iSt das auch möglich?

Meine ganzen Dokus möchte ich auf eine ähnlich einfache Weise so ablegen können (bisher hatte ich die mit ner Datenbank). Aber du kannst mich gerne auch von den Vorteilen von XML überzeugen. Dann will ich mir ein kleinen Programm schreiben, das die ganzen XML-Dateien abgrast und daraus HTML generiert. Und alles schön verlinkt.
Programmiersprache???

Ich selbst erstelle so zB Webseiten, die Aufgrund der vorgegebenen, eingeschränkten Möglichkeiten kein PHP o.ä. zulassen - so kann ich einerseits auf programmiertechnische Grundlagen zurückgreifen (Schleifen, Abfragen, Includes,...) und trotzdem statische Seiten erzeugen.

Das geht doch mit XSL oder ?? xsl:blabla...</xsl:blabla> oder so ähnlich

Wenn Du eine Demo sehen willst, musst Du nochmal posten - ich lade mein aktuelles Projekt dann kurz ins Netz.

gerne

Gruß
Christian