Contents
Blogs need three things: commenting, tags, and feeds.
I will bolt on commenting, maybe Disqus, in the near future.
Tags are kinda similar to an index in concept, so I’m just using Sphinx’s builtin indexing for now. I’d like to be able to more easily work with tagged items so I’m working on a tagging directive.
Sphinx doesn’t generate RSS so I rolled my own as a Sphinx extension (source).
Changed in version 2011-01-03: It now sorts by most recent entries and takes a few configuration options such as not outputting entries older than a certain date or only outputting a maximum number of entries.
I like to entertain my inner-OCD by crafting dotfiles and as such, I talk about them a lot on my blog. I wanted a quick way to link to one of my dotfiles, wherever it may be hosted, so I wrote a reStructuredText role to do so. Something like the following will generate the right link to a specific file, of a specific revision, and a specific line in my BitBucket repo:
See :rc:`line 42 of my ~/barrc <.barrc@b1e8bfc81b0a#42>`.
If I switch to some other provider or self-host, I simply update the URL in my configuration file.
This is a work in progress as I’ve only just launched the site. If you’re interested, you can see the actual reStructuredText source for any of these posts by clicking the ‘View Source’ link in the sidebar and you can see the entire source for this blog at BitBucket.
Posted 565 days ago on 2010-03-17.