chris-martin / argumatronic

my Hakyll blog

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

HELLO

This is my blog.

Technical details and licensing

Currently, the blog is built with Hakyll 4.12 and Stack LTS 12.13 (therefore, GHC 8.4.3). You can find the complete dependency list in the .cabal file. The Haskell code is all in site.hs, the html templates are all in the templates directory, and the CSS is all in the default.css file. That CSS includes the syntax highlighting in code blocks.

All code, including HTML and CSS, are licensed under The Unlicense. Please feel free to use any of it to start your own blog relatively painlessly.

My blog is hosted on AWS. You can find some instructions for setting that up here. I plan to write a guide to setting up your first static site with Hakyll, from intial build to deployment, at some point, but I haven't yet. I chose to use AWS initially because I wanted some experience with AWS; now I just keep it there out of habit. There is also a tutorial for hosting a Hakyll site on Github Pages but I haven't personally tried it.

Content license

The content in this blog, i.e. all images, text, and other assets, included in blog posts and pages, are licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. You are free to use them with attribution for any noncommercial purpose. You may adapt and build upon them as you see fit for your audience.

Why Hakyll

I like Hakyll a lot. It was one of my first Haskell projects, to get a Hakyll site going, and so there is undoubtedly some sentimental attachment to it. But at this point I've been involved in building so many Hakyll sites, and I've enjoyed the relative simplicity and flexibility of it. The Pandoc integration means you have much more flexibility for text presentation than you probably realize. The Joy of Haskell site is built with Hakyll, and we've been really happy with it.

The Hakyll author/maintainer, Jasper, is super helpful and has written and organized a ton of documentation about Hakyll and happily answers user questions.

Hakyll is, in my opinion, a good way to start playing with doing something real in Haskell if you're new to it. For the most part, the Haskell code you'll be playing with isn't too wild and you won't need to be adept with monad transformers.

In addition to Jasper's rather extensive documentation and tutorials, there are other resources you might want to be aware of.

About

my Hakyll blog


Languages

Language:Haskell 54.2%Language:CSS 20.6%Language:HTML 16.3%Language:Nix 8.5%Language:Makefile 0.4%