dm.zdoc

dm.zdoc adalah pembungkus Python kecil di sekitar pydoc untuk membuatnya dapat digunakan untuk Zope.
Catatan: Python versi di bawah 2,6 kurangnya dukungan baik paket namespace di pydoc. Sementara Zope sendiri tidak menggunakan paket namespace sebelum versi 2.12 (yang menggunakan Python 2.6), aplikasi Zope penting (seperti Plone) memang menggunakan paket namespace. Dalam kasus ini, dokumentasi yang dihasilkan oleh pydoc (dan dengan ekstensi zdoc) tidak lengkap.
Penggunaan
zdoc bisa digunakan melalui dmzdoc skrip, melalui modul impor atau terintegrasi dalam Zope contoh menjalankan.
Dalam dua kasus pertama mungkin perlu untuk mengatur Zope variabel lingkungan INSTANCE_HOME dan SOFTWARE_HOME untuk memberitahu zdoc mana sumber Zope dapat ditemukan.
Gunakan via dmzdoc
Script dmzdoc diinstal ketika Anda memiliki setuptools diinstal.
Jika tidak, Anda harus menginstal sendiri. Ini memiliki konten berikut:
dm.zdoc impor; dm.zdoc.cli ()
dmzdoc memiliki pilihan yang sama persis dan parameter sebagai pydoc, didokumentasikan dalam pydoc.
Gunakan melalui modul impor
Modul dm.zdoc mendefinisikan objek yang sama seperti pydoc, didokumentasikan dalam pydoc.
Terintegrasi dalam Zope contoh menjalankan
Untuk penggunaan ini, Anda harus menginstal modul dalam instalasi Zope Anda dan mengaktifkan configure.zcml tersebut pada Zope startup. Hal ini akan memberikan "Zope Root Folder" pandangan@@zdoc yang menyajikan dokumentasi dengan cara yang sama sebagai server pydoc http.
PERHATIAN: Mengekspos dokumentasi contoh Zope dengan cara ini memberikan wawasan yang masuk akal dan bisa memberikan hacker petunjuk berharga untuk serangan. Kemungkinan, Anda akan menginstal ini hanya dalam kasus pembangunan dengan akses terbatas

Apa yang baru dalam rilis ini:.

• Dukungan untuk & quot; terintegrasi dalam runnging Zope contoh & quot; use case

Persyaratan :

• Python