Author SHA1 Message Date
Tirsvad 44ee25d97d Merge pull request 'Rename the wiki pages without hyphens' (#80) from rename-wiki-pages-no-hyphens into main
Quality checks / quality-checks (push) Successful in 25s
Quality / quality (push) Successful in 25s
TirSystem/github-action: Publish wiki / publish-wiki (push) Successful in 9s
TirSystem/github-action: Sync GitHub mirror metadata / sync-metadata (push) Successful in 5s
Reviewed-on: #80
2026-10-12 12:03:33 +02:00
Tirsvad 32fa6a819e Rename the wiki pages without hyphens
Quality checks / quality-checks (pull_request) Successful in 29s
Quality / quality (pull_request) Successful in 29s
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.
2026-10-12 18:02:38 +08:00
Tirsvad a06b54ee7e Merge pull request 'Use the kebab-case repository name' (#79) from rename-repo-kebab-case into main
Quality checks / quality-checks (push) Successful in 24s
TirSystem/github-action: Publish wiki / publish-wiki (push) Failing after 7s
TirSystem/github-action: Sync GitHub mirror metadata / sync-metadata (push) Successful in 6s
Quality / quality (push) Successful in 25s
Reviewed-on: #79
2026-10-12 11:59:00 +02:00
Tirsvad 7e9551e151 Use the kebab-case repository name in URLs and paths
Quality checks / quality-checks (pull_request) Successful in 28s
Quality / quality (pull_request) Successful in 28s
The repository is now TirSystem-BashScript/repo-foundry on Gitea and GitHub.
Update the clone URL, the example paths and the wiki links. Old links keep
working through the redirects of both hosts, so documents that only cite
commits and milestones are left as they are.
2026-10-12 17:52:43 +08:00
Tirsvad fa546d4134 Merge pull request 'Add the wiki, Quality and Release workflows' (#78) from add-wiki-quality-release-workflows into main
TirSystem/github-action: Publish wiki / publish-wiki (push) Successful in 8s
TirSystem/github-action: Sync GitHub mirror metadata / sync-metadata (push) Successful in 5s
Quality checks / quality-checks (push) Successful in 25s
Quality / quality (push) Successful in 25s
Reviewed-on: TirSystem-BashScript/RepoFoundry#78
2026-10-12 11:46:15 +02:00
6 changed files with 17 additions and 17 deletions
+4 -4
View File
@@ -52,8 +52,8 @@ Requirements:
| `jq` (optional) | JSON parsing; without it a small built-in reader is used | | `jq` (optional) | JSON parsing; without it a small built-in reader is used |
```bash ```bash
git clone https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry.git git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
cd RepoFoundry cd repo-foundry
src/create-project.sh --help src/create-project.sh --help
``` ```
@@ -69,7 +69,7 @@ command (below):
```bash ```bash
cd ~/work # the folder that will hold my-app cd ~/work # the folder that will hold my-app
~/src/RepoFoundry/src/create-project.sh # creates ~/work/my-app ~/src/repo-foundry/src/create-project.sh # creates ~/work/my-app
``` ```
### Make it a global command ### Make it a global command
@@ -104,7 +104,7 @@ run `export MSYS=winsymlinks:nativestrict` before the `ln -s`, or use an alias
in `~/.bashrc`, which works because the script finds its own folder: in `~/.bashrc`, which works because the script finds its own folder:
```bash ```bash
alias repo-foundry='bash /c/Users/me/RepoFoundry/src/create-project.sh' alias repo-foundry='bash /c/Users/me/repo-foundry/src/create-project.sh'
``` ```
## Configuration ## Configuration
@@ -13,8 +13,8 @@
## Install ## Install
```bash ```bash
git clone https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry.git git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
cd RepoFoundry cd repo-foundry
src/create-project.sh --help src/create-project.sh --help
``` ```
@@ -22,7 +22,7 @@ Nothing is installed system-wide: the script runs from the checkout.
## Configure ## 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 ## Run
+4 -4
View File
@@ -12,9 +12,9 @@ It is a Bash script. It shows a plan first and creates nothing until you pass `-
| Page | What it covers | | Page | What it covers |
| --- | --- | | --- | --- |
| [Getting started](Getting-started) | Requirements, install and the first run | | [Getting started](GettingStarted) | Requirements, install and the first run |
| [SSH and tokens](SSH-and-tokens) | SSH access to Gitea and the two access tokens | | [SSH and tokens](SshAndTokens) | SSH access to Gitea and the two access tokens |
| [Troubleshooting](Troubleshooting) | Common failures and what to do | | [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/RepoFoundry/src/branch/main/README.md). 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).
Report a problem as an [issue](https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry/issues). Report a problem as an [issue](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues).
@@ -13,7 +13,7 @@ The framework submodule is fetched over SSH on port **10022**. Before you run th
A message that you have successfully authenticated, without shell access, means it works. A message that you have successfully authenticated, without shell access, means it works.
> **Passphrase keys.** The script never prompts for a passphrase. A key with a passphrase must already be loaded in `ssh-agent` (`ssh-add`). This is tracked in [issue 77](https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry/issues/77). > **Passphrase keys.** The script never prompts for a passphrase. A key with a passphrase must already be loaded in `ssh-agent` (`ssh-add`). This is tracked in [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
## Tokens ## Tokens
@@ -22,4 +22,4 @@ The framework submodule is fetched over SSH on port **10022**. Before you run th
| Gitea access token | `GITEA_TOKEN` | always | access token with scopes | | Gitea access token | `GITEA_TOKEN` | always | access token with scopes |
| GitHub personal access token | `GITHUB_PAT` | only when you choose GitHub | **classic** personal access token | | GitHub personal access token | `GITHUB_PAT` | only when you choose GitHub | **classic** personal access token |
Step by step with pictures: [how to create the access tokens](https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry/src/branch/main/howto/create-access-tokens.md). The exact permissions are under [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry/src/branch/main/README.md#token-permissions) in the README. Step by step with pictures: [how to create the access tokens](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/howto/create-access-tokens.md). The exact permissions are under [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) in the README.
+2 -2
View File
@@ -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 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 | | 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 | | 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/RepoFoundry/src/branch/main/README.md#error-handling-and-recovery) and [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/RepoFoundry/src/branch/main/README.md#known-limitations) in the README. 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.
+2 -2
View File
@@ -1,4 +1,4 @@
- [Home](Home) - [Home](Home)
- [Getting started](Getting-started) - [Getting started](GettingStarted)
- [SSH and tokens](SSH-and-tokens) - [SSH and tokens](SshAndTokens)
- [Troubleshooting](Troubleshooting) - [Troubleshooting](Troubleshooting)