# Review - Epic Editor 4.0

When I was researching XML content authoring software for SitePoint’s new book publishing business, the popular choice for such work seemed to be Adobe Framemaker 7. Retrofitted in its newest version to provide for the WYSIWYG editing of XML documents, it seemed a promising lead.

Unfortunately, Framemaker’s origin as an editor for a non-standard file format really shows. To edit existing XML content in Framemaker, you must import that content into Framemaker Structured Document Format, then export it to XML again when you’re done. Those import and export processes, as well as the behaviour of the editor for a given document type, is dictated by an ‘Editing Kit’. Unfortunately, Adobe leaves largely up to you the task of creating Editing Kits for any XML document type you might want to edit.

In particular, we were interested in editing XML content in DocBook format. Framemaker comes with an Editing Kit for DocBook, but it has a number of bugs that prevent it from reading valid documents on import, and cause it to produce invalid documents on export.

Enter: Epic Editor

Arbortext Epic Editor provides the same kind of WYSIWYG editing functionality, but works with XML documents directly. With no import/export process to foul up the works, and an environment designed from the ground up to allow writers to generate valid XML documents, Epic Editor really sets a standard to which Framemaker can only aspire.

At first glance, Epic Editor’s interface looks a lot like your average word processor, the most obvious exception being the Document Map on the left-hand side of the window. The Document Map displays a structural view of the tags, attributes, and content of your document. By default, it scrolls in sync with the main editor view, so you can always see at a glance the structure of the particular document area you’re working on. You can even edit your document right in the Document Map. And for the less technical user, the Document Map can be hidden entirely.

However, once you start working with Epic Editor, you’ll quickly realise that this modern word processor interface belies a slick XML editor that lurks quietly beneath the surface.

Handy Shortcuts and Ease of Use

Once you become accustomed to the keyboard shortcuts that are available, marking up heavily-structured content in Epic Editor is an astoundingly productive experience!

The most commonly-used functions have been integrated specifically so that you can accomplish them quickly. Inserting a new element (tag), for example, simply requires you to hit the Enter key. This brings up an alphabetical pop-up menu of all the elements that can legally be added at that cursor position, or placed around the current selection. This pop-up also includes at its top a list of common structural tasks that can be performed at the current location, such as splitting a paragraph in two.

In complex document types (such as DocBook XML), the menu of elements can be quite extensive, so additional element insertion methods exist.

If you type Ctrl-I, a small pop-up window appears containing the same menu of elements, this time in a scrollable list. Typing the first few letters of the element name you want to insert will take you straight to its entry in the list, so you can insert it by hitting Enter. To quickly insert a <function> tag in a DocBook document, for example, you just type ‘Ctrl-I, F, U, Enter’. If you make a mistake while typing the element name, you just need to pause a moment, and then start typing the name from the beginning again.

Insert Markup Functionality

Finally, there is the full Insert Markup dialog box, accessible through a toolbar button. In addition to the keyboard-seeking list of legal tags as just described, it also lets you insert processing instructions, text entities, and other XML markup.

Typing Ctrl-A opens a dialog that lists the possible attributes for the current element (a toolbar button is also available). Required attributes are highlighted, and attributes with a fixed set of possible values appear as drop-down lists. When you insert a new element that has required attributes, the Attributes dialog box appears automatically for you to input them easily.

One of the most powerful structural features is support for drag-and-drop editing. Want to move a section somewhere else in your document? Simply drag its icon in the Document Map to the place you’d like to move it and let go. The mouse cursor changes during the drag operation to indicate legal and illegal drop locations, as well as locations where the editor will automatically insert new elements to make the dragged element legal there.

Word Processing Features

All this XML editing power, yet Epic Editor still manages to offer most of the amenities of modern word processors as well. Toolbar buttons and keyboard shortcuts are provided for most common formatting commands (e.g. the bold toolbar button inserts an <emphasis role="bold"> tag in DocBook XML mode). Multi-level undo/redo and document change tracking work as expected. And the real-time spell check (with red jagged underlines for misspelled words) and thesaurus are welcome writing tools. The built-in dictionary, however, is somewhat dated, so expect to spend some time adding words like ‘Internet’, ‘download’, and ‘configuration’ to the custom dictionary if you plan to write anything technical. Fortunately, this is a painless, one-click process for each word.

Advanced features are many and varied, and most are disabled by default so as not to confuse novice or non-technical users. The Find/Replace feature can be set to use regular expressions, and match markup (tags and attributes) instead of just document content. An "Edit Selection as XML Source" feature lets you get your hands dirty and work at the code level when you need to (such instances are surprisingly rare!). Tag name aliases, editing behaviour, and WYSIWYG formatting are all fully configurable when you need them.

An Editor For the Big Jobs

In short, Epic Editor is the ideal choice for the WYSIWYG editing of medium-to-large XML content. It handled a ~300 page, heavily structured, technical book without even breaking a sweat, and is far superior to any competitors I could find. In fact, the only downside to this program is that no evaluation version is available for download, so you’ll just have to take my word for it.

Epic Editor 4.3 is available now for Windows, Solaris, and Unix (not Linux).

Product: Epic Editor 4.3 (Arbortext)
Price: US$860 More Information: Visit arbortext.com Replay Category: programming Time: 2003-02-05 Views: 1 Tags: ## Related post • CMS for a review site 2010-09-05 This question already has an answer here: Which Content Management System (CMS)/Wiki should I use? 1 answer Possible Duplicate: Best CMS for review-type sites Hi, what's the better CMS/theme for a review site? It will be a site about movie reviews fr • The Best Markdown Editor for Windows 2015-02-04 Markdown, originally written as a Perl script by John Gruber and Aaron Swartz in 2004, has caught fire and the technology has exploded into many different forms of "text to HTML" markup engines. The original Markdown code has largely been unchan • Rediscovering the obvious 2004-09-20 (Rant alert: you have been warned) Been plowing through The Art of Unix Programming, which, in general, is excellent – should be required reading for anyone developing software. Joel Spolsky wrote a good critique under the title Biculturalism, at the • What features are missing from Python IDE tools? 2011-02-03 What are the most desired features currently lacking in any Python IDE tools? I'm also interested in what's missing in Komodo 6 but available in other tools (I currently use Komodo 6 for Python 3 under Windows). [I am asking for this to be made commu • How to pay more attention to detail as a developer? 2011-09-10 Are there any resources for paying more attention to detail as a software developer? (Especially edge cases, or small mistakes in code, details in the problem description, ramifications for certain changes to a large system) Some thoughts so far: - B • Recording Screencasts as Animated GIFs 2012-02-22 Your customers and readers are inundated with text and images daily, and the challenge of every writer and marketer is to cut through the clutter to present something unique and useful. One way to quickly share information, examples, or a series of i • Add a new post status in the post progression 2012-04-03 I run a site with about 30 authors and 3 editors. Authors submit posts for review, and editors schedule or publish them. It would be useful to have another post status of "Editing" between Pending Review and Scheduled/Published. I realize there' • What is 'System Environment'? 2012-12-12 I am currently self-studying software engineering and the theory that guides it. I started reading about SRS Document and to clarify the things I downloaded a sample SRS document. It had something called 'System Environment'. Can you please, in simpl • Same command is used more than one number of time but i am getting only last output 2014-12-21 I am defined \editor{strong text} and \reviewer{strong text} command is used more than one number of time. But, I am getting only last \editor{Some Text} command output. My class file defined this command below mentioned way: \def\@editor{} \def\edit • Stop users of author role from editing already pending posts 2015-04-10 I want to stop authors from being able to constantly edit posts that are already pending review from editors. To clarify; I already have code in my theme that sets live posts to pending and that works fine... function published_to_pending($post_id) {

• Contributor post to be reviewed and published by only one editor 2013-09-23

I am trying to find a way/plugin where the posts of a contributor can only be edited or published by a specific user editor. Like for example, if I have a contributor named Steve and an editor named Bob, Steve's posts/draft should only be reviewed an

• A Review of the Brackets Editor 2014-04-18

This article is going to take a look at Brackets, an open-sourced editor originally developed by Adobe. It may not have had quite the same level of publicity and hype as Atom, GitHub's new lightweight editor, but it's a promising option for the front

• Code reviewing in the presence of strong type inference and basic editors 2011-04-25

I'm curious to know how folks deal with comparative code reviews (version x against y of a file) in the presence of strong type inference, that is when 'var' (in C#) or 'auto' (in C++ 0x) is used in place of the older more verbose (explicit) type dec

• 6 Online Document and Text Editors Reviewed 2014-04-18

Who wants to limit himself to one computer nowadays? Say hello to online editors, where you can login in anywhere you want and start (or continue where you left off) right away. And some of these editors come pretty close to advanced text editors lik

• Review: Affinity Photo - A New Image Editor Contender? 2015-03-10

The problem with a lot of reasonably priced image editing programs is the fact that they lack a lot of features that professionals need to get the job done. When you sacrifice the price, you typically sacrifice the features you can expect to see. Aff

• Hemingway Editor 2 Review 2015-07-23

In 2014, Jacco Blankenspoor took a look at Hemingway Editor's new desktop app. At the time, Jacco decided he'd rather stick with the online version of Hemingway-not least because of a display bug in the desktop version. Now, a year later, our residen

• Review - Macromedia Contribute 2002-11-26

Do you want to be able to easily update your site through a friendly interface, or give your clients the opportunity to update the sites you created for them without the fear of them ruining the design or server-side code? Do you want to benefit from

• Review - Hot Text: Web Writing That Works 2004-02-07

Do you want to be a writer online? This book can teach you how to write for the Web. Besides just being a tool that will help you to improve your writing, however, it also gives you tips on writing your resume, corresponding with editors, getting pai

• Review - vBulletin 3.0 2004-03-13

vBulletin is commonly used to create interactive communities on a huge scale. This PHP-based bulletin board has been employed on some of the most well known Websites, including Linkin Park, SitePoint and Winamp, to name a few. Known for its extensive