The move to custom XML

Donald Smith dss-lfs at cfl.rr.com
Tue May 20 08:36:25 PDT 2003


Timothy Bauscher wrote:
> On Tue, May 20, 2003 at 01:44:48AM +0200, Matthias Benkmann wrote:
> 
>>>1. acknowledgements.xml
>>>
>>><sect type="page" id="ch01-acknowledgments"
>>>file="acknowledgements.html"><title>Acknowledgments</title>
>>
>>I don't like the use of attributes. Attributes are completely unnecessary
>>when doing custom XML and avoiding them makes XSLT rules simpler, because
>>you don't have to ask yourself "Hmm. Was 'title' an attribute of sect or
>>an extra tag?"

I very much agree with MSB's entire post, most importantly with the 
above paragraph.

>>>4. Emphasis
>>>
>>><warning>Don't forget to install Emacs</warning>
>>
>>If you can, be more specific than just "<warning>". What's the reason for
>>this warning? Put this in the tag name. Yeah, it makes the name ugly but
>>if you ever feel the need to extract/locate/format only a certain kind of
>>warning you'll be thankful for that extra information.
> 
> 
> Can you provide an example?

I don't know what MSB had in mind, but I would put something like 
<WILLNOTCOMPILE> or <GIVESRANDOMERRORS>. The advantage is that you could 
extract a trouble shooting guide from the same XML as the book.

-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe lfs-dev' in the subject header of the message



More information about the lfs-dev mailing list