wompmacho
1144980295
All checks were successful
deploy-docs / build-and-deploy (push) Successful in 24s
27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# 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` |