doc:phd

This is an old revision of the document!


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:

  • autoconf
  • configure/configure.php
  • bunch of scripts in the scripts/ directory
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 5

PHP exts

These are all enabled by default in PHP.

  • libxml2
  • xmlreader
  • dom

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; pear install http://doc.php.net/phd/PhD-0.2.2.tgz

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

This will create

  • “php” directory containing the “phpweb” files
  • “html” direcotry containing the “downloadable chunked html” files
  • “bightml.html” file, which is the “downloadable bightml” file

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

doc/phd.1204946254.txt.gz · Last modified: 2017/09/22 13:28 (external edit)