Что-нибудь лучше, чем PHPDoc?

Кто-нибудь может использовать что-либо еще для документирования своего кода PHP, чем PHPDoc? Есть ли инструменты, которые читают один и тот же синтаксис документации, но дают более богатый результат?

9 ответов

Я тоже пойду на doxygen.

Вот несколько причин:

  • совместим с тегами phpdoc и другими популярными: он совместим
  • работает с различными языками программирования: лучшее время инвестиций
  • Существуют альтернативные синтаксисы: можно выбрать стиль комментариев, который вам подходит.
  • очень эффективен с расширенными форматами/мечениями/метаданными
  • есть графический интерфейс, который не связан с какой-либо IDE и плагином eclipse, а также

И все же свободный, мультиплатформенный и открытый исходный код: -)

Легко учиться, но сложнее, чем phpdoc, потому что намного богаче.


Вы можете попробовать DocBlox; который должен быть альтернативой phpDocumentor, но с поддержкой дополнительных возможностей, полная поддержка PHP 5.3. Дополнительным преимуществом является то, что он довольно быстрый и использует относительно небольшую память.

Вы можете прочитать больше на http://www.docblox-project.org или посмотреть демонстрацию в http://demo.docblox-project.org/default


Другим вариантом, кроме phpDocumentor, является Doxygen документация с PHP поддержка.


ApiGen

http://apigen.org/

ApiGen имеет поддержку пространств имен, пакетов, связей между документами, перекрестных ссылок на стандартные классы PHP и общей документации, создания выделенного исходного кода и экспериментальной поддержки для характеристик PHP 5.4.

DocBlox

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

PHP 5.3 совместимый генератор документации API, предназначенный для проектов любого размера и непрерывной интеграции.

способен полностью анализировать и преобразовывать Zend Framework 2


Я использую Doxygen - вы очень быстро привыкаете к различным ключевым словам - они кажутся самообучающимися.;)

RubyDoc тоже хорош, мне особенно нравится макет rdocs.


Я не использовал его с PHP, но doxygen утверждает, что поддерживает язык.


Doctrine использует PHPDoctor, который, как представляется, хорошо работает с 5.3 в моих тестах.

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


Если вам нужно документировать код для PHP 5.3+, например. если он использует пространства имен Ted Kulp fork PHPDoctor, может быть ваш ответ.

licensed under cc by-sa 3.0 with attribution.