tutorial sirve que plantilla phpdocumentor para documentar codigo code php phpdoc
http://linux.wareseeker.com/Programming/php-tag-engine-1.0.zip/327927

sirve - phpdocumentor tutorial



¿Algún tutorial sobre cómo usar phpDocumentor? (7)

Quiero comenzar a usar phpDocumentor pero me resulta difícil, la interfaz web no funciona bien y no puedo analizar los archivos de ejemplo.

Probablemente no lo haya configurado correctamente y me gustaría tener un buen tutorial paso a paso (es decir, NO ESTE ) para comprobar dónde me he equivocado y, con suerte, conseguirlo analizando algo.

Pero no puedo encontrar nada a través de Google. ¿Alguien puede sugerir buenos tutoriales o recursos para comenzar a usar phpdoc?

¡Muchas gracias!

Ian

EDIT: Gracias por saltar, ashnazg! Estos fueron los pasos que seguí:

  1. Pear no estaba trabajando en mi Mac, así que descargué la versión 1.4.3 y la descomprimí en un directorio
  2. Especificó la ruta absoluta al archivo de muestra 2 en mi HD en la pestaña de archivo
  3. Especificó una carpeta de salida que era de escritura mundial.
  4. Se hizo clic en Crear ... cosas que están ocurriendo en el registro, carpeta de medios creada pero sin informe. El registro concluye "ERROR: nada analizado"

Desde entonces tengo a Pear trabajando e instalé phpdoc de esa manera; puede usarlo a través de la línea de comandos, pero ¿alguna idea acerca de lo que podría hacer con la interfaz web para evitar que analice el archivo? Parece ser feliz en todos los demás aspectos.

EDIT 2: Gracias por el enlace al artículo de Developer.com , Liz: Es muy básico pero es un inicio rápido útil.

La documentación no le dice esto, pero debe mover los archivos de muestra a un directorio que no tenga la cadena "tutorial" en ninguna parte de la ruta. phpDocumentor trata el "tutorial" como una palabra reservada y se niega a analizar cualquier archivo que lo tenga en la ruta.

No tengo conocimiento de ningún tutorial sobre el uso de la interfaz web. Realmente no recibo tantas preguntas de apoyo al usarlo. Si puedes resaltar cómo lo estás usando sin éxito, yo podría ayudarte.

Personalmente, uso etiquetas estándar JavaDoc y un pequeño programa Python para convertir mi PHP en archivos Java (con cuerpos de métodos vacíos). Luego ejecuto JavaDoc: me gustan las características y se ve mucho mejor que cualquier otra cosa que haya visto. Bueno, empecé con Java antes de PHP.

Este pequeño programa de Python es parte de mis cosas de PHP y se puede encontrar en

http://code.google.com/p/mcrwebapp/source/browse/trunk/tools/php2java

(Por lo que vale.)