# HTMTEX Usage
# Marjan Divjak / 2012-10-01


HTMTEX USAGE

Essential files - Installation - Usage - Customization


Essential files

    HTMTEX package contains several files; two of them are
    essential:

        htmtex              Processor, a sed script
        htmtex.css          Style sheet for TEX markup


Installation

    Copy the file htmtex to a suitable directory, for example to
    /usr/local/bin. Make the script executable.

    Copy the file htmtex.css to a suitable directory where it can
    be referenced by html documents.


Usage

    To convert HTML+TEX infile into HTML outfile, filter it through
    the processor:

        htmtex infile > outfile

    or

        cat infile | htmtex > outfile


Customization

    HTMTEX understands only a limited number of Unicode characters:
    Slovenian, Greek, mathematics, and typesetting. However, it is
    very easy - by modifying the sed script htmtex - to change /
    enlarge the set of these characters.

    For example, to bind a German character "U umlaut" to the
    quote-escaped character U', you include a line

        s/U'/UTF8STRING/g

    Similarly you can bind a Japanese kanji "hito" to the
    backslash-escaped string \hito:

        s/\\hito/UTF8STRING/g

    More serious customization requires a working knowledge of the
    stream editor sed (to modify htmtex) and cascading style sheets
    (to modify htmtex.css).
  
# end    

