dm.zdoc

dm.zdoc on pieni Python kääre ympärille pydoc tehdä se käyttökelpoinen Zope.
Huomaa: Python versiot alle 2,6 puuttuu hyvän tuen namespace paketteja pydoc. Vaikka Zope itse ei käytä namespace paketteja ennen versiota 2.12 (joka käyttää Python 2.6), tärkeä Zope sovelluksia (kuten Plone) eivät käytä namespace paketteja. Näissä tapauksissa tuottamien asiakirjojen pydoc (ja laajemmassa zdoc) on epätäydellinen.
Käyttö
zdoc voidaan käyttää joko kautta käsikirjoituksen dmzdoc kautta moduuli tuonti- tai integroitu käynnissä Zope oikeusasteessa.
Kahdessa ensimmäisessä tapauksissa saattaa olla tarpeen asettaa Zope ympäristömuuttujat INSTANCE_HOME ja SOFTWARE_HOME kertoa zdoc missä Zope lähteitä löytyy.
Käytä kautta dmzdoc
Käsikirjoitus dmzdoc asennetaan, kun olet setuptools asennettuna.
Muuten, se on asennettava itse. Se on seuraava sisältö:
tuonti dm.zdoc; dm.zdoc.cli ()
dmzdoc on täsmälleen samat vaihtoehdot ja parametreja pydoc, dokumentoitu pydoc.
Käytä kautta moduuli tuonti
Moduuli dm.zdoc määrittelee saman esineitä kuin pydoc, dokumentoitu pydoc.
Integroitu käynnissä Zope esimerkiksi
Tätä käyttöä, sinun on asennettava moduuli teidän Zope asennus ja aktivoida sen configure.zcml klo Zope käynnistyksen. Tämä antaa "Zope Root Folder" näkymä@@zdoc joka esittelee asiakirjat samalla tavoin kuin pydoc http-palvelin.
HUOMIO: altistaminen dokumentointi Zope Esimerkiksi tällä tavalla tarjoaa järkevä oivalluksia ja voisi antaa hakkerit arvokkaita vihjeitä hyökkäyksiä. Todennäköisesti voit asentaa tämän vasta kehitteillä tapauksissa on rajoitettu pääsy.

Mitä uutta tässä julkaisussa: