Pergunta

usa qualquer outra coisa para documentar o seu código PHP que PHPDoc? Existem algumas ferramentas que lêem a mesma sintaxe documentação, mas dão saída mais ricos?

Foi útil?

Solução

Vou ir para doxygen também.

Aqui estão várias razões:

  • compatível com etiquetas PHPDoc e outros mais populares: IT'S interoperável
  • trabalha com várias linguagens de programação: um melhor investimento de tempo
  • existe sintaxes alternativas: pode escolher o estilo comentando que servi-lo
  • muito eficiente com formatação avançada / marcação / metadados
  • existe uma interface gráfica que não está ligada a qualquer IDE e um plugin do eclipse assim

E ainda livre, multiplataforma e open source: -)

É fácil de aprender, mas difícil que phpdoc porque um monte mais rico.

Outras dicas

Você poderia tentar DocBlox; que se destina a ser uma alternativa para phpDocumentor mas com o apoio para as características adicionais de que o PHP completo 5,3 suporte é um. Um benefício adicional é que é bastante rápido e usos relativamente pouca memória.

Você pode ler mais sobre http://www.docblox-project.org ou ver uma demonstração em http://demo.docblox-project.org/default

Outra opção diferente de phpDocumentor é Doxygen documentação com suporte PHP .

Doxygen ( www.doxygen.org ).

ApiGen

http://apigen.org/

ApiGen tem suporte para PHP 5.3 namespaces, pacotes, ligando entre documentação, referências cruzadas para PHP classes padrão e documentação em geral, a criação de código fonte destacada e suporte experimental para PHP 5.4 traços.

DocBlox

http://www.docblox-project.org/

PHP 5.3 gerador de Documentação API compatível destinado a projetos de todos os tamanhos e integração contínua.

capaz de analisar completamente e transformar Zend Framework 2

Eu estou usando Doxygen também - você se acostumar com as várias palavras-chave muito rápido - eles são uma espécie de auto -explaining. ;)

RubyDoc é bom também, eu espcially como eles layout do RDocs.

Doutrina usa PHPDoctor, que parece funcionar bem com 5.3 em meus testes.

http://peej.github.com/phpdoctor/#download

Eu não usei-o com PHP, mas doxygen reivindicações para suportar o idioma.

Se você precisa de código do documento para PHP 5.3+, por exemplo. se ele usa namespaces de Ted Kulp garfo de PHPDoctor pode ser a sua resposta.

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top