Skip to content

samsonjs/samhuri.net

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

samhuri.net

The source code for samhuri.net.

Overview

This is a custom static site generator written in Swift and geared towards blogging. As is tradition it gets a lot more attention than my actual blog.

Some features:

  • Uses Markdown for posts, rendered using Ink and Plot by @johnsundell
  • Supports the notion of a link post
  • Generates RSS and JSON feeds
  • Generates an archive page that lists all posts
  • Generates listings for each year and month as well
  • Runs on Linux and macOS

The main project is in the samhuri.net directory, and there's a second project for the command line tool called gensite that uses the samhuri.net package to render source files from the following directories:

  • drafts: flat directory of Markdown files that are rendered into www/drafts/
  • posts: Markdown files organized in subdirectories by year and month that are rendered into www/posts/YYYY/MM/
  • public: static files that are copied directly to the output directory www/

The entry points to everything live in the Makefile and the bin/ directory so those are good starting points for exploration. I may or may not document anything else about this project as it's not really intended to be a reusable library. However you should be able to fork it and make it your own without doing a ton of work as I tried not to hardcode my personal info.

If what you want is an artisinal, hand-crafted, static site generator for your personal blog then this might be a decent starting point.

License

Released under the terms of the MIT license.