3 ms·
Before I forget: yes, hand-editing XML is no fun. I did this for years when writing the 'Slackware Basics' book. It is tedious and annoying, even with the excel
by danieldk 16y ago
Before I forget: yes, hand-editing XML is no fun. I did this for years when writing the 'Slackware Basics' book. It is tedious and annoying, even with the excellent nxml-mode for emacs.
For Natural Language Processing for the Working Programmer, we use the <oXygen/> XML editor, which really takes the pain out of writing DocBook documentation. It provides WYSIWYG mode that also renders inline or xincluded XML, such as SVG and MathML. I rarely switch back to the non-WYSIWYG mode, unless I want to reorder some elements quickly.
- cemerick 16y agoFYI, asciidoc is great, provides a pipeline to docbook (and thence on to PDF), and is a joy to edit (not quite as concise as, say, markdown, but not ambiguously-defined, either). See my other comment on this thread about it.
- danieldk 16y agoasciidoc is nice, but the tag set in DocBook is far broader. Also, DocBook makes it easy to add new elements. But if you need just the basic functionality of DocBook, it is great.
- cemerick 16y agoTrue enough. I've needed some bits of docbook that don't have a direct asciidoc corollary twice, and just used asciidoc passthrough blocks to use them. It's a very practical solution to a leaky abstraction, while allowing me to stay in asciidoc 99.7% of the time.