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