so

DocBook xslTNG-gradle

Volume 9, Issue 33; 01 Dec 2025

Introducing a Gradle plugin for transforming DocBook documents with the xslTNG stylesheets.

I’ve been trying to make DocBook, and the DocBook toolchain, easier to use. I wrote xproc (for DocBook) a few weeks ago and immediately started using it. I’ve added a shell script (I haven’t yet written the Powershell equivalent) that makes it even easier to use, if you haven’t checked that out.

I started working on a couple of websites where I wanted to be able to transform DocBook sources. I copied the little Gradle extension that I’d written for xproc (for DocBook) a couple of times, and tweaked it slightly differently a couple of times, and, oh my, no that’s wrong.

So I packaged it up as a proper Gradle extension that I could reuse. Now there’s only one place to fix bugs!

It’s xsltng-gradle ifI’ll let you in on a little secret, you can use it to run any pipeline or transformation that you want. It does a little extra work to setup the DocBook xslTNG Stylesheets, but it won’t notice if you don’t use them. you want to give it a try.

I haven’t (yet) packaged it up and published it in the official Gradle plugins repository. I’ll get to that eventually. In the meantime, I’ve hosted a tiny Maven repository on nwalsh.com to hold it.

I hope it’s reasonably well documented. There’s an example directory in the repository that demonstrates several ways to use it.

#DocBook #Gradle #MarkupMonday

Please provide your name and email address. Your email address will not be displayed and I won’t spam you, I promise. Your name and a link to your web address, if you provide one, will be displayed.

Your name:

Your email:

Homepage:

Do you comprehend the words on this page? (Please demonstrate that you aren't a mindless, screen-scraping robot.)

What is nine minus seven?   (e.g. six plus two is 8)

Enter your comment in the box below. You may style your comment with the CommonMark flavor of Markdown.

All comments are moderated. I don’t promise to preserve all of your formatting and I reserve the right to remove comments for any reason.