[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:       Jaromir Hradilek <jhradile () redhat ! com>
Date:       2013-11-18 22:28:27
Message-ID: 528A948B.6090005 () redhat ! com
[Download RAW message or body]

On 11/18/2013 05:39 PM, Shaun McCance wrote:
> 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.

For the record, this is what I do on a regular basis and the difference 
in rendering is not that significant. What I really love about yelp is 
how fast it renders a reasonably large page (or even an unreasonably 
large one) in comparison with other tools. And if you ever find some 
time to fix bug 704821 [1], it will be a killer app.

[1] https://bugzilla.gnome.org/show_bug.cgi?id=704821
-- 
Jaromir Hradilek
Supervisor, Content Services

Red Hat Czech, s. r. o.
Purkynova 99
612 45 Brno, Czech Republic
-- 
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]