doc:articles:phd_ide

How to build your own PHP Manual format

Requirements

  • PHP Manual documentation sources
  • PHP 5.3+
  • PhD

Step #1 : Download the PHP Manual DocBook sources

Step #2 : Install PhD

Step #3 : Install PhD_IDE

 $ pear install phpdocs/PhD_IDE-beta

Step #4 : Use PhD to generate the appropriate files

The following commands will build the files used by PhD_IDE:

 $ cd /path/to/your/php/doc/checkout
 $ php doc-base/configure.php
 $ phd --docbook doc-base/.manual.xml --package IDE --format xml --format funclist

You now have the following file structure:

 /path/to/your/php/doc/checkout/doc-base/output/index.sqlite
 /path/to/your/php/doc/checkout/doc-base/output/ide-xml/
 /path/to/your/php/doc/checkout/doc-base/output/ide-funclist.txt

Tip: The --output PhD option changes the output directory.

Step #5 : Build your own structure

Json

The following commands use an example script called 'gen-ide.php', and this script requires you to edit its configuration. Namely, the path to your PhD and PHP Documentation checkouts. Edit this script to fit your needs. The following describes default usage:

 $ cp /path/to/your/php/doc/checkout/doc-base/scripts/gen-ide-json.php /tmp/test-ide.php
 $ cd /tmp
 $ vim test-ide.php
 $ ./test-ide.php
 $ open php_manual.json

SQLite 3

 $ phd --docbook path/to/.manual.xml --package IDE --format sqlite

Conclusion

The PhD_IDE PhD package allows customizing the output of the PHP Manual. It takes DocBook XML and converts it to a PHP object containing all (most) of the functions documentation. The main purpose is to allow IDE's to build syntax files for code insight and PHP documentation, but its usage is flexible.

doc/articles/phd_ide.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1