doc:phd

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
doc:phd [2008/04/19 12:06]
kalle Changed download link to 0.2.3
doc:phd [2009/10/16 17:02]
philip fixed typo, -p and -P options are very different :)
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 ​a beautiful manual for all to see. It's generic enough to work on non-php.net projects ​too.+PhD takes the PHP Manual sources (DocBook) and outputs ​the various forms of the PHP Manual. It's generic enough to work on non-php.net projects, although that part is not perfect.
  
-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:
-  ​* autoconf +  * configure.php
-  ​configure/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 ​(the file configure.php creates, which is the entire manual as one valid XML file) and generates ​several possible formats and themes for each translation including:​ 
-In the future it will also generate CHM and PDF files.+  * The PHP.net theme (phpweb): ​~6000 php files 
 +  * HTML: ~6000 html files 
 +  * HTML: One bightml.html file 
 +  * PDF: PDF versions, either as one or several ​PDF files 
 +  * CHM: The CHM files 
 +  * MAN: Man pages
  
 ==== Where to get ==== ==== Where to get ====
-  * Source: [[http://cvs.php.net/​viewvc.cgi/phd/]] +  ​* Definitive Guide: [[http://​doc.php.net/​phd/​docs/​]] 
-  * Demo: [[http://docs.php.net/​manual/​]] +  ​* Source: [[http://svn.php.net/​viewvc/​phd/​]] 
-  * Bugs: [[http://​bugs.php.net/​search.php?​cmd=display&​status=All&​bug_type%5B%5D=Doc+Build+problem|PhD Bugs at bugs.php.net]]+  * [[doc:​phd:​install|Installation docs]] 
 +  * Demo: [[http://​php.net/​manual/​]] 
 +  * Bugs and feature requests: [[http://​bugs.php.net/​search.php?​cmd=display&​status=Open&​bug_type%5B%5D=Doc+Build+problem|PhD Bugs at bugs.php.net]]
  
 ==== Requirements ==== ==== Requirements ====
-PHP 5+  * PHP 5 (5.3 preferred) 
 === PHP exts === === PHP exts ===
-These are all enabled by default ​in PHP.+Required, but enabled by default ​as of PHP 5:
   * 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://​doc.php.net/​phd/​PhD-0.2.3.tgz+NOTE: You need to [[doc:​phd:​install|install PhD]] first.
  
 <code bash> <code bash>
-cvs -d:pserver:​cvsread@cvs.php.net/​repository ​co phpdoc+svn co http://svn.php.net/​repository/​phpdoc/​modules/​doc-en ​phpdoc
 $ cd phpdoc $ cd phpdoc
-$ php configure.php +$ php doc-base/configure.php 
-$ phd -d .manual.xml+$ phd -d doc-base/.manual.xml ​-o output_dir -f php -P PHP
 </​code>​ </​code>​
  
Line 48: Line 55:
   * "​bightml.html"​ file, which is the "​downloadable bightml"​ file   * "​bightml.html"​ file, which is the "​downloadable bightml"​ file
  
-See the "​[[phd/​view|Viewing the results]]"​ for various ways of viewing the rendered files. +See the "[[doc/phd/​view|Viewing the results]]"​ for various ways of viewing the rendered files. 
- + 
 +==== TODO / Planning ==== 
 +  * See the [[doc/​todo/​phd]] page
doc/phd.txt · Last modified: 2017/09/22 13:28 (external edit)