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

[Vikram Dhillon]

Kyle, that's an amazing idea, we can have the best of both worlds, we
could use the topic-based approach and still borrow some stuff from
docbook, that we might need. I would like to work on this idea with
you so can we meet on IRC sometime.

-- 
Regards,
Vikram Dhillon

~~~
There are lots of Linux users who don't care how the kernel works, but
only want to use it. That is a tribute to how good Linux is.
-- Linus Torvalds

On Sat, Jan 23, 2010 at 10:30 AM, Kyle Nitzsche
<kyle.nitzsche at canonical.com> wrote:
> 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
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>