# 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.

\*Hopefully the admins fix it before it matters, but here's what I used to [install the perl module I needed with cpanm](https://stackoverflow.com/questions/2980297/how-can-i-use-cpan-as-a-non-root-user)--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

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