[docbook-apps] Forrest 0.5 with DocBook support

[Steinar Bang <sb at dod dot no>]

According to the Apache Forrest 0.5 release announcement, made on
announcements@xml.apache.org, it contains "Rudimentary Docbook
support".

>From the "New Features" list of Forrest 0.5:
   Docbook support. The DTDs are shipped. Document types are
   automatically detected by the sitemap and there is a basic
   stylesheet which converts DocBook documents to intermediate forrest
   document-v12 for standard rendering. For rendering as full DocBook,
   see this FAQ entry.
	http://xml.apache.org/forrest/upgrading_05.html#New+Features

The "FAQ entry" link on the above page is broken, but a little
clicking about, found me this link:
	http://xml.apache.org/forrest/faq.html#docbook

>From this link:
   There are two ways. Forrest can transform the DocBook format into
   the Forrest "document" DTD on-the-fly and then render that as
   normal. The stylesheet that does this transformation still needs a
   little work but it handles most things.

   The other way is to use the DocBook stylesheets directly. The
   DocBook DTDs are shipped with Forrest and automatically
   handled. However, you will need to have the DocBook stylesheets on
   your system (they are too massive to ship with Forrest) and
   configure Forrest accordingly. You will need to create a "sitemap"
   as explained in Using Forrest and add matches to handle your
   DocBook documents, e.g.
   [snip!]
   You can also use a mixture of the two methods, some handled
   automatically by Forrest and some directly using DocBook
   stylesheets. You can also have a mixture of "document-v*" DTD and
   DocBook.

For those who doesn't know what Apache Forrest is, here's the blurb: 
   Forrest is an XML standards-oriented project documentation
   framework based on Apache Cocoon, providing XSLT stylesheets and
   schemas, images and other resources. Forrest uses these to render
   the XML source content into a website via command-line, robot, or a
   dynamic web application.


To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org.