README.md gefüllt

2026-07-17 11:03:58 +02:00
parent 5c915c74f8
commit 08fbb29af2
1 changed files with 30 additions and 0 deletions
@@ -0,0 +1,30 @@
+# Linklisten-Automatisierung
+
+Dieses Repository dient der automatischen Konvertierung der zentralen `linkliste.csv` in verschiedene Zielformate.
+
+Sobald eine Änderung an der `linkliste.csv` in den `main`-Branch gepusht wird, startet automatisch eine **Gitea Action**, die die Datei verarbeitet und die aktualisierten Formate (`XML`, `YAML`, `JSON`) direkt in das Repository schreibt.
+
+## Funktionsweise
+
+Der Prozess ist vollständig automatisiert:
+1. **Trigger**: Der Workflow reagiert automatisch auf Änderungen an der `linkliste.csv`.
+2. **Verarbeitung**: Ein schlankes Skript auf einem Alpine-Linux-Runner liest die CSV-Datei (Trennzeichen: `;`).
+3. **Konvertierung**: Die Daten werden in die Formate **XML**, **YAML** und **JSON** transformiert.
+4. **Synchronisation**: Die generierten Dateien werden automatisch zurück in das Repository committet und gepusht.
+
+## Dateistruktur
+
+* `linkliste.csv` : Die Quelldatei, die du bearbeitest.
+* `linkliste.xml` : Automatisch generierte XML-Datei.
+* `linkliste.json` : Automatisch generierte JSON-Datei.
+* `linkliste.yaml` : Automatisch generierte YAML-Datei.
+* `.gitea/workflows/` : Enthält die Konfigurationsdatei für die Gitea Action.
+
+## Konfiguration
+
+Die zu exportierenden Spalten werden zentral im Workflow-Skript definiert. Wenn du die CSV-Struktur erweiterst, passe einfach das `COLS`-Array im Workflow an:
+
+```bash
+# Beispiel für die Konfiguration im Workflow-Skript:
+# Spaltenindex:Spaltenname
+COLS=("1:id" "4:inhalt" "2:gruppe" "3:ebene" "5:url" "6:provider" "7:stil")