Sourcecode-Dokumenation

Die Dokumentation unserer Klassen und Funktionen soll mit Hilfe von Doxygen erfolgen. Dieses Programm kann mit Hilfe von Schlüsselwörtern innerhalb des Kommentarbereichs des Sourcecodes eine übersichtliche HTML-Dokumentation erstellen. Diese Seite soll nun die wichtigsten Schlüsselwörter und Formatierungen von Doxygen beschreiben, die wir für Admidio benötigen. Auf der Doxygen-Seite selber findest du auch eine Anleitung zur Anpassung der Dokumentation, sowie eine Übersicht über alle Schlüsselwörter.

Falls du selber formatierte Dokumentation hinzugefügt hast und das Ergebnis in der HTML-Ansicht sehen willst, musst du diese mit Doxygen erstellen. Dazu lädst du die aktuelle Version von Doxygen herunter und installierst das Programm. Nun solltest du noch unsere Konfigurationsdatei von Doxygen herunterladen. Du findest die Datei Admidio_Config_File im SVN unter:

https://admidio.svn.sourceforge.net/svnroot/admidio/trunk/documentation/doxygen

Starte Doxygen und wähle unter File > Open diese Datei aus. Es werden nun “unsere” Einstllungen für Doxygen gesetzt. Du musst nur noch die beiden Pfade auf dem Karteireiter Wizard und der Rubrik Project prüfen und an dein System anpassen und kannst dann unter Run die Doxygen-Dokumentation erstellen.