Кто-нибудь использует что-либо еще для документирования своего PHP кода, чем PHPDoc? Есть ли инструменты, которые читают один и тот же синтаксис документации, но дают более богатый результат?
Я тоже пойду на кислород.
Вот несколько причин:
И все же свободный, мультиплатформенный и с открытым исходным кодом 🙂
Это легко учиться, но сложнее, чем phpdoc, потому что намного богаче.
Вы можете попробовать DocBlox; который должен быть альтернативой phpDocumentor, но с поддержкой дополнительных возможностей, полная поддержка PHP 5.3. Дополнительным преимуществом является то, что он довольно быстрый и использует относительно небольшую память.
Вы можете прочитать больше на http://www.docblox-project.org или посмотреть демонстрацию по адресу http://demo.docblox-project.org/default
Другим вариантом, кроме phpDocumentor, является документация Doxygen с поддержкой PHP .
Doxygen ( http://www.doxygen.org ).
ApiGen поддерживает поддержку пространств имен, пакетов, связей между документацией, перекрестных ссылок на стандартные классы PHP и общей документации, создания выделенного исходного кода и экспериментальной поддержки для PHP 5.4.
http://www.docblox-project.org/
PHP 5.3 совместимый генератор документации API, предназначенный для проектов любого размера и непрерывной интеграции.
способный полностью анализировать и преобразовывать Zend Framework 2
Я тоже использую Doxygen – вы очень быстро привыкаете к различным ключевым словам – они кажутся самообучающимися. 😉
RubyDoc тоже хорош, мне особенно нравится компоновка rdocs.
Я не использовал его с PHP, но doxygen утверждает, что поддерживает этот язык.
Doctrine использует PHPDoctor, который, как представляется, хорошо работает с 5.3 в моих тестах.
Если вам нужно документировать код для PHP 5.3+, например. если он использует пространства имен, то может быть вашим ответом вилка Тэда Кулпа PHPDoctor .