gjoncas/gjoncas.github.io

oneironomics

Theme Credits

The design for this theme comes from CleanMagicMedium-Jekyll by Lucas Gatsas.
The code I started from is by Katy Chuang, who adapted CleanMagic for Hakyll.
Code by other CleanMagic-hakyll users was also helpful: Benedikt Mayer & Ismail Mustafa.

I've added support for LaTeX thanks to Ng Wei En's blog, implemented with KaTeX.
I've also added an RSS feed thanks to this tutorial, using xoltar's site as a baseline.

I'd love to integrate more elaborate features as I get better with Hakyll.
For now, it seems the best place to find tutorials is here. For help, see here.
I still really want to add in-line code with Haskell's diagrams and/or TikZ.

Building with Stack

A quick recap of how to construct the blog on my computer using the command line:

cd C:\Users\Graham\Documents\GitHub\gjoncas.github.io
stack build
stack exec CleanMagic-hakyll build  #or rebuild if you made changes to site.hs

Then, for a preview of the site (exit on cmd by pressing ctrl+C twice):

stack exec CleanMagic-hakyll watch

Then access the site here:

http://127.0.0.1:8000

Editing vs. Publishing

It's slightly convoluted to go from editing to publishing and vice versa. I'm writing this so I don't forget.

About.md, Project.markdown, Research.markdown and index.html need to be in the main directory when editing.
When posting, put them in pages and replace them with files from _site (About, blog, index, Projects, Research).
When editing, delete html versions of posts; when posting, copy the html posts from _site into the posts folder.

There's probably a more efficient way to do this, but I'm just playing by ear here.