Heckle

screenshot of Heckle
jekyll

Heckle

:black_nib: Jekyll in Haskell (feat. LaTeX)

Overview:

Heckle is a static-site compiler written in Haskell that supports both LaTeX/PDF and Markdown/HTML posts. It aims to be simple and unopinionated, offering flexibility for those who want to use either Markdown or LaTeX or both. Heckle is similar to Jekyll, but with a focus on simplicity and ease of use. It can be used with the Hyde Theme to create a blog that looks like a Jekyll blog, but is easier to maintain and supports LaTeX posts.

Features:

  • Supports LaTeX/PDF and Markdown/HTML posts
  • Simple and unopinionated
  • Easy to install and setup
  • Customizable layout for homepage
  • Generates links to LaTeX and PDF files in homepage
  • Requires inclusion of specific meta-data in Markdown files

Installation:

For OSX - Homebrew:

  1. Open your terminal.
  2. Run the command brew install 2016rshah/tools/heckle to install Heckle.

For everyone else - The Haskell Platform:

  1. Open your terminal.
  2. Run the commands stack update and stack install heckle to install Heckle.

Optional: LaTeX

  • For OSX: Install LaTeX using Homebrew.
  • For others: Install LaTeX using your preferred method.

Summary:

Heckle is a static-site compiler written in Haskell that provides support for both LaTeX/PDF and Markdown/HTML posts. It is designed to be simple and flexible, allowing users to choose their preferred markup language or use both. Installation is easy using Homebrew for OSX or The Haskell Platform for other platforms. Heckle includes features such as customizable layouts for the homepage, automatic generation of links to LaTeX and PDF files, and specific meta-data requirements for Markdown files. With Heckle, users can create and maintain a blog that looks like a Jekyll blog but is simpler and supports LaTeX posts.

jekyll
Jekyll

Jekyll is a static site generator written in Ruby that allows you to create simple, fast, and secure websites without the need for a database.