home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / text / hyper / hsc.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  11.3 KB  |  260 lines
  1. Short:    Html-preprocessor (v0.912)
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  0.912
  5. Type:     text/hyper
  6. Kurz:     html-Vorarbeiter
  7. Requires: AmigaOS 2.04, 68020, 2MB, UserIQ>50
  8.  
  9. TITLE
  10.  
  11.   hsc - html sucks completely
  12.  
  13. VERSION 
  14.  
  15.   0.912
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   hsc is a developer tool for html projects.
  24.  
  25.   It can be used on any html file and creates a new html file as
  26.   output. In the input file, you may use an extended syntax based
  27.   on html, but which also allows things like macros and
  28.   conditionals.
  29.  
  30.   It's mainly intended to create and maintain larger html projects.
  31.   As a CLI-only tool, it should be used with `make'; a 
  32.   dependency generator is included.
  33.  
  34.   hsc is *not* a tool to make html easier for beginners; It's a
  35.   tool to make html a bit less painful and brain-damaged for
  36.   people who already know how to work with it.
  37.  
  38. FEATURES
  39.  
  40.   o adds some special tags, for example to
  41.     o include files (also sources)
  42.     o execute shell commands during conversion
  43.     o add comments in a reasonable way
  44.   o supports macros (implemented as additional tags)
  45.   o conditionals (if/else/elseif)
  46.   o simple expressions can be passed as values to attributes (like
  47.     string concatenation, string comparison, import of environment-
  48.     variables, current time or filesize)
  49.   o for local links, checks if file/id exists
  50.   o maintains a project-file to check existence of id's over all 
  51.     files processed
  52.   o supports absolute URIs (relative to root directory of project)
  53.   o replaces special characters by entities
  54.   o evaluates attributes for image size
  55.   o strips comments and specified tags
  56.   o strips useless white spaces
  57.   o replaces icon entities by images
  58.   o performs a (small) syntax- and structure-check
  59.   o easy to extend syntax definition format
  60.   o dependency generator for Makefiles included
  61.   o tool to examine/manipulate project files included
  62.  
  63. NEW FEATURES
  64.  
  65.   o some bugfixes (as usual)
  66.   o added support for recommended tags (not only required)
  67.   o loads of spelling mistakes fixed
  68.  
  69. SPECIAL REQUIREMENTS
  70.  
  71.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of 
  72.   WWW browser and ASCII editor.
  73.   For larger projects, 4MB of memory and 68040 are recommended.
  74.  
  75.   Different to most other WWW tools, hsc requires an user-IQ > 50.
  76.  
  77. AVAILABILITY
  78.  
  79.   o Every Aminet-mirror, file "text/hyper/hsc.lha"; for example
  80.     "ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha"
  81.   o "http://www.giga.or.at/~agi/hsc/"
  82.  
  83. PRICE
  84.  
  85.   Freeware.
  86.  
  87. DISTRIBUTABILITY
  88.  
  89.   Distributed under GNU General Public License.
  90.  
  91. SOURCE CODE
  92.  
  93.   ANSI-C source-code is available in a separate archive (look for
  94.   `hsc-source.lha' at the same site you've got the binaries from).
  95.  
  96.  
  97. ============================= Archive contents =============================
  98.  
  99. Original  Packed Ratio    Date     Time    Name
  100. -------- ------- ----- --------- --------  -------------
  101.       26      26  0.0% 26-Jan-97 21:54:12  FILE_ID.DIZ
  102.      628     273 56.5% 07-Sep-96 00:18:54  hsc.info
  103.    19569    7781 60.2% 26-Jan-97 21:42:40 +CHANGES
  104.      463     238 48.5% 06-Sep-96 22:51:12 +CHANGES.info
  105.    17982    6993 61.1% 26-Jun-95 08:31:52 +COPYING
  106.      463     236 49.0% 06-Sep-96 22:51:12 +COPYING.info
  107.      628     274 56.3% 10-Sep-96 13:12:28 +docs.info
  108.     3956    1868 52.7% 26-Jan-97 21:41:20 +about.html
  109.     6264    2746 56.1% 26-Jan-97 21:43:46 +author.html
  110.     6135    2783 54.6% 26-Jan-97 21:44:28 +bugs.html
  111.     1856     865 53.3% 26-Jan-97 21:41:24 +copy.html
  112.     3426    1359 60.3% 26-Jan-97 21:42:14 +distrib.html
  113.     1998     870 56.4% 26-Jan-97 21:44:08 +envvar.html
  114.     1802     806 55.2% 26-Jan-97 21:41:30 +examples.html
  115.     2558    1059 58.6% 26-Jan-97 21:41:48 +absuris.html
  116.     1634     707 56.7% 26-Jan-97 21:43:52 +checkuri.html
  117.     8009    2885 63.9% 26-Jan-97 21:40:02 +exec.html
  118.     4496    1627 63.8% 26-Jan-97 21:40:14 +expressions.html
  119.     2738    1099 59.8% 26-Jan-97 21:43:00 +getsize.html
  120.     5299    1942 63.3% 26-Jan-97 21:41:54 +if.html
  121.     6010    2520 58.0% 26-Jan-97 21:42:02 +prefs.html
  122.     2129    1011 52.5% 26-Jan-97 21:42:08 +rplcent.html
  123.    12527    3522 71.8% 26-Jan-97 21:42:52 +spcattr.html
  124.     7767    2840 63.4% 26-Jan-97 21:39:54 +spctags.html
  125.     3268    1374 57.9% 26-Jan-97 21:42:38 +strip.html
  126.     1757     774 55.9% 26-Jan-97 21:40:26 +syntax.html
  127.     5882    2244 61.8% 26-Jan-97 21:44:54 +fileargs.html
  128.     3168    1421 55.1% 26-Jan-97 21:40:20 +future.html
  129.      138     138  0.0% 14-Jan-96 17:27:46 +back.gif
  130.      190     190  0.0% 14-Jan-96 17:20:08 +copy.gif
  131.      496     496  0.0% 16-Jan-96 18:59:32 +head.gif
  132.      638     638  0.0% 26-May-96 02:10:44 +hsc.gif
  133.      170     170  0.0% 14-Jan-96 17:14:34 +index.gif
  134.      176     176  0.0% 14-Jan-96 17:14:44 +main.gif
  135.      189     189  0.0% 14-Jan-96 17:15:02 +next.gif
  136.      347     347  0.0% 12-Oct-96 18:51:36 +niceguy.gif
  137.      168     168  0.0% 14-Jan-96 17:28:12 +noback.gif
  138.      211     211  0.0% 14-Jan-96 17:20:36 +nocopy.gif
  139.      200     200  0.0% 14-Jan-96 17:15:28 +noindex.gif
  140.      193     193  0.0% 14-Jan-96 17:15:40 +nomain.gif
  141.      212     212  0.0% 14-Jan-96 17:15:52 +nonext.gif
  142.      213     213  0.0% 15-Jul-96 23:44:28 +noprev.gif
  143.      188     188  0.0% 14-Jan-96 17:16:08 +prev.gif
  144.      141     141  0.0% 04-Nov-95 02:20:36 +up.gif
  145.     6561    2349 64.1% 26-Jan-97 21:44:44 +index.html
  146.      468     253 45.9% 10-Sep-96 13:12:14 +index.html.info
  147.     2831    1191 57.9% 26-Jan-97 21:43:38 +install.html
  148.     4786    1703 64.4% 26-Jan-97 21:40:32 +attrib.html
  149.     4724    1679 64.4% 26-Jan-97 21:40:40 +flag.html
  150.     4624    1898 58.9% 26-Jan-97 21:40:46 +macros.html
  151.    24487    7511 69.3% 26-Jan-97 21:39:46 +messages.html
  152.    12605    4784 62.0% 26-Jan-97 21:44:20 +options.html
  153.     3893    1723 55.7% 26-Jan-97 21:44:00 +ports.html
  154.     3430    1366 60.1% 26-Jan-97 21:43:26 +hscdepp.html
  155.     5225    1942 62.8% 26-Jan-97 21:44:36 +hscpitt.html
  156.     1701     658 61.3% 26-Jan-97 21:43:16 +index.html
  157.     1826     796 56.4% 26-Jan-97 21:41:12 +make.html
  158.     4560    1809 60.3% 26-Jan-97 21:41:02 +makefile.html
  159.     2932    1237 57.8% 26-Jan-97 21:40:54 +prjfile.html
  160.     7596    3001 60.4% 26-Jan-97 21:43:10 +questions.html
  161.     3527    1510 57.1% 26-Jan-97 21:42:28 +related.html
  162.     2592    1205 53.5% 26-Jan-97 21:41:36 +require.html
  163.     2058     953 53.6% 26-Jan-97 21:41:42 +source.html
  164.     4731    1941 58.9% 26-Jan-97 21:45:02 +undocumented.html
  165.     2110     850 59.7% 26-Jan-97 21:40:08 +updates.html
  166.      628     273 56.5% 10-Sep-96 13:12:28 +example.info
  167.       55      55  0.0% 26-Jan-97 21:54:16 +README
  168.     2155     920 57.3% 09-Sep-96 07:48:52 +README
  169.      463     237 48.8% 10-Sep-96 13:12:08 +README.info
  170.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  171.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  172.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  173.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  174.      747     353 52.7% 23-Jul-96 14:08:48 +Makefile
  175.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  176.      628     275 56.2% 06-Sep-96 22:52:28 +grafflwerk.info
  177.     3173    1496 52.8% 30-Jul-96 12:47:06 +hScMsg.rexx
  178.      513     279 45.6% 10-Dec-96 23:03:56 +hScMsg.rexx.info
  179.     1254     635 49.3% 18-Aug-96 08:29:26 +Makefile
  180.      464     229 50.6% 06-Sep-96 22:52:24 +Makefile.info
  181.     1177     558 52.5% 12-Oct-96 16:45:50 +README
  182.      463     238 48.5% 06-Sep-96 22:52:24 +README.info
  183.     2081    1052 49.4% 03-Aug-96 19:13:32 +SendAWeb.rexx
  184.      513     277 46.0% 10-Dec-96 23:03:32 +SendAWeb.rexx.info
  185.     3337    1507 54.8% 04-Aug-96 23:27:42 +SendScMsg.rexx
  186.      513     278 45.8% 10-Dec-96 23:03:52 +SendScMsg.rexx.info
  187.      467     304 34.9% 23-Jan-97 10:14:26 +Hmpf_Grmbl_Wrcks
  188.      463     238 48.5% 06-Sep-96 22:51:12 +Hmpf_Grmbl_Wrcks.info
  189.    96504   52729 45.3% 26-Jan-97 20:43:58 +hsc
  190.      467     206 55.8% 10-Sep-96 13:24:06 +hsc.info
  191.    14659    3677 74.9% 21-Jan-97 22:21:50 +hsc.prefs
  192.    46276   25054 45.8% 26-Jan-97 20:44:44 +hscdepp
  193.      467     210 55.0% 19-Oct-96 22:27:36 +hscdepp.info
  194.    44924   24892 44.5% 26-Jan-97 20:45:26 +hscpitt
  195.      467     210 55.0% 19-Oct-96 22:27:36 +hscpitt.info
  196.      669     417 37.6% 10-Dec-96 23:52:08 +IMPORTANT
  197.      463     241 47.9% 06-Sep-96 22:51:12 +IMPORTANT.info
  198.     2527    1352 46.4% 26-Jan-97 21:54:14 +README
  199.      463     238 48.5% 06-Sep-96 22:51:12 +README.info
  200.      628     276 56.0% 10-Sep-96 13:12:28 +src_docs.info
  201.     3139    1640 47.7% 10-Dec-96 14:27:50 +about.hsc
  202.     5360    2538 52.6% 07-Jan-97 02:25:24 +author.hsc
  203.     5333    2585 51.5% 23-Jan-97 18:05:14 +bugs.hsc
  204.     1140     666 41.5% 14-Jul-96 21:59:54 +copy.hsc
  205.      340     230 32.3% 12-Sep-96 06:59:34 +credits.hsc
  206.     2489    1145 53.9% 07-Jan-97 02:41:14 +distrib.hsc
  207.     1156     655 43.3% 17-Nov-96 18:48:02 +envvar.hsc
  208.     1179     649 44.9% 30-Sep-96 04:05:22 +examples.hsc
  209.      154     133 13.6% 03-Jun-96 21:21:32 +anchor.hsc
  210.      264     167 36.7% 10-Nov-96 03:17:46 +exec.hsc
  211.      257     165 35.7% 20-Dec-95 03:43:58 +expression.hsc
  212.       45      45  0.0% 24-Oct-95 00:27:36 +m_addr.hsc
  213.      104      71 31.7% 12-May-96 23:07:52 +m_file.hsc
  214.      102     101  0.9% 04-Dec-95 04:02:52 +m_next.hsc
  215.      244     156 36.0% 19-Jul-96 22:37:36 +operators.hsc
  216.     1679     826 50.8% 29-May-96 02:24:48 +absuris.hsc
  217.      779     458 41.2% 10-Dec-96 21:28:56 +checkuri.hsc
  218.     6509    2435 62.5% 10-Dec-96 21:30:38 +exec.hsc
  219.     3751    1400 62.6% 10-Dec-96 21:32:30 +expressions.hsc
  220.     1773     881 50.3% 10-Dec-96 21:34:12 +getsize.hsc
  221.     4321    1735 59.8% 21-Jan-97 14:30:34 +if.hsc
  222.     4914    2305 53.0% 10-Dec-96 21:35:48 +prefs.hsc
  223.     1263     761 39.7% 10-Dec-96 21:36:26 +rplcent.hsc
  224.    10878    3222 70.3% 10-Dec-96 21:38:28 +spcattr.hsc
  225.     8571    3251 62.0% 10-Dec-96 21:39:56 +spctags.hsc
  226.     2204    1104 49.9% 10-Nov-96 23:41:38 +strip.hsc
  227.      864     522 39.5% 10-Dec-96 21:40:32 +syntax.hsc
  228.     4997    2001 59.9% 23-Jan-97 19:43:30 +fileargs.hsc
  229.     2341    1195 48.9% 10-Dec-96 14:47:54 +future.hsc
  230.     7958    1676 78.9% 26-Jan-97 21:45:02 +hsc.project
  231.     5553    1447 73.9% 23-Jan-97 18:14:44 +macro.hsc
  232.     2940     894 69.5% 21-Jan-97 22:54:12 +webpage.hsc
  233.     6558    2474 62.2% 26-Jan-97 21:44:34 +index.hsc
  234.     1963     935 52.3% 10-Dec-96 14:49:04 +install.hsc
  235.     3469    1532 55.8% 10-Dec-96 21:41:08 +attrib.hsc
  236.     3494    1481 57.6% 21-Jan-97 22:53:30 +flag.hsc
  237.     3746    1696 54.7% 10-Dec-96 21:42:48 +macros.hsc
  238.     2535    1190 53.0% 26-Jan-97 21:38:36 +main_index.hsc
  239.     5986    1482 75.2% 25-Jan-97 16:10:54 +Makefile
  240.     5882    1472 74.9% 24-Nov-96 15:18:58 +Makefile.bak
  241.    20641    7208 65.0% 23-Jan-97 18:15:02 +messages.hsc
  242.    12071    4858 59.7% 10-Dec-96 21:26:14 +options.hsc
  243.     2973    1455 51.0% 10-Dec-96 21:53:38 +ports.hsc
  244.     2722    1262 53.6% 10-Nov-96 21:05:46 +hscdepp.hsc
  245.     4555    1866 59.0% 10-Dec-96 21:45:04 +hscpitt.hsc
  246.      838     430 48.6% 10-Dec-96 21:45:40 +index.hsc
  247.      998     560 43.8% 10-Dec-96 21:46:00 +make.hsc
  248.     3680    1553 57.7% 10-Dec-96 21:46:44 +makefile.hsc
  249.     1910     960 49.7% 10-Dec-96 21:57:10 +prjfile.hsc
  250.     6757    3111 53.9% 10-Dec-96 21:20:08 +questions.hsc
  251.      196     147 25.0% 09-Sep-96 07:44:00 +README
  252.      463     235 49.2% 10-Sep-96 13:12:00 +README.info
  253.     2571    1336 48.0% 10-Dec-96 21:21:00 +related.hsc
  254.     1755     965 45.0% 21-Jan-97 22:57:28 +require.hsc
  255.     1252     726 42.0% 06-Nov-96 22:33:26 +source.hsc
  256.     3768    1724 54.2% 25-Jan-97 20:18:02 +undocumented.hsc
  257.      978     584 40.2% 23-Jan-97 10:01:38 +updates.hsc
  258. -------- ------- ----- --------- --------
  259.   667789  294808 55.8% 29-Jan-97 19:03:24   157 files
  260.