Statocles::Page - Base role for rendering files
The site this page is part of.
The application this page came from, so we can give it to the templates.
The absolute URL path to save this page to.
The title of the page. Any unsafe characters in the title (
&) will be escaped by the template, so no HTML allowed.
The author of the page.
The MIME type of this page. By default, will use the path's file extension to detect a likely type.
The date of this page. Used for last updated date and blog post dates.
A hash of additional template variables for this page.
A hash of arrays of links to pages related to this page. Possible keys:
feed - Feed pages related to this page alternate - Alternate versions of this page posted to other sites stylesheet - Additional stylesheets for this page script - Additional scripts for this page
Each item in the array is a link object. The most common attributes are:
text - The text of the link href - The page for the link type - The MIME type of the link, optional
A hash of images related to this page. Each value should be an image object. These are used by themes to show images next to articles, thumbnails, and/or shortcut icons.
The markdown object to render document Markdown. Defaults to the markdown attribute from the Site object.
Any object with a "markdown" method will work.
How frequently a search engine should check this page for changes. This is used in the sitemap.xml to give hints to search engines.
Should be one of:
always hourly daily weekly monthly yearly never
NOTE: This is only a hint to search engines, not a command. Pages marked
hourly may be checked less often, and pages marked
never may still be checked once in a while.
never is mainly used for archived pages or permanent links.
How high should this page rank in search results compared to similar pages on this site? This is used in the sitemap.xml to rank individual, full pages more highly than aggregate, list pages.
Value should be between
1.0. The default is
This is only used to decide which pages are more important for the search engine to crawl, and which pages within your site should be given to users. It does not improve your rankings compared to other sites. See the sitemap protocol for details.
A Mojo::DOM object containing the HTML DOM of the rendered content for this page. Any edits made to this object will be reflected in the file written.
Editing this DOM object is the recommended way to edit pages.
Returns true if the page can render a DOM
my %vars = $page->vars;
Get extra template variables for this page
my $html = $page->render( %vars );
The result of this method is cached.
my @links = $page->links( $key ); my $link = $page->links( $key ); $page->links( $key => $add_link );
Get or append to the links set for the given key. See the links attribute for some commonly-used keys.
If only one argument is given, returns a list of link objects. In scalar context, returns the first link in the list.
If two or more arguments are given, append the new links to the given key.
$add_link may be a URL string, a hash reference of link attributes, or a Statocles::Link object. When adding links, nothing is returned.
my $image = $page->images( $key );
my $name = $page->basename;
Get the base file name of this page. Everything after the last
my $dir = $page->dirname;
Get the full directory to this page. Anything that isn't part of "basename".
There will not be a trailing slash unless it is the root directory.