Differences

This shows you the differences between two versions of the page.

--- mantisbt:docbook [2016/07/03 10:53] – Add subtitle for Publican setup in Mantis 1.3 and later dregad
+++ mantisbt:docbook [2016/07/03 11:26] (current) – [MantisBT 1.3 and later] added new section's contents dregad
@@ Line 39: / Line 39: @@
 ===== Building a DocBook Manual =====
+==== MantisBT 1.3 and later ====
+GNU Make files are present in each DocBook's directory, allowing easy build with a single command.
+To build all DocBooks in default //html-desktop// format <code>
+cd /path/to/mantisbt/docbook
+make
+</code>
+To process a specific DocBook, first go to the corresponding directory, e.g. for Administrator's Guide <code>cd /path/to/mantisbt/docbook/Admin_Guide
+</code>
+then execute the appropriate command:
+  * Build it in default (//html-desktop//) format <code>make</code>
+  * Validate the XML files, without building the DocBook <code>make test</code>
+  * Build a PDF <code>make pdf</code>
+  * Clean build in all available formats <code>make clean all</code>
+This is just a few examples, refer to the [[https://github.com/jhradilek/publican-makefile|Makefile's documentation]] for further details.
+It is also possible to manually execute Publican, e.g. <code>
+publican build --langs=en-US --formats=html-desktop,pdf
+</code>
+==== MantisBT 1.2 ====
 We will use the Developer's Guide in English as the example manual for this process, which is in the ''developers/en/'' directory.  You can substitute any other manual or language, assuming the manual exists and has been translated to that language.