ssg-for-sdf/README.md

1.5 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 'ssg5', from https://rgz.ee/ssg.html, which was recommended as a markdown-converting static site generator on another board here.

I had problems with Markdown.pl not working but I posted to REQUESTS, and they added it (but at the time 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:

curl http://cpanmin.us | perl - -l ~/perl5 App::cpanminus local::lib
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