bloggen static site generator

Keywords: static site generator, external javascript library, single external javascript, list post, html file, bloggen, mobile, readability, screen. Powered by TextRank.

bloggen is a static site generator.

There are countless static site generators available—so many, in fact, that there's an entire site dedicated to enumerating and comparing them. Yet, I decided to build another one for myself. Why? Mainly because it's fun and because a static site generator is a tool I use frequently, and I want total control over how it works. Bloggen is a simple piece of software. Here's what it does with a source directory:

• Scans the directory for Markdown files
• Uses SideMark to parse the files and render them as HTML
• Creates an RSS file
• Generates an index.html file
• Produces an Apache config file to limit access to protected posts
• Processes the frontmatter of each post to handle metadata (e.g., skipping drafts, sticky posts, language indicator, timestamping posts, etc.)
• Uses a TF/IDF matching engine to list posts that are potentially similar to the current post
• Applies TextRank to extract keywords from each post
• Generates a list of outgoing links from each post

There's no theme support because such features tend to be distractions. I aim for the simplest possible layout and appearance. As a result, sites generated by Bloggen resemble an old-school mailing list archive. The only styling is a lightweight CSS file that adjusts margins based on screen size, ensuring readability on mobile devices. For posts that use KaTeX, a single external JavaScript library is included on demand. Beyond that, there's no JavaScript at all.

Metadata

242 words

Similar posts

• New microblogging tools
• Blogging with jupyter notebooks
• Blog engine
• Elephas Mastodon client

Powered by TF-IDF/Cosine similarity

Outgoing links

1. /2024/02/sidemark_markdown_parser.md.html

First published on 2025-06-01

Generated on 15 Jan 2025 at 1:58 AM

Index