Jirka Kosek writes:
> Jirka Kosek wrote:
> >
> > Jim Winstead wrote:
> >
> > > of the php documentation? every xslt parser i threw at the php
> > > documentation plus normal walsh's stylesheets choked.
> >
> > I will inform you, if I succeed.
>
> I just succesfully converted English version of manual to single HTML
> file, and to multiple HTML pages with XSLT stylesheets from N. Walsh
> using Saxon XSLT processor. There were few XML syntax errors in source
> files, after correcting them, everything worked fine.
I've just done the same--and I'm wondering what kind of performance
you saw when you did it? On my machine, the Saxon transformation took
38 minutes elapsed time, and the DSSSL transformation took 18 minutes.
> Because I haven't commit access to CVS, there is a list of changes
> neccesary to turn English docs to correct XML:
>
> ./en/chapters/install.xml:
> - there was unterminated entity reference on line 10. Change
> "&url.mirrors" to "&url.mirrors;"
>
> ./en/appendices/migration4.xml
> - there were unescaped & character two times. Change it to correct
> entity reference & (on lines 84 and 87)
I've fixed these in CVS.
> ./en/functions/strings.xml
> ./en/functions/outcontrol.xml
> ./en/language/variables.xml
> - these files contain characters from ISO-8859-1 but out of the ASCII
> (some umlauts, and German sharp s). XML processor implicitly uses UTF-8
> encoding. Upper ISO-8859-1 characters are wrong in UTF-8 file. Easy
> workaround is to place correct encoding declaration as a FIRST LINE of
> these files:
>
> <?xml encoding="iso-8859-1"?>
I added these lines locally to get the Saxon transformation to work,
but haven't committed them as it seems like the sort of thing that may
need to be codified into the general how-to-write-PHP-docs standard or
something. That's for Stig or Egon to decide on, I think. :)
> Simillar problems are probably present in translations to other
> languages.
>
> If you are interested, I can start work on porting DSSSL customizations
> to XSLT. In this case, I would appreciate CVS access.
>
> Jirka
You can 'officially' request CVS access at http://www.php.net/cvs-php.php.
I personally can't give you access and hopefully that'll get the
attention of someone who can. Until then you could probably just post
diff -u patches here and someone can commit for you.
BTW--have you tried using Xalan-C++ on the PHP docs yet? I tried it
but got an ugly namespace assertion bailout, both with DocBook XSL
1.24 and 1.28. I know the Xalan-C++ is only Xalan 1, and is beta (or
alpha) anyway, so I guess I shouldn't be too surprised...I was just
wondering if maybe it's a bit faster than the Java version. I'm trying
out Xalan-Java 2 right now but it might be a while before it's
done. :)
Cheers,
Torben
--
+----------------------------------------------------------------+
|Torben Wilson <[EMAIL PROTECTED]> Adcore Finland|
|http://www.coastnet.com/~torben http://www.adcore.com|
|Ph: 1.604.709.0506 [EMAIL PROTECTED]|
+----------------------------------------------------------------+
