Table of Contents

PhD -- Building the PHP manuals of the future

PhD takes PHP Manual sources (DocBook) and outputs a beautiful manual for all to see. It's generic enough to work on non-php.net projects too.

If you have questions, add it to the FAQ.

PhD Setup (N/A)

Replaces:

PhD Build (N/A)

Replaces the `test`, `test_xml` `.manual.xml` make targets (i.e. builds the `.manual.xml` file and validates it).

PhD Renderer (Beta)

Takes the .manual.xml and generates ~6000 php files, ~6000 html files and one bightml.html file. In the future it will also generate CHM and PDF files.

Where to get

Requirements

PHP exts

These are all enabled by default in PHP.

Usage

Because the builder is not done, we still use the current system to build the .manual.xml file. An example use of PhD today (See `phd -h` for more options):

NOTE: You need to install PhD first.

$ cvs -d:pserver:cvsread@cvs.php.net/repository co phpdoc
$ cd phpdoc
$ php configure.php
$ phd -d .manual.xml

This will create

See the ”Viewing the results” for various ways of viewing the rendered files.