internal test file
| From: | Gabor Hojtsy | Date: | Sun, 10 Feb 2002 19:04:20 +0000 |
| Subject: | internal test file | ||
| Groups: | php.doc.chm | ||
| Request: | Send a blank email to php-doc-chm+get-9@lists.php.net to get a copy of this message | ||
Hi!
I am just uploading an internal test file (not for public release
yet) to http://weblabor.hu/php/internal_test.chm
This is a cut down of the manual, 1/2MB, without the most of
the funcref pages. Though, only funcref pages are missing, other
pages are there as in the lates phpdoc CVS XML sources.
This new test is generated using XSL style sheet I created the
yesteday and today, so there can be errors. Nearly all the page
structures, including the TOC and index terms are created
using a customised DocBokk XSL style sheet set (available fully
from phpdoc CVS).
Using this method, I was able to slim down the generator script,
and only include some filters needed to postprocess XSL output.
These include:
- color coding of examples
- make the first <h[anynum]> tag the main heading
- CSS targeted tweaks, eg. insert a <p> after all </ul>-s, etc.
This seem to speed up the generating process, and more logical,
structural and general. ;)
This does not mean we need to give up any of our plans, even
we have deeper toc in the help file, that anybody ever seen
in PHP documentation ;)
I made this files to conform to Holgers "lo" design as possible.
Though some things need to be overthought. Eg. notes, warnings
and cautions can include other <para>s, and even examples,
and examples can include outputs, and more text, so there was
a need to make the note, warning and caution parts blocks (divs).
This makes them render a bit different, but I modified the CSS
to be as close as it can to Holger's sample.
As I worked with that much with the CSS, I rearranged the parts,
added many comments, and made some logical imporvements. The
file is now more developer friendly. I would like to use this
format from now on (attached) ;)
This test file is able to work with a php_manual_notes.chm
in the same dir (I'll post such a file in the next sample).
I have one generated here on my machine, but the notes in
it are way old (approx. 2001/oct).
I am waiting for comments on what need to be modified in
this sample, and what errors do you find.
Please test!
I would like to give out a next sample next week with this
file, so IMHO this is quite ready to release as a sample
(it will be packed with a user note file of course :).
Goba
Attachment: [text/css] _style_lo.css
Attachment: [text/css] _style_lo.css