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

[Kyle Nitzsche]

Jim Campbell wrote:
> On Fri, Oct 16, 2009 at 12:57 PM, Ian <vern at riseup.net> wrote:
>   
>> Hi
>>     
>>> I am hoping to hold a session on 'doctemplate.' This is a 'template'
>>> I've been developing hosted on LP (https://launchpad.net/doctemplate)
>>> 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 
ideas.
>> Ian
>>
>> --
>> http://ianlawrence.info
>>
>>     
>
> 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
>