Hosting a Hakyll Blog On GitHub With a Custom Domain

Posted on June 14, 2016
  1. Create a GitHub user page. Follow the directions there to create a “Hello world” site. Don’t proceed until that works.
  2. Register a domain.
  3. Point your domain at your GitHub user pages site. It may take 3+ hours before your domain propagates. Don’t continue until this works.
  4. Install stack
  5. Install hakyll via stack install hakyll
  6. Follow this tutorial. However! You already have a master branch. That’s OK. But you do want to have a CNAME file (see step 3 in this list) in your develop branch. Ensure your site looks good before proceeding.
  7. You might want to look at some sample themes.
  8. If you want code syntax highlighting, you need some additional CSS. A list of supported languages can be found in the highlighting-kate source code.
  9. You might also want an RSS feed.
  10. You might also want tags.
Tags: Hakyll, GitHub