Skip to content

Commit 8f8c209

Browse files
committed
fix: generate_sitemap.py
1 parent ba571f1 commit 8f8c209

File tree

2 files changed

+19
-2
lines changed

2 files changed

+19
-2
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,16 @@ Beiträge sind willkommen! Bitte erstelle einen Pull‑Request oder öffne ein I
158158
* [Protokollreferenz](docs/03_protocol_reference/protocol_details.adoc)
159159
* [Befehlsreferenz](docs/01_user_guide/usage.adoc#_command_interface)
160160

161+
## SEO & Sitemap
162+
163+
Die Dokumentation wird automatisch mit einer dynamischen Sitemap (`sitemap.xml`) und branch‑spezifischen `robots.txt`‑Dateien versehen, um die Auffindbarkeit in Suchmaschinen zu verbessern.
164+
165+
* **Sitemap‑Generierung:** Das Skript `tools/generate_sitemap.py` scannt den Build‑Output, weist Prioritäten und Update‑Frequenzen zu und generiert eine valide XML‑Sitemap gemäß sitemaps.org.
166+
* **Branch‑spezifische URLs:** Für die Branches `main`, `preview` und `develop` werden unterschiedliche Base‑URLs verwendet.
167+
* **Integration in CI/CD:** Der GitHub Actions Workflow `.github/workflows/docs.yml` generiert die Sitemap automatisch nach jedem Build und passt die `robots.txt` entsprechend an.
168+
169+
Weitere Details zur Architektur finden Sie im [Architektur‑Dokument](docs/02_developer_guide/architecture.adoc#dokumentations-infrastruktur-sitemap--seo).
170+
161171
## Lizenz
162172

163173
Dieses Projekt steht unter der MIT‑Lizenz – siehe [LICENSE](LICENSE) für Details.

tools/generate_sitemap.py

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -367,7 +367,6 @@ def main():
367367
)
368368
parser.add_argument(
369369
'--branch',
370-
choices=list(BRANCH_URLS.keys()),
371370
help='Git-Branch zur Bestimmung der Base-URL'
372371
)
373372
parser.add_argument(
@@ -386,7 +385,15 @@ def main():
386385
if args.base_url:
387386
base_url = args.base_url.rstrip('/')
388387
elif args.branch:
389-
base_url = BRANCH_URLS.get(args.branch, BRANCH_URLS['main'])
388+
if args.branch in BRANCH_URLS:
389+
base_url = BRANCH_URLS[args.branch]
390+
else:
391+
# Fallback für unbekannte Branches (Feature-Branches)
392+
base_url = BRANCH_URLS['preview']
393+
logger.warning(
394+
f"Unbekannter Branch '{args.branch}'. "
395+
f"Verwende Preview-URL als Fallback: {base_url}"
396+
)
390397
else:
391398
# Standard-URL für main-Branch
392399
base_url = BRANCH_URLS['main']

0 commit comments

Comments
 (0)