Генератор документации PHPDoc в или из Eclipse? [закрытый]
чтобы быть усовершенствованным в прологе, мне нравятся эти две книги:
действительно открывает ум для схем рекурсии и логического программирования.
2 ответа
Для создания документации вы должны использовать phpDocumentor , который можно установить как пакет PEAR.
Затем вы должны вызвать его из командной строки; На самом деле, я никогда не видел, чтобы его вызывали из Eclipse PDT.
Отличное решение - иметь платформу непрерывной интеграции (например, с использованием phpUnderControl ) и интегрировать ее с созданием phpdoc в вашем файл конфигурации сборки; таким образом, phpdoc генерируется каждый раз, когда кто-то фиксирует (или один раз в день, или когда вы хотите ^^) .
В Eclipse PDT вы можете вызывать «внешние инструменты» (см. «Выполнить> Внешний Инструменты »в меню); это позволит вам запустить команду phpdoc (как вы это делаете из CLI);
Да, в Zend есть мастер для этого. Ознакомьтесь с этим кратким руководством .
В качестве альтернативы вы можете создать внешнюю конфигурацию запуска для вызова стандартного phpDocumentor .
- Выберите Выполнить-> Внешние инструменты-> Конфигурации внешних инструментов ...
- На левой панели выберите Программа, затем новый значок (крайний левый значок над панелью).
- На правой панели , выберите вкладку Main.
- Введите generate_doc в поле Name:
- Введите путь к инструменту phpdoc cli в поле Location :.
- Введите любые необходимые аргументы в поле Arguments, например, для текущего входные данные проекта $ {project_loc}.
- Чтобы запустить внешнюю конфигурацию, выберите «Выполнить».
Чтобы повторно запустить конфигурацию, у вас есть несколько вариантов:
- Выберите значок «Внешние инструменты» в строке меню значок внешних инструментов http://help.eclipse.org/ganymede/topic/org.eclipse.cdt.doc.user/images/icon%5Fext%5Ftools. png ", затем щелкните generate_doc
- Выберите" Выполнить "->" Внешние инструменты "->" generate_doc "
- . Нажмите Alt + R, E, 1 (предполагается, что generate_doc является первым элементом в списке, в противном случае выберите соответствующий номер)
![значок внешних инструментов http://help.eclipse.org/ganymede/topic/org.eclipse.cdt.doc.user/images/icon%5Fext%5Ftools. png "](http://help.eclipse.org/ganymede/topic/org.eclipse.cdt.doc.user/images/icon%5Fext%5Ftools.png"){kind=link}