Configuration files, layouts and templates, and all the content you create.
Static Site Generators
This content is open source. Help improve it.
What is a Static Site Generator (SSG)?
There are some configuration files, layouts and templates, and all of the content you create. So.. the trick is to find something that runs nicely on your system and that you can figure out how to operate.
This page is where I keep track of info on the various SSG that I’m experienced with, as I begin to understand the stack surrounding them.
General
- pinceladasdaweb/Static-Site-Generators
- staticsitegenerators.net
- https://www.staticgen.com/
- JAMstack templates
Find the perfect place to begin a new JAMstack site. Deploy a template site to Netlify with just one click. The site’s code will automatically populate as a new folder in your Git repository so you can explore, edit, and update so it works for you. All for free.
Jekyll and GitHub Pages
Jekyll is the SSG built into GitHub, covered on the following pages:
Hugo
MkDocs
MkDocs has built in search, and in some ways simpler than publishing w jekyll.
For example, you don’t need to put frontmatter into every single document.. it will just create a website from markdown files and autogenerate toc based on directory structure.
MkDocs really caught my eye when I saw it running at EthHub
- https://www.mkdocs.org/
- /mkdocs/mkdocs/wiki/MkDocs-Plugins
- MkDocs Material Components - Cheat Sheet
- mkdocs.readthedocs.io
- mkdocs/mkdocs/wiki/MkDocs-Plugins
- mkdocs-awesome-pages-plugin
- mkdocs.plugins/
- metadata-for-markdown-mkdocs/
- https://gristlabs.github.io/mkdocs-windmill/
- https://python-markdown.github.io/extensions/
- https://python-markdown.github.io/extensions/smarty/
Because MkDocs builds with python, that opens up a whole universe of tools at your disposal. The python markdown extensions are a prime example.
However, basically none of the regular jekyll plugins work with mkdocs, it’s a whole universe to its own w Python.