Data::Phrasebook::Plain(3pm)				User Contributed Perl Documentation			      Data::Phrasebook::Plain(3pm)

NAME

       Data::Phrasebook::Plain - The Simple Phrasebook Model.

SYNOPSIS

	   use Data::Phrasebook;

	   my $q = Data::Phrasebook->new(
	       class  => 'Plain',
	       loader => 'Text',
	       file   => 'phrases.txt',
	   );

	   my $r = Data::Phrasebook->new( file => 'phrases.txt' );

	   # simple keyword to phrase mapping
	   my $phrase = $q->fetch($keyword);

	   # keyword to phrase mapping with parameters
	   $q->delimiters( qr{ [% s* (w+) s* %] }x );
	   my $phrase = $q->fetch($keyword,{this => 'that'});

DESCRIPTION

       This module is the fallback or default phrasebook class. It doesn't do much except act as a very simple templating facility.

METHODS

   fetch
       Retrieves the specified "template" and substitutes any "keywords" for "values".

       Thus, given:

	   hello=Hello [% where %]!

       And code:

	   my $text = $q->fetch( 'hello', {
	       where => 'world'
	   } );

       Return value is:

	   Hello world!

       The delimiters are deliberately taken from Template Toolkit.

SEE ALSO

       Data::Phrasebook, Data::Phrasebook::Generic.

SUPPORT

       Please see the README file.

AUTHOR

	 Original author: Iain Campbell Truskett (16.07.1979 - 29.12.2003)
	 Maintainer: Barbie <barbie@cpan.org> since January 2004.
	 for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

	 Copyright (C) 2003 Iain Truskett.
	 Copyright (C) 2004-2010 Barbie for Miss Barbell Productions.

	 This module is free software; you can redistribute it and/or
	 modify it under the Artistic Licence v2.

perl v5.10.1							    2010-08-31					      Data::Phrasebook::Plain(3pm)