Building Documentation Yourself

Documentation which is written in Docbook XML can be quite easily converted into other formats. This page deals with converting to HTML. If you are interested in converting to PDF format, see ["/PDF"]

1. Set up a copy of the docteam svn repository as described on [:DocumentationTeam/Repository:Repository page]. If you want the latest documents, get the svn trunk. If you want to build documents for existing Ubuntu releases, get the appropriate svn branch as described on that page.

2. Install at least the following packages: make & docbook-xsl.

3. Open a terminal and change to the appropriate directory (ubuntu-doc/ubuntu, ubuntu-doc/edubuntu, ubuntu-doc/kubuntu or ubuntu-doc/generic).

4. Type:

   make all

This command will build HTML versions of all the documents available.

Generally there are a number of other make targets which you can use to build specific or miscellaneous documents. Read through the Makefile to discover what these are.

Note: Previews of all docteam work in progress are also available on http://docteam.ubuntu.com

Note: You will see a lot of warnings like the following, which can be safely ignored:

• No localization exists for "c" or "". Using default "en".

CategoryDocteam