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