Upload per ZIP-Tool (1/1)

README.md

@@ -1,5 +1,7 @@
 # ZIP → Gitea Upload
 
+**Live nutzen:** [https://software.obraasch.de/gitea-uploader/index.html](https://software.obraasch.de/gitea-uploader/index.html)
+
 Lädt eine ZIP-Datei direkt aus dem Browser in ein Gitea-Repository hoch -
 mit Ordnerstruktur, in einem oder mehreren Commits. Läuft vollständig
 client-seitig; es wird ausschließlich mit dem selbst angegebenen
@@ -9,8 +11,8 @@ Gitea-Server kommuniziert.
 
 1. Gitea-Server-URL, Benutzername und Passwort oder Zugangstoken eingeben,
    "Verbinden & Repos laden" klicken.
-2. Bestehendes Repo aus der Liste wählen **oder** einen neuen Namen
-   eingeben und "Repo erstellen" klicken.
+2. Konto/Organisation wählen, dann bestehendes Repo aus der Liste wählen
+   **oder** einen neuen Namen eingeben und "Repo erstellen" klicken.
 3. ZIP-Datei auswählen.
 4. Commit-Nachricht anpassen (optional) und "Jetzt hochladen" klicken.
 
@@ -19,11 +21,25 @@ angelegt. Über die Checkbox "Dateien im Repo löschen, die nicht mehr in
 der ZIP enthalten sind" kann der Repo-Stand komplett an die ZIP angepasst
 werden (mit Bedacht nutzen).
 
-## Voraussetzung auf dem Gitea-Server
+Über das Zahnrad-Symbol oben rechts lassen sich Zugangsdaten im Browser
+speichern (nur lokal, nichts wird übertragen) sowie als Datei exportieren
+und auf einem anderen Gerät wieder importieren.
 
-Damit der Browser die Gitea-API von einer anderen Domain aus aufrufen
-darf, muss CORS für diese Domain aktiviert sein (Abschnitt `[cors]` in
-`app.ini`).
+## Voraussetzung auf dem Gitea-Server: CORS
+
+Damit der Browser die Gitea-API von einer anderen Domain aus aufrufen darf, muss CORS auf dem Gitea-Server
+aktiviert sein. In `app.ini` (bei per Helper-Script installiertem Gitea: `/etc/gitea/app.ini`) folgenden
+Abschnitt ergänzen (Position in der Datei ist egal, einfach ans Ende anfügen):
+
+```ini
+[cors]
+ENABLED = true
+ALLOW_DOMAIN = https://software.obraasch.de
+ALLOW_CREDENTIALS = true
+```
+
+Danach den Gitea-Dienst neu starten (`systemctl restart gitea` bei nativer Installation, sonst der
+entsprechende Container-Neustart), damit die Änderung greift.
 
 ## Lizenz