Re: [docbook-apps] how to add "extra" meta-info to a docbook document

[Bob Stayton <bobs at sco dot com>]

On Thu, Aug 21, 2003 at 01:48:32PM -0400, Robert P. J. Day wrote:
> On Thu, 21 Aug 2003, Bob Stayton wrote:
> 
> > If you are using the XSL stylesheets, you can
> > use the 'condition' attribute as Juan says and
> > use the profiling stylesheets, which do 
> > conditional text processing.  See:
> > 
> > http://www.sagehill.net/docbookxsl/Profiling.html
> > 
> > But I'm not sure by what you meant with
> > 
> > "embed non-DB info in a DB file"
> 
> while the actual content of the manual that will be *printed*
> will consist of only docbook tags, i'd like to bury non-docbook
> tags in the manual that i can extract later for creating web pages
> to describe those manuals.
> 
> for example, a web page for any of my courses will contain a
> "synopsis" of the course, as well as a "prerequisites" section.
> these are not valid docbook tags, but i'd like to embed info like
> that in the manual, so that *all* viewable material derived
> from a manual is contained in the manual itself.
> 
> as one solution, i guess i could just put all that info in 
> comments at the top of the docbook file.  that's one way to
> do it.

Comments are a possibility, but they can get lost
in tool chains that have more than one processing step.

If you code your extra stuff in DocBook tags, then you
can easily convert it to HTML for your webpages.
So it still sounds like you could use profiling for this
situation.  For example, add this to your manual:

<section condition="webpagestuff">
  <title>Synopsis</title>
  ...
</section>
<section condition="webpagestuff">
  <title>Prerequisites</title>
  ...
</section>

And process this with the profiling stylesheets to deselect
these sections during regular processing.  Then you could
use a separate XSL stylesheet to select only elements with
condition="webpagestuff", and then use the DocBook HTML
stylesheets to build your webpages.  


Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org