WYSIWYG DocBook: XMLMind Personal Edition

XMLmind logoXMLMind Personal Edition comes with a license that allows you to edit documentation for open source software under a Creative Commons license, such as the core documentation for OpenAM, OpenDJ, OpenIDM, and OpenICF.

Here is a bit more than my last notes on XMLMind. Out of the box, XMLMind Personal Edition lets you edit DocBook 5 XML in near WYSIWYG. I tried opening the OpenDJ admin guide first:

XMLmind-perso

Some notes follow for those of you authoring with XMLMind Personal Edition.

  • Only the currently open file is read-write.
    If the document is set up as a top-level book that references chapter/appendix/reference files with XInclude, then you must open the individual, included documents in order to edit them.
  • Adding paragraphs, itemized lists, ordered lists, tables, figures, is easy.
    If you want to add an item to a variable list, however, you need to select another whole varlistentry from the nested list at the top of the window, and then right-click to Insert Before… or Insert After…
  • Unfortunately, saving a file results in reformatting. Thus svn diff says the whole file has changed. Fine if you are essentially writing or rewriting a whole chapter, but not so fine if you are editing a single line, or fixing a few typos.
Advertisements

1 Comment

Filed under Tools

One response to “WYSIWYG DocBook: XMLMind Personal Edition

  1. XMLMind 5.0.0 is out this week, http://www.xmlmind.com/xmleditor/changes.html#v5.0.0.

    The editor still changes a file even if you don’t edit it, but you do get close to WYSIWYG editing.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s