1README for SVG.pm 2 3SVG.pm is a perl extension to generate standalone or inline SVG (short for 4"Scalable Vector Graphics") images using the W3C's SVG XML recommendation. 5 6Refer to the POD documentation for full documentation and an example script or to 7the following mirror: 8 9 https://metacpan.org/module/SVG 10 11The complete POD documentation for SVG resides in the SVG module itself - type 12"perldoc SVG" on the command line. 13 14(c) 2001-2008 Ronan Oger, RO IT Systems, 15GmbH homepage: http://www.roitsystems.com 16 17CONTACT POINT 18------------- 19 20szabgab@cpan.org 21 22This software is provided as is and without warranty. It is freely distributed 23under the general perl license. 24 25LICENSE 26------- 27 28This software is provided under the terms of the Perl license 29 30OVERVIEW 31-------- 32 33SVG.pm makes it possible to generate fully-functional SVG images in perl. 100% of 34the SVG tags are supported, and any new arbitrary element tag can be added by 35users by declaring it. 36 37DOCUMENTATION 38------------- 39 40The following documentation is available: 41 42* POD in perldoc format (type "perldoc SVG" on the command line.) 43 44RESOURCES 45--------- 46 47The following URLs offer additional resources for users of SVG.pm: 48 49* Perl SVG tutorials http://www.roitsystems.com/tutorial/ 50* Perl SVG Zone homepage http://www.roitsystems.com/ 51* gallery of the use of SVG.pm on the web http://roitsystems.com/gallery/svg/index.html 52* W3 Consortium http://www.w3.org/Graphics/SVG/ 53* Sams Publishing, "SVG Unleashed", September 2002. There is a Perl chapter 54* SVG Open Conference proceedings http://www.svgopen.org/ 55 56INSTALLATION INSTRUCTIONS 57------------------------- 58 59***THERE ARE FOUR WAYS TO INSTALL THE SVG MODULE IN PERL*** 60 611) Systems with CPAN support (all Windows/Unix/Linux/BSD/Mac): 62 ----------------------------------------------------------- 63 64 Install the new distribution via the Perl CPAN module: 65 In a shell: 66 67 /home/somewhere% cpan install SVG 68 69 You can alternatively use CPANPLUS or cpanm. 70 712) (Windows) install Perl from ActiveState: 72 ---------------------------------------- 73 74 Make sure you already have perl or get it here: http://www.activestate.com 75 On the command line: 76 77 C:\> ppm install SVG 78 79 803) Use RPMs: 81 --------- 82 83 Download the source RPM of your choice. 84 In a shell: 85 86 /hom/somewhere/% rpm -ihv SVG-source-rpm-name 87 You may be prompted for the root password 88 894) The hard way (requires make, dmake or nmake, tar, gunzip, and gcc): 90 ------------------------------------------------------------------- 91 92 This method was tested in DOS, Windows, AS400, Linux, Unix, BSD, Mac. 93 Hard-headed users can directly get the distribution from a CPAN mirror. 94 First download the source. 95 Then, in a shell: 96 97 /home/somewhere% gunzip SVG-2.27.tar.gz 98 /home/somewhere% tar-xvf SVG-2.27.tar 99 cd SVG-2.1 100 make 101 make test 102 make install 103 104KNOWN BUGS & ISSUES 105------------------- 106 107Comments tags before the <svg> element are toxic. This is being worked on but I 108can not promise anything. 109 110Please submit bug reports to http://rt.cpan.org 111 112SEE ALSO 113-------- 114 115SVG::Parser 116SVG::DOM 117SVG::XML 118SVG::Element 119 120CHANGE LOG 121---------- 122 123You can find details about the changes over time in the change log file: Changes 124 125COMMENTS/FEEDBACK 126----------------- 127 128Please email your feedback, comments, questions to the email address at the top 129of this document. I will do my best to answer promptly. To date, I have not 130knowingly failed to answer any emails. 131