[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#642150: RFP: docbook-xsl2 -- stylesheets for processing DocBook XML to various output formats



Package: wnpp
Severity: wishlist


* Package name    : docbook-xsl2
  Version         : 0.0
  Upstream Author : Norman Walsh
* URL             : http://norman.walsh.name/2011/08/25/docbook-xslt-2
* License         : BSD?
  Programming Lang: XSL
  Description     : stylesheets for processing DocBook XML to various output formats

First and foremost: these are XSLT 2.0 stylesheets for DocBook V5.0. They aren't expected to produce meaningful results on XSLT 1.0 processors or on DocBook V4.x (or earlier, non-namespaced variants of DocBook).

General goals
Pipeline friendliness. It's quite possible that this project could eventually require an XProc processor. It doesn't yet, but I'm trying to build things in a way that decomposes into seperable pipeline steps in an obvious way. (For example, if you said you really, really needed to process DocBook V4.5 documents with these stylesheets, I'd unflinchingly suggest a two-stage pipeline where the first stage converted your 4.5 document into 5.0.)

User friendliness. It should be easy to use the stylesheets and they should produce results that make sense. That means providing extension functions if they're necessary, supporting ancillary document types (website and slides), developing or porting new output types, etc.

If you've been using the 1.0 stylesheets and switch to the 2.0 stylesheets, there might be changes, even significant ones behind the scenes, but the output shouldn't surprise you.

Customizer friendliness. It should be easy to customize the stylesheets. That means they should be designed for reuse and they should be parameterized in useful ways.



Reply to: