README

1. merlincorey.github.io
2. Static pages and site generators, oh my!
- 2.1. Implemented Generators
3. Comparisons
- 3.1. Implemented Here
- 3.2. Objective Matrix
4. Generator Zoo

1 merlincorey.github.io

Figure 1: This is Merlin's Wizard Hat

2 Static pages and site generators, oh my!

Starting with a basic hand written /index.html and /404.html

Static Site Generators lists 459 static site generators available on GitHub listed by license, language, creation date, and last update date. It will be consulted for vintages on many of these.

2.1 Implemented Generators

This repository implements some of the static site generators.

orgmode: Implemented in README.html and borgmarks
reveal.js: Implemented in reeventure
jupyter: Implemented in vclguba-abgrobbx

3 Comparisons

3.1 Implemented Here

Generator	Inputs	Pros	Cons
orgmode	orgmode	Emacs mode means full featured editing environment.	Emacs mode means so much more than I even know how to uses yet.
reveal.js	html5, javascript	HTML5 layout is both readable and writeable.	Heavy Javascript and CSS dependencies, especially for more than basic slides.
jupyter	python, R	Sharing programming sessions has never been easier.	A bit of a learning curve to figure out how to use all the subcommands and the UI.

3.2 Objective Matrix

Generator	Vintage	Inputs	Extensions
orgmode		orgmode	elisp
reveal.js		html5, javascript	javascript
jupyter		python, R
lektor
frozen-flask
cactus	2011-02 to 2017
hyde (python)
pelican
hyde (chicken scheme)
gatsby
stagit		git
hugo			go

4 Generator Zoo

4.1 orgmode emacs lisp html

Emacs org-mode can directly output HTML from its markup using org-html-export-to-html typically bound to C-c C-e h.

Compare README.org and README.html

4.2 reveal.js javascript html5 slides

Flexible, powerful, and usable Javascript and HTML5 slide presentation framework with an online editor.

4.3 jupyter programming notebook python rlanguage html pdf

Interactive programming notebook for Python and R (primarily, but not exclusively) that can output static HTML and PDF versions of a dynamic notebook state.

4.4 lektor python react

A flexible and powerful static content management system for building complex and beautiful websites out of flat files — for people who do not want to make a compromise between a CMS and a static blog engine.

Python and brought to us by Armin Ronacher.

4.5 frozen flask python jinja

Python flask extension to "freeze" a flask site to static content.

4.6 cactus python django

Simple python with django template based static site generator built for front-end designers.

4.7 hyde (python) python jinja

Python powerful static site generator supporting basic jinja templates.

Merlin Rebrovic's Hyde Starter Kit is a good entry point.

4.8 pelican python markdown restructured

Python static site generator supporting themes with jinja templates, code highlighting, and content in several markup languages.

4.9 hyde (chicken scheme) scheme sxml markdown

Scheme simple static site generator supporting SXML, markdown, and custom transformations.