Can docbook and mallard co-exit? Yes - a proof of concept

[Kyle Nitzsche]

Hi,

Following my previous prototyping/implementation testing:
 (http://lists.ubuntu.com/archives/ubuntu-doc/2010-January/014293.html)

I was wondering whether we could open the door to some mallard without 
moving to all mallard.

So:  maybe a new topic on the yelp home page for "User Topics (Mallard)" 
< bad name, but its just a test to see if the docbook toc page can link 
to a mallard guide page.

Quite doable (although I could not make the ghelp link to the mallard 
guide page work, so I used a file path. Is this a known issue or am I 
doing something wrong?).

Screenshots:

Here's the Yelp home page with the new link to a mallard guide page:
 * 
http://people.canonical.com/~knitzsche/mallard.screenshots/yelp.toc.mallard.link.png

Here's that mallard page:
 * 
http://people.canonical.com/~knitzsche/mallard.screenshots/mallard.usertopics.guidepage.png

Here's the "Kvetching" mallard topic page:
 * 
http://people.canonical.com/~knitzsche/mallard.screenshots/mallard.kvetching.page.png

Conclusions:

 * With the exception of the ghelp url issue I could not resolve, it is 
perfectly doable to have a docbook page have a link to mallard
 * this opens a path to experimentation and incremental implementation

You Can Try it Out:

To try it out, install these packages from my ppa: 
https://edge.launchpad.net/~knitzsche/+archive/ppa

 * yelp (make sure it is version yelp_2.28.0-0ubuntu3dev2. It's pushed 
to LP but hasn't built yet.)
 * mallard-test (again, his is pushed, but not yet built, should be soon)
 * (and ubuntu-getting-started-guide for that content, although it is 
orthogonal to this topic)

Cheers,
Kyle