~duncan-bayne/halp

Perl scripts to run my personal Gemlog and my professional Website
Fix custom descriptions in OG tags
Improve the OG description tag
Add OpenGraph images to directories and generated files

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~duncan-bayne/halp
read/write
git@git.sr.ht:~duncan-bayne/halp

You can also use your local clone with git send-email.

#halp

Halp is a simple templating Web and Gemini static generator, written in Perl 5.

It was created to scratch an itch: to generate both my personal Gemini capsule and my professional Web site using the same basic mechanism.

builds.sr.ht status

#prerequisites

  1. Perl 5 (5.10 or later).
  2. The following CPAN modules:
    1. Clone
    2. File::Copy::Recursive
    3. File::Slurp
    4. HTML::HTML5::ToText
    5. Test::Exception
    6. Text::Template
    7. Try::Tiny
    8. XML::Atom::SimpleFeed

Note that scripts/cpan-dependencies.sh will set these up for you, assuming you have CPAN installed.

#tests

$ prove -rv t

#license

halp is licensed under the GNU Affero General Public License 3.0.

#credits

#test images

#FAQ

#1. why Perl?

I have several goals for Halp:

  1. Long-lived. Ideally, it'll last me for at least a decade, maybe more.
  2. Highly portable. I don't want to be tied to the "big three" of macOS, GNU/Linux, and Windows - Plan 9 is still on my radar for the future.
  3. Safe. This means, e.g., not having to roll my own crypto or template libraries.
  4. Not a Google product.

This led me to a pretty short shortlist:

  1. The Plan 9 dialect of C.
  2. rc shell.
  3. Perl 5.

Having spent a few years as a professional C coder I'm reluctant to reach for it for any text-heavy task. rc is okay but I don't find it terribly easy to read - I struggled a bit with Werc. That left ... Perl!

As funny as it was, I decided I'd rather increase the exposure of a human artist, than promote slop.