readme.md

hi, i'm sam!

notes on how my personal website is implemented.

dev process

to run incremental builds:

npx nodemon -e md,sh,scss --exec ./build.sh

to run hot reload:

npx browser-sync start --server _site --files _site --extensions html

to iterate on Lua filters:

pandoc FILE -t json
pandoc FILE -t lib/writer.lua
npx nodemon -e lua --exec pandoc FILE -t lib/writer.lua

TODOs

• Improve blog.md auto-generation (use post titles)
• Show dates on blog posts
• Revisit the styling - I think I really liked pandoc's built-in styles
  • Use pandoc -D html to check out the default HTMl template

Changelog

• Dec 2023 - converted to Pandoc from Jekyll
• Jan 2017 - cleaned it up, spent a lot of time on Lighthouse optimizations
• Sept 2016 - created this website

Development notes

• Color scheme available at this link.
• Favicons are treacherous and terrible. Fortunately people like Philippe Bernard exist: he has a guest post over at CSS-Tricks detailing just how easy it is to get it all wrong and he's made RealFaviconGenerator, a tool that eases the pain of it all.