ePod - Handles easy-POD: write easy and simple, convert to POD, and from there you know the way.
This module is used to conver easy-POD files to POD.
easy-POD is a simpler version of POD, and is made to write POD files without worry about:
Soo, easy-POD let you make some mistakes when writing POD, than it will fixe them for you when converting to POD.
Actually ePod was created to enable non-programmer persons to writed well formated, structured and indexed documentation, and was inspirated in POD.
** See .epod files in the "./test" directory of the distribution.
use ePod ; my $epod = new ePod( over_size => 10 ) ; my $pod = $epod->epod2pod( "Foo.epod" ) ; print $pod ;
Create a new ePod object.
OPTIONS:
Set the size/level of "=over N", where N is a number.
Convert the given ePod FILE|DATA|GLOB to POD.
Can be a FILE path, DATA (SCALAR) or FILEHANDLE (GLOB)
Convert the given ePod FILE|DATA|GLOB to a POD file.
The file path to the new pod file. If not defined will use the same path and name from the ePod file, or "unamed.pod".
If TRUE tells to that the file (NEW_POD_FILE) can be replaced.
If FALSE|undef and the file already exists this format will be used: "%name-%x.pod", where %name is the file name and %x is a number free.
Check if a given DATA has ePod syntax.
Use => for the head command, and the level is set with "=".
=> same as =head1 ==> same as =head2 ===> same as =head3
Use *> for the =item command, and the level is set with "*".
Note that you don't need to declare =over and =back to use *>.
Example:
*> item1 item2 text **> item1.1 *> item2 item2 text **> item2.1 ***> item2.1.1 *> item3
Equivalent POD:
=over 10 =item item1 item2 text =over 10 =item item1.1 =back =item item2 item2 text =over 10 =item item2.1 =over 10 =item item2.1.1 =back =back =item item3 =back
To explicity end a item, use "/" before the item level. Soo to end *> will be /*>, and for **> is /**>
You need to explocity end a item only when you want a text after an item outside of it. Example:
*> item1 the item text. *> item2 the item text again. and more item text. /*> Text outside of itens.
=over 10 =item item1 the item text. =item item2 the item text again. and more item text. =back Text outside of itens.
Note that if you want to use POD syntax with easy-POD you won't be able to use =head and =item commands.
All the other POD syntax can be used with easy-POD syntax.
Pod::HtmlEasy, Pod::Parser, Pod::Master, Pod::Master::Html.
Graciliano M. P. <gm@virtuasites.com.br>
I will appreciate any type of feedback (include your opinions and/or suggestions). ;-P
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install ePod, copy and paste the appropriate command in to your terminal.
cpanm
cpanm ePod
CPAN shell
perl -MCPAN -e shell install ePod
For more information on module installation, please visit the detailed CPAN module installation guide.