pdbtxt2html(1) [minix man page]

pdbtxt2html(1)						      General Commands Manual						    pdbtxt2html(1)

NAME

       pdbtxt2html - Doc Text to HTML converter for Palm Pilots

SYNOPSIS

       pdbtxt2html [ -t ] file.txt [ file.html ]
       pdbtxt2html -v

DESCRIPTION

       pdbtxt2html converts text converted from a Doc(4) file via txt2pdbdoc(1) to HTML.  If no HTML filename is given, the generated HTML is sent
       to standard output.

   Document Title
       The first line of the file is used for the HTML document title.

   Bookmarks
       The last line of the file is examined and, if it contains a string enclosed between < and >, that is taken to be the bookmark marker.   The
       entire file is then scanned looking for lines beginning with it (ignoring leading whitespace).  These lines are converted to HTML headings.

       The  number  of whitespace characters after the first bookmark marker is used for heading level 1.  The level of subsequent headings is set
       to the number of whitespace characters between the bookmark marker and the bookmark text minus the number for the first bookmark plus one.

   Embedded URLs
       Valid URLs (according to RFC 1630) embedded in the text are turned into hyperlinks.  The ftp, gopher, http, https,  mailto,  news,  telnet,
       and wais URLs are recognized.

OPTIONS

       -t   Compile a table of contents and insert it between the first heading and the body.

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

EXAMPLE

       To convert a Doc file to HTML:

	    txt2pdbdoc alice.pdb alice.txt
	    pdbtxt2html alice.txt alice.html

SEE ALSO

       html2pdbtxt(1), txt2pdbdoc(1), doc(4), pdb(4)

       Tim Berners Lee.  Universal Resource Identifiers in WWW, Network Working Group of the Internet Engineering Task Force, June 1994.
	    http://info.internet.isi.edu/in-notes/rfc/files/rfc1630.txt

AUTHOR

       Paul J. Lucas <pauljlucas@mac.com>

txt2pdbdoc							 January 21, 2005						    pdbtxt2html(1)

html2pdbtxt(1)						      General Commands Manual						    html2pdbtxt(1)

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.

SEE ALSO

       pdbtxt2html(1), txt2pdbdoc(1), doc(4), pdb(4)

       International Standards Organization.  ``ISO 8859-1: Information Processing -- 8-bit single-byte coded graphic character sets  --  Part	1:
       Latin alphabet No. 1.''	1987.

       World Wide Web Consortium.  ``Character entity references in HTML 4.0.''  HTML 4.0 Specification, http://www.w3.org/

AUTHOR

       Paul J. Lucas <pauljlucas@mac.com>

html2pdbtxt							 January 21, 2005						    html2pdbtxt(1)