summaryrefslogtreecommitdiffstats
path: root/indenters/hindent.html
blob: e1a8012871470d7f88062f52b4ea287ed04924ab (plain)
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
152
153
154
155
156
<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->

<html>
<head>
<title>HINDENT(1) manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>

<h2><a name='sect0' href='#toc0'>Name</a></h2>
hindent - HTML reformatting/nesting utility 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>hindent</b> [-fslcv]
[-i <i>num</i>] [-t <i>num</i>] [file ...] 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
This utility takes one or more HTML
files and reformats them by properly indenting them for greater human readability.
The new HTML code is written to standard output, any errors go to standard
error. If no file is specified, <b>hindent</b> reads from standard input. If more
than one file is specified, each is taken in turn and all output is concatenated
(with no way to distinguish when one output ends and the next begins). <p>
Without
any options, <b>hindent</b> simply varies the amount of whitespace at the beginning
of each line of input - no lines are added or subtracted from the HTML code.
This means that it generates output that should draw the same on all browsers
as the input HTML. If the <b>-s</b> or <b>-f</b> options are used, the resulting HTML may
not draw exactly the same any more.  It is important that you keep your
original HTML data around, just in case! <p>
This version of <b>hindent</b> understands
all container tags defined in the HTML 3.2 standard. 
<h2><a name='sect3' href='#toc3'>Options</a></h2>

<dl>

<dt><b>-c</b> </dt>
<dd>Case.  Forces
all tags to lowercase.  By default, <b>hindent</b> forces all tags to uppercase.
</dd>

<dt><b>-f</b> </dt>
<dd>Flow.  Prints just tags without any data between the tags. Damages the
HTML in a big way, so save a copy of your original HTML. This option helps
you follow the HTML code flow visually. </dd>

<dt><b>-i <i>num</i></b> </dt>
<dd>Indent level.  Set indentation
to this many character spaces per code nesting level. If set to 0, no indentation
is done (all output is left-justified). </dd>

<dt><b>-l</b> </dt>
<dd>List tags.  Causes <b>hindent</b> to print
a complete list of tags that it recognizes to stdout, and exits. </dd>

<dt><b>-s</b> </dt>
<dd>Strict.
 Multiple tags per line are broken out onto separate lines. Can damage the
HTML in minor ways by drawing an extra space character in certain parts
of the web page, so save a copy of your original HTML. This option helps
you follow the HTML code flow visually, especially with computer-generated
HTML that comes out all on one line. </dd>

<dt><b>-t <i>num</i></b> </dt>
<dd>Tab stop.  Set the number of spaces
that a tab character occupies on your system.  Defaults to 8, but some people
prefer expanding tabs to 4 spaces instead.  If set to 0, no tabs are output
(spaces used to indent lines). </dd>

<dt><b>-v</b> </dt>
<dd>Version.  Prints <b>hindent</b>&rsquo;s version number
to stdout and exits immediately. </dd>
</dl>
<p>
The <b>-s</b> option is the most useful, it would
be the default if it didn&rsquo;t damage the HTML code. <p>
Any combination of these
options may be used. 
<p> 
<h2><a name='sect4' href='#toc4'>Examples</a></h2>
<p>
Example 1.  Download a web page, reformat it,
view it: <br>
<pre>
</pre><p>

<dl>

<dt>CRlynx -source <a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'>http://www.domtools.com/~pab</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
 | hindent | moreExample 2.  View
only the structure, one tag per line: </dt>
<dd><br>
<pre>
</pre></dd>
</dl>
<p>

<dl>

<dt>CRlynx -source <a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'>http://www.domtools.com/~pab</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
</a>
 | hindent -s -f | moreExample 3.  Reformat
my home page non-damagingly with 4-space tabs, keeping a backup copy: </dt>
<dd><br>
<pre>


</pre></dd>
</dl>

<h2><a name='sect5' href='#toc5'>CRcd $HOME/public_htmlmv index.html index.html.oldhindent -i4 index.html.old
&gt; index.htmlSite</a></h2>
The master web page for this tool is: 
<dl>

<dt><a href='http://www.domtools.com/unix/hindent.shtml'>http://www.domtools.com/unix/hindent.shtml</a>

</dt>
<dd></dd>
</dl>

<h2><a name='sect6' href='#toc6'>Version</a></h2>
<b>Hindent</b> version 1.1.2 
<h2><a name='sect7' href='#toc7'>Author</a></h2>
Paul Balyoz &lt;pab@domtools.com&gt; <p>

<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Options</a></li>
<li><a name='toc4' href='#sect4'>Examples</a></li>
<li><a name='toc5' href='#sect5'>CRcd $HOME/public_htmlmv index.html index.html.oldhindent -i4 index.html.old > index.htmlSite</a></li>
<li><a name='toc6' href='#sect6'>Version</a></li>
<li><a name='toc7' href='#sect7'>Author</a></li>
</ul>
</body>
</html>