Upcoming UI changes for UNR: Customizing Yelp's Home Page

Shaun McCance shaunm at gnome.org
Tue Sep 15 23:01:12 UTC 2009


On Tue, 2009-09-15 at 17:56 -0400, Kyle Nitzsche wrote:
> I am aware of mallard, which sounds great and raises such interesting 
> questions as:
>     > Could Ubuntu help be re-factored using mallard (someday) to 
> separate UI details (this button does this, that check box does that, 
> etc.) from other content in order to enable content reuse in multiple 
> 'wrapper' docs, for example, to enable making a troubleshooting guide 
> that re-uses the single-sourced UI documentation content (currently the 
> UI documentation is mixed together with other content).
> 
> I am not aware of an upstream effort to move from run-time transform of 
> docbook into html (which is a slowish process) towards a help viewer 
> that assumes run-time x/html files and uses theme-based dynamic css (via 
> the gtk theme change signal I mentioned previously). (Which doesn't mean 
> such activities do not exists!) This approach is not inconsistent with 
> docbook or mallard (both of which have xslt that converts them to html). 
> Docbook and mallard could be the definitive single source. They would be 
> transformed to x/html at build time though, not run-time. Which means, 
> among other thing, the help viewer could be any browser, such as the 
> webkit one I have made, or Firefox...

The single most compelling feature of Mallard is that you can
drop pages into a document and have links to them appear from
other pages in the document.  I don't see how we can possibly
do this without any run-time processing.

The performance issues in Yelp are, by and large, not a result
of the XSLT.  They're mostly a result of excessive or poorly
executed disk access.  If anybody wants to talk about this,
the correct place to do it would be upstream.

--
Shaun






More information about the ubuntu-doc mailing list