Perl-Advent
Perl-Advent copied to clipboard
The Perl Advent calendar
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
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 2023); 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/