Re: Killing entity magic/validating individual files (quick summary)
| From: | Hannes Magnusson | Date: | Thu, 16 Apr 2009 07:40:08 +0000 |
| Subject: | Re: Killing entity magic/validating individual files (quick summary) | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969380360@lists.php.net to get a copy of this message | ||
On Tue, Apr 7, 2009 at 10:18, Hannes Magnusson
<hannes.magnusson@gmail.com> wrote:
> Hi all
>
> For the last few days I've been trying to work out how to kill the
> entity file include magic and getting our files to validate standalone
> (so, for instance you can work on individual files in XML editors or
> to render individual files)...
> Quickish summary of the things I've concluded;
And a Quickish summary of changes I ended up using:
- manual.xml.in
* Changed all entity includes (&bookinfo, &chapters.intro;
&reference.bzip2.book;...) to be XIncludes to
href="/ROOT/bookinfo.xml", href="/ROOT/chapters/intro.xml",
"/ROOT/reference/bzip2/book.xml"..
* Removed most of the SYSTEM entities, except for language-defs
- docbook/docbook-xml/docbook.dtd added the dbgenent DocBook4.5
module back in (dbgenent.module) and added most of the SYSTEM entities
from the manual.xml.in file
- Added DTD (called in PHookBook) to all files xincluded by
manual.xml.in, and declared an &magic.files.include; SYSTEM entity
(which replaced the &reference.<extname>.functions; entity) pointing
to entities.<extname>.xml
- Created a catalog file for PHookBook which rewrote "/ROOT/" to
"/path/to/doc/<lang>/"
I Think thats pretty much it.
I don't have the changed files anymore, it was pretty simple to write
a script that did these changes after knowing what exactly needed to
be done :)
There may have been something else I did which I've forgotten to
mention.. I experimented a lot but I think this should describe the
end results fairly OK.
If someone wants to try this out and hits any problem then just ask :)
-Hannes