[GSOC] DocBook5 upgrade
| From: | Hannes Magnusson | Date: | Thu, 14 Jun 2007 21:09:28 +0000 |
| Subject: | [GSOC] DocBook5 upgrade | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969376673@lists.php.net to get a copy of this message | ||
Hi all
As a part of my Google Summer of Code work on Livedocs I decided to
upgrade our phpdoc to DocBook5.0RC4 as doing so after deploying
Livedocs would be really painful.
The patch is available at http://bjori.php.is/phpdoc/docbook5.upgrade.bz2
And phpweb_xsl build (thanks to Alex Songe for the build): http://lohan.php.is
This is a major change so I would appreciate if you could look through
the build.
99.5% of the changes are:
- Replacing the id attribute with xml:id
- Adding xmlns="http://docbook.org/ns/docbook" to all root elements
- Replace the <ulink /> elements with regular <link /> element using
the XLink:href attribute.
All three are rather simple to upgrade with a few line php/perl/shell script.
The 0.5% you'll pretty much have to grep for, but they include:
- "Randomly" added <para /> tags here and there in <entry />s
containing block elements
- Removing markup from <literal /> elements (or replace it with
something more meaningful).
I haven't dug through en/internals yet but will do soonish.
This patch will break _all_ (i.e. Japanese and French) translations
and they will need to upgrade too asap.
These changes should _not_ have any user _visible_ changes (there are
one or two or three markup changes) as it still uses the same
DocBook4-XSL, so if you find any differences please let me know.
Unless there are any scary looking objections I'll commit this.. say.. Monday?
Next on my GSoC schedule is to create a decent, readable and foxy
looking OO skeleton taking advantage of the kickass extendability of
DocBook5.
I was thinking I would use ext/reflection
(php.net/language.oop5.reflection) as a proof-of-concept example
extension for that work as it has to be moved anyway.
-Hannes