Style sheet references

While STML allows a large variety of text markup itself, sometimes it is needed to have additional capabilities for text representation. STML allows to define symbolic indications on certain portions of the document. HTML output will convert this into references on classes defined in the style sheet of the help set, so that markup for these portions is almost unlimited.

General style sheet usage

The STML engine allows to define a style sheet for the help set. If that one is defined, it is referenced in each and any document of the set. Therefore, it is possible to change the look of all parts of the output by applying appropriate standard rules in the style sheet.

Document divisions

Sometimes, certain parts of the document have to be signed as something special, e.g. an example section, a source code section or whatever. For these cases, those parts of the document can be enclosed between the division command “:div” and “:/div”. “:div” takes the name of the division as parameter.

Note that the division parameters introduce the paradigm of start and end command for a section. This is different from all other stand-alone commands but necessary as it would not be possible to determine division ends by any other way.

Divisions are always put either directly on top of the document base or the last opened division. So, divisions can be stacked. A division which is forgotten to be ended will end at the end of the document.

Example

We assume the following style sheet definition:

.warn { background-color: red; color: black; }

Then, we can reference this style definition like this

To exchange the light bulb, remove the broken one from the socket and insert a new one.

:div warn

:h2 Warning

You **must not** touch any contacts in the socket!

:/div

With the new light bulb, you will have light again in your room.

To exchange the light bulb, remove the broken one from the socket and insert a new one.

Warning

You must not touch any contacts in the socket!

With the new light bulb, you will have light again in your room.

By the way: As you might already have thought, the example sections in this document do also make usage of the division mechanism.

In LaTeX output, div definitions are ignored and any content in them is just printed as everything else. You can, however, pass some extended configuration to the LaTeX output. If that one contains LaTeX environments (defined by \newenvironment of the same name as the div class, LaTeX output will put \begin and \end declarations for this environment into the LaTeX source code.