Live data from Hacker News

Ask HN: Looking for lightweight personal blogging platform

news.ycombinator.com

31–40 of 84 posts

Re: Ask HN: Looking for lightweight personal blogging platform

#31
post #27

Sounds like any static site generator supporting Markdown will do. - Jekyll: the OG, but requires a ruby toolchain. - Hugo: compiles to a single static binary, but you may have to get used to its (Go text/html) templating. - Zola: also compiles to a single static binary, but uses Jinja-like templating. - Gozer [^1]: my own, like Hugo, but 1000x simpler. I rolled my own because I wanted something that didn't move unde…

I run Jekyll in its own official docker container. You just need to mount the directory with the md files and it autogenerates new htmls whenever an md is updated. No need for Ruby.

I'm on my phone now and I can't check what I used to run it but all the details are at https://github.com/envygeeks/jekyll-docker/blob/master/READM...

Then HTMLs can be deployed to the public facing server.

Re: Ask HN: Looking for lightweight personal blogging platform

#33
Build your own setup with Soupault! It has the Unix philosophy of piping output to CLI tools that do one thing well rather than locking you into a specific system. It helps glue together many other tools like a lightweight syntax renderer, modified date adding, aggregating the posts to create feeds, make some markup modifications, etc.

Additional suggestions outside a specific tool:

* Inevitably you will need more than base Markdown supports features, so you’ll either need to buy into a specific Markdown fork (some of which aren’t open) that won’t port to other platforms if you need to migrate, script the hell out Pandoc or some other tool creating your own fork, or you could start with a lightweight syntax like reStructuredText or AsciiDoc that have a more comprehensive base supporting 98% of your needs including proper metadata in the file, image sizes, figures, callouts/admonitions, spans with class names, definition lists, details/summary, footnotes, citing blockquotes; building these ad-hoc will suck to maintain & could output bad semantic markup making it difficult for screen readers, TUI browsers, web crawlers to parse & understand

* Don’t do syntax highlighting on the client side for a static site (e.g. no highlight.js or similar)

* Don’t touch the base user font size for a blog as users should be able to override font size for their accessibility (e.g. no body { font-size: 14px })

* Add an Atom and/or RSS feed

Re: Ask HN: Looking for lightweight personal blogging platform

#36
post #33

Build your own setup with Soupault! It has the Unix philosophy of piping output to CLI tools that do one thing well rather than locking you into a specific system. It helps glue together many other tools like a lightweight syntax renderer, modified date adding, aggregating the posts to create feeds, make some markup modifications, etc. Additional suggestions outside a specific tool: * Inevitably you will need more th…

If you only care about web, Markdown has always supported inserting raw HTML. Unfortunately, these lightweight markup languages cannot emulate all of the features of all of the underlying output formats, because different output formats have incompatible features.

Re: Ask HN: Looking for lightweight personal blogging platform

#37
post #19

As per many other comments, it sounds like a static site generator like Hugo ( https://gohugo.io/ ) or Jekyll ( https://jekyllrb.com/ ), hosted on GitHub Pages ( https://pages.github.com/ ) or GitLab Pages ( https://about.gitlab.com/stages-devops-lifecycle/pages/ ), would be a good match. If you set up GitHub Actions or GitLab CI/CD to do the build and deploy (see e.g. https://gohugo.io/hosting-and-deployment/hosting…

Or Blades (https://getblades.org)

Re: Ask HN: Looking for lightweight personal blogging platform

#38
For a static blog written in Markdown, Github has all of that built-in.

When you’re on Github, use its IDE by pressing the . key. You can, of course, use Git and edit the files locally.

Own and maintain these two folders _posts and _assets. If you are going to write regularly, I suggest creating sub-folders inside _posts but name your Markdown files by date such as 2024-02-5-foo-bar-is-my-file.md.

On Github, use Github Pages (officially powered by Jekyll) and deploy using one of the pre-defined Jekyll Themes[1]. That’s it, your blog is at reponame.github.io which you can CNAME it from a domain you own just like I did mine at my-domain.com.

Comments: You can either use Github Discussion as your blog’s commenting system or embed a third party service which you can export and carry around when you change such services. Honestly, and personally, I don’t want to deal with comments these days.

Now, for the customization, the themes are in simple Jekyll[2] which you can play around with. In future, if you want to move from Jekyll to something else, you just have to worry about that _posts and _assets folder. They may have different naming convention but you can just config-managed it or change it to your choice. This is why I suggested owning that two yourself.

You also may not worry about FrontMatter[3] (meta in the header) and its accompanying jazz by asking Jekyll to use the plugins jekyll-optional-front-matter and jekyll-titles-from-headings. These comes as part of the officially supported Jekyll plugins[4] by Github. That way, you are just writing a human-readable plain-text spiced up with Markdown and readable by almost every other Static Site Generator. You can use your favorite IDE or another Markdown editor such as Obsidian to edit your files without ever running Jekyll locally.

Now, play with the _config.yml that Jekyll generates for you from the theme above to define your post dates, navigation, and others. Jekyll is one of the OGs — the Gandalf of Static Site Generators. If you have a problem, someone somewhere has solved that.

If you really think of it, “there is no spoon”, eer, I mean “Jekyll.”

Did I missed something? I was supposed to write a blog article for my website on this one and this comment will serve as my starting bullet points.

1. https://docs.github.com/en/pages/setting-up-a-github-pages-s...

2. https://jekyllrb.com

3. https://frontmatter.codes/docs/markdown

4. https://docs.github.com/en/pages/setting-up-a-github-pages-s...

Post reply on HN