NAME

news_xml2alvis.pl - news XML to Alvis XML converter

SYNOPSIS

  news_xml2alvis.pl [options] [source directory ...]

Options:

  --xml-ext            XML 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
  --help               brief help message
  --man                full documentation
  --[no]warnings       warnings output flag
  

OPTIONS

--xml-ext

Sets the XML file identifying filename extension. 
Default value: 'xml'.

--meta-ext

Sets the  meta file identifying filename extension.
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 the meta files. Default value 'iso-8859-1'.

--help

Prints a brief help message and exit.

--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 XML document is
 called foo.news and the meta information is in foo.meta.
 In this case news_xml2alvis.pl should be called like this:

       news_xml2.alvis.pl --xml-ext news --meta-ext meta  
 
 The news XML files are expected to be of the format

 <DOCUMENT>
   <article>
     <date></date>
     <iso-date></iso-date>
     <title></title>
     <content></content>
     <links>
         <link type="a">
             <location></location>
         </link>
     </links>
   </article>

 and meta files of the format 

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

 Special features are url,title,date,detectedCharSet.