NAME
plerdwatcher - Daemon that automatically updates a Plerd-based blog when needed
SYNOPSIS
In /path/to/plerd/conf/plerd.conf:
base_uri: http://blog.example.com path: /home/me/Dropbox/plerd title:
My Lovely Blog
And then, on the command line, while in the top-level plerd directory:
bin/plerdwatcher start
DESCRIPTION
This script launches a simple daemon that monitors a Plerd blog's directory of Markdown-based source documents for changes. When it sees changes, it will direct Plerd to publish or republish files as needed.
It also supports options to send and receive webmentions, as described in "OPTIONS", below.
plerdwatcher runs via App::Daemon, and accepts all the command-line arguments documented there.
It stores its logs in a directory called log
and other run-time files in a run
directory, both of which it expects to find as siblings of its own parent directory (usually bin
).
For instructions on installing and using Plerd, please see the README file that should have accompanied this distribution. It is also available online at https://github.com/jmacdotorg/plerd#plerd.
OPTIONS
config
bin/plerdall --config=/path/to/plerd.conf
Specify the location of a valid Plerd config file.
If not specified here, then this program will seek a config file in these locations, and in this order:
plerd.conf
, in the current working directoryconf/plerd.conf
, in the current working directory.plerd
, in your home directory
Consult the config file generated by plerdall --init
to learn more about the config file format.
EXPERIMENTAL OPTIONS
All of these Webmention-related options are experimental.
send-webmentions
bin/plerdwatcher --send-webmentions start
Newly created or updated posts will also attempt to send webmentions to any URLs they link to.
receive-webmentions=port
bin/plerdwatcher --receive-webmentions=4000 start
Launches a webserver that listens on the specified TCP port. This will allow plerdwatcher to receive webmentions.
SEE ALSO
AUTHOR
Jason McIntosh <jmac@jmac.org>