epydoc

5El calor

1Respuesta

restructuredText, docstring y python interactive shell

Estoy usando reStructuredText para documentar mi código, a fin de obtener buenas páginas HTML fuera de línea mediante epydoc. Los resultados son brillantes. El único inconveniente es que cuando uso el

27El calor

2Respuesta

Cómo documentar el código de Python: Epydoc, doxygen, Sphinx, ...?

No estoy seguro de si debería usar Epydoc o doxygen para documentar mi código Python. Actualmente preferiría Epydoc ya que está especializado en Python y su sintaxis no es muy diferente de la de doxyg

6El calor

3Respuesta

epydoc AttributeError: el objeto 'Texto' no tiene 'datos' de atributo

No he usado epydoc en los últimos 2 años, pero me ha resultado muy útil hacer un seguimiento de mis clases y métodos con muy poco esfuerzo. Hoy instalé la última versión 3.0.1 pero aparece este error

18El calor

3Respuesta

¿Cuál es la relación entre docutils y Sphinx?

Parece que hay una gran cantidad de herramientas de documentación para Python. Otro con el que me he encontrado es epydoc. Parece que Sphinx es el estándar de facto, porque se usa para generar los doc

9El calor

3Respuesta

¿Forma automatizada de cambiar del formato de docstring de epydoc al formato de docstring de sphinx?

Tengo un proyecto que documenté usando epydoc. Ahora estoy tratando de cambiar a esfinge. He formateado todas mis cadenas de documentos para epydocs, usando B {}, L {} etc. para negrita, enlaces y sim