Text::MetaText 0.22

Text::MetaText is a Perl extension implementing meta-language for processing "template" text files.

SYNOPSIS

use Text::MetaText;

my $mt = Text::MetaText->new();

# process file content or text string
print $mt->process_file($filename, %vardefs);
print $mt->process_text($textstring, %vardefs);

# pre-declare a BLOCK for subsequent INCLUDE
$mt->declare($textstring, $blockname);
$mt->declare(@content, $blockname);

SUMMARY OF METATEXT DIRECTIVES

%% DEFINE
variable1 = value # define variable(s)
variable2 = "quoted value"
%%

%% SUBST variable %% # insert variable value
%% variable %% # short form of above

%% BLOCK blockname %% # define a block blockname
block text...
%% ENDBLOCK %%

%% INCLUDE blockname %% # include blockname block text
%% INCLUDE filename %% # include external file filename

%% INCLUDE file_or_block # a more complete example...
variable = value # additional variable definition(s)
if = condition # conditional inclusion
unless = condition # conditional exclusion
format = format_string # printf-like format string with %s
filter = fltname(params) # post-process filter
%%

%% TIME # current system time, as per time(2)
format = format_string # display format, as per strftime(3C)
%%