Skip to content

Latest commit

 

History

History
35 lines (29 loc) · 1.44 KB

README.md

File metadata and controls

35 lines (29 loc) · 1.44 KB
Raw

kholdstare.github.com

A blog website about my coding projects and other interests

How this site is put together

I started this many years ago, and by now have forgotten the technologies I cobbled together back then to get everything to work. The goal was Markdown or bust, for posts and presentations. Here are the details so I don't forget the next time I need to tweak something.

  • Update ruby jems
    • Run bundle install
  • Jekyll for static site generation
    • To preview locally run bundle exec jekyll serve --drafts --incremental
    • The generation step is run by github pages automatically
  • Design/styling
    • Customized Zurb Foundation v3 (ancient I know) sass sylesheets
    • To regenerate css from sass live run bundle exec compass watch
  • Presentations
    • Imported as a submodule from my presentations repository
    • Uses pandoc and reveal.js
    • Run make in root dir to generate html and pdf of presentations
  • Diagrams
    • Dia to draw diagrams and generate .svgs and .pngs
    • See diagrams_src directory for the .dia files
    • Run make in root dir to generate the images
    • Will use [diagrams.net](draw.io aka diagrams.net) going forward, to generate .svgs
    • [https://www.diagrams.net/blog/mermaid-diagrams](Mermaid syntax looks interesting)

TODO

  • Fix sass -> css generation (looks like using foundation v3)
  • Consider upgrading foundation to v6? This will most likely mean a complete re-design 🤦