Perl Advent Calendar

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

Authors

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.

The website

Using Docker? See DOCKER.md for containerized build and preview instructions.

0. Add previous year to archives.yaml

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

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

1. Build root files

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 .

2. Build all (recent) advent calendars

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

Then build all recent calendars

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

3. Test (locally)

Start HTTP webserver in one line:

http_this --autoindex .

You can visit http://127.0.0.1:7007/

Editors

For notes on the editing process, please refer to EDITING.md