Re: [gentoo-doc] GuideXML: define values & use conditional tags

[Xavier Neys]

Xavier Neys wrote:
Hi *,

Replying to the original post to keep links :)

> Please have a look at the following links and compare:
>
> Define values in books:
> http://gentoo.neysx.org/mystuff/handbook/handbook-mips.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-hppa.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-alpha.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-ppc64.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-ppc.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-sparc.xml?passthru=1
> http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?passthru=1

Use them in shared chapters across all architectures:
> http://gentoo.neysx.org/mystuff/handbook/hb-install-config.xml?passthru=1

and in merged x86 & amd64 arch-specific chapters
http://gentoo.neysx.org/mystuff/handbook/hb-install-x86+amd64-bootloader.xml?passthru=1
http://gentoo.neysx.org/mystuff/handbook/hb-install-x86+amd64-disk.xml?passthru=1
http://gentoo.neysx.org/mystuff/handbook/hb-install-x86+amd64-kernel.xml?passthru=1
http://gentoo.neysx.org/mystuff/handbook/hb-install-x86+amd64-medium.xml?passthru=1

> I did not want to make block tags conditional to avoid having to test all
> p,table,pre,ul,dl... and added a test attribute to the body tag. The only
> change to the DTD would be to make "body+" and add the test attribute.
> The test can be any XPath expression that is evaluated and if it returns true,
> the body is processed.

Now, I do want more tags that allow a condition. I tried both ways and the XML
ends up a lot easier to read when you don't have to create bodies around a
single block tag.
Even <li> and <tr> can be made conditional.
Look at the table about the video statement in the bootloader section
http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=10
http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=10
The only difference is an extra row. Using <tr test="...">... is a lot more
readable and easier to maintain than two separate tables inside different bodies.

> The result looks like:
> http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-sparc.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-ppc.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-ppc64.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-alpha.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-hppa.xml?part=1&chap=8
> http://gentoo.neysx.org/mystuff/handbook/handbook-mips.xml?part=1&chap=8

and for the merged x86 & amd64 bits:
http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=2
http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=2
http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=4
http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=4
http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=7
http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=7
http://gentoo.neysx.org/mystuff/handbook/handbook-x86.xml?part=1&chap=10
http://gentoo.neysx.org/mystuff/handbook/handbook-amd64.xml?part=1&chap=10

I'll try to add it all on www.g.o early next week, or early the week after.
I receive family this weekend and I'll be away the next one, and I don't
commit anything like this unless I know I can be available in case anything
goes wrong :)


Cheers,
-- 
/  Xavier Neys
\_ Gentoo Documentation Project
/
/\ http://www.gentoo.org/doc/en/