Man Linux: Main Page and Category List

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.