WIP Static wiki website using Zola - https://www.getzola.org
Find a file
2026-03-07 13:26:33 -06:00
content/wiki i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
sass i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
static testing 2026-03-04 15:09:07 -06:00
templates i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
.gitignore i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
config.toml i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
flake.lock testing 2026-03-04 15:09:07 -06:00
flake.nix built out more 2026-03-05 14:42:51 -06:00
LICENSE testing 2026-03-04 15:09:07 -06:00
README.md i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00
result i'm kinda hitting zola's limits 2026-03-07 13:26:33 -06:00

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