- LICENSE AND COPYRIGHT
- BUGS AND LIMITATIONS
pod2axpoint inputfile.pod > outputfile.xml
pod2axpoint converts POD input to AxPoint XML, which can be used to generate HTML Slideshows.
There is another script for this purpose on cpan, podslides-ax-magicpoint-0.01, but this creates a xslt transformation and doesn't support everything of AxPoint. That's why I wrote my own.
Beside the known perlpod markup some exceptions has been made:
Only the title =head1 is supported currently.
Images can be included using the tag G<image.png>.
Plain XML code can be included using the xml formatter, eg:
=begin xml <title>Blah</title> =end xml
This way you add the required metadata block to your slide.
AxPoint is required. I used the FreeBSD port:
Beside axpoint you need Pod::Tree for parsing POD.
AxPoint itself has a lot of dependencies, here are all the (FreeBSD) packages were installed:
axpoint-1.50 XML Based Presentations docbook-xml-4.2_1 XML version of the DocBook DTD expat-2.0.0_1 XML 1.0 parser written in C fontconfig-2.3.2_6,1 An XML-based font configuration API for X Windows libxml2-2.6.27 XML parser library for GNOME p5-XML-Filter-BufferText-1.01 Filter to put all characters() in one event p5-XML-Filter-XSLT-0.03 XSLT as a SAX Filter p5-XML-LibXML-1.62001 Interface to Gnome libxml2 library p5-XML-LibXML-Common-0.13 Routines and Constants common for XML::LibXML and XML::GDOM p5-XML-LibXSLT-1.59 Perl interface to the GNOME XSLT library p5-XML-NamespaceSupport-1.09_1 A simple generic namespace support class p5-XML-Parser-2.34_2 Perl extension interface to James Clark's XML parser, expat p5-XML-SAX-0.15 Simple API for XML p5-XML-SAX-Expat-0.38 Simple API for XML p5-XML-SAX-Writer-0.50 SAX2 XML Writer sdocbook-xml-1.1,1 "Simplified" DocBook XML DTD xmlcatmgr-2.2 SGML and XML catalog manager
If you're not on FreeBSD try cpan or install all the stuff manually - which is annoying.
Last but not least: try FreeBSD.
Copyright (c) 2007 Thomas Linden
This tool is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See rt.cpan.org for current bugs, if any.
To debug pod2axpoint use debug() or the perl debugger, see perldebug.
Thomas Linden <tlinden |AT| cpan.org>