Jump to: navigation, search

Mylyn/Docs/EPUB/Editor

< Mylyn‎ | Docs‎ | EPUB
Revision as of 12:44, 6 July 2012 by Torkildr.gmail.com (Talk | contribs)

EPUB Editor (DRAFT)

Currently the supporting UI only allows for one single file to be assembled into an EPUB. The only other option is to write a rather extensive Ant task. While this is useful when doing headless builds - an EPUB editor could be very useful when wanting to assemble the more complex publications.

The basic idea is to introduce a new file type; .epubspec which describes an EPUB, it's contents and various options for converting Wikitext Markup if applicable. It should be possible to open this file into an editor especially designed to handle it. The editor should handle all aspects of an EPUB hence placing as few limits as possible on the author.

Editor features

Epub-editor page1.png

The editor should be based on Eclipse forms with a few logically grouped pages.

  1. Overview
    1. The overview section contains the most important metadata such as title and author. The title area holds warnings and errors pertaining to that area.
    2. The Play button is used to build the EPUB
    3. The Export button is used to export the build to an Ant script
    4. The Verify button is used to perform a "deep" verification of the EPUB.
    5. The Help button will open Eclipse Help on the subject
    6. Additional properties are author and contributor specifications along with other properties that can be added
  2. Spine
    1. An editable list of all pages that are in the reading order.
    2. Activating (double click) a page will open the appropriate editor; whether it be XHTML, or Wiki Markup
  3. Manifest
    1. An editable list of all items.
    2. Activating (double click) a page will open the appropriate editor.
  4. Design
    1. Conversion (wiki markup conversion options).
    2. Style sheets for Wiki Markup conversion to XHTML
    3. Cover page image

General features

  • When an EPUB specification is added to a project, the project's build specification should be updated to include a builder for this file type.
  • The builder shall locate all .epubspec files found in the project and build the associated EPUB file when executed.
  • It should be possible to convert .epubspec files to Ant scripts