software/catdoc/index.html

   1 <HTML><HEAD>
   2 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=koi8-r">
   3 <TITLE>catdoc and xls2csv - free MS-Office format readers</TITLE>
   4 <META NAME="description" CONTENT="Command-line utilities to convert MS-Office files to plain (or not so plain) text">
   5 </HEAD><BODY>
   6 <H1>catdoc &amp; xls2csv</H1>
   7 <H3>Overview</H3>
   8 <STRONG>catdoc</STRONG> is program which reads one or
   9 more Microsoft word files and outputs text, contained insinde them
  10 to standard output. Therefore it does same work for .doc files, as
  11 unix <B>cat</B> command for plain ASCII files.
  12
  13 <P>
  14 It is now accompanied by <STRONG>xls2csv</STRONG> - program which
  15 converts Excel spreadsheet into comma-separated value file
  16 </p>
  17 <P>
  18 Optionaly, catdoc is able to translate some non-ASCII chars into correspoindig
  19 TeX escape sequences and convert charsets from Windows ANSI codepage to
  20 local codepage of target machine. (Because catdoc is russian program,
  21 by default it converts <B>cp1251</B> to <B>koi8-r</B>, when running under
  22 UNIX and to <B>cp866</B> when running under DOS.
  23 </p>
  24 <P> Catdoc has rudimentary table handling.  In TeX mode it inserts &amp; when
  25 encounters field delimiter and \\ when encounters end of table row. No
  26 table headers are produced although.
  27 </p>
  28 <P>
  29 Catdoc doesn't even try to preserver MS-Word character formatting. It's
  30 goal is to extract plain text and allow you to read it and, probably,
  31 reformat with TeX, according to TeXnical rules, most Word users
  32 haven't even heard about.
  33 </p>
  34 <p>
  35 If you are looking for tool which would preserve word formatting, look
  36 to <a href="http://wvware.sf.net">wvWare</a> or some portable office
  37 suite like <a href="http://www.openoffice.org">OpenOffice.org</a>.
  38 </p>
  39 <P>
  40 <strong>xls2csv</strong> does roughly same for Excel files. It extracts
  41 data and leaves out any formatting info and formulas. Concept is that
  42 you want to see data, not the way it was created.
  43 </p.
  44 <p>
  45 Since version 0.94 program <strong>catppt</strong> which prints out text
  46 from PowerPoint files is also included</p>
  47 <H3>Supported platforms</H3>
  48
  49 <UL>
  50 <LI>Unix. Catdoc was initially developed for Linux and Sparc Solaris.
  51 It also runs on variety of other Unices. For instance it is included in
  52 FreeBSD ports collection.
  53 <LI>MS-DOS. Catdoc also runs on MS-DOS, even on XT machines. MS-DOS is
  54 only platform for which compiled executables are provided. These
  55 executables are 16-bit real mode. I think that protected mode version of
  56 xls2csv might be useful, but don't have time to support it.
  57 </UL>
  58
  59 <p align=center><font size="+3">There is no support for catdoc under
  60 Windows</font></p>
  61
  62 Not because I hate windows. Just because I don't use it. Note that DOS
  63 catdoc is not intended to be used under windows. For example, it doesn't
  64 support long file names.
  65
  66 <h3>Character encodings conversion</h3>
  67 <p>
  68 Catdoc doesn't use system provided charset conversion libraries. It
  69 might be considered a bug, but <a
  70 href="http://www.oracle.com">Oracle</a>, <a href="http://www.tcl.tk">Tcl</a> and
  71 <a href="http://www.perl.org">Perl</a> do the same. Portable software
  72 really doesn't have any other choice, because some operating systems,
  73 which claim to be POSIX-compatible do not provide support for all
  74 neccessary encodings via their <b>iconv(3)</b> function.
  75 </p>
  76 <p>
  77 Catdoc doesn't introduce its own incompatible format of charset
  78 descriptions. Instead it uses encoding description files, available from
  79 <a href="ftp://ftp.unicode.org/Public/MAPPINGS/"> Unicode Consortium FTP site</a>
  80 </p>
  81 <p>
  82 Catdoc encoding conversion system has unique feature - it is able to
  83 replace character, which is not available in the target encoding, by
  84 multicharacther sequence. So, sometimes catdoc can be used as charset
  85 converter  for plain text files.
  86 </p>
  87 <p>
  88 Catdoc now doesn't support any multibyte encodings except utf-8. (of
  89 course, Word's internal UCS2 representation is supported). Problem is
  90 that no one have contributed me code for such support, which can be
  91 compiled as MS-DOS realmode program. And I refuse to add any patches
  92 which require 32-bit system.
  93 </p>
  94 <H3>License</H3>
  95 <b>catdoc</b> and <b>xls2csv</b> are distributed under <A
  96 HREF="http://www.gnu.org/copyleft/gpl.html">GNU Public License</A>.
  97 <P>
  98 <H3>Current status</H3>
  99
 100 Current version of <strong>catdoc</strong> is 0.94.1
 101 <p>
 102 See <a href="changelog.html">Changelog for details</a>.
 103 <p>
 104 <H3>Download</h3>
 105 <dl>
 106 <dt><A
 107 href="http://ftp.45.free.net/pub/catdoc/catdoc-0.94.1.tar.gz">catdoc-0.94.1.tar.gz</a>
 108 <dd> Source-only distribution for all platform<br>
 109   (SHA1 hash sum dc3a7906cd02bc1823fedc292ba6b23662e39faf)
 110 <dt><A
 111 href="http://ftp.45.free.net/pub/catdoc/catdoc-0.94.1.zip">catdoc-0.94.1.zip</a>
 112 <dd>Sources + DOS realmode executables <B>THESE ARE NOT WINDOWS PROGRAMS</B><br>
 113 (SHA 1 hash sum d94fa56cb6992ce3e7e4b9ebcf6aae42542a7580)
 114 </dl>
 115 Previous versions can be found on <a href="archive.html">archive page</a>
 116 <h3>Documentation</h3>
 117 <p>
 118 Catdoc is documented in traditional Unix man pages. For MS-DOS users
 119 plain-text and postscript versions of man pages are included in the
 120 distrbution.
 121 </p>
 122 <p>
 123 Html formatted versions of man pages are available here: <a
 124 href="catdoc.1.html">catdoc(1)</a> <a href="catppt.1.html">catppt(1)</a>
 125 <a href="xls2csv.1.html">xls2csv(1)</a>.
 126
 127 <h3>Support</h3>
 128 Catdoc has web based  bugtracking system. To prevent me to accidently login there via insecure connection, access is allowed via https only.
 129 <p>
 130 If you don't already have CA certificate for my perlsonal CA, visit
 131 <a href="http://www.45.free.net/cvstrac.html">my CVStrac page</a> and install certificate into your browser. Otherwise, <a href="https://www.45.free.net/cgi-bin/cvstrac/catdoc/">go directly to the login page</a>.
 132
 133 </BODY>
 134 </HTML>