NAME¶
hxname2id - move some NAME and ID attributes from an A to its parent
SYNOPSIS¶
hxname2id [
-x ] [
file ]
DESCRIPTION¶
The
hxname2id command reads an HTML file and looks for elements with an A
element as first child, with no intervening text other than whitespace. If
that A element has an ID or NAME attribute, it is moved to the parent element
and removed from the A.
Because Netscape 4 doesn't understand ID attributes, it was common practice to
write <H2><A NAME="sect7">...</A></H2>
instead of <H2 ID="sect7">. This program can be used to
convert such old HTML files to the new convention.
Other programs in this suite, such as
hxmultitoc(1), require IDs on
headings instead of A elements with NAME attributes. So it is useful to run
hxname2id prior to running
hxmultitoc and similar program.
hxname2id can be used in a pipe.
OPTIONS¶
The following options are supported:
- -x
- Use XML conventions: empty elements are written with a slash at the end:
<IMG />
OPERANDS¶
The following operand is supported:
- file
- The name of an HTML file. If absent, standard input is read instead.
DIAGNOSTICS¶
The following exit values are returned:
- 0
- Successful completion.
- > 0
- An error occurred in the parsing of the HTML file. hxname2id will
try to correct the error and produce output anyway.
SEE ALSO¶
asc2xml(1),
hxmultitoc(1),
hxnormalize(1),
hxnum(1),
hxtoc(1),
xml2asc(1)
BUGS¶
The error recovery for incorrect HTML is primitive.