customize xslt or customize the schema?

[Tim Arnold]

Hi, I'm trying to decide how best to solve a problem I have with some tech documentation.
The doc is originally in LaTeX and I'm converting to DocBook 5 (using plasTeX). The doc contains both Figure and 'Output'  elements.
When rendered, a Figure is numbered as chapter.figure

The 'Output' element is like a  Figure, but appears only in Examples, and is numbered as chapter.example.output

There are of course references to both Figures and Outputs.

Which way should I go for this situation--add a new element by customizing the schema or customize the xsl stylesheets to use different numbering and gentext? I can differentiate between the two with xpath. (something like this: chapter//figure versus chapter/example/figure@remap=Output)

thanks for any insights.
--Tim Arnold



---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Richard Hamilton-2]

Tim,

To the extent that I understand what you are trying
to do, I think I'd go with customizing the stylesheet.
I prefer not to mess with the schema unless I have to.

Dick Hamilton
---------------------------------
XML Press
XML for Technical Communicators
http://xmlpress.net
[phone]

> -----Original Message-----
> From: Tim Arnold [mailto:Tim.Arnold@...]
> Sent: Thursday, July 02, 2009 11:36 AM
> To: docbook@...
> Subject: [docbook] customize xslt or customize the schema?
>
>
> Hi, I'm trying to decide how best to solve a problem I have
> with some tech documentation.
> The doc is originally in LaTeX and I'm converting to DocBook
> 5 (using plasTeX). The doc contains both Figure and 'Output'  
> elements.
> When rendered, a Figure is numbered as chapter.figure
>
> The 'Output' element is like a  Figure, but appears only in
> Examples, and is numbered as chapter.example.output
>
> There are of course references to both Figures and Outputs.
>
> Which way should I go for this situation--add a new element
> by customizing the schema or customize the xsl stylesheets to
> use different numbering and gentext? I can differentiate
> between the two with xpath. (something like this:
> chapter//figure versus chapter/example/figure@remap=Output)
>
> thanks for any insights.
> --Tim Arnold
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@...
> For additional commands, e-mail: docbook-help@...
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Tim Arnold]

Hi Dick,
I'd rather customize the stylesheet too, but now that I'm actually trying to validate, I get this from the oNVDL validator:

error: assertion failed:
  figure must not occur in the descendants of example

So I guess I'm going to *have* to customize the schema since my 'Output' always occurs in examples.

rats.

thanks,
--Tim

> -----Original Message-----
> From: Dick Hamilton [mailto:rlhamilton@...]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook@...
> Subject: RE: [docbook] customize xslt or customize the schema?
>
> Tim,
>
> To the extent that I understand what you are trying
> to do, I think I'd go with customizing the stylesheet.
> I prefer not to mess with the schema unless I have to.
>
> Dick Hamilton
> ---------------------------------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> [phone]
>
>
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold@...]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook@...
> > Subject: [docbook] customize xslt or customize the schema?
> >
> >
> > Hi, I'm trying to decide how best to solve a problem I have
> > with some tech documentation.
> > The doc is originally in LaTeX and I'm converting to DocBook
> > 5 (using plasTeX). The doc contains both Figure and 'Output'
> > elements.
> > When rendered, a Figure is numbered as chapter.figure
> >
> > The 'Output' element is like a  Figure, but appears only in
> > Examples, and is numbered as chapter.example.output
> >
> > There are of course references to both Figures and Outputs.
> >
> > Which way should I go for this situation--add a new element
> > by customizing the schema or customize the xsl stylesheets to
> > use different numbering and gentext? I can differentiate
> > between the two with xpath. (something like this:
> > chapter//figure versus chapter/example/figure@remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe@...
> > For additional commands, e-mail: docbook-help@...
> >
> >
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Bob Stayton]

Hi,
Why not map your Output element to <example role="Output">, and not use
<figure> in it at all?  In DocBook 5, figure and example have the same
content model.

Bob Stayton
Sagehill Enterprises
bobs@...


----- Original Message -----
From: "Tim Arnold" <Tim.Arnold@...>
To: <docbook@...>
Sent: Wednesday, July 08, 2009 10:02 AM
Subject: RE: [docbook] customize xslt or customize the schema?


Hi Dick,
I'd rather customize the stylesheet too, but now that I'm actually trying to
validate, I get this from the oNVDL validator:

error: assertion failed:
  figure must not occur in the descendants of example

So I guess I'm going to *have* to customize the schema since my 'Output'
always occurs in examples.

rats.

thanks,
--Tim

> -----Original Message-----
> From: Dick Hamilton [mailto:rlhamilton@...]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook@...
> Subject: RE: [docbook] customize xslt or customize the schema?
>
> Tim,
>
> To the extent that I understand what you are trying
> to do, I think I'd go with customizing the stylesheet.
> I prefer not to mess with the schema unless I have to.
>
> Dick Hamilton
> ---------------------------------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> [phone]
>
>
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold@...]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook@...
> > Subject: [docbook] customize xslt or customize the schema?
> >
> >
> > Hi, I'm trying to decide how best to solve a problem I have
> > with some tech documentation.
> > The doc is originally in LaTeX and I'm converting to DocBook
> > 5 (using plasTeX). The doc contains both Figure and 'Output'
> > elements.
> > When rendered, a Figure is numbered as chapter.figure
> >
> > The 'Output' element is like a  Figure, but appears only in
> > Examples, and is numbered as chapter.example.output
> >
> > There are of course references to both Figures and Outputs.
> >
> > Which way should I go for this situation--add a new element
> > by customizing the schema or customize the xsl stylesheets to
> > use different numbering and gentext? I can differentiate
> > between the two with xpath. (something like this:
> > chapter//figure versus chapter/example/figure@remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe@...
> > For additional commands, e-mail: docbook-help@...
> >
> >
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...




---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Rowland, Larry]

Hello Tim,

You could also try mapping it to something other than a figure.  While the screen and screenshot elements are not formal objects with titles and numbering, they are valid children of example and may map semantically to what "Output" did in the original.  You would need to populate the xreflabel with the value of whatever provided the title of the original "Output" element, but it would provide a valid document without modifying the schema.  This may not be the most appropriate mapping, but you might want to look at whether mapping to other elements that are valid children of an example would work before hacking the schema.

Just a thought.

Best Regards,
Larry

-----Original Message-----
From: Tim Arnold [mailto:Tim.Arnold@...]
Sent: Wednesday, July 08, 2009 11:02 AM
To: docbook@...
Subject: RE: [docbook] customize xslt or customize the schema?

Hi Dick,
I'd rather customize the stylesheet too, but now that I'm actually trying to validate, I get this from the oNVDL validator:

error: assertion failed:
  figure must not occur in the descendants of example

So I guess I'm going to *have* to customize the schema since my 'Output' always occurs in examples.

rats.

thanks,
--Tim

> -----Original Message-----
> From: Dick Hamilton [mailto:rlhamilton@...]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook@...
> Subject: RE: [docbook] customize xslt or customize the schema?
>
> Tim,
>
> To the extent that I understand what you are trying
> to do, I think I'd go with customizing the stylesheet.
> I prefer not to mess with the schema unless I have to.
>
> Dick Hamilton
> ---------------------------------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> [phone]
>
>
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold@...]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook@...
> > Subject: [docbook] customize xslt or customize the schema?
> >
> >
> > Hi, I'm trying to decide how best to solve a problem I have
> > with some tech documentation.
> > The doc is originally in LaTeX and I'm converting to DocBook
> > 5 (using plasTeX). The doc contains both Figure and 'Output'
> > elements.
> > When rendered, a Figure is numbered as chapter.figure
> >
> > The 'Output' element is like a  Figure, but appears only in
> > Examples, and is numbered as chapter.example.output
> >
> > There are of course references to both Figures and Outputs.
> >
> > Which way should I go for this situation--add a new element
> > by customizing the schema or customize the xsl stylesheets to
> > use different numbering and gentext? I can differentiate
> > between the two with xpath. (something like this:
> > chapter//figure versus chapter/example/figure@remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe@...
> > For additional commands, e-mail: docbook-help@...
> >
> >
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Tim Arnold]

thanks for that idea--now I have my Examples in the Examples section mapped to
<section role="example">
and my Outputs mapped to
<example role="output">

and the doc is validating. I wasn't thinking of an 'example' in the right way.

much thanks,
--Tim

> -----Original Message-----
> From: Bob Stayton [mailto:bobs@...]
> Sent: Wednesday, July 08, 2009 1:15 PM
> To: Tim Arnold; docbook@...
> Subject: Re: [docbook] customize xslt or customize the schema?
>
> Hi,
> Why not map your Output element to <example role="Output">, and not use
> <figure> in it at all?  In DocBook 5, figure and example have the same
> content model.
>
> Bob Stayton
> Sagehill Enterprises
> bobs@...
>
>
> ----- Original Message -----
> From: "Tim Arnold" <Tim.Arnold@...>
> To: <docbook@...>
> Sent: Wednesday, July 08, 2009 10:02 AM
> Subject: RE: [docbook] customize xslt or customize the schema?
>
>
> Hi Dick,
> I'd rather customize the stylesheet too, but now that I'm actually trying to
> validate, I get this from the oNVDL validator:
>
> error: assertion failed:
>   figure must not occur in the descendants of example
>
> So I guess I'm going to *have* to customize the schema since my 'Output'
> always occurs in examples.
>
> rats.
>
> thanks,
> --Tim
>
> > -----Original Message-----
> > From: Dick Hamilton [mailto:rlhamilton@...]
> > Sent: Tuesday, July 07, 2009 5:41 PM
> > To: Tim Arnold; docbook@...
> > Subject: RE: [docbook] customize xslt or customize the schema?
> >
> > Tim,
> >
> > To the extent that I understand what you are trying
> > to do, I think I'd go with customizing the stylesheet.
> > I prefer not to mess with the schema unless I have to.
> >
> > Dick Hamilton
> > ---------------------------------
> > XML Press
> > XML for Technical Communicators
> > http://xmlpress.net
> > [phone]
> >
> >
> > > -----Original Message-----
> > > From: Tim Arnold [mailto:Tim.Arnold@...]
> > > Sent: Thursday, July 02, 2009 11:36 AM
> > > To: docbook@...
> > > Subject: [docbook] customize xslt or customize the schema?
> > >
> > >
> > > Hi, I'm trying to decide how best to solve a problem I have
> > > with some tech documentation.
> > > The doc is originally in LaTeX and I'm converting to DocBook
> > > 5 (using plasTeX). The doc contains both Figure and 'Output'
> > > elements.
> > > When rendered, a Figure is numbered as chapter.figure
> > >
> > > The 'Output' element is like a  Figure, but appears only in
> > > Examples, and is numbered as chapter.example.output
> > >
> > > There are of course references to both Figures and Outputs.
> > >
> > > Which way should I go for this situation--add a new element
> > > by customizing the schema or customize the xsl stylesheets to
> > > use different numbering and gentext? I can differentiate
> > > between the two with xpath. (something like this:
> > > chapter//figure versus chapter/example/figure@remap=Output)
> > >
> > > thanks for any insights.
> > > --Tim Arnold
> > >
> > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: docbook-unsubscribe@...
> > > For additional commands, e-mail: docbook-help@...
> > >
> > >
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@...
> For additional commands, e-mail: docbook-help@...
>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...