Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

152 lines (128 sloc) 4.693 kb
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Pod & DocBook</title>
<!-- metadata -->
<meta name="version" content="S5 1.1" />
<meta name="presdate" content="20080707" />
<meta name="author" content="Jozef Kutej"/>
<meta name="company" content="" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<!-- configuration parameters -->
<meta name="defaultView" content="slideshow" />
<!-- <meta name="defaultView" content="outline" /> -->
<meta name="controlVis" content="hidden" />
<!-- style sheet links -->
<link rel="stylesheet" href="ui/default/slides.css" type="text/css" media="projection" id="slideProj" />
<link rel="stylesheet" href="ui/default/outline.css" type="text/css" media="screen" id="outlineStyle" />
<link rel="stylesheet" href="ui/default/print.css" type="text/css" media="print" id="slidePrint" />
<link rel="stylesheet" href="ui/default/opera.css" type="text/css" media="projection" id="operaFix" />
<!-- S5 JS -->
<script src="ui/default/slides.js" type="text/javascript"></script>
<!-- syntax highlighting -->
<link rel="stylesheet" type="text/css" href="ui/sh/sh_style.css" />
<script type="text/javascript" src="ui/sh/sh_main.js"></script>
<script type="text/javascript" src="ui/sh/sh_perl.js"></script>
<script type="text/javascript" src="ui/sh/sh_sql.js"></script>
</head>
<body><!-- onload='sh_highlightDocument();' -->
<div class="layout">
<div id="controls"><!-- DO NOT EDIT --></div>
<div id="currentSlide"><!-- DO NOT EDIT --></div>
<div id="header"></div>
<div id="footer">
<!-- added by Jozef :) -->
<div id="counter" style="float: right; margin-right: 10px;">10</div>
<span id="ignoreClicks" />
<h1>7. Jul 2008</h1>
<h2>Pod & DocBook</h2>
</div>
</div>
<div class="presentation">
<div class="slide">
<h1>Pod & DocBook</h1>
<h3>Jozef</h3>
<p><img src='pod-docbook/docbook-and-perl.png'/></p>
</div>
<div class="slide">
<h1>DocBook</h1>
<h2>"The Source for Documentation"</h2>
<ul>
<li>documentation?</li>
<li>everyone needs one</li>
<li>no one relly enjoy to write one</li>
<li>it's not that easy to start to use it - no "main stream editor",
just a lot of tags definitions laying around on web</li>
<li>after it's setup, it's easy to write and generate different formats - PDF, HTML, ...</li>
</ul>
</div>
<div class="slide">
<h1>Pod</h1>
<h2>the Plain Old Documentation format</h2>
<ul>
<li>every (?) Perl developer is aware and it's easy to use</li>
<li><code>=head1, =head2, =cut, L&lt;&gt;</code><br/> know-how is just enough to write it</li>
<li>probably doesn't need introduction || justification</li>
</ul>
</div>
<div class="slide">
<h1>Pod + DocBook</h1>
<h2>CPAN has:</h2>
<ul>
<li>Pod::DocBook 0.05<br/>(Alligator Descartes - latest release 03 Apr 1999)</li>
<li>Pod::DocBook 1.2<br/>
(Nandu Shah - latest release 16 Mar 2004<br/>
<font color="red">** UNAUTHORIZED RELEASE **</font>)<br/>
MIA</li>
<li>Pod::2::DocBook 0.01<br>(Jozef Kutej - latest release 02 Jul 2008)<br/>
+ Paul Fenwick, + Yanick Champoux</li>
</ul>
</div>
<div class="slide">
<h1>Pod::2::DocBook - Why</h1>
<h2>Why?</h2>
<ul>
<li>allow to create DocBook sections from Pod that can be xincluded
to the main documentation file</li>
<li>developers continue with Pod, "writers" can write the "sauce"</li>
<li>has a DocBook documentation ;-) (doc/)</li>
<li>has "source" for it's documentation (examples/pod2docbook-docbook)</li>
</ul>
</div>
<div class="slide">
<h1>Pod::2::DocBook doc/</h1>
<h2>let's see how it look like</h2>
<ul>
<li>Pod-2-DocBook.html</li>
<li>Pod-2-DocBook.pdf</li>
</ul>
</div>
<div class="slide">
<h1>Pod::2::DocBook example</h1>
<h2>examples/pod2docbook-docbook/</h2>
<ul>
<li>in version >= 0.02_01</li>
<li>apt-get install docbook-utils psutils docbook-xml docbook-xsl xsltproc fop make</li>
<li>cd Pod-2-Docbook/examples/pod2docbook-docbook/</li>
<li>make Pod-2-DocBook.html</li>
<li>make Pod-2-DocBook.pdf</li>
<li>let's try/see it...</li>
</ul>
</div>
<div class="slide">
<h1>Pod::2::DocBook@?</h1>
<ul>
<li><a href="http://search.cpan.org/perldoc?Pod::2::DocBook">Pod::2::DocBook@CPAN</a></li>
<li><a href="http://www.ohloh.net/projects/pod-2-docbook">Pod::2::DocBook@Ohloh</a></li>
</ul>
</div>
<!-- <div class="slide" style="background: url('catalyst-tricks/view.jpg') right top no-repeat;"> -->
<div class="slide">
<h1>And that's it...</h1>
<h2>Questions?</h2>
<p style="text-align: center;"><img src="catalyst-tricks/questions.jpg" alt="" title=""></p>
</div>
</div>
</body>
</html>
Jump to Line
Something went wrong with that request. Please try again.