PFT::Content - Filesytem tree mapping content
PFT::Content->new($basedir); PFT::Content->new($basedir, {create => 1});
The structure is the following:
content ├── attachments ├── blog ├── pages ├── pics └── tags
Quick accessors for directories
$tree->dir_root $tree->dir_blog $tree->dir_pages $tree->dir_tags $tree->dir_pics $tree->dir_attachments
Non-existing directories are created by the constructor.
Create and return a page. A header is required as argument. If the page does not exist it gets created according to the header. If the header contains a date, the page is considered to be a blog entry (and positioned as such).
Similar to new_entry, but does not create the content file if it doesn't exist already.
new_entry
Given a PFT::Header object, returns the path of a page or blog page within the tree.
Create and return a tag page. A header is required as argument. If the tag page does not exist it gets created according to the header.
Similar to new_tag, but does not create the content file if it doesn't exist already.
new_tag
List all blog entries
List all pages
List all tag pages
List all entries (pages, blog, tags)
Accepts a list of strings which will be joined into the path of a picture file. Returns a PFT::Content::Blob instance, which could correspond to a non-existing file. The caller might create it (e.g. by copying a picture on the corresponding path).
PFT::Content::Blob
List all pictures
Accepts a list of strings which will be joined into the path of an attachment file. Returns a PFT::Content::Blob instance, which could correspond to a non-existing file. The caller might create it (e.g. by copying a file on the corresponding path).
Note that the input path should be made by strings in encoded form, in order to match the filesystem path.
List all attachments
Go back in blog history. Expects one optional argument as the number of steps backward in history. If such argument is not provided, it defaults to 0, returning the most recent entry. Returns a PFT::Content::Blog object.
Given a path (of a page) determine the corresponding date. Returns a PFT::Date object or undef if the page does not have date.
Given a path (of a page) determine the corresponding slug string.
Notify a renaming of a inner file. First parameter is the original name, second parameter is the new name.
To install PFT, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PFT
CPAN shell
perl -MCPAN -e shell install PFT
For more information on module installation, please visit the detailed CPAN module installation guide.