Seite 1 von 1

EPYdoc Beispiel läuft nicht

Verfasst: Donnerstag 10. Juli 2008, 11:11
von Secki
Hallo zusammen,

ich wollte mein Programm mit Epydoc dokumentieren. Dazu hab ich mir das Beispiel von http://epydoc.sourceforge.net/configfile.html geholt und auf meine Bedürfnisse eingestellt. Allerdings weiß ich nicht, wie ich aus diesm Beispiel jetzt die Dokumentation generieren lassen kann. Wenn ich es als Skript ausführe, bekomme ich schon in der 2. Zeile bei modules: einen Fehler. Er erkennt hier den Doppelpunkt als Fehler??
Kann mir da jemand helfen?
Danke im Vorraus

Grüße

Verfasst: Donnerstag 10. Juli 2008, 11:44
von Zap
Was du da hast ist ein Configfile und du must dies an Epidoc übergeben
In diesem Configfile ist halt festgelegt welche Sourcen Analysiert werden soll.

Code: Alles auswählen

python c:\python25\Scripts\epydoc.py --conf=epydoc_export.cfg

Verfasst: Donnerstag 10. Juli 2008, 11:56
von Secki
Danke, das hilft mir schonmal weiter, ich versteh nur noch nicht so ganz dein Beispiel. Wie und wo übergebe ich denn das Configfile?

Verfasst: Donnerstag 10. Juli 2008, 12:12
von Zap
Mh... :?

Also:

erstelle eine kleine Datei namens "test.cfg" mit folgendem Inhalt:

Code: Alles auswählen

[epydoc]
name: OS API
modules: os
target: os_apidocs
Nun startest du das epydoc.py Skript (das sich unter MeinPython/Scripts befindet). Diesem übergibst du beim Start den Parameter --config=test.cfg

Beispiel bei mir:

Code: Alles auswählen

C:\>python c:\Python25\Scripts\epydoc.py --conf=test.cfg
Als Ergebnis solltest du nun einen Ordner "os_apidocs" vorfinden in dem die API des OS Modules dokumentiert ist.

Verfasst: Donnerstag 10. Juli 2008, 13:03
von Secki
Alles klar, jetzt funktionierts einwandfrei! Danke für die schnelle Hilfe.
Bin schon ein Kind der Windowsgeneration, deshalb hab ich beim Aufruf einer Datei + Übergeben einer Datei nicht an DOS gedacht. Eine frage bleibt aber: Wieso die Umwandlung in ein cfg file? Würd das auch noch anders funktionieren? :?: