example - phpdocumentor download windows
Algo mejor que PHPDoc por ahÃ? (9)
¿Alguien usa algo más para documentar su código PHP que PHPDoc? ¿Hay alguna herramienta que lea la misma sintaxis de documentación pero que brinde un mejor resultado?
Doxygen ( www.doxygen.org ).
Estoy usando Doxygen también - te acostumbras a las varias palabras clave muy rápido - son una especie de autoexplicación. ;)
RubyDoc también es agradable, especialmente me gusta el diseño de los rdocs.
Iré por doxygen también.
Aquí hay varias razones:
- compatible con las etiquetas phpdoc y otras populares: es interoperable
- funciona con varios lenguajes de programación: una mejor inversión de tiempo
- hay sintaxis alternativas: puede elegir el estilo de comentario que más le convenga
- muy eficiente con formateo / etiquetado / metadatos avanzados
- hay una GUI que no está vinculada a ningún IDE y un plugin de eclipse también
Y aún libre, multiplataforma y fuente abierta :-)
Es fácil de aprender, pero más difícil que phpdoc porque es mucho más rico.
No lo he usado con PHP, pero doxygen afirma que admite el lenguaje.
Doctrine usa PHPDoctor, que parece funcionar bien con 5.3 en mis pruebas.
Podrías probar DocBlox; que pretende ser una alternativa para phpDocumentor pero con soporte para características adicionales de las cuales el soporte completo de PHP 5.3 es uno. Un beneficio adicional es que es bastante rápido y usa relativamente poca memoria.
Puede leer más en http://www.docblox-project.org o ver una demostración en http://demo.docblox-project.org/default
Si necesita documentar el código para PHP 5.3+, ej. si usa espacios de nombres, el fork de PHPDoctor de Ted Kulp podría ser tu respuesta.
ApiGen
ApiGen tiene soporte para espacios de nombres PHP 5.3, paquetes, enlaces entre documentación, referencias cruzadas a clases estándar de PHP y documentación general, creación de código fuente resaltado y soporte experimental para rasgos PHP 5.4.
DocBlox
http://www.docblox-project.org/
PHP 5.3 generador de documentación API compatible dirigido a proyectos de todos los tamaños e integración continua.
capaz de analizar completamente y transformar Zend Framework 2