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.