/usr/share/doc/hsc/docs/about.html is in hsc 0.934-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>hsc - Introduction</title>
<link rev="owns" title="Thomas Aglassinger" href="mailto:agi@giga.or.at">
<link rel="Next" href="copy.html">
<link rel="Copyright" href="copy.html">
<link rel="Previous" href="index.html">
<meta name="ROBOTS" content="NOINDEX, NOFOLLOW">
</head>
<body>
<a href="index.html"><img src="image/main.png" alt="Contents" align="middle" width="70" height="16"></a>
<img src="image/noindex.png" alt="-----" align="middle" width="70" height="16">
<a href="copy.html"><img src="image/copy.png" alt="Copyright" align="middle" width="70" height="16"></a>
<a href="index.html"><img src="image/back.png" alt="Up" align="middle" width="70" height="16"></a>
<a href="index.html"><img src="image/prev.png" alt="Previous" align="middle" width="70" height="16"></a>
<a href="copy.html"><img src="image/next.png" alt="Next" align="middle" width="70" height="16"></a>
<hr>
<p align="right"><i>Welcome Boyz and Girls to the Non-Official Shit-Reduction Program</i><br>
(Novi Sad, "Me, Myself, All Over Again")
</p>
<h1>Introduction</h1>
The main purpose of this chapter is to help you deciding whether you
should go on reading this documentation or not.
<h2>Motivation</h2>
<p>If you read this, it's quite likely that you tried to design an HTML
page. And you probably found out that HTML is a very clumsy thing: No
macros, no include files and several other features lacking.</p>
<p>And what can you do after your page is ready? View it with a
browser and test-click all links? Pfuahahaha! Most browser are
designed to handle as many errors as possible and display a readable
page, but don't mention your errors! And link-testing is a very stupid
task...</p>
<p>Of course, there are several tools around: You can use a macro
languages like <kbd>m4</kbd> to define macros and include files, use
some of the various HTML validators, replace your special characters
with <kbd>recode</kbd> and run a link validation tool on your
page.</p>
<p>So, after installing several tools, compilers and
interpreters, you are ready to go — and can start five programs
after a simple change to one of your pages.</p>
<h2>What It Is</h2>
<p><kbd>Hsc</kbd> tries to summarize the functionality of all
these tools in one program: it performs a (basic) syntax
check, validates your (local) links, replaces special characters
by entities and provides a way to define macros which resembles
HTML.</p>
<p>It also supports several features you probably will not find in
most other tools, like <a href="features/uris.html#prjrel">project
relative URIs</a>, stripping useless whitespace and automatically
setting the <a href="features/getsize.html">attributes for images
size</a>.</p>
<p>Furthermore it provides some concepts to maintain your project with
popular tools like <kbd>make</kbd>.</p>
<h2>How It Works</h2>
<p><kbd>Hsc</kbd> simply acts as a preprocessor: You give it an ``extended''
HTML-source (later in this document referred as ``hsc source'')
containing special commands, and <kbd>hsc</kbd> interprets it and produces a
pure HTML output as object file. This output file can be viewed with
your browser.</p>
<p>Normally you will create your hsc sources using a simple text editor,
maintain them in a <i>Makefile</i> and process them with <kbd>hsc</kbd>. At least I consider
this the recommended way of using this tool.</p>
<h2>What It Is Not</h2>
<p>Obviously, there is no fancy GUI, no (pseudo-)WYSIWYG, no drag&drop
— there are other programs which provide these functionalities. But a
common shortcoming of these programs usually is that they give less support for
large projects and are limited in configurability.</p>
<p>If you just want to create your own personal homepage, write a short HTML
document with information about your three freeware-proggies, include a picture
of your cat, send greets to Sepp and Hugo or something like that, there are
probably other tools which are easier to handle and will serve your needs more
or less well.</p>
<p>It should also be stated that you will require various skills usually
not needed for W3-authoring (or better: not expected to be needed by most
people). This includes a basic understanding of macro creation, writing
<i>Makefile</i>s and playing around with scripting languages like Rexx. If you have
never done such things before, I recommend you forget this package soon and come
back in a few years.</p>
<p>This also is no install-and-run package. You will need several other tools to
fully use it, and it is not within the scope of this documentation which one you
choose. However, it contains some comments and suggestions on that in various
places.</p>
<p>Despite the general HTML- and W3-hype of the recent years, both this tool and
its author consider many concepts introduced with it ridiculous, braindead and
sometimes even pure crap. So this manual contains opinions and language you
might consider offensive. If you want to hear the usual ``Oh how great are all
those things!'', you will have to look for something else.</p>
</body></html>
|