Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mason(3pm) [debian man page]

Mason(3pm)						User Contributed Perl Documentation						Mason(3pm)

NAME

       Mason - Powerful, high-performance templating for the web and beyond

SYNOPSIS

	 foo.mc:
	   % my $name = "Mason";
	   Hello world! Welcome to <% $name %>.

	 #!/usr/local/bin/perl
	 use Mason;
	 my $mason = Mason->new(comp_root => '...');
	 print $mason->run('/foo')->output;

DESCRIPTION

       Mason is a powerful Perl-based templating system, designed to generate dynamic content of all kinds.

       Unlike many templating systems, Mason does not attempt to invent an alternate, "easier" syntax for templates.  It provides a set of syntax
       and features specific to template creation, but underneath it is still clearly and proudly recognizable as Perl.

       Mason is most often used for generating web pages. It has a companion web framework, Poet, designed to take maximum advantage of its
       routing and content generation features.  It can also be used as the templating layer for web frameworks such as Catalyst and Dancer.

       All documentation is indexed at Mason::Manual.

       The previous major version of Mason (1.x) is available under the name HTML::Mason.

SUPPORT

       The mailing list is "mason-users@lists.sourceforge.net". You must be subscribed to send a message. To subscribe, visit
       https://lists.sourceforge.net/lists/listinfo/mason-users <https://lists.sourceforge.net/lists/listinfo/mason-users>.

       You can also visit us at "#mason" on <irc://irc.perl.org/#mason>.

       Bugs and feature requests will be tracked at RT:

	   http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mason
	   bug-mason@rt.cpan.org

       The latest source code can be browsed and fetched at:

	   http://github.com/jonswar/perl-mason
	   git clone git://github.com/jonswar/perl-mason.git

       The official Mason website is <http://www.masonhq.com/>, however it contains mostly information about Mason 1. We're not sure what the
       future of the website will be wrt Mason 2.

ACKNOWLEDGEMENTS

       Thanks to Stevan Little and the Moose team for the awesomeness of Moose, which motivated me to create a second version of Mason years after
       I thought I was done.

       Thanks to Tatsuhiko Miyagawa and the PSGI/Plack <http://plackperl.org/> team, who freed me from ever worrying about server backends again.

SEE ALSO

       HTML::Mason

AUTHOR

       Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Jonathan Swartz.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.14.2							    2012-05-02								Mason(3pm)

Check Out this Related Man Page

Mason::Plugin::HTMLFilters(3pm) 			User Contributed Perl Documentation			   Mason::Plugin::HTMLFilters(3pm)

NAME

       Mason::Plugin::HTMLFilters - Filters related to HTML generation

FILTERS

       HTML or H
	   Do a basic HTML escape on the content - just the characters '&', '>', '<', and '"'.

	       <input name="company" value="<% $company | H %>">

       HTMLEntities
	   Do a comprehensive HTML escape on the content, using HTML::Entities::encode_entities.

       URI or U
	   URI-escape the content.

	       <a href="<% $url | U %>">

       HTMLPara
	   Formats a block of text into HTML paragraphs.  A sequence of two or more newlines is used as the delimiter for paragraphs which are
	   then wrapped in HTML ""<p>""...""</p>"" tags. Taken from Template::Toolkit. e.g.

	       % $.HTMLPara {{
	       First paragraph.

	       Second paragraph.
	       % }}

	   outputs:

	       <p>
	       First paragraph.
	       </p>

	       <p>
	       Second paragraph.
	       </p>

       HTMLParaBreak
	   Similar to HTMLPara above, but uses the HTML tag sequence "<br><br>" to join paragraphs. Taken from Template::Toolkit. e.g.

	       % $.HTMLPara {{
	       First paragraph.

	       Second paragraph.
	       % }}

	   outputs:

	       First paragraph.
	       <br><br>
	       Second paragraph.

       FillInForm ($form_data, %options)
	   Uses HTML::FillInForm to fill in the form with the specified $form_data and %options.

	       % $.FillInForm($form_data, target => 'form1') {{
	       ...
	       <form name='form1'>
	       ...
	       % }}

SUPPORT

       The mailing list for Mason and Mason plugins is mason-users@lists.sourceforge.net. You must be subscribed to send a message.  To subscribe,
       visit https://lists.sourceforge.net/lists/listinfo/mason-users <https://lists.sourceforge.net/lists/listinfo/mason-users>.

       You can also visit us at "#mason" on <irc://irc.perl.org/#mason>.

       Bugs and feature requests will be tracked at RT:

	   http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mason-Plugin-HTMLFilters
	   bug-mason-plugin-htmlfilters@rt.cpan.org

       The latest source code can be browsed and fetched at:

	   http://github.com/jonswar/perl-mason-plugin-htmlfilters
	   git clone git://github.com/jonswar/perl-mason-plugin-htmlfilters.git

SEE ALSO

       Mason

perl v5.14.2							    2012-06-11					   Mason::Plugin::HTMLFilters(3pm)
Man Page