Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP DocBook build instructions #6

Merged
merged 1 commit into from
Jan 25, 2018
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docbook/README.md
Original file line number Diff line number Diff line change
@@ -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)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@DavidFatDavidF you've mentioned in #3 (comment):

So far we are using only preliminary, built-in oXygen transforms but Jano is working on modified stylesheets for HTML and PDF

Can you provide direct links to the missing prerequisites, please?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What edition of Saxon do we use? Can we use a community edition?


### 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/
```
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This approach returns error:

Static error at fo:root on line 1 column 375 of XLIFF-EM-BP.xml_xslt:
  XTSE0150: The supplied file does not appear to be a stylesheet
The supplied file does not appear to be a stylesheet

What commands and params are you using?