Not sure about the OP, but I have a small devlog which is basically just a Bash script which I run whenever I need to write a new post. The script takes a bunch of markdown files in a folder and spits out HTML files (common index.html + files of each individual post) with a header/footer. This HTML is then served using a web server.
I just tried visiting the Jekyll website to see how to get started, the documentation page has the following under the Getting Started section --
1) Install Ruby, Ruby Gems.
2) Understand what Gem, Gemfiles, Bundler(?) are.
3) Tells me about it's community for some reason.
4) Finally there's a page which tells me how to make a 'Hello World' blog.
5) 10 more pages explaining what Liquid, layouts, includes, datafiles, assets, deployment are.
6) I still don't know how to make a new post.
Most static site generators have too much of cognitive load. I just want a bunch of plain HTML files generated (ideally in <1s + no JS) from a bunch of markdown files, I don't really care for 99% of the features these things have. I would rather spend a few hours a write a simple script to do it myself instead of wading through the documentation looking for the relevant parts.
I left Octopress (a flavor jekyll) for those reasons[1]. Pelican[2] is what I use now. It takes a dir of markdown files and makes a decent website. It was even easy for me to write a no-nonsense theme without being good at python.
I just tried visiting the Jekyll website to see how to get started, the documentation page has the following under the Getting Started section --
1) Install Ruby, Ruby Gems.
2) Understand what Gem, Gemfiles, Bundler(?) are.
3) Tells me about it's community for some reason.
4) Finally there's a page which tells me how to make a 'Hello World' blog.
5) 10 more pages explaining what Liquid, layouts, includes, datafiles, assets, deployment are.
6) I still don't know how to make a new post.
Most static site generators have too much of cognitive load. I just want a bunch of plain HTML files generated (ideally in <1s + no JS) from a bunch of markdown files, I don't really care for 99% of the features these things have. I would rather spend a few hours a write a simple script to do it myself instead of wading through the documentation looking for the relevant parts.