NAME

    html2alvis - HTML to Alvis XML converter
    

SYNOPSIS

    html2alvis [options] [source directory ...]

  Options:

    --html-ext                 HTML file identifying filename extension
    --meta-ext                 meta file identifying filename extension
    --out-dir                  output directory
    --N-per-out-dir            # of records per output directory
    --meta-encoding            the encoding of the meta files
    --html-encoding            the encoding of all HTML files
    --html-encoding-from-meta  take the encoding of the HTML files from
                               the meta files (attribute 'detected-charset')
    --[no]original             include original document?
    --help                     brief help message
    --man                      full documentation
    --[no]warnings             warnings output flag
    

OPTIONS

--html-ext

    Sets the HTML file identifying filename extension. 
    Default value: 'html'.

--meta-ext

    Sets the  meta file identifying filename extension.
    The meta file syntax is

          <feature name>\t<feature value>\n

    Special features are url,title,date,detectedCharSet.
    Default value: 'meta'.

--out-dir

    Sets the output directory. Default value: '.'.

--N-per-out-dir

    Sets the # of records per output directory. Default value: 1000.

--meta-encoding

    Specifies the encoding of all meta files. Default value 'iso-8859-1'.

--html-encoding

    Specifies the encoding of all HTML files. Default value 'iso-8859-1'.
    Default: undef (meaning 'guess').

--html-encoding-from-meta

    Specifies whether the encoding of an HTML file should be read from
    the corresponding meta file. If no information is given there,
    --html-encoding is used, if that is not given, the encoding is guessed.
    Default: no.

--[no]original

    Shall the original document be included in the output? Default
    value: yes.

--help

    Prints a brief help message and exits.

--man

    Prints the manual page and exits.

--[no]warnings

    Output (or suppress) warnings. Default value: yes.

DESCRIPTION

    Goes recursively through the files under the source directory
    and converts them to Alvis XML files. Meta information (such
    as the URL or the detected character set, title of the document
    etc.) can be given in a separate meta file, one per each document,
    recognized by the shared basename. E.g. the HTML document is
    called foo.original and the meta information is in foo.meta.
    In this case html2alvis should be called like this:
   
          html2.alvis --html-ext original --meta-ext meta