Henry's Notes
The Basics
- turn <foo>.xsl into <foo>.dsl:
xslj -c /usr/contrib/share/lib/xml/catalog
<foo>.xsl > <foo>.dsl
- use jade to get the output:
jade -d <foo>.dsl -c
/usr/contrib/share/lib/xml/catalog <foo>.xml
The Official LT-XML documentation
File Locations
I've rationalised and reconstructed all of this, but some people may
therefore not find everything where they expect.
Sources and FSF emacs byte-compiled files are in
/usr/contrib/share/lib/emacs/lisp/psgml
and
/usr/contrib/share/lib/emacs/lisp/xml.
Info files are in
/usr/contrib/share/info.
XED
I've written a structure-smart editor for XML document instances (no
DTDs) called xed, which is now available in /usr/contrib/bin.
Invoke it with no arguments to start creating your own XML documents,
or with the name of an existing (well-formed) XML document to edit,
and you're off. The Help button will show you a summary of available
commands and keystrokes.
This is an alpha release, I'm sure there will be bugs. Please send me
LOTS of detailed information when it doesn't work, crashes, or even
doesn't work the way you'd like it to.
There is one weakness in the current release: entity references will
be replaced by their definitions in all cases except < and &.
XML
Continuing our efforts to make more support for XML available, I've
reorganised the library files and added new tools and resources:
- /usr/contrib/share/lib/xml
now has a number of useful things, including templates for XML
(using my simple document DTD) and XSL files:
empty-doc.xml
empty-sheet.xsl
Try 'xed /usr/contrib/share/lib/xml/empty-doc.xml'
- /usr/contrib/share/lib/sgml
now has up-to-date TEI and HTML4 dtd files plus other goodies.
- /usr/contrib/bin/jade is the latest test release, set up to work
with XML input by default -- use /usr/contrib/bin/sjade for SGML.
- The latest versions of all the SP tools (nsgmls, spam, sgmlnorm,
spent, sx) are installed in /usr/contrib/bin, with
/usr/contrib/share/lib/sgml/catalog as the built-in catalog default.
- A validator for XML files is available as /usr/contrib/bin/nsgmlx.
- Tools to render XML files conformant to my simple document DTD into
HTML and RTF are available as
/usr/contrib/bin/doc2html
/usr/contrib/bin/doc2rtf
These take a single XML file as input and produce an HTML or RTF file
as output. /usr/contrib/share/lib/xml/sample.xml is an illustrative
example.
The up-to-date documentation for this release is in /usr/contrib/share/doc/sgml
as HTML files.
For application developers, the 16-bit libraries (sp-m, spgrove, grove
and style) and headers are in place in /usr/contrib/{lib,include}.
Bibliography
- An uptranslator for bibtex reference output which would produce an XML
file with the appropriate information;
- a style-sheet which would turn such a file into an HTML file with
paragraph per entry, tagged <a name='[citation tag]'>...</a>;
- A <cite cite-tag='...'/> tag into my simple doc.dtd;
- A style-sheet fragment for XML-to-HTML which turns <cite
cite-tag='xyzzy'/> into <a href='http://...../#xyzzy'>xyzzy</a>, where
the URL is a parameter and points to the file output from (2) above;
- A style-sheet fragment for XML-to-print which turns <cite
cite-tag='xyzzy'/> into e.g. [xyzzy] AND sucks the relevant XML text from
the output of (2) up and formats it into the References section.