eyestep . org

eyestep edge

the edge markup language

EDGE is a SGML based markup language designed for generic
documents. It aims to be as general as necessary for the every day document
and text production. It is not limited to a specific type of documents,
like technical documentation or encoding of books.

It has a modular layout, very similar to that of the TEI dtd.
Beside a small core set of tags for hierachical structuring of documents
(like book, article, or set) and core markup
(like paragraphs, lists and examples), it provides a list of additional
markup sets. It very simple to extend EDGE by adding new sets of tags.

EDGE is an application of SGML, like HTML or DocBook. So
everything you know about other DTDs is useful for EDGE, too.

The EDGE markup language is only a dtd. So tagging documents
and texts can be done in a application indepandant way. It is used to
markup documents in a semantic way. But the real world wants to use
documents, and therefore special tools are needed to work with text marked
up in such a way. The EDGE dtd is accompignated by a set of DSSSL
stylesheets. They are used to render generic EDGE documents for printing
or for HTML.

download

You can always download the most recent version of EDGE -
including the DTD, stylesheets, tools, etc. - from sourceforge, either by
getting released packages, or by checking out the newest versions from CVS.
Released versions are normally better tested and are simpler to
install.

Released versions

Go to sourceforge download pages to donwload released versions.
The various parts EDGE are available seperately, so you can get only the
parts you really need.

Please note that the packages of EDGE does not include the
necessary third party software, like SGML processors, a DSSSL stylesheet
engine, etc. You have to get those packages seperately. All additional
software is available as OpenSource. See section further on for
details.

Get EDGE by CVS

The newest versions of EDGE are always available from the CVS.
To access the CVS follow these steps. Login to the CVS server first:

cvs -d":pserver:anonymous@cvs.edgeml.sf.net:/cvsroot/edgeml" login

and press the return key, when asked for a password. Then check
out the module you need:

cvs -d":pserver:anonymous@cvs.edgeml.sf.net:/cvsroot/edgeml" co -P module

Replace module with one of the following modules:

	:	dtd - the EDGE DTD
	:	stylesheet - a set of stylesheets for printing and html generation
	:	documentation - the dtd documentation
	:	site - the edge home page sources

Requirements

EDGE is designed to work as application independent as possible.
Therefore the requirements are recommendations really.
You normally will need the following software, if you're working with
EDGE:

	:	a SGML processor (incl. parser, validator, etc.).
	:	You can use any; the jade (or OpenJade) package is a good choice.
	:	if you want to use the EDGE stylesheets (edge-dsssl) you need a DSSSL engine; OpenJade is here a good choice too.

The EDGE stylesheet package includes some bash scripts to
make life more easy. These needs a working bash shell, and
some standard tools available on UN*X/POSSIX platforms, like
basename, dirname, sed, etc. The absence of this tools
doesn't make the stylesheet package unusable on system not
providing them (e.g. Windows).

To edit EDGE files you can use the text editior of your choice,
a good opensource SGML editor with DTD support is psgml mode
for the emacs editor

feedback

EDGE is an open source project. Everyone is welcome to
contribute. Feedback is welcomed and requested. Please check the
project page on sourceforge for further
details and discussion lists, or contact me privatly (gck at eyestep dot org).