Special Tags

• <* comment *> insert comments
• <$exec> execute shell commands during conversion
• <$if> <$else> conditional conversion
• <$include> include a file
• <$insert> insert several stuff
• <$LET> set global attributes
• <$macro> define macro-tags
• <$message> display user message
• <| don't parse |> don't parse section

<* This is a hsc-comment *>

And you can comment out sections of html-source without any problems for the browser. This simply is possible because comments in the HSC-source are not written to the HTML-object.

Of course, if you need the standard comments, you can use

<!-- This is a html/sgml-comment -->

    <$EXEC COMMAND="command">

<$if (__SYSTEM__="AMIGA")>

<$exec COMMAND="list >t:hugo.list DIRS">   <* write listing to "t:hugo.list" *>
<$include FILE="t:hugo.list" SOURCE PRE>   <* include directory list *>
<$exec COMMAND="delete t:hugo.list QUIET"> <* remove temporary file *>

<$else><$if (__SYSTEM__="UNIX")>

<$exec COMMAND="ls -al >hugo.list">       <* write listing to "t:hugo.list" *>
<$include FILE="hugo.list" SOURCE PRE>    <* include directory list *>
<$exec COMMAND="rm hugo.list">            <* remove temporary file *>

<$else>

<* unknown OS: abort conversion with error message *>
<$message text="operating system not supported" class="fatal">

</$if></$if>

inc                          Dir ----rwed Today     17:48:21
image                        Dir ----rwed Thursday  07:10:36
features                     Dir ----rwed Yesterday 04:10:17
macro                        Dir ----rwed Thursday  06:45:15
exmpl                        Dir ----rwed Yesterday 03:43:59
5 directories - 10 blocks used

<$INCLUDE FILE="filename" [SOURCE] [PRE]>

To include a source file, eg a C- or HTML-source so that the tags are not interpreted but displayed, add the optional boolean attribute SOURCE.

<$INCLUDE FILE="hugo.c" SOURCE>

Note that this does not include a <PRE>-tag to render the text as it exists with the same line breaks and spaces.

To get this done, you should use the optional boolean attribute PRE. This inserts a <PRE> before the included data and a </PRE> afterwards.

<$INSERT what [options]>

Insert current date and time

<$INSERT TIME>

Optionally, you can pass a format-string, that discribes the time. As hsc just calls the ANSI-C function strftime() to perform that task, I've included an extract of the man-pages to this function:

        Each conversion specification is replaced by the characters as follows
        which are then copied into the buffer.

         %A    is replaced by the full weekday name.

         %a    is replaced by the abbreviated weekday name, where the abbreviation
              is the first three characters.

         %B    is replaced by the full month name.

         %b or h
              is replaced by the abbreviated month name, where the abbreviation
              is the first three characters.

         %C    is equivalent to ``%a %b %e %H:%M:%S %Y'' (the format produced by
              asctime(3).

         %c    is equivalent to ``%m/%d/%y''.

         %D    is replaced by the date in the format ```mm/dd/yy'''.

         %d    is replaced by the day of the month as a decimal number (01­31).

         %e    is replaced by the day of month as a decimal number (1­31); single
              digits are preceded by a blank.

         %H    is replaced by the hour (24­hour clock) as a decimal number
              (00­23).

         %I    is replaced by the hour (12­hour clock) as a decimal number
              (01­12).

         %j    is replaced by the day of the year as a decimal number (001­366).

         %k    is replaced by the hour (24­hour clock) as a decimal number (0­23);

              single digits are preceded by a blank.

         %l    is replaced by the hour (12­hour clock) as a decimal number (1­12);
              single digits are preceded by a blank.

         %M    is replaced by the minute as a decimal number (00­59).

         %m    is replaced by the month as a decimal number (01­12).

         %n    is replaced by a newline.

         %p    is replaced by either ``AM'' or ``PM'' as appropriate.

         %R    is equivalent to ``%H:%M''

         %r    is equivalent to ``%I:%M:%S %p''.

         %t    is replaced by a tab.

         %S    is replaced by the second as a decimal number (00­60).

         %s    is replaced by the number of seconds since the Epoch, UCT (see
              mktime(3)).

         %T or X
              is equivalent to ``%H:%M:%S''.

         %U    is replaced by the week number of the year (Sunday as the first day
              of the week) as a decimal number (00­53).

         %W    is replaced by the week number of the year (Monday as the first day
              of the week) as a decimal number (00­53).

         %w    is replaced by the weekday (Sunday as the first day of the week) as
              a decimal number (0­6).

         %x    is equivalent to ``%m/%d/%y %H:%M:%S''.

         %Y    is replaced by the year with century as a decimal number.

         %y    is replaced by the year without century as a decimal number
              (00­99).

         %Z    is replaced by the time zone name.

         %%
            is replaced by `%'.

<$INSERT TIME FORMAT="%b %d %y">

Insert text

<$INSERT TEXT="hugo was here!">

<$INSERT TEXT=<href>>

<$LET [$UPDATE] [$GLOBAL] attribute>

If you define an attribute via <$LET> inside a macro, it is of local existence only and is removed after processing the macro. You can suppress this with using the optional flag $GLOBAL: in this case, the attribute exists until the end of conversion.

    <$message TEXT="message text" [CLASS="class"]>