This directory contains
sgml2
an simple sgml to "anything" converter.
* Remark
This is a very early release.
I hope someone finds it as useful as I do. If so, please, give me feedback,
so I can decide to do further development with respect to the public or
my own purpose.
Feel free to email me as jw@ibch50.inf.ti-dresden.de .
* What is it good for?
Sgml2 is to convert sgml-files to "anything", where "anything" means
any document-description by ascii-files (like say TeX, roff, lout and
so on).
The output can be depending of the values of options of sgml-tags and
may in-/exclude parts depending whether an option is set or not.
Entity-definition like > can be converted to any other
representation.
A magical (yet hard-coded) input-cooking is done for regular text
(outside of markups) for easy encoding accented characters or things
like > and &. It is close to the german.sty from LaTeX. (see below)
Sgml2 does not check a document against a DTD, nor accept tag-abbreviation
(yet).
* How does it work?
o Sgml2 needs a configuration-file which is used to determine what
tag-names are known and how the affect the output. At this time only a
config-file for HTML exist (File-name html). The Format is described
at top of this File. It supports most HTML+ -tags and some
self-defined for my own use (JW as a comment, ADDR and BIBL as an
address- and bibliographi-database and some more).
Values of options assigned to Markups are represented by $(optionname)
in this file, and Text only to be included if otion optname is set may
be included ans %optname(text). see html.
More the configuration-file determines which Entity's are converted to
other representations
o Magical character-cooking on input is done for:
* german character like "a -> ä to "s ->szlig;
* "> -> >
* "< -> <
* "& -> &
* "" -> "
Any not recognized sequence is treated unchanged.
o The environment-variable SGML2LIB is used to locate the
configuration-file after looking up the current directory.
o To perform a conversion do:
sgml2 config-file-name < infile > outfile
for instance:
sgml2 html < example.sgml > example.html
* How to install?
Simply make a directory sgml2, cd into it, un-tar the archive and type make.
Then you may strip the resulting sgml2 and move it to a directory in your path.
For customization you may adjust the field "theDirs" of char* at top
of the File main.c. These are the prefixes (and order of them) used by
sgml2 to locate it's configuration-file. The configuration-file(s)
should be moved to a location referenced there or by the
envionmentvariable SGML2LIB.
If you don't have bison your yacc may complain about mrkprint.y for
any unknown reason (as on my AIX/RS 6000). For that case or if you
don't have yacc anyway the files mrkprint.c and sgml2.c are provided,
which are really mrkprint.tab.c and sgml2.tab.c from the
bison-output. So you can adjust the makefile and continue with these
files as source.
* Things to do in the future:
Feel free to email me what you would like most to see in a future
release.
- set up some files for conversion to TeX, lout, [gn]roff, man.
(Please could some good soul do this for me at least for roff and
man. I know almost nothing about them.)
- add option -n to supress output except for special requested.
- add option "-r tagname" to select the range <tagname> to
</tagname> for (non)printing.
- add the option "-t tagname" to select the output-representation of
<tagname> for (non)printing.
- extend the syntax of tagname for -t and -r to somthing like
tagname%optionname=value to restrict the selection to tags with
tagname and the option otionname set to value.
(This would let you select single Addresses or blibliographies from
a database-file.)
- add the option "-o filename" to select an output-filename
- add input-files (instead of stdin)
- anything else? Suggestions?
- it's at this time partially quick and dirty programmed; clean-up
|
