gitpan / palm-palmdoc Goto Github PK
View Code? Open in Web Editor NEWRead-only release history for Palm-PalmDoc
Home Page: http://metacpan.org/release/Palm-PalmDoc
Read-only release history for Palm-PalmDoc
Home Page: http://metacpan.org/release/Palm-PalmDoc
README for Palm::PalmDoc WHATIS This module can format ASCII text into a PalmDoc PDB file. INSTALLING Palm::PalmDoc can be installed easily by using the CPAN module. perl -MCPAN -e"install Palm::PalmDoc" or manually by untarring the archive and running the following commands. perl Makefile.PL make make test make install REQUIREMENTS This module does not require any modules. USING Palm::PalmDoc can be used as follows. # Example 1 use Palm::PalmDoc; my $doc = Palm::PalmDoc->new({INFILE=>"foo.txt",OUTFILE=>"foo.pdb",TITLE=>"foo bar",COMPRESS=>1}); $doc->read_text(); $doc->write_text(); -or- # Example 2 use Palm::PalmDoc; my $doc = Palm::PalmDoc->new({OUTFILE=>"foo.pdb",TITLE=>"foo bar"}); $doc->compression(1); $doc->body("Foo Bar"x100); $doc->write_text(); -or- #Example 3 use Palm::PalmDoc; my $doc = Palm::PalmDoc->new(); $doc->body("Foo Bar"x1000); $doc->title("Foo Bar Baz"); open(FOO,">foo.pdb") || die $!; print FOO $doc->pdb_header(),$doc->body(); close(FOO); -or- #Example 4 use Palm::PalmDoc; $doc = Palm::PalmDoc->new(); $doc->parse_from_file("README"); open(F,">readme.pdb") || die $!; $doc->parse_from_filehandle("",\*F); $doc->compression(1); #Compression is off by default $doc->read_text(); $doc->write_text(); Palm::PalmDoc provides the following functions : * new(@params) The constructor of Palm::PalmDoc. This function can accept parameters used to generate the PalmDoc file. Parameters accepted are INFILE, OUTFILE, TITLE and BODY. They need to be passed in hash context (or a list/array mimicking a hash). A reference to a hash is also accepted, as well as a reference to an array. my $doc = Palm::PalmDoc->new({INFILE=>"foo.txt",OUTFILE=>"foo.pdb"}); is same as my $doc = Palm::PalmDoc->new(INFILE=>"foo.txt",OUTFILE=>"foo.pdb"); or as my $doc = Palm::PalmDoc->new("INFILE","foo.txt","OUTFILE","foo.pdb"); Keys are always uppercased (even though they may not be passed as such). Possible keys are: - INFILE The input filename - OUTFILE The output filename - TITLE The document title - BODY The document body - COMPRESS Boolean to indicate compression - IGNORENL Boolean to indicate to ingoring newlines. * body($body) This is a plain getter/setter function except that it also sets the required length. The same action can be performed by setting the appropriate hash key/value pair in the constructor or by using the read_text function. $doc->body("Foo Bar"x100); * title($title) This is a plain getter/setter function for the title. The same action can be performed by setting the appropriate hash key/value pair in the constructor. $doc->title("Foo Bar Baz"); * infile($filename) This is a plain getter/setter function for the Input filename. The same action can be performed by setting the appropriate hash key/value pair in the constructor. If both an input file and an input filehandle are defined, the input file is used. $doc->infile("foo.txt"); * outfile($filename) This is a plain getter/setter function for the Output filename. The same action can be performed by setting the appropriate hash key/value pair in the constructor. If both an output file and an output filehandle are defined, the output file is used. $doc->outfile("foo.pdb"); * parse_from_file($inputfile,$outputfile) parse_from_file uses infile() and outfile() to set the filenames. If both an input file and an input filehandle are defined, the input file is used. Same applies for output file and output filehandle. $doc->parse_from_file("foo.txt","foo.pdb"); * parse_from_filehandle($inputfilehandle,$outputfilehandle) parse_from_filehandle takes filehandle as arguments. When no input filehandle is defined STDIN is used. When no output filehandle is defined STDOUT is used. If both an input file and an input filehandle are defined, the input file is used. Same applies for output file and output filehandle. $doc->parse_from_filehandle(\*FOO,\*BAR); * read_text() This function uses the inputfile property to read the body from a file. It also sets the required length. This function returns the text read if successfull or a false if not successfull. $doc->read_text(); * write_text() This function uses the outputfile property to write the header and body to a file. The headers are generated by the pdb_header function. This function returns true if successfull or false if not successfull. $doc->write_text(); * pdb_header() This function generates the correct PDB headers for the body and length. You only need to use this function if you're writing the body to a file manually since write_text() already used pdb_header. This function returns the generated header which should precede the converted body. Writing to an already opened filehandle can be done with parse_from_filehandle too. * compression($boolean) This function toggles the compression. By default compression is off. The same action can be performed by setting the appropriate hash key/value pair in the constructor. $doc->compression(1); #Turn PalmDoc Compression on * ignorenl($boolean) This function toggles the ignoring the newlines. By default newlines are not ignored. The same action can be performed by setting the appropriate hash key/value pair in the constructor. Credit for this functionality goes to Josef Moellers. $doc->ignorenl(1); #Ignore newlines THANK YOU!!!! A HUGE thanks goes to Josef Moellers for fixing 2 BIG bugs in the code. Thanks also to Scott Wiersdorf for adding warning cleanness. Waves to Steve Swantz for pointing me to the typos in the POD and README. John G. Smith for pointing out that titles can't be longer than 31 chars and providing fix for it. TODO Since my primary goal was to port the core, most of the features present in Bibelot are not included. DISCLAIMER MOST of this code is borrowed from Bibelot (http://www.sourceforge.net/projects/bibelot/). This code is released under GPL (GNU Public License). More information can be found on http://www.gnu.org/copyleft/gpl.html VERSION This is Palm::PalmDoc 0.13. AUTHOR This Module was written by Hendrik Van Belleghem ([email protected]) Bugs fixed & feature added by Josef Moellers Bugs fixed by Helge Oldach SEE ALSO Bibelot - http://www.sourceforge.net/projects/bibelot/ GNU & GPL - http://www.gnu.org/copyleft/gpl.html
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.