On September 4, 2018 7:22:02 AM CDT, Ken Moffat via blfs-dev <[email protected]> wrote: >On Tue, Aug 28, 2018 at 02:41:01AM +0100, Ken Moffat wrote: >> On Mon, Aug 27, 2018 at 02:56:53AM +0100, Ken Moffat wrote: >> > >> > Once the dust has settled on 8.3, I hope to have another go at >> > trying to make the structure of the perl modules more like what we >> > do for python modules (one page for all modules, pulling in a file >> > for each) - the difference will be that there are so many that >> > they'll need their own subdirectory. >> > >> Gave this a few hours this evening, fell back to trying to create a >> dummy modules page with one module, and very cut down from the >> Python modules (after trying, and totally failing, to link to a >> simple perl module from a new-perl-modules page). Still getting DTD >> breakage, failure to read the included module, and in this case it >> breaks up on the fields of the xinclude statement. >> >> At this point, I would be happy to never see docbook again. >> >Some progress, now working on a short Proof of Concept (so for the >moment modules in the PoC will get a new- prefix on indexing etc, >with both new and current perl-modules pages. > >What I have found out about our docbook, copying examples from the >Python module pages, can be asserted: > >1. Entity names defined within a file are local to that file. > >2. Copying existing entity names in this situation (-download-http, >-md5sum) often works, they can be referenced, book renders. > >3. Setting names prefixed autovivification- (the first module I was >trying to do), even if copied from the existing perl-modules page, >does not work. Ditto prefixing the entitites as new- (before I was >certain if they were local or common to the book). Similarly with >random rude prefixes. That was where I gave up last time. > >After starting afresh, I fixed up the DTD problem by using a >different approach to the problematic text. Then I delved in to >test some variations so I could get a better idea of the undefined >entity problem (which gave me the assertions). > >I then tried prefixing the entities as my- (the pages are or perl, >after all) - so far I've got two pages (i.e. two modules), each with >entities my-download-http and my-md5sum. A bit more to do >(dependencies, some other cleanups) before I've got something to >show. >
Take a look here: https://tdg.docbook.org/tdg/5.0/ch02.html That's for 5.0, but section 1.3 applies equally to Docbook 4.5. --DJ -- Sent from my Android device with K-9 Mail. Please excuse my brevity. -- http://lists.linuxfromscratch.org/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
