html2pdbtxt - Online in the Cloud

PROGRAM:

NAME

html2pdbtxt - HTML to Doc Text converter for Palm Pilots

SYNOPSIS

html2pdbtxt [ -bchars ] [ -ttitle ] [ -uURL ] file.html [ file.txt ]
html2pdbtxt -v

DESCRIPTION

html2pdbtxt converts HTML to text suitable for conversion to a Doc(4) file via
txt2pdbdoc(1). If no text filename is given, the generated text is sent to standard
output.

HTML Tags
The following HTML tags (and corresponding ending tags) are recognized: ADDRESS, A NAME,
BLOCKQUOTE, BR, CENTER, DIV, DL, DT, H1, H2, H3, H4, H5, H6, OL, OPTION, PRE, P, SELECT,
SCRIPT, STYLE, TABLE, TITLE, UL. In all cases, the most ``reasonable'' thing is done
given the constraints of the Doc(4) format which is essentially plain text. ALT
attributes (typically found in IMG tags) have their text extracted and placed between
brackets [like this]. All other HTML tags are stripped.

Character Entities
Both HTML character and numeric (decimal and hexadecimal) entity references are converted
to their byte value according to the ISO 8859-1 (Latin 1) character set so they appear
properly on the Pilot. For example, ``résumé'' becomes ``resume'' with
accented letter 'e's.

Document Title
Unless specified with the -t option, the HTML file is scanned for <TITLE> ... </TITLE>
tags and, if found, the title is extracted and put on line 1 of the generated file.

Bookmarks
Bookmarks are placed into the generated file wherever <A NAME="..."> tags are found in the
HTML file.

OPTIONS

-bchars Specify the character sequence that is to serve as the bookmark indicator. The
default is (*). (See the CAVEATS.)

-ttitle Specify the title of the document that is to appear on line 1 of the generated
file overriding any title found inside the HTML file between <TITLE> ...
</TITLE> tags.

-uurl Specify the URL the HTML file supposedly came from and put it on the line after
the title, if any, in the generated file.

-v Print the version number to standard output and exit.

EXAMPLE

To convert an HTML file to Doc:

html2pdbtxt -u http://www.wonderland.org/ alice.html alice.txt
txt2pdbdoc "`head -1 alice.txt`" alice.txt alice.pdb

CAVEATS

1. Some Doc readers have a ``feature'' whereby, during the scan for bookmarks phase, they
recognize the bookmark sequence of characters anywhere in the text and not just at the
beginning of a line.

2. Some Doc readers do not allow the bookmark sequence to contain the > character since
they interpret that as the sequence delimiter, e.g., <->> will be interpreted as the
sequence being merely -.

3. Ordered lists (via the OL tag) are treated as unordered lists (like the UL tag)
because it would greatly complicate the code since it would have to be parsed rather
than simple substitutions being performed.

Use html2pdbtxt online using onworks.net services