RE: [docbook-apps] Support for callout extensions in xsltproc

[Jeff Beal <jeff.beal@ansys.com>]

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/saxon651.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
> 
> 
>