← Back to team overview

ubuntu-developer-manual team mailing list archive

Ubuntu branding and Improved navigation (html) with doctemplate 1.9.18

 

Hi,

Build system's "doctemplate_make_html" command now produces Ubuntu branded (init) output (for article projects) that has improved navigation: * http://people.canonical.com/~knitzsche/doctemplate_1.9.18/build/html/en/index.html

(via the default html-customization layer, which is built for, ah, easy per-project customization. Don't like it, modify your customization/ dir and point articles at it via their 'environment' file's CUSTOM variable )

(I need to get this in universe, but for now, reminder, the ppa is here: https://launchpad.net/~doctemplate-team.)

ALSO:

Now that ubuntu-developer-manual(guide) is set up with a separate 'customization' directory, I can/will easily update it to use this new html style/UI_design without having to modify any chapter(article) branches. (Each chapter is a doctemplate article project and a docbook <article>. C'mon, it's not that bad, talk to me :)

FURTHER
Simplifications through use of jQuery. Nice how this allows executing javascript when the DOM is ready in the browser *without* having to insert the "onload=myjavascriptmethod();" as an attribute of the body tag in the source html. This means I do not need to modify the html <body> element, just to run a js function onload... cool! This, in turn, means the docbook customization layer does not need to handle that, does not need to override the appropriate xsl template in the html-customization layer, which is good, good, good (simpler).

For other default outputs:
 * http://people.canonical.com/~knitzsche/doctemplate_1.9.18/build/pdf/en/
 * http://people.canonical.com/~knitzsche/doctemplate_1.9.18/build/html-site/en/
Outputs fully localized (images/translations), as previously noted (but not pushed there).
epub also supported (but not pushed there).

Cheers,
Kyle







Follow ups