Xavier Neys wrote:
> GOOD news:
> I believe I've got it right on my box.
> I tested two guides (I already had this feature in mind when I rewrote
> the quick guide and its lvm+raid sibling), and a bit of a handbook.
That IS good news!
> BAD news:
> I still don't know when, or even whether, this would be available in Gentoo's
> own XSL. Almost all templates need to be changed and it's *not* going to
> happen overnight.
>  http://gentoo.neysx.org/mystuff/gentoo-x86+raid+lvm2-quickinstall.xml
>  http://gentoo.neysx.org/mystuff/gentoo-x86-quickinstall.xml
>  http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=4
> The logic is chapters, sections and bodies can all be included, i.e. they
> either have the current structure or contain a single <include href=""/>
> element. A chapter can include chapters, a section can include sections and a
> body can include bodies.
Awesome. So the includes are all inline, and don't need to be specified
in the handbook-$arch.xml files.
Now, where are those includes being pulled from? Let's take
hb-install-sparc-disk.xml. There's quite a bit of common stuff to all
the other handbooks, as well as Sparc-specific partitioning sections.
For the common stuff, such as the "Block Devices" subsection, is it
reading that from a separate xml file? like block-devices.xml, that
contains just a tiny bit of xml for the block devices subsection?
I just want to be clear on how the includes are actually working.
> It's a bit unfair to let you know all this without knowing when or whether you
> can use it, but at least you know...
No, that's okay. As when I emailed the list back around the 2007.0
release, it was understood that it wasn't a change that could be made
right away, and I wasn't expecting it to be completely ready for the
2007.1 release either.
However, say it gets ready some time in the next 3 months, about halfway
between releases. How about putting it into effect right away on the
online handbooks well in advance of the next release? I'm willing to do
the work on converting the handbooks myself, if need be. Sure, the docs
on the CDs would have a different structure, but we can't do anything
about those anyway once they're packaged up.