README for SVG.pm
SVG.pm is a perl extention to generate standalone or inline SVG
(scaleable vector graphics) images using the W3C SVG xml recommendation.
Refer to the pod for full documentation and an example script,
or to the following mirrors:
1/ http://search.cpan.org/perldoc?SVG
2/ http://search.cpan.org/~ronan
The complete pod for SVG resides in SVG::Manual
type perldoc SVG::Manual on the command line
(c) 2001-2008 Ronan Oger, RO IT Systems, GmbH
homepage: http://www.roitsystems.com
CONTACT POINT
-------------
ronan@cpan.org
This software is provided as is and without warranty.
It is freely distributed under the general perl license.
LICENSE
-------
This software is provided under the terms of the Perl license
OVERVIEW
--------
SVG.pm makes it possible to generate fully-functional SVG images in perl.
100% of the SVG tags are supported, and any new arbitrary element tag can be
added by users by declaring it.
VERSION
-------
2.33 Sunday, 2005.05.15
DOCUMENTATION
-------------
The following documentation is available:
POD in HTML format
pod in perldoc format (type perldoc SVG on command line)
RESOURCES
---------
The following URLs offer additional resources for users of SVG.pm:
* Serverside Perl Forum: http://www.roitsystems.com/serverside/
* SVG.pm on-line manual http://www.roitsystems.com/man/SVG.html
* Perl SVG tutorials http://www.roitsystems.com/tutorial/
* Perl SVG Zone homepage http://www.roitsystems.com/
* gallery of the use of SVG.pm on the web http://roitsystems.com/gallery/svg/index.html
* SVG Foundation http://www.svgfoundation.org
* SVG Developers mailing list http://www.yahoogroups.com/svg-developers/
* W3 Consortium http://www.w3.org
* Sams Publishing, "SVG Unleashed", September 2002. There is a Perl chapter
* SVG Open Conference proceedings http://www.svgopen.org
* SVG foundation http://www.svgfoundation.org
* SVG dot org http://www.svg.org
INSTALLATION INSTRUCTIONS
-------------------------
***THERE ARE FIVE WAYS TO IMPLEMENT SVG MODULE IN PERL***
1/ Systems with CPAN support (all Unix/Linux/BSD/Mac):
-----------------------------------------------------
Install the new distribution via the Perl CPAN module:
In a shell:
/home/somewhere% perl -MCPAN -e"install SVG"
2/ (WIN) install Perl from Active State or equivalent:
-----------------------------------------------------
Make sure you already have perl or get it here: http://www.activestate.com
On the command line:
C:\> ppm
PPM> set repository tmp http://roitsystems.com/PPM/SVG/
PPM> install SVG
PPM> quit
C:\>
3/ Use Source RPMs.
Download the source RPM of your choice.
In a shell:
/hom/somewhere/% rpm -ihv SVG-source-rpm-name
You may be prompted for the root password
4/ The hard way (requires make or nmake, tar, gunzip, and gcc):
---------------------------------------------------------------
This method was tested in DOS, Windows, AS400, Linux, Unix, BSD, Mac.
Hard-headed users can directly get the distribution from
http://www.roitsystems.com/PPM/SVG/SVG-2.27.tar.gz or
http://www.roitsystems.com/PPM/SVG/ .
First download the source.
Then, in a shell:
/home/somewhere% gunzip SVG-2.27.tar.gz
/home/somewhere% tar-xvf SVG-2.27.tar
cd SVG-2.1
make
make test
make install
5/ If all the above fail, there is still a (cumbersome) way:
-----------------------------------------------------------
You have to install to a local dirctory and explicitly call the module
by using one of the following line in your calling program:
#using use lib
use lib 'path/where/the/release/is/located';
-or-
#using BEGIN block at the beginning of the file
BEGIN {
push @INC 'path/to/svg.pm-file'; #where the SVG.pm file lives
push @INC 'path/to/svg.pm-file/SVG'; # where the Utils.pm file lives
}
#Refer to the Perl manual for more details.
KNOWN BUGS & ISSUES
-------------------
Comments tags before the <svg> element are toxic. This is being worked on but I can not promise anything.
Please submit bug reports to http://rt.cpan.org
SEE ALSO
--------
SVG::Parser
SVG::DOM
SVG::XML
SVG::Element
CHANGE LOG
----------
You can find details about the changes over time in the change log file: Changes
COMMENTS/FEEDBACK
-----------------
Please email your feedback, comments, questions to the email address at the top
of this document. I will do my best to answer promptly. To date, I have not
knowingly failed to answer any emails.