HTML Slider Directives

Directives are commands in the definition file that cause HTML Slider to do something with the tokens that you defined. Directives are one line statements -- they cannot be continued. The first character on the line is a pound sign. The pound sign is followed by the directive name, which is in-turn followed by the directive arguments. For example:

#MakePage ./Example.html MainPageTemplate

In this example, "#MakePage" is the directive, "./Example.html" is the first argument, and "MainPageTemplate" is the second argument.

Directives are not normally not acted upon when the file is parsed. Instead, during the parsing stage, when a directive is encountered, it is stored in a queue of tasks to perform when the user clicks on the "Process" button. Stored along with the directive is the current set of token definitions, that exist in the file at the point in which the directive is found.

The #MakePage Directive

The #MakePage directive creates an output file by doing token replacement. Token replacement is explained in the following pages. #MakePage takes two arguments: the name of the output file is the first argument. The name of a token that contains the template text is the second argument. The second argument can be omitted, and if it is omitted, then the token with the name "Template" is used automatically.

The #MakeSlide Directive

The #MakeSlide directive creates an output file by doing token replacement, but with lots of special additional processing beforehand. The special processing allows you to create presentations such as slide shows, with a table of contents on every page. This special processing is described elsewhere. The output file name for #MakeSlide is determined as part of the special processing. #MakeSlide takes one arguments: the name of a token that contains the template text. This argument can be omitted, and if it is omitted, then the token with the name "Template" is used automatically.

At this point you should continue and read about token replacement.