https://github.com/oreillymedia/docbook2htmlbook
XSL Transform to convert Docbook XML to HTMLBook
https://github.com/oreillymedia/docbook2htmlbook
Last synced: 20 days ago
JSON representation
XSL Transform to convert Docbook XML to HTMLBook
- Host: GitHub
- URL: https://github.com/oreillymedia/docbook2htmlbook
- Owner: oreillymedia
- Created: 2013-06-21T19:45:52.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-03-11T17:26:41.000Z (about 2 months ago)
- Last Synced: 2025-03-11T17:47:18.495Z (about 2 months ago)
- Language: XSLT
- Homepage:
- Size: 351 KB
- Stars: 19
- Watchers: 78
- Forks: 7
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
docbook2htmlbook
================
This script is currently in development and converts [DocBook XML](http://www.docbook.org/) to [HTMLBook](https://github.com/oreillymedia/HTMLBook).
It's written in XSLT 2.0, so you'll need to run it with an XSLT 2.0 processor.
### Running the Script
Run these commands to output the HTMLBook:
```java -jar saxon9he.jar -s:book.xml -o:book.xml unwrapblocks.xsl```
```java -jar saxon9he.jar -s:book.xml -o:book.html docbook2htmlbook.xsl```
If you're starting with DocBook 5, run the DB 5 to DB 4 converter first:
```java -jar saxon9he.jar -s:book.xml -o:book.xml db5to4.xsl```
```java -jar saxon9he.jar -s:book.xml -o:book.xml unwrapblocks.xsl```
```java -jar saxon9he.jar -s:book.xml -o:book.html docbook2htmlbook.xsl```
#### Optional parameters
* Output xref label text by running conversion with parameter ```xref_label``` set to ```true```. For example:
```java -jar saxon9he.jar -s book.xml -o book.asc docbook2htmlbook.xsl xref_label=true```
### Validating the Output
You can validate the output against the HTMLBook Schema, found [here](https://github.com/oreillymedia/HTMLBook).