chore: release v0.19.2
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# Publishing this wiki to GitHub
|
||||
|
||||
These files are the source for the **OpsLog GitHub Wiki**. GitHub stores a wiki
|
||||
as its own git repository (`<repo>.wiki.git`), so publishing means pushing these
|
||||
`.md` files into it.
|
||||
|
||||
## Automatic — via the release script (recommended)
|
||||
|
||||
The release task (`.vscode/release.ps1`, VS Code → *Tasks: Run Task* → *Release
|
||||
OpsLog*) **publishes the wiki automatically** at the end of every release: it
|
||||
clones `github.com/GregTroar/OpsLog.wiki.git` to a temp folder, copies every page
|
||||
from this `wiki/` folder (except this guide), and pushes only if something
|
||||
changed. Auth reuses your GitHub git credential (set up by `gh auth login`).
|
||||
|
||||
**One-time:** on GitHub, open the repo → **Wiki** tab → *Create the first page* →
|
||||
Save. This initialises the wiki repo so the script's clone succeeds.
|
||||
|
||||
## Manual (if you want to push between releases)
|
||||
|
||||
```bash
|
||||
# One-time: clone the wiki repo NEXT TO the project (not inside it)
|
||||
git clone https://github.com/GregTroar/OpsLog.wiki.git
|
||||
|
||||
# Then, to update:
|
||||
cp wiki/*.md ../OpsLog.wiki/ # (skip README-PUBLISHING.md if you like)
|
||||
cd ../OpsLog.wiki
|
||||
git add . && git commit -m "Update wiki" && git push
|
||||
```
|
||||
|
||||
The pages appear immediately under the repository's **Wiki** tab.
|
||||
|
||||
## How the pages work
|
||||
|
||||
- Each `.md` file is one wiki page. The **file name** becomes the page title and
|
||||
URL: `Getting-Started.md` → page *Getting Started* at `.../wiki/Getting-Started`.
|
||||
- **`_Sidebar.md`** renders as the navigation sidebar on every page.
|
||||
- **`_Footer.md`** renders at the bottom of every page.
|
||||
- Link between pages with `[[Page Name]]` (wiki-link) or a normal relative link
|
||||
`[text](Getting-Started)`.
|
||||
- `Home.md` is the wiki landing page.
|
||||
|
||||
## Keep it in sync with the README
|
||||
|
||||
The wiki mirrors [`README.md`](../README.md). When you add a feature, update the
|
||||
matching wiki page and the README together so they don't drift.
|
||||
Reference in New Issue
Block a user