1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
|
Doc Toolkit 0.99.1 - E-Text Tools for PalmPilot Users
Copyright 1998 Rob Tillotson <robt@debian.org>
This program is free software; see the file doc/COPYING in the
distribution for details.
For more information and the most up-to-date version, see:
http://www.io.com/~rob/cq/
Description:
Doc Toolkit is a set of tools for building PalmPilot e-texts in the
de facto standard Doc format. It is written in the Python
programming language, and thus requires the Python interpreter
version 1.5 or newer. It also requires PalmPython (0.5.1 or newer),
my package of PalmPilot data access code; you should be able to get
PalmPython from the same place you got this package, or from the URL
shown above.
Installation:
In this version, no installation is necessary as long as all the
files are located in the same directory. This includes the command
scripts (htmltodoc, etc.); you can make symbolic links to them, but
they must be physically located in the same directory as the other
Python source.
Manual pages are provided in the "doc" subdirectory; you can copy
them to /usr/local/man/man1 or wherever the manuals are on your
system. (If you just want to read them without installing, try
"nroff -man htmltodoc.1 | less" or a similar command.
Features:
Doc Toolkit is structured as a set of separate modules that share a
common core. Currently, there are modules to convert HTML to Doc,
text to Doc, and Doc to text. There are currently three user-level
commands in the package:
htmltodoc -- convert HTML to Doc ("htmltodoc -h" for help)
texttodoc -- convert text to Doc ("texttodoc -h" for help)
doctotext -- a simple Doc database dumper
Common to all modules:
- input may come from local files or http: or ftp: URLs
- input files may be gzipped
- documents may be installed directly to a connected PalmPilot
- Doc category support
- user-specified creator, type, and backup settings
- support for special TealDoc embedded tags
- bookmarks are written directly into the document, eliminating
the need for auto-scan or <BOOKMARK> tags
- TealDoc header and horizontal rule support
HTML-to-Doc Converter:
- can convert <H1>...<H6> to TealDoc <HEADER> tags, with word wrap
based on actual PalmPilot font metrics
- <HR> tags converted to TealDoc <HRULE> tags or simulated using
ordinary text
- automatic bookmark creation from labeled anchors (<A
NAME="...">...</A>)
- optional summary of links at end of document
- <UL TYPE="..."> and <OL TYPE="..."> support
- supports extended characters, both standard ISO-8859-1 HTML4
entities plus additional characters from the PalmPilot character
set
Text-to-Doc Converter:
- automatic reflow of paragraphs
- embedded "tags" for adding headers, rules, bookmarks, etc.
|