The Perl Advent Calendar is a series of articles that run from December 1 to 25 each year.

Raise an issue suggesting your topic.

Fork the repo and start a new article. The script will prompt you for a few things and will create a new file for you under YEAR/incoming/.

perl script/new_article

Edit your article, and test it as you work:

perl t/article_pod.t 2023/incoming/your-article.pod

When you are satisfied, create a pull request. You can keep working on the article and pushing updates to your fork; the pull request will automatically see the updates.

Currently this needs to be run manually once per year, in the new year.

./year2yaml $(perl -MTime::Piece -le 'print localtime->year - 1') 

To create some root files from archives.yaml:

• archives.html - list of advent calendars
• archives-AZ.html - list of modules
• archives-Yd.html - list of articles

Execute the following script:

perl mkarchives .

cpm install -g WWW::AdventCalendar App::HTTPThis

Then build all recent calendars

for year in $(seq 2011 2024); do cd $year && advcal -c advent.ini -o `pwd` && cd ..; done

Start HTTP webserver in one line:

http_this --autoindex .

You can visit http://127.0.0.1:7007/