RE: [PHP-DOC] Validating the addition of a new file to the documentation
| From: | Ruslan Yakushev | Date: | Tue, 22 Sep 2009 18:15:50 +0000 |
| Subject: | RE: [PHP-DOC] Validating the addition of a new file to the documentation | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969380884@lists.php.net to get a copy of this message | ||
> Date: Tue, 22 Sep 2009 09:26:18 +0200
> Subject: Re: [PHP-DOC] Validating the addition of a new file to the documentation
> From: hannes.magnusson@gmail.com
> To: ruslany@hotmail.com
> CC: phpdoc@lists.php.net
>
> 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
Yes, that worked. Thanks for your help!
By "lot of time" I meant ~ 5 minutes :). I will try using the --partial parameter.