Doc Template (Was: Doc-team members going to UDS?)

Kyle Nitzsche kyle.nitzsche at
Fri Oct 16 19:39:59 UTC 2009

Jim Campbell wrote:
> On Fri, Oct 16, 2009 at 12:57 PM, Ian <vern at> wrote:
>> Hi
>>> I am hoping to hold a session on 'doctemplate.' This is a 'template'
>>> I've been developing hosted on LP (
>>> that allows one to create new documentation:
>>>  * Whose source is docbook (article or book)
>>>  * That is easily localizable (images, strings)
>>>  * That supports numerous localized outputs: pdf, html (with a
>>> javascript-based UI with a navigation TOC, next/previous buttons, etc),
>>> docbook
>>>  * All controlled by a few simple and well-documented make commands.
>>>  * Optional installation with package installation such that it is
>>> registered with rarian for display in yelp.
>>>  * String localization can be done in LP in a straightforward manner.
>> Some more ideas:
>> When you sign up to the doc team through LP, the first thing you’ll do
>> is check the  project you want out of bazaar
>> You send stuff by checking it in
>> The continuous build system will let you see your contributions
>> formatted as it will be printed in pdf/html etc.
>> And, if your contribution contains code it is kept in separate source
>> code files and the build system will include the extracts you want
>> directly into the formatted final document (and it’ll syntax highlight
>> them along the way).
>> I will be @ UDS for the meeting
Looking forward to seeing you there, Ian, and talking more about these 
>> Ian
>> --
> I've started this as a new thread.  I'm hopeful that this project
> could be made to work with Mallard syntax (the xml-based syntax that
> is being used for new upstream GNOME documentation) 
If Mallard provides xslt transforms that convert it into html (like 
nwalsh's do for docbook) then this is possible. As a first step, I 
assume the source is a docbook article or book. Mallard looks very 
interesting, but I don't really know enough about it yet.

> and that it could
> also support translations via Transifex, one of the main FLOSS
> translation tools.
My first goal is LP integration.
> Is this at all a possibility?
Everything is possible! (Some things are more likely than others ;)
> Jim

More information about the ubuntu-doc mailing list