The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!-- Generated by Pod::Advent 0.06 (Pod::Simple 3.02, Perl::Tidy 20060719) on 2007-12-31 16:03:05 -->
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>2008 Perl Advent Calendar: Getting Started</title>
<link rel="stylesheet" href="../style.css" type="text/css" />
<link rel="alternate" type="text/plain" href="getting_started.pod" />
</head>
<body>
<h1><a href="../">Perl Advent Calendar 2008-12</a>-00</h1>
<h2 align="center">Getting Started</h2>
<h3 align="center">by David Westbrook</h3>
<p>This is a basic POD example for using <tt><a href="http://search.cpan.org/perldoc?Pod::Advent" title="Pod::Advent">Pod::Advent</a></tt> to generate a <a href="Perl Advent Calendar">http://perladvent.pm.org</a> entry such as this. Once the POD is written or updated, simply execute the <tt>pod2advent</tt> script and save the output:</p>
<pre>
<span class="i">$ pod2advent</span> <span class="w">getting_started</span>.<span class="w">pod</span> &gt; <span class="w">pod2advent</span> <span class="w">getting_started</span>.<span class="w">html</span>
</pre>

<p>And we get the file that you are now reading. The POD source is included below (normally this would be your <span style="font-style: italic">.pl</span> script file):</p>
<a name="getting_started.pod" id="getting_started.pod"></a><h2><a href="getting_started.pod">getting_started.pod</a></h2><pre>
<a name="getting_started.pod.1"></a>   1 <span class="pd">=for advent_year 2008</span>
<a name="getting_started.pod.2"></a>   2 
<a name="getting_started.pod.3"></a>   3 <span class="pd">=for advent_day 00</span>
<a name="getting_started.pod.4"></a>   4 
<a name="getting_started.pod.5"></a>   5 <span class="pd">=for advent_title Getting Started</span>
<a name="getting_started.pod.6"></a>   6 
<a name="getting_started.pod.7"></a>   7 <span class="pd">=for advent_author David Westbrook</span>
<a name="getting_started.pod.8"></a>   8 
<a name="getting_started.pod.9"></a>   9 <span class="pd">This is a basic POD example</span>
<a name="getting_started.pod.10"></a>  10 <span class="pd">for using M&lt;Pod::Advent&gt; to generate a</span>
<a name="getting_started.pod.11"></a>  11 <span class="pd">A&lt;Perl Advent Calendar|http://perladvent.pm.org&gt; entry such as this.</span>
<a name="getting_started.pod.12"></a>  12 <span class="pd">Once the POD is written or updated, simply execute</span>
<a name="getting_started.pod.13"></a>  13 <span class="pd">the F&lt;pod2advent&gt; script and save the output:</span>
<a name="getting_started.pod.14"></a>  14 
<a name="getting_started.pod.15"></a>  15 <span class="pd">=begin code</span>
<a name="getting_started.pod.16"></a>  16 
<a name="getting_started.pod.17"></a>  17 <span class="pd">$ pod2advent getting_started.pod &gt; pod2advent getting_started.html</span>
<a name="getting_started.pod.18"></a>  18 
<a name="getting_started.pod.19"></a>  19 <span class="pd">=end code</span>
<a name="getting_started.pod.20"></a>  20 
<a name="getting_started.pod.21"></a>  21 <span class="pd">And we get the file that you are now reading.</span>
<a name="getting_started.pod.22"></a>  22 <span class="pd">The POD source is included below</span>
<a name="getting_started.pod.23"></a>  23 <span class="pd">(normally this would be your I&lt;.pl&gt; script file):</span>
<a name="getting_started.pod.24"></a>  24 
<a name="getting_started.pod.25"></a>  25 <span class="pd">=sourcedcode getting_started.pod</span>
</pre>
<div style="float: right; font-size: 10pt"><a href="getting_started.pod">View Source (POD)</a></div><br />
</body>
</html>