This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Goal and Conclusion Tags


From: Jirka Kosek <jirka@kosek.cz>
To: Stephan Wiesner <stephan@stephan-wiesner.de>
CC: docbook-apps@lists.oasis-open.org
Subject: Re: DOCBOOK-APPS: Goal and Conclusion Tags
Date: Sun, 22 Sep 2002 11:33:07 +0200

Stephan Wiesner wrote:
This is clearly a solution, though I loose the logical meaning. I like
to use style sheets that can generate documents with 'only exercises' or
'only solutions' or 'whole document 'without annotations'. For this I
like to use special tags to mark my meaning.
You can use role attribute for distinguish normal section from goal,
e.g.

<section role="goal">
...
</section>

This allows you to process your document selectively and doesn't enforce
you to modify DocBook and stylesheets.
Well, whether he added special handling for 'goal' & 'conclusion', or just special handling for 'role="goal"' and 'role="conclusion"', he'd still need to supply a stylesheet wrapper to do anything special---it's just that the document can still be valid and render reasonably if he uses 'role' instead of adding his own new tags.

I'd actually suggest that if these sections are *always* going to be named "Goal" and "Conclusion", he doesn't even need to use the role attribute. I'm a bit rusty on my XSLT, but I'm 99% certain you can construct an XPath expression that selects 'section's, based specific values of their 'title' child.

Which approach one prefers is probably more stylistic. If the 'title' element of these sections is supplied in the form of an entity reference, this can be done without even committing to one or the other of the above solutions! (Since entities must be balanced, you can't put the start & end tags of the section in entities, though, so you'd have to commit to using 'section' or 'sect1', instead of a special element.)


Matt


_________________________________________________________________
Join the world’s largest e-mail service with MSN Hotmail. http://www.hotmail.com


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]