Adding a floating image

Hi,

I am unable to place an image in my paragraph so that the paragraph text
flows around it. I am using saxon and the XEP processor. Where are the
values of the dbfo documented?
Here's my code:

<sidebar>
<?dbfo sidebar-width="335px"?>
<?dbfo float-type="left"?>
<para>
<imagedata fileref="img/david-bowie-001.jpg" scale="100" scalefit="1"
  width="315px" depth="445px" contentwidth="315px" contentdepth="445px"/>
</para>
</sidebar>

--

-- 
View this message in context: http://www.nabble.com/Adding-a-floating-image-tp24282778p24282778.html
Sent from the docbook General mailing list archive at Nabble.com.

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 <at> remap=Output)

thanks for any insights.
--Tim Arnold

Disabling the ToC

Re: Disabling the ToC

On 7/6/09 9:52 AM, Ken Preudhomme wrote:
> Hey all,
>
> Using DocBook 4.5 to generate my documents. I wanted to customize
> whether or not the table of contents is shown or not for specific
> documents. I was looking over the XSD but couldn't figure out how to
> disable the table of contents. Can someone point me in the correct
> direction?

I pass this to xsltproc:

   --stringparam generate.toc ''

so I suspect you'd want to set the param in your stylesheet:

   <xsl:param name="generate.toc" select="''"/>

--
Paul

indexterm in footnote

In the description of footnotes in the DocBook 5 documentation
   http://www.docbook.org/tdg5/en/html/footnote.html
under the section "Additional Constraints" it lists the following
constraint:
   indexterm must not occur in the descendants of footnote
I'm confused about how indexterms are supposed to be used in footnotes. 
Typically (I think) you have a para inside the footnote (at least that's
how the example works on that same page).  The implication of the above
constraint would then be that any indexterm in a footnote has to be outside
the text of the footnote, I guess like this:

   <para>An annual percentage rate<footnote>
   <indexterm>...prime rate...</indexterm>
   <para>The prime rate, as published in the <citetitle>Wall Street
   Journal</citetitle> on the first business day of the month,
   plus 7.0%.
   </para>
   </footnote>
   ...

Is that the intention?  One perhaps undesirable result of this would be
that if the footnote extends over two pages, the indexterm might point to
the wrong page.  Or is the expectation that in the output document, the
index would say something like "prime rate: 23 footnote 7"?

(Of course, one might say that footnotes should never extend over more than
one page.  That's a rule we academics tend to break...)

   Mike Maxwell

RE: 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
(970) 231-3624 

> -----Original Message-----
> From: Tim Arnold [mailto:Tim.Arnold <at> sas.com] 
> Sent: Thursday, July 02, 2009 11:36 AM
> To: docbook <at> lists.oasis-open.org
> 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 <at> remap=Output)
> 
> thanks for any insights.
> --Tim Arnold
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> 
> 

RE: 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 <at> frii.com]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook <at> lists.oasis-open.org
> 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
> (970) 231-3624
> 
> 
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold <at> sas.com]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook <at> lists.oasis-open.org
> > 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 <at> remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> > For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> >
> >
> 
> 

Re: 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 <at> sagehill.net

----- Original Message ----- 
From: "Tim Arnold" <Tim.Arnold <at> sas.com>
To: <docbook <at> lists.oasis-open.org>
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 <at> frii.com]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook <at> lists.oasis-open.org
> 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
> (970) 231-3624
>
>
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold <at> sas.com]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook <at> lists.oasis-open.org
> > 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 <at> remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> > For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> >
> >
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
For additional commands, e-mail: docbook-help <at> lists.oasis-open.org

RE: customize xslt or customize the schema?

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 <at> sagehill.net]
> Sent: Wednesday, July 08, 2009 1:15 PM
> To: Tim Arnold; docbook <at> lists.oasis-open.org
> 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 <at> sagehill.net
> 
> 
> ----- Original Message -----
> From: "Tim Arnold" <Tim.Arnold <at> sas.com>
> To: <docbook <at> lists.oasis-open.org>
> 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 <at> frii.com]
> > Sent: Tuesday, July 07, 2009 5:41 PM
> > To: Tim Arnold; docbook <at> lists.oasis-open.org
> > 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
> > (970) 231-3624
> >
> >
> > > -----Original Message-----
> > > From: Tim Arnold [mailto:Tim.Arnold <at> sas.com]
> > > Sent: Thursday, July 02, 2009 11:36 AM
> > > To: docbook <at> lists.oasis-open.org
> > > 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 <at> remap=Output)
> > >
> > > thanks for any insights.
> > > --Tim Arnold
> > >
> > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> > > For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> > >
> > >
> >
> >
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> 
> 
> 

RE: customize xslt or customize the schema?

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 <at> sas.com] 
Sent: Wednesday, July 08, 2009 11:02 AM
To: docbook <at> lists.oasis-open.org
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 <at> frii.com]
> Sent: Tuesday, July 07, 2009 5:41 PM
> To: Tim Arnold; docbook <at> lists.oasis-open.org
> 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
> (970) 231-3624
> 
> 
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold <at> sas.com]
> > Sent: Thursday, July 02, 2009 11:36 AM
> > To: docbook <at> lists.oasis-open.org
> > 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 <at> remap=Output)
> >
> > thanks for any insights.
> > --Tim Arnold
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
> > For additional commands, e-mail: docbook-help <at> lists.oasis-open.org
> >
> >
> 
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe <at> lists.oasis-open.org
For additional commands, e-mail: docbook-help <at> lists.oasis-open.org