README
1This package includes the module Text::FIGlet, several scripts which use it,
2the FIGlet fonts standard.flf and mini.flf and documentation on creating fonts.
3
4NAME
5 Text::FIGlet - a perl module to provide FIGlet abilities, akin to banner
6
7SYNOPSIS
8 my $font = Text::FIGlet-E<gt>new(-f=>"doh");
9 print scalar $font->figify(-A=>"Hello World");
10
11DESCRIPTION
12
13 But why?
14
15 Because I could.
16
17 But why?
18
19 Because I like FIGlet and Perl.
20
21 But why? In Bob's name WHY?! What purpose could it serve?
22
23 If you want something more substantive imagine:
24 * Run Apache with mod_perl
25 * In F<startup.pl> create a Text::FIGlet object
26 * figify text for the heads of Directory listings,
27 and you look like a warm and fuzzy BBS
28 * create ornate text based counters or timestamps on pages
29 * {shudder} CAPTCHA bots
30 NOTE: Ransom mode--unique to this implementation--may be handy here.
31
32 Or not, I just make the scissors, now run along.
33
34EXAMPLES
35
36% figlet -A Hello World
37 _ _ _ _ __ __ _ _
38| | | | ___| | | ___ \ \ / /__ _ __| | __| |
39| |_| |/ _ \ | |/ _ \ \ \ /\ / / _ \| '__| |/ _` |
40| _ | __/ | | (_) | \ V V / (_) | | | | (_| |
41|_| |_|\___|_|_|\___/ \_/\_/ \___/|_| |_|\__,_|
42
43
44% figlet.pl -A Hello World
45 _ _ _ _ __ __ _ _
46| | | | ___ | || | ___ \ \ / / ___ _ __ | | __| |
47| |_| | / _ \| || | / _ \ \ \ /\ / / / _ \ | '__|| | / _` |
48| _ || __/| || || (_) | \ V V / | (_) || | | || (_| |
49|_| |_| \___||_||_| \___/ \_/\_/ \___/ |_| |_| \__,_|
50
51figlet.pl is a young adult and does not yet do sophisticated smushing,
52or other fancy layout like vertical fitting.
53
54minifig.pl is a self-contained version of figlet.pl
55It requires nothing more than a standard Perl distribution.
56For more information about minifig.pl see minifig.pl -help,
57and doc/minifig.HOWTO on customizing it.
58
59% minifig.pl -A Hello World
60
61|_| _ | | _ \ / _ ._ | _|
62| | (/_ | | (_) \/\/ (_) | | (_|
63
64
65INSTALLATION
66
67perl Makefile.PL
68make test
69bin/figlet.pl -d share
70make install
71