Re: Validating the addition of a new file to the documentation
| From: | Hannes Magnusson | Date: | Tue, 22 Sep 2009 07:26:18 +0000 |
| Subject: | Re: Validating the addition of a new file to the documentation | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969380880@lists.php.net to get a copy of this message | ||
2009/9/22 Ruslan Yakushev <ruslany@hotmail.com>:
> I have created a new file "iis6.xml" in the "en\install\windows\
> directory".
You need to add &install.windows.iis6; on line 51 in
en/install/windows/index.xml
> Then I run the following commands:
>
> C:\PHPSVN\phpdoc>php doc-base\configure.php
> C:\PHPSVN\phpdoc>phd -d C:\phpsvn\phpdoc\doc-base\.manual.xml
[...]
> Also, rather than re-building the entire manual - is there a way to build
> the docs only for the file that I need to validate? Re-building of the
> entire doc content takes a lot of time.
Lot of time? If it takes you more then 5minutes then something is very
very wrong.
If you only want to get the raw html version you can pass "--package
PHP --format xhtml" to PhD (assuming you are using PhD 0.9).. Using
PhD 0.4 you can pass "--format xhtml --theme chunkedhtml" to PhD.
Furthermore, PhD supports partial rendering. By passing the "--partial
the-id-you-want-to-render" PhD will only render that ID, and all its
children. If you only want that particular ID and not its children,
pass "--partial the-id-you-want-to-render=false"
For more clever options, see "phd --help"
-Hannes