array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'about.generate.php', 1 => 'Как создаются форматы документации', 2 => 'Как создаются форматы документации', ), 'up' => array ( 0 => 'about.php', 1 => 'О руководстве', ), 'prev' => array ( 0 => 'about.howtohelp.php', 1 => 'Как помочь в написании документации', ), 'next' => array ( 0 => 'about.translations.php', 1 => 'Переводы', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'appendices/about.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Как создаются форматы документации

Это руководство написали на языке XML-разметки по спецификации » DocBook XML DTD. Файлы PHP-документации обрабатывает » PhD (The [PH]P based [D]ocBook renderer, Средство визуализации DocBook-файлов на основе PHP) в целях поддержки и форматирования.

Работа с XML-разметкой как с единственным исходным форматом помогает создавать документацию во многих форматах и одновременно разрешает редактировать только один исходный документ для всех форматов. Утилита для форматирования руководства — » PhD. Чтобы создать руководство в формате Windows HTML Help, мы пользуемся компилятором CHM-файлов » Microsoft HTML Help Workshop и, разумеется, самим PHP — для дополнительных преобразований и форматирования.

Руководство создали на разных языках и в разных форматах, дополнительную информацию даёт страница » https://www.php.net/docs.php. Исходный код XML-файлов можно скачать из Git или просмотреть онлайн по адресу » https://github.com/php/doc-ru.