dm.zdoc es un pequeño envoltorio de Python alrededor pydoc para que sea utilizable para Zope.
Nota: versiones de Python debajo 2.6 carecen de un buen soporte para paquetes de espacio de nombres en pydoc. Aunque sí Zope no utiliza paquetes de espacio de nombres antes de la versión 2.12 (que utiliza Python 2.6), aplicaciones Zope importantes (como Plone) hacen uso de paquetes de espacio de nombres. En estos casos, la documentación producida por pydoc (y por zdoc extensión) es incompleta.
Uso
zdoc bien se puede utilizar a través de la dmzdoc guión, a través del módulo de importación o integrado en una instancia Zope correr.
En los dos primeros casos, podría ser necesario ajustar el Zope variables de entorno-instancia y SOFTWARE_HOME para decirle zdoc donde las fuentes de Zope se pueden encontrar.
Use mediante dmzdoc
El dmzdoc script está instalado cuando se tiene setuptools instalados.
De lo contrario, debe instalarlo usted mismo. Se tiene el siguiente contenido:
dm.zdoc importación; dm.zdoc.cli ()
dmzdoc tiene las mismas opciones y parámetros exactos como pydoc, documentados en pydoc.
Use mediante módulo de importación
El dm.zdoc módulo define los mismos objetos que pydoc, documentados en pydoc.
Integrado en una instancia Zope corriendo
Para este uso, se debe instalar el módulo en la instalación de Zope y activar su configure.zcml al iniciar Zope. Esto le dará a la "Carpeta raíz Zope" zdoc la vista@@que presenta la documentación de la misma forma que el servidor http pydoc.
ATENCIÓN: La exposición de la documentación de una instancia de Zope de esta manera proporciona una visión sensata y podría dar a los hackers pistas valiosas para los ataques. Probablemente, usted instalará esto sólo en casos de desarrollo con acceso restringido
¿Cuál es nuevo en esta versión:.
- Soporte para el & quot; integrado en un runnging instancia Zope & quot; caso de uso
Requisitos :
- Python
Comentarios que no se encuentran