doc:phd
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
doc:phd [2008/08/01 18:46] – fix link to viewing the result page bjori | doc:phd [2017/09/22 13:28] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
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/ | + | |
+ | | ||
* [[doc: | * [[doc: | ||
- | * Demo: [[http://docs.php.net/ | + | * Demo: [[http:// |
- | * Bugs: [[http:// | + | * Bugs and feature requests: [[http:// |
==== Requirements ==== | ==== Requirements ==== | ||
- | * PHP 5 | + | * PHP 5 (5.3 preferred) |
- | * Translators require ngsmls currently | + | |
=== 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 [[doc: | 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 |
</ | </ | ||
This will create | This will create | ||
* " | * " | ||
- | * "html" direcotry containing the " | + | * "xhtml" direcotry containing the " |
- | * "bightml.html" file, which is the " | + | * "bigxhtml" file, which is the " |
See the " | See the " | ||
- | + | ||
+ | ==== TODO / Planning ==== | ||
+ | * See the [[doc/ |
doc/phd.1217616366.txt.gz · Last modified: 2017/09/22 13:28 (external edit)