From 0057fe97555a5e4a8759dc14b1a3206a74fd6136 Mon Sep 17 00:00:00 2001 From: Albrecht Degering Date: Tue, 7 Jul 2026 11:28:34 +0200 Subject: [PATCH] Sync wiki from project files --- Repo-docs-GITEA-ISSUES.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/Repo-docs-GITEA-ISSUES.md b/Repo-docs-GITEA-ISSUES.md index 4c5e7f3..d1d7bd7 100644 --- a/Repo-docs-GITEA-ISSUES.md +++ b/Repo-docs-GITEA-ISSUES.md @@ -1,4 +1,4 @@ - + > Mirrored from `/mnt/DATA/git/govoplan-core/docs/GITEA_ISSUES.md`. > Origin: `repository`. @@ -191,6 +191,22 @@ Apply the wiki mirror: ./scripts/gitea-sync-wiki.py --env-file /home/zemion/.config/gitea/gitea.env --apply ``` +The default apply path uses the Gitea wiki git repository, not one REST API +request per page. It keeps a local checkout cache below +`/tmp/codex-gitea-wiki-sync`, commits changed pages once per repository, and +pushes that commit. This is much faster and avoids REST wiki-page timeouts. +Use `--transport api` only when the wiki git remote is unavailable. + +Limit a sync to one repository or one generated page while working: + +```bash +./scripts/gitea-sync-wiki.py --repo govoplan-core --apply +./scripts/gitea-sync-wiki.py --repo govoplan-core --page Repo-docs-MODULE-ARCHITECTURE --apply +``` + +Page-limited syncs do not rewrite `Codex-Project-Index`; run a full repository +sync when the set of mirrored pages changes. + The wiki sync mirrors durable text documents only: root README-style files, docs/codex project docs, and selected product notes such as roadmap, plan, concept, pitch, and whitepaper files. It skips generated folders, dependency/build output, `.gitea` templates, and filenames that look credential-related. Each managed wiki page contains a `codex-wiki-sync` marker and a source path. Reruns update only managed pages unless `--overwrite-unmanaged` is passed. Each repository also gets a managed `Codex-Project-Index` page linking the mirrored pages.