NAME

svgcal.pl - Creates the pages for a calendar in SVG format

VERSION

This documentation refers to svgcal.pl version 0.3.1.

SYNOPSIS

  svgcal.pl [option] --date {see below}
  svgcal.pl [--verbose | --VERSION | --help | --man]

OPTIONS:
 -o --out=str   The base file name when out putting multiple months
 -d --date      Parameters that control the months displaied on the
                calendar
   start=YYYY-MM   Start month
   end=YYYY-MM     End month
   year=YYYY       Year to base the whole calendar on (Default next year)
   month=YYYY-MM   Display only this month
 -m --moon      Moon parameters
   display=1       Display the moon on individual days
   quarters=1|0    Show only whole quarters
   vpos=top|bottom Specifies which quadrent the moon should appear in
   hpos=left|right as above
   xoffset=num     Precisly set the x position of moon
   yoffset=num     Precisly set the y position of moon
   radius=n%       The radius as a percentage of day box width
   image=url       An image of the moon to use as the fill background of
                   the moon
 -c --ical      ICal parameters
 -p --page      Specify a page type or a height or width of the page
   page=A0..A6     The page type
   height=size     The page height (with optional units)
   width=size      The page width (with optional units)
 -i --image     Specifies the images to be displayed on the calendar
   src=file        This image will be used for any image with out a specific
                   month image.
   dir=directory   Finds images in the directory named after the months
                   (eg 01-12 or January-December)
   YYYY-MM=file    Use this image for the specified month
 -h --height    The height on the page that the calendar shoud take up.
                Either a fraction or a percent (Default 50%)
 -C --config    Location of the configuration file (Default ~/.svgcal)
 -P --path=template path
                Specify a colon seperated path to find templates in
 -t --template=template_dir
                The name of a template directory to use instead of the
                default templates (expects to find a template there called
                calendar.svg)
 -s --save      Save any other command line options to your config file
    --show-template
                Displays the default template used by SVG::Calendar,
                this is useful if you want to change the default template

 -v --verbose   Show more detailed option
    --version   Prints the version information
    --help      Prints this help information
    --man       Prints the full documentation for svgcal.pl

DESCRIPTION

This script provides a command line interface to the SVG::Calendar library. Most of the functionality is exposed here.

Configuration

To make configuration using this tool options can be saved to thee ~/.svgcal file. The format of the configuration file is similar to INI files. The easiest way to start using the configuration file is once you have set up the options that you like use the --save option which will write the current configuration to the file. If you use --save again the file should be updated leaving comments in place.

SUBROUTINES/METHODS

DIAGNOSTICS

CONFIGURATION AND ENVIRONMENT

DEPENDENCIES

INCOMPATIBILITIES

BUGS AND LIMITATIONS

There are no known bugs in this module.

Please report problems to Ivan Wills (ivan.wills@gmail.com).

Patches are welcome.

AUTHOR

Ivan Wills - (ivan.wills@gmail.com)

LICENSE AND COPYRIGHT

Copyright (c) 2006-2009 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW, Australia 2077) All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. 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.