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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>hsc - Features - Macros - Modifiers For Tag- And Macro Declarations</TITLE>
<LINK REV="owns" TITLE="Thomas Aglassinger" HREF="mailto:agi@giga.or.at">
<LINK REL="Next" HREF="attrib.html">
<LINK REL="Copyright" HREF="../copy.html">
<LINK REL="Previous" HREF="macros.html">
<META name="ROBOTS" content="NOINDEX, NOFOLLOW">
</HEAD>
<BODY>
<A HREF="../index.html"><IMG SRC="../image/main.gif" ALT="Contents" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<IMG SRC="../image/noindex.gif" ALT="-----" ALIGN="middle" WIDTH="70" HEIGHT="16">
<A HREF="../copy.html"><IMG SRC="../image/copy.gif" ALT="Copyright" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="../index.html"><IMG SRC="../image/back.gif" ALT="Up" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="macros.html"><IMG SRC="../image/prev.gif" ALT="Previous" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="attrib.html"><IMG SRC="../image/next.gif" ALT="Next" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<HR>
<H1>Modifiers For Tag- And Macro Declarations</H1>
<P>Within <A HREF="macros.html"><CODE><$macro></CODE></A> and <A HREF="../features/prefs.html#deftag"><CODE><$deftag></CODE></A>,
you can use several modifiers to tell <KBD>hsc</KBD> how to handle this macro/tag.</P>
Allowed modifiers for both <A HREF="macros.html"><CODE><$macro></CODE></A> and <A HREF="../features/prefs.html#deftag"><CODE><$deftag></CODE></A> are:
<DL>
<DT><CODE>/CLOSE</CODE>
(short: <CODE>/C</CODE>)
<DD>
macro/tag is a container and requires a corresponding end tag.
<DT><CODE>/ONLYONCE</CODE>
(short: <CODE>/1</CODE>)
<DD>
macro/tag is required at the most once within a document
<DT><CODE>/REQUIRED</CODE>
(short: <CODE>/R</CODE>)
<DD>
macro/tag is required to appear at least once within a document
<DT><CODE>/RECOMMENDED</CODE>
(short: <CODE>/RCMD</CODE>)
<DD>
macro/tag ought to appear least once within a document
<DT><CODE>/MUST_BE_INSIDE</CODE>
(short: <CODE>/MBI</CODE>)
<DD>
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 <CODE><LI></CODE> must be used inside some sort of lists only,
therefor it's <CODE>/MBI="ul|ol|dir|menu"</CODE> is used.
The vertical bar (``<CODE>|</CODE>'') is used as a separator for multiple tags.
<DT><CODE>/NOT_ALLOWED_WITHIN</CODE>
(short: <CODE>/NAW</CODE>)
<DD>
Like <CODE>/MBI</CODE>, but this time tags that must not be
used before. For example, a nested usage of <CODE><A></CODE>
is not allowed, therefor <CODE>/NAW="a"</CODE> is used.
</DL>
Additionally, the following modifiers can be used with <A HREF="../features/prefs.html#deftag"><CODE><$deftag></CODE></A>
<DL>
<DT><CODE>/AUTOCLOSE</CODE>
(short: <CODE>/AC</CODE>)
<DD>
Used for <CODE><P></CODE> and <CODE><LI></CODE>, which can be used as container
or single tag depending on the HTML version. Tags marked with this
modifier can not be nested.
<DT><CODE>/JERK</CODE>
(short: <CODE>/J</CODE>)
<DD>
tag is only used by jerks
<DT><CODE>/LAZY</CODE>
(short: <CODE>/L</CODE>)
<DD>
This modifier has just been for my laziness and defines some
often needed attributes with a single letter;
``<CODE>c</CODE>'' for ``<CODE>CLASS:string</CODE>'',
``<CODE>h</CODE>'' for ``<CODE>HREF:uri</CODE>'',
``<CODE>i</CODE>'' for ``<CODE>ID:id</CODE>'',
``<CODE>k</CODE>'' for ``<CODE>CLEAR:bool</CODE>'',
``<CODE>l</CODE>'' for ``<CODE>LANG:string</CODE>'',
``<CODE>m</CODE>'' for ``<CODE>MD:string</CODE>'',
``<CODE>s</CODE>'' for ``<CODE>SRC:uri</CODE>'',
``<CODE>w</CODE>'' for ``<CODE>NOWRAP:bool</CODE>''.<BR>
For example, use <CODE>/LAZY="cil"</CODE>.
<DT><CODE>/OBSOLETE</CODE>
(short: <CODE>/O</CODE>)
<DD>
tag is obsolete and should not be used any more. This eg.
concerns <CODE><LISTING></CODE>.
<DT><CODE>/SKIPLF</CODE>
(short: <CODE>/S</CODE>)
<DD>
skip a linefeed ("\n") that comes immediately after the tag. This
is only useful for some of <KBD>hsc</KBD>'s special tags and only avoids
some unnecessary empty lines.
<DT><CODE>/SPECIAL</CODE>
(short: <CODE>/SPC</CODE>)
<DD>
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 <CODE><!></CODE> (for SGML comments).
<DT><CODE>/WHTSPC</CODE>
(short: <CODE>/W</CODE>)
<DD>
If this modifier is set, any occurrence of the container is checked
for succeeding/preceding white spaces. By default, this concerns
the tags <CODE><A></CODE>, <CODE><TITLE></CODE>, headings and physical/logical
styles like <CODE><B></CODE> or <CODE><strong></CODE>.
</DL>
</BODY></HTML>
|
