2012-08-20 12 views
5

Me preguntaba si es posible usar POD (documentación simple) con Python? ¿Y cómo debería hacerlo?¿Es posible usar POD (documentación antigua simple) con Python?

+2

¿Por qué lo necesita? Python tiene su propio formato de docstring que es interpretado por 'pydoc'. Si usa POD, los usuarios de su módulo necesitarían una herramienta para leerlo. ¿Estás seguro de que esto es lo que quieres? Si solo quieres documentar tu código, utiliza la cadena de documentos de python. – javex

Respuesta

1

No parece haber una forma directa de utilizar POD en línea en un archivo de Python. Sin embargo, los módulos de Python (incluida la biblioteca estándar de Python) están documentados usando reStructuredText. Esto generalmente se hace usando Sphinx, que produce la documentación de docstrings con formato ReStructuredText. Sphinx y el primero fueron diseñados específicamente para llenar un nicho similar a POD.

Cuestiones relacionadas