phpDocumentor 1.4.4

’tag’

PHPDoctor вместо phpDocumentor

Май 28, 2012

После того, как я попробовал использовать PHPDoctor, то теперь однозначно буду использовать только его. Почему решил попробовать? Ответ простой: меня интересовало включение исходного кода файлов, которые документируются, phpDocumentor версии 1.4.4 не мог справиться с задачей, а PHPDoctor справляется отлично.

Установка PHPDoctor

PHPDoctor ставится просто. Сначала его нужно скачать:

Далее распаковать в любом месте. Я распаковал его в папку phpdoctor, которую создал в папке с локальным сервером:
/var/www/phpdoctor

Помещать его в папку с локальным сервером не обязательно. Для меня это способ всегда знать, где он находится.

Все, установка завершена. В отличие от phpDocumentor – это невероятно простой способ.

Использование PHPDoctor

Перед использованием в папке с PHPDoctor создается файл настроек с расширением ini и любым именем. Например:
myconfig.ini

После создания копируем туда содержимое файла default.ini и меняем необходимые настройки.

Список параметров с описанием можно посмотреть на странице:

В принципе в файле default.ini они и так достаточно хорошо описаны.

После сохраняем файл myconfig.ini и выполняем команду в Терминале:

php phpdoc.php myconfig.ini

Перед выполнением команды нужно перейти в папку с PHPDoctor из Терминала:

cd /var/www/phpdoctor/

В папке, которая была указана в файле настроек myconfig.ini для сохранения документации, появятся файлы.

Особенности PHPDoctor

Как я уже сказал, PHPDoctor отлично справляется с задачей указания ссылок на файлы и отображение их исходного кода.

Подсветка синтаксиса в PHPDoctor

Для того, чтобы в исходном коде файлов работала подсветка синтаксиса необходимо скачать GeSHi и поместить его в папку с PHPDoctor:

Директивы файла конфигурации

files – Names of files to parse. This can be a single filename, or a comma separated list of filenames. Wildcards are allowed.

ignore – Names of files or directories to ignore. This can be a single filename, or a comma separated list of filenames. Wildcards are NOT allowed.

source_path – The directory to look for files in, if not used the PHPDoctor will look in the current directory (the directory it is run from).

subdirs – If you do not want PHPDoctor to look in each sub directory for files uncomment this line.

quiet – Set how loud PHPDoctor is as it runs. Quiet mode suppresses all output other than warnings and errors.

verbose – Set how loud PHPDoctor is as it runs. Verbose mode outputs additional messages during execution.

doclet – Select the doclet to use for generating output.

doclet_path – The directory to find the doclet in. Doclets are expected to be in a directory named after themselves at the location given.

taglet_path – The directory to find taglets in. Taglets allow you to make PHPDoctor handle new tags and to alter the behavour of existing tags and their output.

default_package – If the code you are parsing does not use package tags or not all elements have package tags, use this setting to place unbound elements into a particular package.

overview – Specifies the name of a HTML file containing text for the overview documentation to be placed on the overview page. The path is relative to "source_path" unless an absolute path is given.

package_comment_dir – Package comments will be looked for in a file named package.html in the same directory as the first source file parsed in that package or in the directory given below. If package comments are placed in the directory given below then they should be named ".html".

globals – Parse out global variables.

constants – Parse out global constants.

private – Generate documentation for all class members.

protected – Generate documentation for public and protected class members.

public – Generate documentation for only public class members.

d – The directory to place generated documentation in. If the given path is relative to it will be relative to "source_path".

windowtitle – Specifies the title to be placed in the HTML.

doctitle – Specifies the title to be placed near the top of the overview summary file.

header – Specifies the header text to be placed at the top of each output file. The header will be placed to the right of the upper navigation bar.

footer – Specifies the footer text to be placed at the bottom of each output file. The footer will be placed to the right of the lower navigation bar.

bottom – Specifies the text to be placed at the bottom of each output file. The text will be placed at the bottom of the page, below the lower navigation bar.

tree – Create a class tree.

Tags: , , , ,
Записано в Ubuntu, Программирование    |    Постоянная ссылка