3 ms·
Like many others here I'm going to recommend Jekyll too, and I recently started blogging with it [1]. Although the primary reason to suggest Jekyll would be tha
by abhgh 3y ago
Like many others here I'm going to recommend Jekyll too, and I recently started blogging with it [1]. Although the primary reason to suggest Jekyll would be that its non-nonsense and has been around a while (which is what the other comments mention), I would also like to add that when I needed customizations it was easy to Google for them because of the large community. Going in I believed that no platform will match all my needs, so I needed something where minor customizations wouldn't demand a steep learning curve. Some specific examples that I was able to solve with some basic searching:
[1] On the homepage [a] I needed some excerpts from the post to appear underneath the title. I also wanted this excerpt to show up in the RSS feed.
[2] Since I think of my posts as live documents - if I remember a new detail, I add it to my posts, because more than anything else my blog is notes for me -I also wanted to add a "Last major update" date to my posts - you can see this appear over the titles (the date after '||') and at the top of individual articles. I wanted this to be manual because I didn't want this date to change because I fixed a typo etc.
[3] Since I'm interested in technical articles, I wanted a good way to cite papers. I use jekyll scholar [b] for the purpose, and if you look at the last 2 articles on my blog you'll see the outcomes it produces.
[4] I also wanted my article URLs to be concise instead of the jekyll default which has year, month, day as part of it - this was a fairly easy change to make as well.
[5] Linking to a different section in an article or a section in another article without using the public URL (because this might change if for some reason I end up with a different namespace tomorrow) - this is also possible using variables, whose values get (re-)generated every time you change the document markdown.
[6] Before I push the article to github I usually have it served for a while (typically a few days) on a local server on my laptop (you don't have to install a separate server - the jekyll build system bundles one, this is how you locally see what the article would look like) which I proof-check from different devices while in the house, e.g., from my mobile when I'm not at my desk. Its convenient.
[7] Of course, support for MathJax.
[8] Lot's of themes to pick from. For ex. Al-Folio [c] is a minimalist theme that seems to be becoming popular for academic writing.
I'm sure some of the other solutions do most of these, but I wanted to draw your attention to the ease of customizability.
[a] https://blog.quipu-strands.com/ https://blog.quipu-strands.com/
[b] https://github.com/inukshuk/jekyll-scholar https://github.com/inukshuk/jekyll-scholar
[c] https://github.com/alshedivat/al-folio?tab=readme-ov-file https://github.com/alshedivat/al-folio?tab=readme-ov-file