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 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD>
<TITLE>Hsc - Manual</TITLE>
<LINK REV="owns" TITLE="Thomas Aglassinger" HREF="mailto:agi@giga.or.at">
<LINK REL="Home" HREF="index.html">
<LINK REL="Copyright" HREF="copy.html">
<LINK REL="Next" HREF="about.html">
<META HTTP-EQUIV="keywords" CONTENT="html,tool,preprocessor,macro,include,condition,suck">
<META HTTP-EQUIV="description" CONTENT="This is the documentation to hsc, a developer tool for html-projects. It acts as a preprocessor and supports macros, expressions, conditionals, include files, replaces special characters, performs a structure check, tests existence of local links and several other things. Optionally it can keep track of documents being processed and maintain the dependencies between them, making it relatively easy to integrate it into existing developer environments.">
</HEAD>
<BODY>
<IMG SRC="image/nomain.gif" ALT="----" ALIGN="middle" WIDTH="70" HEIGHT="16">
<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>
<IMG SRC="image/noback.gif" ALT="--" ALIGN="middle" WIDTH="70" HEIGHT="16">
<IMG SRC="image/noprev.gif" ALT="--------" ALIGN="middle" WIDTH="70" HEIGHT="16">
<A HREF="about.html"><IMG SRC="image/next.gif" ALT="Next" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<P ALIGN="right">
<I>Don't believe the hype<BR>
Take a look at the small print<BR>
Ignore the bold type<BR></I>
(Carter U.S.M, "Do Re Me, So Far So Good")
</P>
<H1>Hsc</H1>
<P><STRONG>(Version 0.916, 12-Jan-1998)</STRONG></P>
<P><IMG SRC="image/austria.gif" ALT="[A.E.I.O.U.]" ALIGN="middle" WIDTH="22" HEIGHT="14"> Es
gibt keine <A HREF="teutsch.html">deutschsprachige
Dokumentation</A>.</P>
<P>This is the documentation to hsc, a developer tool for html-projects. It acts as a preprocessor and supports macros, expressions, conditionals, include files, replaces special characters, performs a structure check, tests existence of local links and several other things. Optionally it can keep track of documents being processed and maintain the dependencies between them, making it relatively easy to integrate it into existing developer environments.</P>
<IMG SRC="image/hsc.gif" ALT="..SUCK SUCK SUCK.." ALIGN="right" WIDTH="81" HEIGHT="73">
<P>A current version of this program and manual should always be
available from <A
HREF="http://www.giga.or.at/~agi/hsc/">http://www.giga.or.at/~agi/hsc/</A>, both as
hypertext (html) and printabel (Postscript) document.</P>
<H2>About The Program</H2>
<UL>
<LI><A HREF="about.html">Introduction</A> - What's this all about?
<LI><A HREF="copy.html">Copyright And Disclaimer</A> - not-my-fault, Freeware, source included
<LI><A HREF="author.html">Author</A> - how to contact me
<LI><A HREF="changes.html">Changes And News</A> - what's new with this release
<LI><A HREF="updates.html">Updates</A> - where to find them
</UL>
<H2>Before You Begin</H2>
<UL>
<LI><A HREF="require.html">Requirements</A> - what to own and know
<LI><A HREF="distrib.html">Archive Contents</A> - things coming along
<LI><A HREF="install.html">Installation</A> - where to put the whole
damn thing
</UL>
<H2>Usage</H2>
<UL>
<LI><A HREF="options.html">Invoking <KBD>hsc</KBD></A>
<UL>
<LI><A HREF="options.html#options">Options</A> and
<A HREF="options.html#switches">Switches</A> - there are loads of them
<LI><A HREF="options.html#exitcodes">Exit Code</A> - return to sender
</UL>
<LI><A HREF="examples.html">Example Usage</A> - how it is supposed to work
<LI><A HREF="fileargs.html">File Arguments</A> - specifying input and output
<LI><A HREF="messages.html">Messages</A> - shit happens
<UL>
<LI><A HREF="messages.html#elements">Message Elements</A>
<LI><A HREF="messages.html#classes">Message Classes</A>
<LI><A HREF="messages.html#options">Message Options</A>
<LI><A HREF="messages.html#list">List Of Messages</A>
</UL>
<LI><A HREF="envvar.html">Environment Variables</A> - save the nature
</UL>
<H2>Features</H2>
<UL>
<LI><A HREF="features/spctags.html">Special Tags</A>
- make life a bit easier
<LI><A HREF="features/checkuri.html">Check Existence</A>
of local URIs to avoid dangling links
<LI><A HREF="features/uris.html#prjrel">Project Relative URIs</A>
- avoid paths like "../../../image/back.gif"
<LI><A HREF="features/rplcent.html">Replace Special Characters</A>
by their entities
<LI><A HREF="features/getsize.html">Get Size</A> of images and set attributes
<CODE>WIDTH</CODE> and <CODE>HEIGHT</CODE>
<LI><A HREF="features/spcattr.html">Special Attributes</A>
- access various information
<LI><A HREF="features/strip.html">Strip Specific Elements</A> - comments,
redundant linefeeds and white-spaces, unneeded tags,
tags with external references
<LI><A HREF="features/syntax.html">Structure And Syntax Check</A>
to avoid surprises with different browsers
</UL>
<H2>Advanced Topics</H2>
<UL>
<LI><A HREF="features/assign.html">Attribute Assignments</A>
<LI><A HREF="features/expressions.html">Expressions</A>
- there's more to life than strings
<UL>
<LI><A HREF="features/expressions.html#operators">Operators</A>
<LI><A HREF="features/expressions.html#boolean">Boolean Expressions</A>
<LI><A HREF="features/expressions.html#priorities">Priorities</A>
</UL>
<LI><A HREF="macro/macros.html">Macros</A>
- create your own shortcuts and templates.
<UL>
<LI><A HREF="macro/flag.html">Macro Modifiers</A>
<LI><A HREF="macro/attrib.html">Attribute Declaration</A>
<LI><A HREF="macro/attrib.html#type">Attribute Types</A>
<LI><A HREF="macro/attrib.html#modifier">Attribute Modifiers</A>
</UL>
<LI><A HREF="features/if.html">Conditionals</A>
- what if..?
<UL>
<LI><A HREF="features/if.html#general">General Syntax</A>
<LI><A HREF="features/if.html#simple">Some Simple Examples</A>
<LI><A HREF="features/if.html#nesting">Nesting Conditionals</A>
<LI><A HREF="features/if.html#macros">Conditionals And Macros</A>
</UL>
<LI><A HREF="features/prefs.html">Syntax Definition</A>
- what to do if html version 17.3 is out
<LI><A HREF="features/exec.html">Execute Shell Commands</A>
- poor man's pseudo-CGI
<LI><A HREF="project/index.html">Project Management</A>
- I'll <KBD>make</KBD> ya
<UL>
<LI><A HREF="project/prjfile.html">Project Files</A> -
where <KBD>hsc</KBD> stores information about a project
<LI><A HREF="project/hscpitt.html"><KBD>hscpitt</KBD></A> -
<KBD>hsc</KBD> project interfering and trashing tool
<LI><A HREF="project/make.html">make</A> - a general purpose tool for project management
<LI><A HREF="project/makefile.html">Makefiles</A> - how to adopt them for <KBD>hsc</KBD>
<LI><A HREF="project/hscdepp.html"><KBD>hscdepp</KBD></A> -
<KBD>hsc</KBD> dependency procreator
<LI><A HREF="project/hscpaltrow.html"><KBD>hscpaltrow</KBD></A> -
a Rexx-script utilizing <KBD>hscpitt</KBD>
</UL>
<LI><A HREF="usecases.html">Some Use-Cases</A> -
hints how to do certain things
</UL>
<H2>Miscellaneous</H2>
<UL>
<LI><A HREF="questions.html">Questions</A> - and maybe some answers..
<LI><A HREF="source.html">Source Code</A> - compiling it
<LI><A HREF="ports.html">Existing Ports</A> - Amiga rulez? Not really.
<LI><A HREF="others.html">Other html-Extensions</A> - pre²protranscessingpost
<LI><A HREF="bugs.html">Known Bugs, Problems and Limitations</A> - don't whizz on the electric fence
<LI><A HREF="future.html">Future Improvements</A> - what might happen
<LI><A HREF="related.html">Related stuff</A> - tools and further information
</UL>
<HR>
<ADDRESS>
<A HREF="author.html">Thomas Aglassinger</A> (agi@giga.or.at),
12-Jan-1998
</ADDRESS>
</BODY></HTML>
|