mantisbt:docbook
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
mantisbt:docbook [2012/04/30 11:46] – dregad | mantisbt:docbook [2016/07/03 11:26] (current) – [MantisBT 1.3 and later] added new section's contents dregad | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Working with DocBook Manuals ====== | ====== Working with DocBook Manuals ====== | ||
- | |||
===== Required Tools ===== | ===== Required Tools ===== | ||
- | No special tools are needed to edit DocBook files, | + | No special tools are needed to edit DocBook files, |
+ | |||
+ | In order to build the manuals | ||
+ | |||
+ | |||
+ | ==== MantisBT 1.3 and later ==== | ||
+ | |||
+ | MantisBT 1.3 uses [[https:// | ||
- | For Debian-based Linux distributions, | ||
< | < | ||
- | | + | $ sudo apt-get |
</ | </ | ||
- | The command below installs the toolchain on Ubuntu-based systems (tested successfully on Ubuntu 12.04 desktop) | + | This was tested successfully on Ubuntu 14.04 LTS, but should work with older versions too. |
+ | |||
+ | |||
+ | ==== MantisBT 1.2 ==== | ||
+ | |||
+ | To build MantisBT 1.2 documentation, | ||
+ | |||
+ | The command below installs the toolchain on **Ubuntu**-based systems (tested successfully on Ubuntu 12.04 LTS and 13.04 desktop) | ||
< | < | ||
- | | + | $ sudo apt-get install docbook docbook-dsssl docbook-slides docbook-utils linuxdoc-tools make openjade xmlto |
</ | </ | ||
- | For Fedora-based | + | For **Debian**-based |
< | < | ||
- | | + | $ sudo aptitude install docbook docbook-dsssl docbook-slides docbook-utils linuxdoc-tools make openjade xmlto |
</ | </ | ||
+ | For **Fedora**-based distros, run this command instead: | ||
+ | < | ||
+ | $ su -c 'yum groupinstall " | ||
+ | </ | ||
===== Building a DocBook Manual ===== | ===== Building a DocBook Manual ===== | ||
+ | |||
+ | ==== MantisBT 1.3 and later ==== | ||
+ | |||
+ | GNU Make files are present in each DocBook' | ||
+ | |||
+ | To build all DocBooks in default // | ||
+ | cd / | ||
+ | make | ||
+ | </ | ||
+ | |||
+ | To process a specific DocBook, first go to the corresponding directory, e.g. for Administrator' | ||
+ | </ | ||
+ | |||
+ | then execute the appropriate command: | ||
+ | |||
+ | * Build it in default (// | ||
+ | * Validate the XML files, without building the DocBook < | ||
+ | * Build a PDF < | ||
+ | * Clean build in all available formats < | ||
+ | |||
+ | This is just a few examples, refer to the [[https:// | ||
+ | |||
+ | It is also possible to manually execute Publican, e.g. < | ||
+ | publican build --langs=en-US --formats=html-desktop, | ||
+ | </ | ||
+ | |||
+ | ==== MantisBT 1.2 ==== | ||
We will use the Developer' | We will use the Developer' |
mantisbt/docbook.1335800794.txt.gz · Last modified: 2013/05/10 09:11 (external edit)