Source code: ref/usage.htp

Table of Contents

<BLOCK body>

htp is designed to be run from the command-line.  Basic usage is
as so:
    htp [options] &lt;source filename&gt; &lt;final HTML filename&gt;
Command-line options are discussed in the <A HREF="options.html">options and
customization</A> section.  Most options can also be embedded in the htp
source files themselves.
The source file contains standard and htp-specific markup tags.  htp
processes the source file and writes the resulting output to the final
HTML file.
To handle larger sets of files, htp also accepts a response file, which
lists input/output filename pairs and additional response files.  A
response file is specified as so:
    htp [options] @&lt;response filename&gt;
A response file is a text file, with input and output filenames specified
on each line, or alternatively, another response file.  Also,
options can be included provided they are preceded by a minus sign
(&lsquo;-&rsquo;), as if they were typed on the command-line.  Since the
response file is processed once and in order, options should be placed
before specifying any files or response files.  Finally, a comment can
be placed in the response file by adding a semi-colon.  All text on the
line beyond the semi-colon will be ignored.
    ; sample response file
    -<A HREF="options.html">CONDENSE</A> -<A HREF="options.html">IMGXY</A>
    index.htp index.htm
    page1.htp page1.htm
A hierarchy of response files can be created using this format.
htp will automatically search for a default response file named
"htp.rsp" if no response file is specified.  Therefore, to execute htp
with a default response file, type
    htp [options] @
And, in a response file, only a new directory needs to be specified to
use a default response file:
Note that the trailing slash (or backslash) <EM>must</EM> be included for
htp to properly discover the response file.
Additionally, htp will automatically convert slashes and backslashes for
file names in all response files and htp special tags <STRONG>only</STRONG>.
This means that response files and file names specified by a
<A HREF="file.html">FILE INCLUDE</A> do not need to be changed if the files
are taken back and forth between a DOS and UNIX platform.
<STRONG>It will not convert slashes in standard HTML tags.</STRONG>
It will convert them internally if the file must be accessed, as in the case
of <A HREF="img.html">IMG</A>, but the pathname will <EM>not</EM> be changed
in the final output.
While processing, htp will display informational, warning, and error
messages.  Informational messages are preceded with a "[-]" string.
Warning messages are preceded with a "[*]" string.  Error messages
are preceded with a "[!]" string.  Error messages will halt processing
of the file, and htp will exit with an error level of 1 (one).


  page source
  htp project
  htp homepage
hosted by
HTML coding Powered by htp
htp on-line reference /
Authors: Jim Nelson, Jochen Hoenicke, Michael Möller.
Maintainers: Jochen Hoenicke.

Copyright © 1995-96 Jim Nelson.
Copyright © 2001-2003 Jochen Hoenicke.
Permission to reproduce and distribute this hypertext document granted according to terms described in the License section.

last updated Tue Feb 22, 2011