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 and put it at /posts/index.html, duh!

    • 301 redirect /archive to /posts, and update the header link

    • Check and delete _data.json files

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

• Link years to year indexes in the posts archive

• Fix missing days on post dates in the archive and year indexes

• Find a way to add the site name to HTML titles rendered by plugins

• Clean up the posts plugin

  • Why don't plain data structures always work with Stencil? Maybe computed properties are a no-go but we can at least use structs instead of dictionaries for the actual rendering

  • Separate I/O from transformations

  • Factor the core logic out of PostsPlugin ... separate I/O from transformations? Is that an improvement or does it obscure what's happening?

  • Stop validating metadata in Post, do that when rendering markdown

  • Remove RenderedPost

  • Move all dictionary conversions for use in template contexts to extensions

  • Stop using dictionaries for template contexts, use structs w/ computed properties

• 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)

  • Use perf tools on beta.samhuri.net and compare to samhuri.net to see if inlining css and minifying JS is actually worthwhile

  • 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?