Archive

djot

"Djot is a light markup syntax. It derives most of its features from commonmark, but it fixes a few things that make commonmark's syntax complex and difficult to parse efficiently. It is also much fuller-featured than commonmark, with support for definition lists, footnotes, tables, several new kinds of inline formatting (insert, delete, highlight, superscript, subscript), math, smart punctuation, attributes that can be applied to any element, and generic containers for block-level, inline-level, and raw content. "

• by John MacFarnale of pandoc
• implemented in Lua
• custom pandoc reader
• custom pandoc writer
• luarocks install djot

Idyll

"Idyll can be used to create explorable explanations, write data-driven stories, and add interactivity to blog engines and content management systems. The tool can generate standalone webpages or be embedded in existing pages."

• expands on markdown syntax
• implemented in javascript
• github
• gallery
• variables declared like -- [var name:'x' value:10 /]
• datasets -- [data name:'myData' source: 'myData.csv' /]

Articles

• Elements Of a Great Markup Language

---

See also Static Site Generators

Some notes and links on Static Site Generators (SSG).

A "hello world" program for the 2010's (and 2020s).

Articles

Why You Should Write Your Own Static Site Generator; Nov 2023.

The understated innovation of static site generators

Smaller Static Sites with New Formats - 2022. Optimizing Fonts, Images etc using newer formats and tools.

Elements Of a Great Markup Language

"... static site generator which takes a bunch of input documents, a custom conversion script, and outputs a bunch of HTML files."

low touch - hosted SSG

• prose.sh -- a blog platform for hackers. scp blog.md pros.sh:/ and boom. First create an account by logging in to ssh new@prose.sh.

Desktop SSG

Publii - Open-Source CMS for Static Site

Static site generators

roman-kashitsyn/mmapped.blog that powers mmapped.blog is a Go program that implements? subset of latex and converts it to HTML. See the "blogware" source code.

Kitten: Home A 💕 Small Web development kit. Build using #html, #css , and #javascript . Progressively enhance with Streaming HTML and #htmx

jemdoc -- light text-based markup language designed for creating websites. Based on Asciidoc. Has #latex support for math, but the equations are rendered as static images, not MathJax etc.,. Appears to be popular with academics.

JBake - Java based open source static site/blog generator -- this is actually surprisingly smooth.

nuex/zodiac: A static website generator written in awk and sh.

Makefile-Based Static Website Generator

Makefile and discount powered blog

Static site generator with rsync and lowdown - Roman Zolotarev [SSG]

kambrium/dssg: A static site generator written in D

sysgears/grain: Static Web Site Building Framework For Groovy that uses ASCIIdoctor

Static site generators need less rigid content APIs | Hacker News

Hammer for Mac 6.9 - Available Now

jeremycw/mfbg: Mother F*ing Blog Generator -- a Makefile + pandoc.

Home - Styx Static Site Generator -- The Purely Functional Static Site Generator. Styx is a functional static site generator based on the Nix package manager.

srid/rib-sample: Sample site for the Rib static site generator

Pelican 4.2.0 — Pelican 4.2.0 documentation with m.css looks very good.

bastibe/org-static-blog: A static site generator using org-mode

Lume, the static site generator for Deno - Lume

jorge  is a personal (small + opinionated) site generator inspired by Jekyll, written in Go, with org-mode and markdown support.

Static site generator for Django - Django Distill

Headless SSG

• Rspress -- Rust based.

• ponzu-cms/ponzu: Headless CMS with automatic JSON API. Featuring auto-HTTPS from Let's Encrypt, HTTP/2 Server Push, and flexible server framework written in Go.

  go get -u github.com/ponzu-cms/ponzu/...

Deployments

surge.sh:

• Build and automatically deploy a React site – Joshua Tjhin – Medium

Examples of surge.sh sites:

• http://reasonablern.surge.sh/

• See my surge.sh pages

Commenting systems

• Various ways to include comments on your static site; Jan 2018.
• utterances -- A lightweight comments widget built on GitHub issues. Use GitHub issues for blog comments.
• umputun/remark: comment engine - Social login via Google, Twitter, Facebook, GitHub and Yandex. Markdown support with friendly formatter toolbar. Moderator can remove comments and block users

Search for static sites

• tinysearch/tinysearch 🔍 Tiny, full-text search engine for static websites built with Rust and Wasm

Not exactly SSG

• vhodges/stitcherd: Dynamic content for mostly static sites.

Crazy / Fun static site generators

• https://github.com/technomancy/technomancy.us - built using m4 macros, and a Makefile.
• this uses mdoc, install etc., to produce https://text.causal.agency/001-make.txt.
• soupault -- is a static website generator based on HTML rewriting.

Typst

Rheo? is an typesetting and static site engine for Typst.