dm.zdoc

وdm.zdoc هو مجمع بيثون صغيرة حول pydoc لجعلها صالحة للاستعمال لZope.
ملاحظة: تفتقر الإصدارات بيثون أدناه 2.6 دعما جيدا لحزم مساحة الاسم في pydoc. في حين Zope نفسها لا تستخدم حزم مساحة الاسم قبل الإصدار 2.12 (الذي يستخدم بايثون 2.6)، وتطبيقات Zope الهامة (مثل بلون) لا تستخدم حزم مساحة الاسم. في هذه الحالات، فإن الوثائق التي تنتجها pydoc (وبالتبعية zdoc) غير مكتملة.
استعمال
يمكن أن تستخدم إما zdoc عبر dmzdoc النصي، عبر وحدة الاستيراد أو دمج في مثيل Zope قيد التشغيل.
في الحالتين الأوليين قد يكون من الضروري لضبط Zope متغيرات البيئة INSTANCE_HOME وSOFTWARE_HOME أن أقول zdoc حيث مصادر Zope يمكن العثور عليها.
استخدام عبر dmzdoc
تثبيت dmzdoc النصي عندما يكون لديك setuptools المثبتة.
خلاف ذلك، يجب تثبيت ذلك بنفسك. أنه يحتوي على المحتوى التالي:
dm.zdoc الاستيراد؛ dm.zdoc.cli ()
dmzdoc لديه نفس الخيارات والمعلمات بالضبط كما pydoc، وثقت في pydoc.
استخدام عبر وحدة الواردات
يحدد dm.zdoc وحدة الكائنات نفسها كما pydoc، وثقت في pydoc.
المتكاملة في مثيل Zope تشغيل
لهذا الاستخدام، يجب تثبيت وحدة التركيب Zope الخاص وتفعيل configure.zcml لها عند بدء التشغيل Zope. وهذا يعطي "مجلد الجذر Zope" zdoc وجهة نظرالذي يعرض وثائق بنفس الطريقة مثل ملقم pydoc HTTP.
تنبيه: فضح توثيق مثيل Zope بهذه الطريقة يقدم أفكارا معقولة ويمكن إعطاء قراصنة ادلة قيمة لهجمات. الأرجح، سوف تثبيت هذا إلا في حالات تنمية مع وصول مقيد

ما هو الجديد في هذا الإصدار:.

الدعم للومثل؛ متكاملة في Zope المثال ومثل runnging. حالة الاستخدام

المتطلبات:

بيثون