opubWriter

For two weeks I have been grappling manfully with treeview data bindings and nested repeater event bubbles to create a new look for opubWriter. I realised that I was trying to do too much on the ‘Content’ screen – edit documents, add and remove documents, and rearrange the table of contents – so I have split this functionality to create two new screens.

The Editor screen simply shows the table of contents as a treeview and the wysiwyg editing area, along with a Save button. A significant improvement is that opubWriter can now create and handle book structures of arbitrary depth – hence the nested repeater event bubbles.

New Editor screen

This following screenshot shows four levels. To display a document, you click on its name in the treeview.

The plus and minus icons can be used to expand and collapse the divisions of the book so you can bring the part you’re working on conveniently into view.

The screenshot also shows that the editing area can be resized to match your preference.

One feature that’s slightly less attractive than before is that I’ve removed the ‘save’ option from the editing area and replaced it with a ‘Save’ button. I couldn’t get the tinyMCE plugin to work reliably, and there are risks that it will behave differently in different browsers. I notice that WordPress and Blogger both have separate Save buttons, so opubWriter is in good company in that respect.

The next screenshot shows the Navigation tab of the Organisation screen.

Organisation/Navigation screen

On this screen you also see the hierarchical structure of the book, but this time you don’t expand and collapse the view.

To the left of each content document  you will see a group of icons each of which represents an action you can perform. The icons and their meanings are listed in the table below.

	Download the content document.
	Delete the content document.
	Move the content document up within its level.
	Move the content document down within its level
	Save the title of the content document.

The download option allows you to save a single content document, which you might want to do in order to upload it into another book. This post show you how to do that below. This action keeps the document in the current publication and doesn’t affect it in any way.

The delete option allows you to remove a content document completely from the publication. Obviously, you must think carefully before taking this action. For instance, you might want to take a copy of the .epub file or download the content document before you delete it.

The actions to move a content document up and down in the reading order act only at the current level of the document. Where a content document is the first one at its level e.g. the Introduction to Part 1 in the screenshot, the ‘move up’ icon is not shown. Conversely, a document which is the last at its level does not have a ‘move down’ icon. If you really must promote or demote a content document to a different level, the approach is to save it first by downloading it and then uploading it to its new position. Again, uploading a content document is explained below.

The ‘save’ action refers to the text of the table of contents entry. You can use this option to change the text displayed in the table of contents. Technically, this will be saved in the NCX file of the epub in the <navLabel><text> element.

The second tab to mention on the Organisation screen is the Content tab. This provides the ability to add new content at any position within an epub publication. The new content document can either be created from scratch using details you provide or it can be uploaded from an existing content document on your computer system.

The screenshot below shows the Organisation/Content screen.

Organisation/Content screen

To create a new content document, you enter three pieces of information:

1. The entry to appear in the table of contents.
2. A unique filename for the document.
3. An optional document heading.

 To upload an existing content document, you use the Browse button to locate the file on your computer system; then you enter the following two pieces of information:

Having selected the source of the new content, you then select where it will go. There is a dropdown list that lets you specify a relative position which contains the following options:

1. The entry to appear in the table of contents.
2. A unique filename for the document.

The document relative to which the new content is placed is selected in the next dropdown list. The entries in this list show the full path to each document. This allows you to distinguish between, for instance, “PART ONE/Chapter 5″ and “PART TWO/Chapter 5″.

The screenshot shows the Content screen completed and ready for the Create button to be clicked.

Notice there’s also a tab on the Organisation screen called ‘Spine’. At some point this will be developed to allow control over the reading sequence defined by the spine and the ability to change the ‘linear’ attribute of a spine item which identifies content as primary or  auxiliary.