Section: HTML-XML-utils (1)Updated: 21 Nov 2008Local indexUp
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.