ssg-for-sdf/README.md

1.4 KiB

ssg-for-sdf

I just started messing around as part of looking for a way to make contributing to tutorials easier, and got as far as using 'ssg', from https://www.romanzolotarev.com/ssg.html, which was recommended as a markdown-converting static site generator on another board here.

I had problems with Markdown.pl not working (I posted to REQUESTS, somehow the perl Text:Markdown isn't working), but I used cpanm and installed that library locally*, and then ssg worked!

Because I didn't like how it silently would fail on the markdown problem, so I added a little pipeline-tracing with the bash 'caller' command (I looked it up), and so with that it becomes a bash script instead of a plain sh script, but I think it's better. I posted it here on the sdf git if anyone wants to try it out.

It's cool, it processes markdown first then HTML, so existing HTML files are untouched until you delete them from src folder.

*Hopefully the admins fix it before it matters, but here's what I used to install the perl module I needed with cpanm--Text::Markdown--which you can ignore installing cpanm because it's already installed on SDF. It's just:

eval `perl -I ~/perl5/lib/perl5 -Mlocal::lib`
echo 'eval `perl -I ~/perl5/lib/perl5 -Mlocal::lib`' >> ~/.profile
echo 'export MANPATH=$HOME/perl5/man:$MANPATH' >> ~/.profile
cpanm Text::Markdown