Short:        V0.931; html-preprocessor (bin)
Author:       Matthias Bethke <matthias.bethke@gmx.net>, Thomas Aglassinger
Uploader:     Matthias Bethke <matthias bethke gmx net>
Type:         text/hyper
Version:      0.931
Replaces:     comm/www/hsc-0.929.lha
Architecture: m68k-amigaos
Kurz:         html-Vorarbeiter

Long: This is a binary-only release of HSC for AmigaOS. Sources are available from http://www.linguistik.uni-erlangen.de/~msbethke/software.html
Requires: AmigaOS 2.04, 68020, 2MB, UserIQ>50

NAME

  hsc - HTML Sucks Completely

VERSION 

  0.931

AUTHOR

  Matthias Bethke <Matthias.Bethke@gmx.net>
  Thomas Aglassinger <agi@giga.or.at>

DESCRIPTION

  Hsc is a developer tool for HTML-projects.

  It can be used on any HTML file and creates a new HTML file as
  output. In the input file, you may use an extended syntax based on
  HTML, but which also allows extensions like macros, conditionals and
  more.

  It is mainly intended for creating and maintaining larger HTML projects.
  As a commandline tool, it can be used together with `make', and a
  dependency generator is included.

  Hsc is *not* a tool to make HTML easier for beginners; it's a tool
  to make HTML a bit less painful and brain-damaged for people who
  already know how to work with it.

FEATURES

  - macros (implemented as additional tags)
  - conditionals (if/else/elseif)
  - expressions, supporting
    - string concatenation and comparison
    - integer maths
    - import of environment variables
    - current time
    - size of files
  - special tags to
    - include files (also verbatim text)
    - export data to files
    - execute shell commands (and include output)
    - write comments in a reasonable way
  - for local links, checks if file/ID exists
  - project relative URIs
  - replaces special characters by entities
  - evaluates attributes for image size (PNG/JFIF/GIF)
  - can strip useless white space, comments and tags
  - replaces icon entities by images
  - performs a basic syntax and structure check
  - error messages are easier to understand than the esoteric crap
    tools like sglms vomit
  - maintains a project file
  - includes hscpitt, a tool to examine/manipulate project files
  - includes hscdepp, a dependancy generator for makefiles

NEW FEATURES

  - Replaced the partial (and partially wrong) compiled-in entity list with the
    official and complete one from the W3C website.
  - Activated the ENTITYSTYLE option that had been hidden in there since Agi's
    times. HSC can now write entities either as found in the source,
    symbolically (like "&amp;uuml;"), numerically ("&amp;#252;"), or as UTF-8 ("ü"). The
    latter is now the default for XHTML documents!
  - Added a PREFNUM attribute to &lt;$defent&gt;, meaning that the numeric
    representation should be used if ENTITYSTYLE=replace
    Entities with a RPLC character may have arbitrary numeric representations, as
    long as these are above 160 (positions 128-159 are unused in Latin1 and
    Unicode!).
    This allows e.g. to replace the CP-1252 Euro symbol (#128, if your HSC source
    should be in this charset, which is not recommended) with a proper Unicode
    Euro (#8364).
  - Removed the undocumented (and fairly dangerous [well, you shouldn't have tried
    this at home in the first place!] BTW) option JENS/S.
  - Reverted to compilation of individual object files from each source.
  - Documentation: updated the Requirements page, documented new features,
    corrected minor bits.

  Check the file CHANGES for details.

REQUIREMENTS

  Unixoid: tested on Linux, HP/UX 10.20 and MacOS X; Makefile supports
           NeXTStep, should compile fine on other flavors, too.
  AmigaOS: OS2.04 or higher (tested: OS3.1), 2MB RAM, 68020
           recommended: 4MB RAM, 68060.
           Compilation requires unistd.h which comes (at least) with SAS/C
           and gcc
  RiscOS : anybody without the latest version left? :)

  Other than many other HTML-tools, hsc requires a user IQ > 50. You
  should also know how to work with the shell and how to write
  Makefiles. Some experience with macro processors and/or programming
  languages ([A]Rexx, Perl, Python or even a Real Language[tm]) facilitate
  things :)

AVAILABILITY

 - currently only from my homepage at
   http://www.linguistik.uni-erlangen.de/~msbethke/software.html
   This release consists of a source archive, an RPM for Linux/i386 and an LHA
   archive of the binaries for AmigaOS.

PRICE

  Freeware.

DISTRIBUTION

  Distributed under the GNU General Public License.