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: [docbook-apps] Support for callout extensions in xsltproc


Without XSLT customization it is pretty much useless.  File an RFE at
SourceForge, and maybe something at least could get in.  I might poke at
this a little bit and see what I can come up with.  I've created a
customization around mediaobjectco that creates HTML imagemaps, and this
shouldn't be much harder.  (Assuming I'm thinking correctly.)

Jeff

> -----Original Message-----
> From: Kenneth Johansson [mailto:ke-joh@sectra.se]
> Sent: Friday, August 08, 2003 5:38 AM
> To: Jeff Beal
> Cc: DOCBOOK-APPS
> Subject: RE: [docbook-apps] Support for callout extensions in xsltproc
> 
> 
> Sorry, but I'm no programmer and probably wouldn't be able to 
> make the customization required.
> 
> If the XSL stylesheets or tools doesn't support callout bugs 
> in images the mediaobjectco is useless at this point, or am I wrong?
> 
> /Kenneth
> 
> > -----Original Message-----
> > From: Jeff Beal [mailto:jeff.beal@ansys.com]
> > Sent: Thursday, August 07, 2003 17:10
> > To: 'Kenneth Johansson'
> > Cc: DOCBOOK-APPS
> > Subject: RE: [docbook-apps] Support for callout extensions 
> in xsltproc
> > 
> > 
> > There isn't any support for image callouts.  You'd probably 
> have to use
> > inline CSS in your document to handle this one.  The XSLT 
> customization
> > would probably be a little hairy, just because all of the 
> mediaobject code
> > is a little hairy.  I think what you would need, though, 
> would be to put a
> > style="position:relative" on an HTML <DIV> that contains 
> the <IMG> and all
> > of the callouts.  Your areas would probably have to output 
> something like
> > 
> > <SPAN style="position: absolute; left: 12px; top:
> > 147px">callout_graphic</SPAN>
> > 
> > You may also have to play with the z-index property to be sure 
> > the callouts
> > are rendered on top of the graphic.
> > 
> > Jeff
> > > -----Original Message-----
> > > From: Kenneth Johansson [mailto:ke-joh@sectra.se]
> > > Sent: Thursday, August 07, 2003 11:06 AM
> > > To: Kenneth Johansson; Jeff Beal; Bob Stayton
> > > Cc: DOCBOOK-APPS
> > > Subject: RE: [docbook-apps] Support for callout 
> extensions in xsltproc
> > > 
> > > 
> > > I managed to fix my problems with programlistingco. I'd made 
> > > a bad customization.
> > > 
> > > Oh, forgot to say that Saxon didn't solve my problem of 
> > > getting callout bugs in my image either. Here's what I tried:
> > > 
> > > <mediaobjectco>
> > >   <imageobjectco>
> > >     <areaspec id="options" units="calspair">
> > >       <area coords="12 147" id="options1" />
> > > 
> > >       <area coords="197 140" id="options2" />
> > > 
> > >       <area coords="456 88" id="options3" />
> > > 
> > >       <area coords="260 290" id="options4" />
> > > 
> > >       <area coords="260 320" id="options5" />
> > > 
> > >       <area coords="12 392" id="options6" />
> > >     </areaspec>
> > > 
> > >     <imageobject>
> > >       <imagedata fileref="images/options_dialog.gif" format="GIF"
> > >       scale="100" scalefit="" />
> > >     </imageobject>
> > > 
> > >     <calloutlist>
> > >       <callout arearefs="options1">
> > >         <para>This list shows the current configuration 
> and commands
> > >         that are assigned to a shortcut.</para>
> > >       </callout>
> > > 
> > >       <callout arearefs="options2">
> > >         <para>Shows the current shortcut assigned to the 
> > > command.</para>
> > >       </callout>
> > > 
> > >       <callout arearefs="options3">
> > >         <para>This list shows the the commands that are 
> available but
> > >         not used. </para>
> > >       </callout>
> > > 
> > >       <callout arearefs="options4">
> > >         <para>Define a shortcut for a command by typing in 
> > > the shortcut
> > >         combination in the edit box.</para>
> > >       </callout>
> > > 
> > >       <callout arearefs="options5">
> > >         <para>The entered shortcut is checked to see if 
> it is already
> > >         assigned to a command.</para>
> > >       </callout>
> > > 
> > >       <callout arearefs="options6">
> > >         <para>The path to the currently selected menu or window is
> > >         displayed in the path box.</para>
> > >       </callout>
> > >     </calloutlist>
> > >   </imageobjectco>
> > > </mediaobjectco>
> > > 
> > > Have I missed anything? The image is 615x501 pixels.
> > > 
> > > 
> > > 
> > > 
> > > > -----Original Message-----
> > > > From: Kenneth Johansson [mailto:ke-joh@sectra.se]
> > > > Sent: Thursday, August 07, 2003 13:29
> > > > To: Jeff Beal; Bob Stayton
> > > > Cc: DOCBOOK-APPS
> > > > Subject: RE: [docbook-apps] Support for callout extensions 
> > > in xsltproc
> > > > 
> > > > 
> > > > Hi,
> > > > 
> > > > I've moved to Saxon but I get some strange errors:
> > > > 
> > > > When using programlistingco (haven't tried any other elements 
> > > > using callouts) the callouts are not put on the correct 
> line, but 
> > > > one below. It seems like the segments between the callouts are 
> > > > their own tables which must be wrong?!
> > > > 
> > > > I also get errors like: "Chapter 1. Writing Documentation" 
> > > > (should be Chapter 1. Writing Documentation).
> > > > 
> > > > My command line: 
> > > > ke-joh:13> java com.icl.saxon.StyleSheet -o writing.html 
> > > > writing-documentation.xml 
> > > > 
> ../../lib/docbook-xsl/custom_stylesheets/stylesheets/xhtml/customx
> > > > html.xsl use.extensions=1
> > > > 
> > > > My param customizations:
> > > > <xsl:param name="use.extensions" select="'1'"/>
> > > > 
> > > > <!-- Default file extension for HTML output -->
> > > > <xsl:param name="html.ext" select="'.html'"/>
> > > > 
> > > > <!-- Base directory for HTML output -->
> > > > <xsl:param name="base.dir" select="'html/'"/>
> > > > 
> > > > <!-- Should first section be chunked too? -->
> > > > <xsl:param name="chunk.first.sections"/>
> > > > 
> > > > <!-- Include admonition graphics? -->
> > > > <xsl:param name="admon.graphics" select="'1'"/>
> > > > 
> > > > <!-- Default admonitions graphics path -->
> > > > <xsl:param name="admon.graphics.path" select="'../../images/'"/>
> > > > 
> > > > <!-- Admonition graphics extension format -->
> > > > <xsl:param name="admon.graphics.extension" select="'.png'"/>
> > > > 
> > > > <!-- Callout graphics path -->
> > > > <xsl:param name="callout.graphics.path" 
> > > > select="'../../images/callouts/'"/>
> > > > 
> > > > <xsl:param name="callout.graphics" select="'1'"></xsl:param>
> > > > 
> > > > <xsl:param name="callouts.extension" select="'1'"></xsl:param>
> > > > 
> > > > <xsl:param name="callout.graphics.extension" 
> > > select="'.png'"></xsl:param>
> > > > 
> > > > <xsl:param name="saxon.extensions" select="'1'"/>
> > > > 
> > > > Thanks,
> > > > 
> > > > /Kenneth
> > > > 
> > > > 
> > > > 
> > > > > -----Original Message-----
> > > > > From: Jeff Beal [mailto:jeff.beal@ansys.com]
> > > > > Sent: Wednesday, August 06, 2003 14:51
> > > > > To: 'Kenneth Johansson'; Bob Stayton
> > > > > Cc: DOCBOOK-APPS
> > > > > Subject: RE: [docbook-apps] Support for callout 
> > > extensions in xsltproc
> > > > > 
> > > > > 
> > > > > It shouldn't be very difficult at all.  As for which is 
> > > > preferable, Saxon
> > > > > seems to have been more stable for longer, and its 
> performance is 
> > > > > comparable
> > > > > to xsltproc's (for chunked HTML output) on my Windows 
> > > 2000 machine.
> > > > > 
> > > > > Both programs are written in Java, so your first step is to 
> > > > > install a recent
> > > > > version of a Java Runtime Environment.  (I recommend 
> version 1.4 
> > > > > or greater
> > > > > because some of the XML parsing is built into the JRE 
> after 1.4.) 
> > > > >  You may,
> > > > > of course, already have one somewhere, so you would just need 
> > > > to make sure
> > > > > it's in your path.  (If you need any help with that, I 
> > > can help you
> > > > > off-line.  I've had to find and install JRE's on just about 
> > > > every platform
> > > > > except for Macintosh.)
> > > > > 
> > > > > Once your JRE is installed, go to saxon.sourceforge.net 
> > > and download the
> > > > > "recommended" version of Full saxon.  (Instant Saxon 
> only works 
> > > > > on Windows,
> > > > > and doesn't perform as well or have as much 
> functionality because 
> > > > > it relies
> > > > > on the Microsoft JVM.)  Once you've installed that, 
> you'll want 
> > > > to include
> > > > > the paths to saxon.jar and saxon651.jar (from the DocBook XSL 
> > > > > distribution)
> > > > > in your CLASSPATH environment variable (e.g.
> > > > > 
> /some_path/saxon/saxon.jar:/some_path/docbook-xsl/extensions/saxon
> > > > > 651.jar --
> > > > > use a semi-colon instead of a colon on Windows platforms.)
> > > > > 
> > > > > To run Saxon, you just need to invoke the Java 
> interpreter and 
> > > > pass it the
> > > > > name of the Saxon class (com.icl.saxon.StyleSheet) as an 
> > > > > argument, followed
> > > > > by Saxon's arguments as documented with the Saxon 
> > > distribution: "java
> > > > > com.icl.saxon.StyleSheet {args}"
> > > > > 
> > > > > Jeff
> > > > > 
> > > > > > -----Original Message-----
> > > > > > From: Kenneth Johansson [mailto:ke-joh@sectra.se]
> > > > > > Sent: Wednesday, August 06, 2003 3:28 AM
> > > > > > To: Bob Stayton
> > > > > > Cc: DOCBOOK-APPS
> > > > > > Subject: RE: [docbook-apps] Support for callout 
> > > extensions in xsltproc
> > > > > > 
> > > > > > 
> > > > > > Hi,
> > > > > > 
> > > > > > That is unfortunate for me. Would it be difficult to change 
> > > > > > my set up to Xalan or Saxon? Which is preferrable? I 
> > > also use FOP. 
> > > > > > 
> > > > > > best regards,
> > > > > > 
> > > > > > /Kenneth
> > > > > > 
> > > > > > > -----Original Message-----
> > > > > > > From: Bob Stayton [mailto:bobs@sco.com]
> > > > > > > Sent: Tuesday, August 05, 2003 18:27
> > > > > > > To: Kenneth Johansson
> > > > > > > Cc: DOCBOOK-APPS
> > > > > > > Subject: Re: [docbook-apps] Support for callout 
> extensions 
> > > > > > in xsltproc
> > > > > > > 
> > > > > > > 
> > > > > > > On Tue, Aug 05, 2003 at 05:55:15PM +0200, Kenneth 
> > > Johansson wrote:
> > > > > > > > Hi,
> > > > > > > > 
> > > > > > > > I've run in to the problem where callouts are 
> not showing
> > > > > > > > up in the programlisting in a programlistingco. Browsing
> > > > > > > > the mail archive I see that there is no support 
> for callout
> > > > > > > > extensions in libxslt. Is this still the case? 
> Will there
> > > > > > > > be any support included within a near future? I've just
> > > > > > > > learned to use xsltproc and don't want to switch to a
> > > > > > > > new processor.
> > > > > > > 
> > > > > > > I haven't seen any evidence of progress on implementing
> > > > > > > Norm's extension functions for xsltproc.  I doubt you will
> > > > > > > see it in the near future.  If you require such 
> an extension,
> > > > > > > you will need to use Saxon or Xalan.  
> > > > > > > 
> > > > > > > -- 
> > > > > > > 
> > > > > > > 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
> > > > > > 
> > > > > > 
> > > > > > 
> > > > > 
> > > > > 
> > > 
> ---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: 
> > > docbook-apps-unsubscribe@lists.oasis-open.org
> > > > > For additional commands, e-mail: 
> > > docbook-apps-help@lists.oasis-open.org
> > > > > 
> > > > > 
> > > > 
> > > > 
> > > > 
> > > 
> ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: 
> > > docbook-apps-unsubscribe@lists.oasis-open.org
> > > > For additional commands, e-mail: 
> > > docbook-apps-help@lists.oasis-open.org
> > > > 
> > > > 
> > > 
> > > 
> > > 
> > 
> 
> 
> 

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


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