doc:phd
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
doc:phd [2008/03/08 03:17] – imported, initially written by Etienne, Hannes, and Philip philip | doc:phd [2009/10/16 16:35] – updated phd execution example to reflect 0.9/1.0 philip | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ==== PhD -- Building the PHP manuals of the future | + | ==== PhD -- Building the PHP manual with PHP ==== |
- | PhD takes PHP Manual sources (DocBook) and outputs | + | PhD takes the PHP Manual sources (DocBook) and outputs |
- | If you have questions, add it to the [[phd/faq|FAQ]]. | + | If you have questions, add them to the [[doc:phd:faq|FAQ]]. |
== PhD Setup (N/A) == | == PhD Setup (N/A) == | ||
Replaces: | Replaces: | ||
- | | + | * configure.php |
- | | + | |
* bunch of scripts in the scripts/ directory | * bunch of scripts in the scripts/ directory | ||
Line 14: | Line 13: | ||
== PhD Renderer (Beta) == | == PhD Renderer (Beta) == | ||
- | Takes the .manual.xml and generates ~6000 php files, ~6000 html files and one bightml.html file. | + | Takes the .manual.xml |
- | In the future it will also generate CHM and PDF files. | + | * The PHP.net theme (phpweb): |
+ | * HTML: ~6000 html files | ||
+ | * HTML: One bightml.html file | ||
+ | * PDF: PDF versions, either as one or several | ||
+ | * CHM: The CHM files | ||
+ | * MAN: Man pages | ||
==== Where to get ==== | ==== Where to get ==== | ||
- | * Source: [[http://cvs.php.net/ | + | |
- | * Demo: [[http://docs.php.net/ | + | |
- | * Bugs: [[http:// | + | * [[doc: |
+ | * Demo: [[http:// | ||
+ | * Bugs and feature requests: [[http:// | ||
==== Requirements ==== | ==== Requirements ==== | ||
- | PHP 5 | + | * PHP 5 (5.3 preferred) |
=== PHP exts === | === PHP exts === | ||
- | These are all enabled by default | + | Required, but enabled by default |
* libxml2 | * libxml2 | ||
* xmlreader | * xmlreader | ||
* dom | * dom | ||
+ | Optional: | ||
+ | * Haru (or PDF) | ||
==== Usage ==== | ==== 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): | + | Because the builder is incomplete, we still use the current system to build the huge .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:// | + | NOTE: You need to [[doc: |
<code bash> | <code bash> | ||
- | $ cvs -d:pserver: | + | $ svn co http://svn.php.net/ |
$ cd phpdoc | $ cd phpdoc | ||
- | $ php configure.php | + | $ php doc-base/configure.php |
- | $ phd -d .manual.xml | + | $ phd -d doc-base/.manual.xml |
</ | </ | ||
Line 47: | Line 55: | ||
* " | * " | ||
- | See the " | + | See the "[[doc/phd/ |
- | + | ||
+ | ==== TODO / Planning ==== | ||
+ | * See the [[doc/ |
doc/phd.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1