Path: usenet.cise.ufl.edu!newsfeeds.nerdc.ufl.edu!news.magicnet.net!news.maxwell.syr.edu!newsfeed.corridex.com!nntp2.savvis.net!inetarena.com!not-for-mail
From: Gareth Rees <[email protected]>
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: HTML::FromText
Followup-To: comp.lang.perl.modules
Date: 27 Dec 1998 17:02:23 GMT
Organization: Canon Research Centre Europe
Lines: 54
Approved: [email protected] (comp.lang.perl.announce)
Message-ID: <[email protected]>
NNTP-Posting-Host: halfdome.holdit.com
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:205 comp.lang.perl.modules:7194

See http://www.perl.com/CPAN/authors/id/G/GD/GDR/HTML-FromText-1.000.tar.gz

 NAME
       HTML::FromText - flexibly mark up plain text as HTML

 SYNOPSIS
       use HTML::FromText 'text2html';
       print text2html($text, paras => 1, urls => 1);

 DESCRIPTION
       The function `text2html' converts plain text to HTML.  It can
       apply the follow transformations (each transformation is
       selected by passing the appropriate flag as an argument):

       * Turn HTML metacharacters into HTML entities.

       * Spot URLs and convert them to links.

       * Spot e-mail addresses and convert them to `mailto:' links.

       * Preserve line breaks.

       * Expand tabs and preserve spaces throughout the text.

       * Mark up words surrounded with *asterisks* as bold.

       * Mark up words surrounded with _underscores_ as underlined.

       * Format the text as paragraphs.

       * Spot paragraphs where every line begins with whitespace, and
         mark them up as block quotes.

       * Spot bulleted paragraphs and mark them up as an unordered
         list.

       * Spot numbered paragraphs and marks them up as an ordered list.

       * Spot headings (paragraphs starting with numbers) and mark them
         up as headings of the appropriate level.

       * Format the first paragraph of the text as a first-level
         heading.

 INSTALLATION
       perl Makefile.PL && make && make test && make install

 BUGS
       * There are lots of transformations it doesn't do.

--
Gareth Rees