internal test file

From: 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
« previous php.doc.chm (#9) next »