1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
<WEBPAGE chapter="hsc - Features - Macros - "
PREV="macros.html"
NEXT="attrib.html"
title="Modifiers For Tag- And Macro Declarations">
<$macro LIFLAG SHORT:string/r LONG:string/r ONLYDEFTAG:bool>
<DT><CODE>/<(long)></CODE>
(short: <CODE>/<(short)></CODE>)
<DD>
</$macro>
<P>Within <ln_macro> and <ln_deftag>,
you can use several modifiers to tell <hsc> how to handle this macro/tag.</P>
Allowed modifiers for both <ln_macro> and <ln_deftag> are:
<DL>
<LIFLAG long="CLOSE" short="C">
macro/tag is a container and requires a corresponding end tag.
<LIFLAG long="ONLYONCE" short="1">
macro/tag is required at the most once within a document
<LIFLAG long="REQUIRED" short="R">
macro/tag is required to appear at least once within a document
<LIFLAG long="RECOMMENDED" short="RCMD">
macro/tag ought to appear least once within a document
<LIFLAG long="MUST_BE_INSIDE" short="MBI">
Needs a string as argument, that contains a list of container tags,
that must be started before tag is allowed to be used.<BR>
Example:<BR>
The tag <TG>LI</TG> must be used inside some sort of lists only,
therefor it's <CODE>/MBI="ul|ol|dir|menu"</CODE> is used.
The <vbar> is used as a separator for multiple tags.
<LIFLAG long="NOT_ALLOWED_WITHIN" short="NAW">
Like <CODE>/MBI</CODE>, but this time tags that must not be
used before. For example, a nested usage of <TG>A</TG>
is not allowed, therefor <CODE>/NAW="a"</CODE> is used.
</DL>
Additionally, the following modifiers can be used with <ln_deftag>
<DL>
<LIFLAG long="AUTOCLOSE" short="AC">
Used for <TG>P</TG> and <TG>LI</TG>, which can be used as container
or single tag depending on the HTML version. Tags marked with this
modifier can not be nested.
<LIFLAG long="JERK" short="J" ONLYDEFTAG>
tag is only used by jerks
<LIFLAG long="LAZY" short="L" ONLYDEFTAG>
This modifier has just been for my laziness and defines some
often needed attributes with a single letter;
<qq><CODE>c</CODE></qq> for <qq><CODE>CLASS:string</CODE></qq>,
<qq><CODE>h</CODE></qq> for <qq><CODE>HREF:uri</CODE></qq>,
<qq><CODE>i</CODE></qq> for <qq><CODE>ID:id</CODE></qq>,
<qq><CODE>k</CODE></qq> for <qq><CODE>CLEAR:bool</CODE></qq>,
<qq><CODE>l</CODE></qq> for <qq><CODE>LANG:string</CODE></qq>,
<qq><CODE>m</CODE></qq> for <qq><CODE>MD:string</CODE></qq>,
<qq><CODE>s</CODE></qq> for <qq><CODE>SRC:uri</CODE></qq>,
<qq><CODE>w</CODE></qq> for <qq><CODE>NOWRAP:bool</CODE></qq>.<BR>
For example, use <CODE>/LAZY="cil"</CODE>.
<LIFLAG long="OBSOLETE" short="O">
tag is obsolete and should not be used any more. This eg.
concerns <TG>LISTING</TG>.
<LIFLAG long="SKIPLF" short="S">
skip a linefeed ("\n") that comes immediately after the tag. This
is only useful for some of <hsc>'s special tags and only avoids
some unnecessary empty lines.
<LIFLAG long="SPECIAL" short="SPC">
This one marks tags which are no normal tags with some attributes,
but have their own syntax. The only html tag which has this modifier
set is <TG>!</TG> (for SGML comments).
<LIFLAG long="WHTSPC" short="W">
If this modifier is set, any occurrence of the container is checked
for succeeding/preceding white spaces. By default, this concerns
the tags <TG>A</TG>, <TG>TITLE</TG>, headings and physical/logical
styles like <TG>B</TG> or <TG>strong</TG>.
</DL>
</WEBPAGE>
|
