2  Sample format files

mistie.scm -f plain.mistie input.doc > input.html

plain converts the characters <, >, &, and " to their HTML encodings. One or more blank lines are treated as paragraph separation.

plain provides a small set of control sequences geared for manual writing. The default escape character is \ (backslash). Typically, arguments of plain's control sequences are specified within braces ({...}), as in TeX or LaTeX.

\i typesets its argument in italic. E.g., \i{italic} produces italic. Other control sequences in this vein are \b for bold and \small for small print.

\p puts its argument in monospace fixed font and is used for program code. If it is not convenient to enclose \p's argument in braces (e.g., the enclosed code contains non-matching braces), then the argument may be specified by the placing the same character on each side. (This is like LaTeX's \verb.) Another useful feature of the \p control sequence: If its argument starts with a newline, it is displayed with the linebreaks preserved.

Use \title for specifying a document's title, which is used as both the internal title and the external (bookmarkable) title.

\stylesheet{file.css} causes the resulting HTML file to use the file file.css as its style sheet. A sample style sheet mistie.css is included in the distribution.

\section, \subsection, \subsubsection produce numbered section headers of the appropriate depth. \section*, etc., produce unnumbered sections.

\urlh{URL}{TEXT} typesets TEXT as a link to URL.

\obeylines{...} preserves linebreaks for its argument. Note that this is dissimilar in call, though not in function, to TeX's {\obeylines ...}.

\flushright is like \obeylines, but sets its argument lines flush right.

\input FILE or \input{FILE} includes the contents of FILE.

\eval evaluates the following Scheme expression.

\scmkeyword (prog1 block)

\scmconstant (true false)

A style sheet (see plain.mistie) is used to set the colors. The style sheet mistie.css, provided with this distribution, has the following style class settings:

.scheme {
color: brown;
}

.scheme .keyword {
color: #cc0000;
font-weight: bold;
}

.scheme .variable {
color: navy;
}

.scheme .number,.string,.char,.boolean,.constant {
color: green;
}

.scheme .comment {
color: teal;
}

The class .scheme specifies the background punctuation style, and the various subclasses, -- .keyword, .variable, etc. -- specify the styles for the various syntactic categories. Note that we have combined the subclasses for numbers, strings, etc., into one, but you can separate them out if you want to distinguish between them.

You may wish to modify these settings for your documents. Additionally, there are browser-specific ways you can use to override the settings of other authors' documents.

Navigation bars at the bottom allow the user to travel across the pages.

\bibitem can be used to enumerate bibliographic entries. \cite{BIBKEY} points to the entry introduced by \bibitem{BIBKEY}. \cite's argument can list multiple keys, with comma as the separator.