WIP Static wiki website using Zola - https://www.getzola.org
| content/wiki | ||
| sass | ||
| static | ||
| templates | ||
| .gitignore | ||
| config.toml | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| README.md | ||
| result | ||
We are considering our options regarding maintainability of https://wiki.cyberia.club. Some have suggested switching to a static site generator with markdown pages stored on our git server. Some benefits to this approach are:
- (Re)uses an established auth mechanism instead of juggling several.
- More people know Markdown than some random wiki software's markup language.
Some considerations people have raised include:
- Maintain as frictionless an editing flow as possible
- edit button links to forgejo's edit interface for that page
- any authenticated user should be allowed to edit
- SSG and contents live in separate repos
This repo houses my (reese's) attempt to build this with Zola. I'm not sure it's the right tool for a wiki but if we find something better we can always adapt these files.
Some stumbling blocks I've found:
- pages require a frontmatter block even if it's empty
- does forgejo have "add file" templates?
- not sure it supports transclusions (page within a page)
- internal links need
wiki/prefix- could write a link resolver macro?
- limited set of templates have restrictive set of variables available