Quickstart
Here's a quickstart document how to install and start hacking Plagger.
Install Dependencies from CPAN
Plagger requires lots of CPAN modules and can be installed using CPAN shell and/or ppm.
Unix Systems
On UNIX systems like Linux, Mac OSX or FreeBSD, you can use CPAN shell to install the dependencies. The best way to install them is to call
cpan> test Plagger
and Module::Install will take care about installing the dependencies. Because the command is test not install, this won't install Plagger to your system. I'd suggest using svn repository to sync up to the latest version, rather than installing Plagger onto your system.
See InstallPlagger how to actually install Plagger.
Windows
On Windows with ActivePerl?, you can also use CPAN shell if you have nmake.exe. But some modules require XS and can also be installed via PPM. (Example: DateTime?, XML-LibXML, HTML-Parser)
Install Dependencies using package manager
Couple of unofficial repositories contain rpm/debian/ppm packages so that you can install quickly onto your system using apt, yum, or ppm.
If you're using FreeBSD, Plagger is in ports under "textproc/p5-Plagger".
Create config.yaml
Now you're ready to start hacking Plagger. Run plagger command line and you'll get:
Plagger->bootstrap: config.yaml: No such file or directory at ./plagger line 19
Yeah, you have to create config.yaml in the current directory. Copying example config files in the examples directory is a good way to start rather than manually scratching the whole config.
Plagger accepts the path (or filename) to the .yaml file with --config option or the short version -c, like ./plagger --config debug.yaml or ./plagger -c debug.yaml, so that you can have multiple config files and run them via different crontab entry.
See PlaggerCookbook how to write config YAML file and what can be done.