org-posts

This repository contains my blog posts in org mode format and a build system to generate the HTML.

In addition it provides a script to sync the files to a given server.

Usage

Copy the env.example file to .env and adjust the values to your environment.

To start developing.

nix develop

To build the HTML from the blog posts into the public directory.

build

To sync the created HTML to the server.

publish

Link to Mastodon

When you add the following header to a post it will generate a section mentioning Mastodon and will link to the post that belongs to the given ID.

#+BLOG_COMMENTS_THREAD_ID:

org-social/social.org

This file contains a template for my org-social posts. As I don’t want to commit the changes everytime I post something new I disable git tracking for it.

git update-index --assume-unchanged ./org-social/social.org

To re-enable the tracking

git update-index --no-assume-unchanged ./org-social/social.org

Tasks

NEXT Spellcheck all posts

NEXT Tags

It would be nice if I could tag my posts by topic so that readers can browse them easier.

NEXT Filter source

Currently everything gets added to the source. I think the Emacs config and the posts would be enought to build the posts. This way I don’t get a new build everytime I update the social.org file.

NEXT Add a script to only sync social.org

Finished

Better styling

• [X] Especially the footer needs to be smaller
• [X] Change colors
• [X] The into paragraph could be nicer
• [X] Remove CDN
• [X] Footnotes look ugly

Remove index.org from sitemap

Currently index.org gets included which is a bit stupid as it means that I list the page itself as a blog post.

Correct sort order

For some reason the posts don’t show up in order.

Disable heading numbers in rss.xml

Can be done by configuring the normal org export.

https://mastodon.social/@tiang/114825462665180768

Maybe include the sitemap

Limit contact page to main page

Include all previous posts

I found some additional posts which I should include as well. Just for the fun of it and historic reasons.

[#A] Inlcude a link to home

Currently when one clicks on a post you’re stuck on that post. Therefore it would be nice to have a link on each page that takes the user back to the home page.

[#A] Setup NixOS config

[#A] Link to Mastodon verifcation

RSS feed

Include static files

At the moment only the plain text gets exported but non of the other files like pictures, etc.

They don’t get included automatically by org-publish therefore I had to included rsync in the buildPhase to sync the static files to the $out directory.

Resources

• https://www.gnu.org/software/emacs/manual/html_node/org/Publishing-options.html
• https://github.com/Fuco1/.emacs.d/blob/c40209872174ffbf4e9024793e86c25f6e0781cd/files/org-blog.el#L226C1-L231C60
• https://git.sr.ht/~taingram/org-publish-rss/
• https://github.com/ox-tufte/ox-tufte
• https://github.com/edwardtufte/tufte-css

Inspiration

• https://systemcrafters.net/publishing-websites-with-org-mode/building-the-site/
• https://systemcrafters.net/publishing-websites-with-org-mode/automated-site-publishing/
• https://taingram.org/blog/org-mode-blog.html