Chapter 2. Getting Started

Table of Contents
2.1. Starting epcEdit
2.2. The startup dialog
2.3. What is on the screen
2.4. Opening existing documents
2.5. How a document is displayed by epcEdit
2.6. Basic editing operations

This chapter is intended to give you a quick start in using epcEdit. It demonstrates the basic facilities of epcEdit by using an example XML-document with a simple DTD that defines a book-like structure. The available elements in this DTD are:

example1

The document element that encloses the complete document content. It can contain a document title (mandatory) and any number of chapters.

title

A title element that can be used as a document title or as a title for a single chapter in the document. It can contain text, emphasized text, and footnotes.

chapter

A chapter element contains an optional title and any number of paragraphs.

para

A paragraph element can contain text, emphasized text, figures, and footnotes.

em

represents emphasized text. The type of emphasis is defined by an attribute that can have one of the values bf (bold face), it (italics), or ul(underline).

fn

is a footnote element that may contain text, emphasized text, or other footnotes.

figure

A container element for images and formulas.

image

An empty element for images. The name of the file containing the image is specified as an attribute value.

formula

A formula element that contains the formula text.

2.1. Starting epcEdit

The following paragraphs describe the methods for starting epcEdit on different operating systems. On all platforms, epcEdit will check for the existence of a license key and display an information dialog if no license key was found or if a time-restricted license key (for example for an evaluation version) is in use. The license information dialog is described in detail in The license dialog

epcEdit will not start if it can not find a valid license key or if the license key has expired.

2.1.1. Starting epcEdit on a Windows system

On a Windows system, you can start epcEdit by pressing the Start button and selecting epcEdit from the Programs menu. If you have opted to associate epcEdit with XML or SGML files during the installation process, it is sufficient to double-click on an XML or SGML document.

2.1.2. Starting epcEdit on Unix and Linux

On a Unix system, please enter the command epcedit to start epcEdit. Depending on your installation and path settings, you may need to provide the complete program path to invoke epcEdit, e.g. /usr/local/tksgml/bin/epcedit. The name of a document can be passed as an argument to epcEdit.

If epcEdit has been integrated into your desktop environment, it is sufficient to click or double-click on the epcEdit icon or start menu entry. Depending on your installation and file type associations, it may be sufficient to click or double click on an SGML or XML document.

The desktop environment integration of epcEdit is an installation issue that is outside of the scope of this document.