static site generator
This article is a stub. You can help the IndieWeb wiki by expanding it.
Static site generators or SSGs are programs that take a set of flat text files on disk and transforms them into a set of static HTML files ready to be served by a standard web server, or some variation of this example.
For details on implementations and examples of IndieWeb building blocks e.g.
- How to send & receive Webmentions with static site generators
- Long term maintenance advantages
- Archival ready html output
- Can be hosted on any webserver
- Free or cheap * static hosting options are available
- No "moving parts"; nothing to break
- Easy to get started
- Source files can be edited on an operating system. Usually its just text files!
- Generators are typically fairly simple programs to write and modify
- Lots of existing options; Few are better than most
- No database-antipattern
- Fewer security vulnerabilities with static HTML+CSS
- Most SSGs are written as CLI programs and are difficult for non-technical people to learn
- Can be difficult to install due to the use of programming language package managers
- Most SSGs don't scale well with large data sets
- Changes can only be shown as quickly as the build runs
Popular and Documented SSGs
- Hugo (Go)
- Jekyll (Ruby)
- Jekyll has support for an "incremental build" mode which only builds files that have been changed. This reduces the deploy time after a cache has been built of posts.
- Pelican (Python)
- Eleventy (node.js)
- Zola (Rust)
- Docpad (now considered "archived")
Graphical Editing User Interfaces
Setting up a CMS or micropub service can help make it easier to post without editing files directly. These usually require some kind of continuous integration to allow automatically building and deploying the site whenever these UIs change the underlying files.
Page editing User Interfaces
Some services add the ability to edit pages graphically in a "What You See Is What You Get" style visual editor. This can be more accessible to users without coding experience.
- rascul is writing his own site generator for https://rascul.io.
- bear is writing and using Hakkan.
- Emma Kuo is writing and using Skein.
- Daniel Goldsmith is using Hugo and writing nanopub, a micropub-endpoint for SSGs
- AJ Jordan is writing Stratic and lazymention (Webmention for static sites)
- Amit Gawande is using Hugo and posting with micro.blog via a micropub-endpoint
- capjamesg is building letsjam, a static site generator built with Python and jinja2. James formerly used Jekyll to generate his website.
- Ethan Yoo is using Hugo for ethanyoo.com and mdBook for his personal wiki
- ttntm is using Eleventy to build his site since switching from Hugo in 04/2021
- adi is writing and using mkws, a simple static site generator using sh as templating language.
- Anthony Ciccarello is using Eleventy to build his site after switching from Jekyll for ciccarello.me
- Add yourself here… (see this for more details)
- 2015/Static Websites
- static site
- static site cms
- Static hosting
- https://github.com/strugee/lazymention app that can handle webmention sending and websub hub pings when notified of new deploy
- webmention.io receiver for static sites - https://github.com/martymcguire/morris - bake webmention data during build
- "And if you're a web dev like me, it's extremely satisfying to roll a little static site generator and play with things like microformats and webmentions." @qubyte August 20, 2018
- Introduction to SSG from 2015
- List of SSG
- "listen—fine—SSR your static build on demand at request-time but before I’ll get on board we need to agree that you’ve reinvented PHP" @zachleat May 4, 2020
- how to make your own https://blog.lmorchard.com/2020/05/25/diy-easy-blog-oven/
- Waving a thankful goodbye to: static-websites and more.
- SSGs are not always a "simple" option: https://kevq.uk/static-site-generators-are-easy-to-useright/