Statocles::Theme - Templates, headers, footers, and navigation
version 0.083
# Template directory layout /theme/site/layout.html.ep /theme/site/include/layout.html.ep /theme/blog/index.html.ep /theme/blog/post.html.ep my $theme = Statocles::Theme->new( store => '/theme' ); my $layout = $theme->template( qw( site include layout.html ) ); my $blog_index = $theme->template( blog => 'index.html' ); my $blog_post = $theme->template( 'blog/post.html' ); # Clear out cached templates and includes $theme->clear;
A Theme contains all the templates that applications need. This class handles finding and parsing files into template objects.
When the "store" is read, the templates inside are organized based on their name and their parent directory.
The root URL for this application. Defaults to /theme.
/theme
The source store for this theme.
If the path begins with ::, will pull one of the Statocles default themes from the Statocles share directory.
An array of stores to look for includes. The "store" is added at the end of this list.
The cached template objects for this theme.
The cached template objects for the includes.
Handle the path :: share theme.
my $tmpl = $theme->read( $path )
Read the template for the given path and create the template object.
path
my $tmpl = $theme->build_template( $path, $content )
Build a new Statocles::Template object with the given path and content.
content
my $tmpl = $theme->template( $path ) my $tmpl = $theme->template( @path_parts )
Get the template at the given path, or with the given path_parts.
path_parts
my $tmpl = $theme->include( $path ); my $tmpl = $theme->include( @path_parts );
Get the desired template to include based on the given path or path_parts. Looks through all the include_stores before looking in the main store.
$theme->helper( $name, $sub );
Register a helper on this theme. Helpers are functions that are added to the template to allow for additional features. Helpers are usually added by Statocles plugins.
There are a default set of helpers available to all templates which cannot be overridden by this method.
$theme->clear;
Clear out the cached templates and includes. Used by the daemon when it detects a change to the theme files.
Get the extra, non-template files to deploy with the rest of the site, like CSS, JavaScript, and images.
Templates, files that end in .ep, will not be deployed with the rest of the site.
.ep
Doug Bell <preaction@cpan.org>
This software is copyright (c) 2016 by Doug Bell.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Statocles, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Statocles
CPAN shell
perl -MCPAN -e shell install Statocles
For more information on module installation, please visit the detailed CPAN module installation guide.