[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fedora-docs-list
Subject:    Re: Lowering the participation barrier for Fedora Docs
From:       Shaun McCance <shaunm () gnome ! org>
Date:       2013-11-18 16:39:57
Message-ID: 1384792797.2998.189.camel () recto
[Download RAW message or body]

On Sat, 2013-11-16 at 19:21 -0500, Christopher Antila wrote:
> - - There is a significant barrier to entry. DocBook is clumsy at first, and 
> writing XML markup by hand is always a pain (maybe I'm just not using the 
> right tools). As far as I know, the only way to preview the final output is by 
> actually making the final output, so DocBook needs a bit of imagination.

Yelp renders DocBook on the fly. If you're running GNOME, it's already
installed. Auto-reload isn't currently hooked up for DocBook (it is for
Mallard), but that's fixable.

Of course, Yelp's rendering will differ from Publican's, so you'll want
to use Publican for final proofing. But putting Yelp and a text editor
side-by-side is a nice way to see a preview of what you're writing.

--
Shaun


-- 
docs mailing list
docs@lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs
[prev in list] [next in list] [prev in thread] [next in thread]