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@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs
