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.
ĸen
--
Also Spuke Zerothruster
(Finnegans Wake)
--
http://lists.linuxfromscratch.org/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
