/ 
Comics-0.05
River stage zero No dependents
/ Comics

NAME

Comics - Comics aggregator in the style of Gotblah

SYNOPSIS

perl -MComics -e 'main()' -- [options] [plugin ...]

or

perl Comics.pm [options] [plugin ...]

If the associated collect tool has been installed properly:

collect [options] [plugin ...]

 Options:
   --spooldir=XXX	where resultant images and index must be stored
   --refresh		consider all images as new
   --ident		shows identification
   --help		shows a brief help message and exits
   --man                shows full documentation and exits
   --verbose		provides more verbose information
   --quiet		provides no information unless failure

OPTIONS

--spooldir=XXX

Designates the spool area. Downloaded comics and index files are written here.

--help

Prints a brief help message and exits.

--man

Prints the manual page and exits.

--ident

Prints program identification.

--verbose

Provides more verbose information. This option may be repeated for even more verbose information.

--quiet

Silences verbose information.

plugin

If present, process only the specified plugins.

Mostly for testing.

DESCRIPTION

This program will load the available plugins and run all of them.

The plugins will examine the contents of comics sites and update the 'cartoon of the day' in the spool area.

Upon completion, an index.html is generated in the spool area to view the comics collection.

It is best to run this program from the spool area itself.

PLUGINS

Important: This program assumes that the plugins can be found in ../lib relative to the location of the executable file.

All suitable Comics::Plugin::plugin.pm files are examined and loaded.

Plugins are derived from Fetcher classes, see below.

See Comics::Plugin::Sigmund for a fully commented plugin.

FETCHERS

Fetchers implement different fetch strategies. Currently provided are:

Comics::Fetcher::Direct - fetch a comic by URL.

Comics::Fetcher::Single - fetch a comic by examining the comic's home page.

Comics::Fetcher::GoComics - fetch a comic from a GoComics site.

ACKNOWLEDGEMENTS

The people behind Gotblah, for creating the original tool.

LICENSE

Copyright (C) 2016, Johan Vromans,

This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.