From 32fa6a819e85723d22b64216f03276f55a7c5cb7 Mon Sep 17 00:00:00 2001 From: Jens Tirsvad Nielsen Date: Mon, 12 Oct 2026 18:02:38 +0800 Subject: [PATCH] Rename the wiki pages without hyphens Gitea stores a page whose name has a hyphen under an escaped address (Getting-started.-), which the shared publish workflow does not match, so the second run tried to create the page again and got HTTP 400. Use GettingStarted and SshAndTokens, as the wiki of TirSystem/github-action does. --- wiki/{Getting-started.md => GettingStarted.md} | 2 +- wiki/Home.md | 4 ++-- wiki/{SSH-and-tokens.md => SshAndTokens.md} | 0 wiki/Troubleshooting.md | 2 +- wiki/_Sidebar.md | 4 ++-- 5 files changed, 6 insertions(+), 6 deletions(-) rename wiki/{Getting-started.md => GettingStarted.md} (93%) rename wiki/{SSH-and-tokens.md => SshAndTokens.md} (100%) diff --git a/wiki/Getting-started.md b/wiki/GettingStarted.md similarity index 93% rename from wiki/Getting-started.md rename to wiki/GettingStarted.md index a1443fd..7d577b1 100644 --- a/wiki/Getting-started.md +++ b/wiki/GettingStarted.md @@ -22,7 +22,7 @@ Nothing is installed system-wide: the script runs from the checkout. ## Configure -Copy `config.env.example` to `config.env` and `.env.example` to `.env`, then set the service addresses and the tokens (see [SSH and tokens](SSH-and-tokens)). `.env` holds credentials and is never committed. +Copy `config.env.example` to `config.env` and `.env.example` to `.env`, then set the service addresses and the tokens (see [SSH and tokens](SshAndTokens)). `.env` holds credentials and is never committed. ## Run diff --git a/wiki/Home.md b/wiki/Home.md index 7c57f97..c1150bb 100644 --- a/wiki/Home.md +++ b/wiki/Home.md @@ -12,8 +12,8 @@ It is a Bash script. It shows a plan first and creates nothing until you pass `- | Page | What it covers | | --- | --- | -| [Getting started](Getting-started) | Requirements, install and the first run | -| [SSH and tokens](SSH-and-tokens) | SSH access to Gitea and the two access tokens | +| [Getting started](GettingStarted) | Requirements, install and the first run | +| [SSH and tokens](SshAndTokens) | SSH access to Gitea and the two access tokens | | [Troubleshooting](Troubleshooting) | Common failures and what to do | The full reference (configuration files, security decisions, error handling, known limitations) is the [README](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md). diff --git a/wiki/SSH-and-tokens.md b/wiki/SshAndTokens.md similarity index 100% rename from wiki/SSH-and-tokens.md rename to wiki/SshAndTokens.md diff --git a/wiki/Troubleshooting.md b/wiki/Troubleshooting.md index 626724a..fc5d4e4 100644 --- a/wiki/Troubleshooting.md +++ b/wiki/Troubleshooting.md @@ -4,7 +4,7 @@ | --- | --- | | The plan says the SSH test failed | Your key is in your Gitea account, the host key is known (`ssh -p 10022 -T git@git.tirsystem.com`), and a passphrase key is loaded with `ssh-add` | | The script stops at the tool check | bash is 4.4 or later, and `git` and `curl` are installed | -| A host rejects the token | The token is current and has the scopes in [SSH and tokens](SSH-and-tokens) | +| A host rejects the token | The token is current and has the scopes in [SSH and tokens](SshAndTokens) | | A run stopped half way | Fix the cause and run the same command again with `--apply`: what was already created is offered for reuse | More: [Error handling and recovery](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#error-handling-and-recovery) and [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#known-limitations) in the README. diff --git a/wiki/_Sidebar.md b/wiki/_Sidebar.md index e480d59..0cf28c9 100644 --- a/wiki/_Sidebar.md +++ b/wiki/_Sidebar.md @@ -1,4 +1,4 @@ - [Home](Home) -- [Getting started](Getting-started) -- [SSH and tokens](SSH-and-tokens) +- [Getting started](GettingStarted) +- [SSH and tokens](SshAndTokens) - [Troubleshooting](Troubleshooting)