ssg-for-sdf/README.md
2020-06-30 07:58:20 +00:00

24 lines
1.4 KiB
Markdown

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