README

   1 HTML-AutoConvert
   2
   3 This module is intended for best-effort auto-conversion of arbitrary files
   4 into HTML.
   5
   6 The main focus is on conversion of Microsoft Word .DOC and .RTF file as well
   7 as Adobe PDF.  The OpenOffice plugin also converts .SXW and .ODT formats.
   8
   9 The actual conversion is mostly done by shelling out to existing programs.
  10 Useful programs to have installed:
  11
  12 For DOC/RTF/SXW/ODT:
  13 OpenOffice v2.3 or later
  14 Python and Python-UNO
  15
  16 For DOC:
  17 wvWare http://wvware.sourceforge.net/
  18 antiword http://www.winfield.demon.nl/index.html
  19
  20 For RTF:
  21 unrtf ftp://ftp.gnu.org/pub/gnu/unrtf/
  22
  23 For PDF:
  24 poppler http://poppler.freedesktop.org/
  25
  26 INSTALLATION
  27
  28 To install this module, run the following commands:
  29
  30         perl Makefile.PL
  31         make
  32         make test
  33         make install
  34
  35 SUPPORT AND DOCUMENTATION
  36
  37 After installing, you can find documentation for this module with the
  38 perldoc command.
  39
  40     perldoc HTML::AutoConvert
  41
  42 You can also look for information at:
  43
  44     RT, CPAN's request tracker
  45         http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-AutoConvert
  46
  47     AnnoCPAN, Annotated CPAN documentation
  48         http://annocpan.org/dist/HTML-AutoConvert
  49
  50     CPAN Ratings
  51         http://cpanratings.perl.org/d/HTML-AutoConvert
  52
  53     Search CPAN
  54         http://search.cpan.org/dist/HTML-AutoConvert
  55
  56
  57 COPYRIGHT AND LICENCE
  58
  59 Copyright (C) 2008 Freeside Internet Services, Inc.
  60
  61 This program is free software; you can redistribute it and/or modify it
  62 under the same terms as Perl itself.
  63
  64 HTML::AutoConvert::OpenOffice.pm derived from "PyODConverter"
  65 <http://www.artofsolving.com/opensource/pyodconverter>
  66 Copyright (C) 2008 Mirko Nasato <mirko@artofsolving.com>
  67 Licensed under the GNU LGPL v2.1 - http://www.gnu.org/licenses/lgpl-2.1.html
  68 - or any later version.
  69