dm.zdoc

dm.zdoc är en liten Python wrapper runt pydoc att göra den användbar för Zope.
Obs: Python-version under 2.6 saknar bra stöd för namn paket i pydoc. Medan Zope själv inte använder namn paket före version 2.12 (som använder Python 2.6), viktiga Zope program (t.ex. Plone) gör använda namn paket. I dessa fall är de handlingar som pydoc (och i förlängningen zdoc) ofullständig.
Användning
zdoc kan antingen användas via skriptet dmzdoc, via modul import eller integrerad i en rinnande Zope instans.
I de två första fallen kan det vara nödvändigt att ställa in Zope miljövariabler INSTANCE_HOME och SOFTWARE_HOME berätta zdoc där Zope källorna kan hittas.
Användning via dmzdoc
Skriptet dmzdoc installeras när du har setuptools installerat.
Annars måste du installera det själv. Den har följande innehåll:
import dm.zdoc; dm.zdoc.cli ()
dmzdoc har exakt samma alternativ och parametrar som pydoc, dokumenterade i pydoc.
Användning via modulen import
Modulen dm.zdoc definierar samma objekt som pydoc, dokumenterade i pydoc.
Integrerad i en kör Zope instans
För denna användning måste du installera modulen i din Zope installation och aktivera dess configure.zcml på Zope start. Detta kommer att ge "Zope Root Folder" utsikten@@zdoc som presen dokumentationen på samma sätt som den pydoc http-server.
OBS: Exponera dokumentation av en Zope instans på detta sätt ger vettiga insikter och kunde ge hackare värdefulla ledtrådar för attacker. Troligt, kommer du installerar bara i utvecklings fall med begränsad tillgång

Vad är nytt i den här versionen:.

• Stöd för & quot; integrerad i en runnging Zope instans & quot; användningsfall

Krav :

• Python