ubuntu-manual team mailing list archive
Mailing list archive
Re: [UCLP] [Reminder] Collaberation meeting
Regarding docbook ease of use and suitability, a while ago I put
together a build system (I call it doctemplate) for docbook that was
designed to maximize certain values:
* extreme ease of use
* multiple output formats, all localized (currently two forms of html,
* localization of text and images
* separation of content (including translations and images) from build
infrastructure (so there is no irreversible commitment to doctemplate).
* for pdf output, ability to specify font per language
* built-in per-output format docbook customization layers and
parameters. For pdfs this means customizable tables of contents, front
pages, profiles, etc. etc.
* autogeneration of localized omf files (for installing docs in
gnome-like systems such as ubuntu)
I packaged it up and pushed it up to a doctemplate Launchpad PPA:
If anyone would like to give it a try, just:
(1) add the ppa:
(2) install doctemplate:
sudo apt-get install doctemplate
(3) create a new directory for the new docbook article and move into it:
(4) create the article:
* the article/ directory contains "sample-article.xml'. That's where
you can start editing if you like.
* articles are set up by default for four languages: en, es, ru, zh_TW
(see the LINGUAS) file
(6) build html (first type):
(6a) view it in, for example, Russian, by opening: build/html/ru/index.html
Note that all generated output files are placed in build/ directory and
this can be deleted at any time.
(7) build html (second type):
(7a) view it in, for example, Russian, by opening: build/html/ru/index.html
(8) build pdfs in all target languages:
(8a) view, Russian pdf:
(9) build epub (ebook):
(9a) view Russian epub ebook:
(install fbreader: sudo apt-get install fbreader)
I need to update docs (they are so old as to be wrong and confusing),
and perhaps revisit this project if folks find it useful.
Docbook articles are supported, books have some issues. But since
articles have a structure that is is very appropriate for short topic
based help, this seems applicable.
On 07/10/2010 07:47 PM, Kevin Godby wrote:
Hello, Phil and, er, Phill.
On Sat, Jul 10, 2010 at 6:25 PM, Phil Bull<philbull@xxxxxxxxx> wrote:
Frustratingly, my Internet connection went down before the meeting, and
only just came back up. Does anyone have logs for the meeting that I can
You can read the logs of the meeting here:
This week, each team (manual, docs, and learning) are going to work on
writing a sample in the following formats: Docbook 5, HTML 5, Mallard,
and DITA. This way we can get a feel for the various formats, their
pros and cons, and also explore how the writing styles differ among
the materials produced by each team.
I encourage everyone to post questions, notes about what they've
learned, opinions, etc. to the mailing lists throughout the week.