pft init - Initialize a PFT Site
pft init [options]
This command initializes a PFT site in the current directory. It generates a configuration file named pft.yaml and it creates the following filesystem structure (see pft(1)).
pft.yaml
A generic configuration skeleton is provided by default, and can be modified by editing the pft.yaml configuration file. Each option explained in this manual page corresponds to an equally named setting in the pft.yaml file.
Remote host where to publish (see pft-pub(1)). Defaults to example.org.
example.org
Method used for publishing (see pft-pub(1)). Defaults to rsync+ssh.
rsync+ssh
Remote path on publishing host (see pft-pub(1)). Defaults to /home/$USER/public_html, as by tradition.
/home/$USER/public_html
Port for connection on publishing host (see pft-pub(1)). Defaults to 22.
22
User login on publishing host (see pft-pub(1)). Defaults to $USER (environment variable).
Global Author, can be overriden by individual entries. Defaults to $USER (environment variable).
$USER
Charset of the generated web pages. Defaults to what is defined by locale(1).
Description of the channel (<description> in the XML). Defaults to News from a PFT website.
<description>
News from a PFT website
Number of most recent blog entries to list in the RSS feed. Defaults to 10.
10
File name of the RSS XML to be published by pft-gen-rss(1). Defaults to feed.rss.
feed.rss
First page, where index.html will redirect the browsers. Defaults to Welcome.
index.html
Welcome
Global HTML template, can be overriden by individual entires. Defaults to default.html.
default.html
Global theme (e.g. light or dark) optionally honored by templates. Specific accepted values depend on the template implementation. Defaults to light.
light
dark
Title of the website. Defaults to My PFT website.
My PFT website
Base url for the website. Defaults to http://example.org.
http://example.org
Browser to be invoked by pft-show(1). You may specify an executable, or a sh(1) command where "%s" gets replaced with the file name (e.g. "firefox -profile x '%s'"). Defaults to $BROWSER (environment variable), or firefox if not defined.
$BROWSER
firefox
Editor to be invoked by pft-edit(1). You may specify an executable, or a sh(1) command where "%s" gets replaced with the file name (e.g. "vim +'set filetype=markdown spell' %s"). Defaults to $EDITOR (environment variable), or vi if not defined.
$EDITOR
vi
# END AUTOGEN
The following environment variables are honored as sensible defaults unless some different setting is supplied by command line arguments.
pft, pft-pub(1)
To install App::PFT, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::PFT
CPAN shell
perl -MCPAN -e shell install App::PFT
For more information on module installation, please visit the detailed CPAN module installation guide.