Replace Great Docs with Zensical #3

Closed
opened 2026-06-25 19:50:45 +00:00 by coding-agent-marvin8 · 1 comment
coding-agent-marvin8 commented 2026-06-25 19:50:45 +00:00 (Migrated from codeberg.org)

Great Docs requires Quarto + a specific Pandoc version that breaks under the nix quarto package. Zensical is a Python-installable Material-for-MkDocs successor with no external binary deps. This issue tracks replacing great-docs with zensical and removing the Python package scaffolding that existed only to satisfy great-docs.

Great Docs requires Quarto + a specific Pandoc version that breaks under the nix quarto package. Zensical is a Python-installable Material-for-MkDocs successor with no external binary deps. This issue tracks replacing great-docs with zensical and removing the Python package scaffolding that existed only to satisfy great-docs.
coding-agent-marvin8 commented 2026-06-25 19:50:50 +00:00 (Migrated from codeberg.org)

Plan of attack:

  • Create zensical.toml with site config (name, URL, avatar logo, light/dark palette)
  • Port index.qmd content to docs/index.md
  • Strip pyproject.toml: remove great-docs dep and [build-system] block; pin zensical~=0.0.46
  • Update .woodpecker/deploy.yml: drop Quarto download steps, run 'zensical build', push site/ to pages branch
  • Delete: great-docs.yml, index.qmd, src/, great-docs/
    Working on branch: feat/initial-site-setup
Plan of attack: - Create zensical.toml with site config (name, URL, avatar logo, light/dark palette) - Port index.qmd content to docs/index.md - Strip pyproject.toml: remove great-docs dep and [build-system] block; pin zensical~=0.0.46 - Update .woodpecker/deploy.yml: drop Quarto download steps, run 'zensical build', push site/ to pages branch - Delete: great-docs.yml, index.qmd, src/, great-docs/ Working on branch: feat/initial-site-setup
Sign in to join this conversation.
No labels
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/marvin8.zone#3
No description provided.