dm.zdoc

dm.zdoc è un minuscolo involucro Python intorno pydoc per renderlo utilizzabile per Zope.
Nota: versioni di Python sotto 2,6 manca un buon supporto per i pacchetti namespace in pydoc. Mentre Zope sé non usa pacchetti namespace prima versione 2.12 (che utilizza Python 2.6), importanti applicazioni Zope (quali Plone) fanno usare pacchetti namespace. In questi casi, la documentazione prodotta da pydoc (e per estensione zdoc) è incompleta.
Utilizzo
zdoc può essere usata tramite dmzdoc sceneggiatura, tramite modulo di importazione o integrata in una esecuzione istanza Zope.
Nei primi due casi potrebbe essere necessario impostare la Zope variabili d'ambiente INSTANCE_HOME e SOFTWARE_HOME dire zdoc dove si trovano le sorgenti di Zope.
Utilizzare via dmzdoc
Il dmzdoc script è installato quando si hanno setuptools installati.
In caso contrario, è necessario installare da soli. Essa ha il seguente contenuto:
dm.zdoc importazione; dm.zdoc.cli ()
dmzdoc ha le stesse opzioni precise e parametri pydoc, documentati in pydoc.
Utilizzare tramite modulo di importazione
Il dm.zdoc modulo definisce gli stessi oggetti pydoc, documentati in pydoc.
Integrato in una esecuzione un'istanza Zope
Per questo uso, è necessario installare il modulo nella propria installazione Zope e attivare la sua configure.zcml all'avvio Zope. Questo darà il "Zope Root Folder" la vista@@zdoc che presenta la documentazione nello stesso modo in cui il server di pydoc http.
ATTENZIONE: Esponendo la documentazione di un'istanza Zope in questo modo fornisce intuizioni sensibili e potrebbe dare hacker indizi preziosi per gli attacchi. Probabilmente, verrà installato questo solo in casi di sviluppo con accesso limitato

Cosa c'è di nuovo in questa versione:.

• Supporto il & quot; integrato in un runnging un'istanza & quot Zope; caso d'uso

Requisiti :

• Python