Just to add, I've made a brief video giving an overview of the
documentation system used - it's at:
In the near future, I hope to add videos that go into more depth on
some of the key design and coding aspects for this.
On Fri, Sep 28, 2012 at 5:16 PM, Michael Kay <mike@...> wrote:
> A new rendition of the Saxon 9.4 documentation is available at
> It is delivered using Saxon-CE (XSLT 2.0 running in the browser). If you
> go to the final section, "Using Help", there are some technical details
> of how it works. You can view one of the main stylesheets here:
> and navigate from here to the other stylesheets.
> The main body of the documentation is held on the server in an
> HTML5-based format, so the work of the stylesheet is much more about
> handling user interaction (including manipulation of the browser bar,
> and the search capability) than actual formatting.
> To do the Javadoc, we (Phil Fearon, actually) adapted an existing
> Javadoc doclet to generate an XML form of the Javadoc information - not
> a trivial task since the source Java comments on which it works can
> contain badly formed HTML; there are then XSLT stylesheets to browse
> this data.
> If you're interested in using any of the same technology for your own
> content, please don't hesitate to ask. It's not in any way productized
> yet, but in principle it's all resuable. The XSLT code is all on the
> site and we're quite happy for anyone to use it any way they like. We
> hope the Javadoc renderer might be of general interest, though it's by
> no means perfect yet. We might get around to making it a formal open
> source project at some stage. The XML of the documentation is also
> available for repurposing.
> Meanwhile, sorry about the continuing performance/reliability problems
> over at dev.saxonica.com. We like Redmine, but the Ruby-on-Rails
> platform on which it depends seems to have something of a reputation for
> causing memory problems. We're taking steps to move the database over to
> a specialist Redmine hosting provider who hopefully will know all the
> magic incantations needed to keep the show on the road.
> Michael Kay
> Got visibility?
> Most devs has no idea what their production app looks like.
> Find out how fast your code is with AppDynamics Lite.
> saxon-help mailing list archived at http://saxon.markmail.org/