NAME
Pod::PseudoPod::PerlTricks - Turn Pod into the HTML PerlTricks needs
SYNOPSIS
use Pod::PseudoPod::PerlTricks;
DESCRIPTION
***THIS IS ALPHA SOFTWARE. MAJOR PARTS WILL CHANGE***
I wrote just enough of this module to get my job done, and I skipped every part of the specification I didn't need while still making it flexible enough to handle stuff later.
PerlTricks.com Style Guide v0.01 ========================== ===== By David Farrell
Introduction ------------ This document is intended to guide PerlTricks authors in producing articles that are consistent with the aims of the website. None of this is set in stone - great writing should always prevail.
Goal ---- We aspire to reasoned, insightful, professional writing with a lighthearted bent.
Topics of interest ------------------ - Anything Perl related: news, events, tutorials, community - Non-Perl programming subjects: version control, hosting, sysadmin - Open Source
Looking for an idea for an article? Our bread and butter is: "here is something cool you can do with Perl". Start there.
Politics / Tone --------------- - We are pro: Perl, Open Source and free software - No rants or "hit pieces" - Reasoned criticism is fine
Language -------- - American English - 300-1,000 words per article - Simple English (use http://www.hemingwayapp.com/ to help) - Only capitalize the first letter of a word in headings (no title case) - Articles can begin with an italicised introductory paragraph - Technical terms / references when first used should be quoted in speech marks (") - Use the first-person - We are "PerlTricks.com" - You can use "we" to refer to PerlTricks.com, the staff, our point of view etc. - When referring to modules for the first time, provide a link to metacpan
Markup ------ - HTML - <h3> for sub-headers - <p> for paragraphs - <a> for links - <code> for inline code - <pre class="prettyprint lang-perl"><code></code></pre> for Perl code block - <pre><code><span class="nocode"></span></code></pre> for plain code block - <blockquote><div class="quote"></div></blockquote> for blockquote - <i>, <b> can be used for emphasis - <ul>, <table> are supported - Inline images ... can be done, let me know if you need them and I'll upload in the backend
Questions or comments ? Email me: perltricks.com@gmail.com
- document_header
-
The empty string. We don't worry about that here. The blogging platform adds that.
-
The empty string. We don't worry about that here. The blogging platform adds that.
The Pod::Simple mechanics
Everything else is the same stuff from Pod::Simple
.
start_output
end_output
These methods simple set flags and defer everything else to the verbatim handler.
TO DO
SEE ALSO
SOURCE AVAILABILITY
This source is in Github:
http://github.com/briandfoy/pod-pseudopod-perltricks
If, for some reason, I disappear from the world, one of the other members of the project can shepherd this module appropriately.
AUTHOR
brian d foy, <bdfoy@cpan.org>
COPYRIGHT AND LICENSE
Copyright © 2014-2015, brian d foy <bdfoy@cpan.org>. All rights reserved.
You may redistribute this under the same terms as Perl itself.