From cb177d0d395cc7f92fa8617c4b23c1775caa3bff Mon Sep 17 00:00:00 2001 From: TerAleS Date: Thu, 25 Jan 2018 13:22:50 +0200 Subject: [PATCH] WIP Initial draft of DocBook build instructions --- docbook/README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docbook/README.md diff --git a/docbook/README.md b/docbook/README.md new file mode 100644 index 0000000..0cce46f --- /dev/null +++ b/docbook/README.md @@ -0,0 +1,25 @@ + +# Sources of the documentation are written in the DocBook format + +It builds automatically when you push your changes to the GitHub, +but you may want to check how it looks before pushing changes. + +To check how it looks without pushing changes you have to prepare your +machine to build DocBook 5.1. + +## Build + +If you are new to DocBook and XLST precessor check out good introductory video +["Installing and Using Saxon for your XSLT Development" by Peter K. Johnson](https://youtu.be/FsDq2-VV0Uo) + +### Prerequisites + +* [Java 8](https://www.java.com/en/download/) +* [Saxon-PE](http://www.saxonica.com/download/java.xml) + +### Building + +Run from the project root folder: +``` +java -jar saxon9pe.jar -xsl:./docbook/T1/WG3/XLIFF-EM-BP.xml_xslt -s:./docbook/T1/WG3/ -o:./docs/ +```