Dokumentation in Python mit Grafiken

[Florian F.]

Hallo liebes Python Forum,

vorab, ich benutze momentan Epydoc zur Dokumentation, aber das ist leider nicht ausreichend genug. Um meinen Quelltext auf für nicht Entwickler zugängig zu machen suche ich nach einer möglichkeit Grafiken in die Dokumentation zu übernehmen, da dann einige Vorgänge leichter zu verstehen sind.

Gibt es in dieser Richtung eine Möglichkeit ?

Ich danke für Antworten

[lunar]

http://sphinx.pocoo.org/

Das wird auch für die Python-Dokumentation benutzt.

[Florian F.]

danke dir, aber könntest du mir eventuell auch sagen wie ich dort ein Bild in eine Dokumentation einbinden würde ?

[derdon]

Sphinx nutzt reStructuredText also werden Bilder so eingebunden wie in der reStructuredText-Referenz angegeben.

EDIT: in der Sphinx-Doku steht auch was dazu: http://sphinx.pocoo.org/rest.html#images

[Florian F.]

Ich habe es mal versucht, aber leider bis jetzt kein erfolg.
Hier mal mein Sample:

Code: Alles auswählen

__docformat__ = "restructuredtext de"

zaehl = 0
def zaehlr(anzahl):
  """Dokumentation start
  Diese Funktion dokumentiert , das Sie die Schleife
  solange durchlaeuft bis Anzahl erreicht wurde
  

    
  .. image::  sonnenuntergang.jpg
  """
  
  
  for i in range(anzahl):
    print anzahl


zaehlr(300)  

Was mache ich da falsch ?

[lunar]

In der Dokumentation von Sphinx steht, wie man Bilder einbindet, und welche Erweiterung Docstrings in die Dokumentation aufnimmt bzw. wie man diese konfiguriert. Wenn du dich an diese Dokumentation gehalten hast, und der Buildprozess fehlschlägt, dann solltest detaillierte Informationen über Fehlermeldung und Umgebung posten.

[Florian F.]

Nein, ich glaube ich hab mich vorhin total schlecht ausgedrückt ^^
Ich bin schon mit dem egg unter Python 2.6 bei der installation gescheitert.
ich weis nicht genau wie ich das einbinden muss und genauso wenig wie
ca. so ein buildbefehl aussieht. Könntest du mir eventuell da weiterhelfen... immer langsam bitte da ich das auf arbeit ausprobieren muss

Danke für dein Verständnis ^^

[nemomuk]

warum bist du gescheitert?
Was spricht gegen ein einfaches "easy_install sphinx"?

@lunar: wo ist denn dein easy_uninstall? kann es nicht mehr finden...

[lunar]

@SchneiderWeisse
http://files.lunaryorn.de/view/code/easy_uninstall.py

@Florian F.
"easy_install sphinx", danach das Sphinx-Intro und anschließend den Rest der Dokumentation lesen.

[nemomuk]

danke...
lässt sich irgendwie nicht mehr über die Suche auf deiner Seite finden...

[lunar]

danke...
lässt sich irgendwie nicht mehr über die Suche auf deiner Seite finden...

Die Suche erfasst auch nur den Teil, der mit Sphinx erstellt wurde, sprich alles unter www.lunaryorn.de. files.lunaryorn.de basiert zwar auf den Sphinx-Templates, die Suche zu erweitern ist allerdings ein bisschen komplexer als nur die Templates zu verwenden, und dazu hatte ich einfach keinen Bock Vor allem, weil ich nicht so viel Ahnung von Java-Script habe

[Florian F.]

Hallo, nochmal ^^

ich hab mittlerweile Sphinx zum laufen bekommen
Jetzt ist nur noch die Frage wie mein Buildcommand aussehen muss, damit z.b. alle dateien innerhalb des Verzeichnisses:
C:\workspace\Ka\src
Dokumentiert werden und in das Verzeichnis:
C:\workspace\Ka\src\documentation
gepackt werden ?

[Florian F.]

Kann mir da keiner weiterhelfen ?
Bzw wie sieht der Buildcommand bei euch aus ?
Wo liegen dabei eure py dateien ?

[Florian F.]

Also ich habe eine Möglichkeit gefunden wie ich Epydoc weiter nutzen kann und zusätzlich Grafiken einfügen kann. Ich habe jedoch das Problem das, wenn ich ReStructuredText benutze, dass meine kompletten Formatierungen weg sind. Leider sind das mehere Hundert dateien die ich nicht unbedingt ändern möchte -.-

Hat jemand vielleicht eine idee wie ich einen teil des dokuments im plaintext haben möchte und den anderen als ReStructuredText ?

[Leonidas]

Kann mir da keiner weiterhelfen ?

Doch sicherlich, aber wenn du Hilfe innerhalb von 4 Stunden erwartest, ist das schon etwas knapp. Schließlich ist noch nicht einmal Feierabend und einige Leute müssen arbeiten und können erst abends Fragen beantworten. Ansonsten solltest du dich an den kostenpflichtigen Sphinx-Support wenden

[Florian F.]

Könntest du mir eventuell weiterhelfen
Keine sorge ich hb nicht vergessen das leute arbeiten sind. War ich vorhin selbst noch.
Habe auch erfahren, dass ich unbedingt epydoc benutzen soll. Könnte man das so erweitern das man grafiken einfügen kann ?

Gruß