Path: usenet.cise.ufl.edu!huron.eel.ufl.edu!usenet.eel.ufl.edu!uky.edu!atl-news-feed1.bbnplanet.com!cpk-news-hub1.bbnplanet.com!news.gtei.net!nntp.abs.net!cyclone.i1.net!uunet!in2.uu.net!news.neta.com!not-for-mail
From: [email protected] (Jari Aalto+mail.perl)
Newsgroups: comp.lang.perl.announce,comp.lang.perl.misc
Subject: ANNOUNCE: v1.138 t2html.pl Text to html conversion script, Perl 5.004+
Followup-To: comp.lang.perl.misc
Date: 26 Nov 1998 03:36:47 GMT
Organization: University of Tampere
Lines: 124
Approved: [email protected] (comp.lang.perl.announce)
Message-ID: <[email protected]>
NNTP-Posting-Host: gadget.cscaper.com
X-Trace: news.neta.com 912051407 14872 206.67.186.3 (26 Nov 1998 03:36:47 GMT)
X-Complaints-To: [email protected]
NNTP-Posting-Date: 26 Nov 1998 03:36:47 GMT
X-Disclaimer: The "Approved" header verifies header information for article transmission and does not imply approval of content.
Xref: usenet.cise.ufl.edu comp.lang.perl.announce:174 comp.lang.perl.misc:50591



Download

       ANNOUNCE: v1.138 t2html.pl Text to html conversion script, Perl 5.004+

       Home page:

           ftp://cs.uta.fi/pub/ssjaaa/t2html.html

       Available by Email:

           To: <[email protected]>
           Subject: send t2html.pl

       Perl language interpreter pointers at (Win32/Unix etc.)

           http://language.perl.com/info/software.html

What's new

   Faster and Cleaner HTML code generation.

       The HTML markup code was completely rewritten and the
       --html-column-color option was made obsolete. Colours are now coming
       from CSS.

       This version now generates HTML 2x faster, eg. my 600k Procmail
       faq PAGE now takes 33secs on HP-UX, where it used to take 70secs.

   HTML 4.0 CSS now supported

       The generated html contains default HTML 4.x CSS (Cascading Style
       Sheet) information which you can easily modify. The new CSS takes
       advantage of some nice MSIE "hoovering" of links to make HTML
       pages more responsive.

       You can import your own CSS or Jave code with --java-file switch.

Description

       Writing text documents is different from writing messages to Usenet
       or to your fellow workers. There already exists several tools to
       convert email messages into html, like MHonArc, Email hyper
       archiver, but for regular text documents, like for memos, FAQs,
       help pages and for other papers, I didn't find any suitable html
       converter couple of years back.

       I wanted a simple html tool which would read text documents I
       maintained: several Emacs guides, procmail tips page, program
       documentations, my home pages etc. and convert them into html. And
       here you will find the specification how to format your text
       documents for *t2html* perl script.

       Program has html Link validation commands (uses LWP)

How it works

       Text must be placed at certain column positions to enable proper
       html formatting. The style used is called Technical format (TF).
       You're looking at TF format right now. TF specification is included
       in the t2html.pl --help.

       You need nothing else but a text editor where the current column
       number is displayed or editor that advances your TAB by 4 spaces.
       That's it.

Comparision to existing txt2html.pl

       The t2html.pl is different that text2html.pl in following respect:

       [t2html]

       o   Requires that you really format your text into
           TF layout like this message. This ensures that all your documents
           look similar.
       o   was designed to meet requirements of formally written
           text, such as official MEMOs, FAQs, drafs, lectures...
       o   Generates coloured html pages: --html-colour
       o   Generates Framed html pages: --html-frame

       [text2html]

       o   txt2html.pl uses normal text file and requires no previous
           markup.

Emacs and minor mode for helping to write TF

       If word `Emacs' means anything to you, then you can use additional
       Emacs minor mode (package TinyTf.el) that I wrote especially to
       help writing documents, formatting paragraphs, auto filling bullets
       and keeping TOC up to date. The description of the Emacs package is
       added to the page. If you don't know about Emacs but got
       interested, then see these for more Emacs info:

           ftp://cs.uta.fi/pub/ssjaaa/elisp.html
           ftp://cs.uta.fi/pub/ssjaaa/ema-tiny.html
           ftp://cs.uta.fi/pub/ssjaaa/tiny-tools.tar.gz  (contains tinytf.el)

Todo


   HTML Split feature

       This would be nice, but it's hard to implement, especially with
       frame support. Don't expect it appear in near future.

   Configuration file

       There are dozen of options and it would be nice if the files you
       convert can be specified from Perl configuration file.

   Better linkin capabilities

       Currently the linking of separate documents must be instructed by
       hand with separate options:

               --button-next
               --button-previous
               --button-top            (usually index.html)

End