samhuri.net

The source code for samhuri.net.

New version using Swift

The idea is to create a bespoke set of tools, not a general thing like Jekyll. If something can be factored out later that's a bonus, not a goal.

This is a plan for migrating from a mix of node.js (harp) and Ruby to Swift. Use Ink, John Sundell's Markdown parser, to render posts, and some other library for generating HTML. Will probably try generating HTML from code because I've never tried it and it seems fun. The pointfree.com guys have one already and Sundell is releasing one Real Soon(tm).

This version will go back to its roots and use headers at the top of markdown files. It was so much easier than indexing everything. Check out the old repo to see how nice it was back in the day. The code that renders it was separate and is available at 9af9d75.

Execution, trying TDD for the first time:

• Replace harp with custom Swift code

  • Write a test harness that renders a site and then checks the output with diff -r

  • Write a site generator that renders www/index.html from site.json

  • Add support for site styles

  • Add support for page styles

  • Add support for site scripts

  • Add support for page scripts

  • Add support for CSS files

  • Transform LESS into CSS

  • Migrate static pages to the new site generator

    • About

    • 404 / missing (configure via .htaccess as well)

    • cv

    • check and delete _data.json

  • Migrate projects to the new site generator

    • Migrate projects page

    • Migrate project page

    • Check and delete _data.json

  • Migrate posts to markdown with headers somehow

    • Define the new format

    • Decide whether to migrate from 9af9d75 or the current harp format (probably easier to migrate the new format because posts may have been updated since then)

    • Migrate posts

    • Migrate year indexes

    • Migrate month indexes

    • Migrate index / recent posts

    • Migrate archive

    • Check and delete _data.json filse

  • Search for other _data.json files and eliminate any that are found

• Consider using Swift for samhuri.net as well, and then making SiteGenerator a package that it uses ... then we can use Plot or pointfree.co's swift-html

• Replace remaining Ruby with Swift

  • Generate RSS feed (ditch mustache templates)

  • Generate JSON feed

  • Munge HTML files to make them available without an extension (index.html hack, do it in the SiteGenerator)

  • Inline CSS?

  • Minify JS? Now that we're keeping node, why not ...

• Add a server for local use and simple production setups (or use a file watcher + python -m SimpleHTTPServer?)

• Figure out an iPad workflow with minimal code. Maybe a small app with some extensions and shortcuts?