docs-public/README.md

Public Wiki Source (docs-public)

This repository exclusively contains the Markdown content, static assets, and dynamic configuration overrides for your public-facing wiki.

🏗️ Architecture

Your Wiki architecture is decoupled. This repository contains the text, but the hugo-framework repository contains the styling and engine (Blowfish).

What lives here:

• content/ (Optional: Just place your markdown files in the root instead)
• static/ (Images, downloads, icons)
• config/ (Dynamic overrides for the Top Navigation Menu: menus.en.toml)
• .gitea/workflows/deploy.yaml (The CI/CD pipeline script)

🚀 Deployment

Pushing changes to the main branch automatically triggers the Gitea Action.

The Runner:

1. Checks out this repository.
2. Clones the hugo-framework.
3. Injects your Markdown and the menus.en.toml.
4. Injects the "Edit Link" URL dynamically via Environment Variables (HUGO_PARAMS_ARTICLE_EDITURL).
5. Builds the site.
6. Deploys it directly to the Nginx web server volume at /srv/caddy/sites/wiki.

Public URL: https://wiki.wompmacho.com