OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] PACBook announce

On Fri, 17 Jul 2015, Dew, Simon wrote:


I'm pleased (also slightly nervous) to announce the PACBook project.
This is a suite of linguistic pre-processing stylesheets for XML
documentation, primarily aimed at DocBook.

The project is hosted here:


The stylesheets deal with two inter-related areas:

1. Translating documents;

2. The linguistic consequences of transclusion and / or conditional

Users of Publican may be interested to know that, among many other
things, these stylesheets attempt to address the linguistic problems
mentioned here:


Although I'm using these stylesheets daily (along with the DocBook XSL
stylesheets) and have been for years, this is not a 1.0 release.
Documentation is, ironically, a work in progress ? see the doc folder or
the wiki, and unit tests are basically non-existent.

I'm happy to offer these stylesheets to the DocBook community in the
hope that someone will find them useful. Contributions are welcome.

Thank you for posting this. Is there a location where the HTML documents can be read rather than seen unrendered in GitHub?

The Readme could benefit from a little expansion. What *are* "the linguistic consequences of transclusion and/or conditional processing"? How do I know if I'm suffering from them? (Like the first time reading about a medical condition, I'm starting to feel like I might already have this. Is it normal for XSL to hurt?)

How does this package help make it better?


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]