OpenBSD cgit About Filters Hack
update - I moved from self-hosted cgit to sourcehut. Join me there!
Fri, 6 Dec 2019 21:22:36 -0800
I set up cgit recently on OpenBSD for the first time and I was surprised to see that the about filters do not seem to be working. Typically there are some built-in converters that convert markdown to html, man to text. I have no idea why this is missing and the only information that I was able to find about this was in the CVS changelog from 2018.
Disable the filter feature as it wouldn’t work with the way cgit.cgi is built statically for us.
If i try to set the readme option to a plain text README file, it
does not seem to preserve line breaks, tabs or spaces and looks pretty
strange.
Another option would be to simply write HTML to format my README.
The hack that I came up with is to write plain text and then wrap it in
a <pre> tag.
In /var/www/conf/cgitrc I set readme=:README.html and then in the
root of my repo I have a README.html file that looks like this:
<pre>
Blog
====
Source for the dev.levlaz.org website. This site is generating using
ssg[1] which is a static site generator. The included Makefile provides
some helper scripts to make working with ssg a bit easier.
</pre>
The end result you can see here.
Now, I just want to go figure out why the filters don’t work to begin with.
Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.
Check out some more stuff to read down below.
Most popular posts this month
- SQLite DB Migrations with PRAGMA user_version
- Using cgit
- Lev Lazinskiy
- Convert Markdown to PDF in Sublime Text
- Making cgit Pretty
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- AI Mania Is Eviscerating Global Decision-Making from Ludicity
- No-One Escapes the Permanent Underclass from Fernando Borretti
- Is it ethical to use AI? from charity.wtf
- The logical destination of LLMs from Andy Bell
- Revised rules of engineering leadership. from Irrational Exuberance
- The circus freaks of open source from Drew DeVault's blog
- Clanker: A Word For The Machine from Armin Ronacher's Thoughts and Writings
- I ran a half-marathon! from gluecko.se
Articles from blogs I follow around the net
Pluralistic: AI solipsists and AI cynics (24 Jul 2026)
Today's links AI solipsists and AI cynics: You don't have to believe that AI "works" to believe that it's a good investment. Hey look at this: Delights to delectate. Object permanence: Malware v stolen computer; Industrial material made from old coffee and...
via Pluralistic: Daily links from Cory Doctorow July 24, 2026Safari and system design, pt. 2
Around the time I was writing about iPhone’s Safari breaking the expected “tap to jump to the top” gesture, a conversation on social media pointed to yet another thing that this tab control does strangely. A typical use of Safari means two groups of sites:...
via Unsung July 23, 2026Issue 107 – An unserious offer
The crypto industry has spent $200 million to get a bill too corrupt for Democrats to pass and a president too corrupt to sign anything that might meaningfully limit his grift.
via Citation Needed July 23, 2026Generated by openring