withstudiocms · trueberryless · Apr 21, 2025 · Apr 20, 2025 · Apr 20, 2025 · Apr 20, 2025
@@ -1,7 +1,7 @@
 ---
 i18nReady: true
 title: Code-Beiträge
-description: Erfahre, wie du zu StudioCMS beitragen kannst
+description: Erfahre, wie du Code zu StudioCMS beitragen kannst
 sidebar:
   order: 2
 ---
@@ -60,4 +60,4 @@ Jetzt, wo du Teil der StudioCMS-Community bist, kannst du uns helfen, andere PRs
 Oh, und du wirst dein Gesicht in der [Liste der Mitwirkenden][contributors] sehen! 🎉
 
 {/* Links */}
-[contributors]: /de/guides/contributing/getting-started/#unsere-mitwirkenden
+[contributors]: /de/guides/contributing/getting-started/#unsere-mitwirkenden
@@ -1,7 +1,7 @@
 ---
 i18nReady: true
 title: Erste Schritte
-description: Erfahre, wie du zu StudioCMS beitragen kannst
+description: Lerne die Grundlagen der Mitwirkung in StudioCMS
 sidebar:
   order: 1
 ---

@@ -1,34 +1,120 @@
 ---
 i18nReady: true
 title: Übersetzungen
-description: Erfahre, wie du bei der Übersetzung von StudioCMS helfen kannst
+description: Erfahre, wie du Übersetzungen zu StudioCMS beisteuern kannst
 sidebar:
   order: 2
   badge:
-    text: Demnächst
-    variant: note
+    text: Aktualisiert
+    variant: success
 ---
 
 import ReadMore from '~/components/ReadMore.astro';
+import { FileTree } from '@astrojs/starlight/components';
 
 StudioCMS ist ein globales Projekt, und wir wollen es für alle zugänglich machen. Wenn du mehrere Sprachen fließend beherrschst, kannst du uns helfen, StudioCMS in deine Sprache zu übersetzen.
 
-## Dashboard-i18n
+## Mach mit auf Discord
 
-Aktueller Stand der Übersetzung
+Bevor du dich ins Übersetzen stürzt, schau in unserem [Discord-Chat](https://chat.studiocms.dev) vorbei.
+
+Auf Discord bekommst du Antworten in Echtzeit und kannst dich mit anderen Übersetzerinnen und Übersetzern abstimmen, damit niemand unwissentlich auf der gleichen Seite arbeitet. Außerdem finden dort alle unsere i18n-Diskussionen und Stiltipps statt, was es zur ersten Anlaufstelle macht, um sich über bewährte Verfahren zu informieren und an Entscheidungen beteiligt zu werden.
+
+:::tip[Du kannst nicht auf Discord zugreifen?]
+Wir wollen, dass du trotzdem mitmachst! Bitte eröffne ein neues Issue auf GitHub für [Docs](https://github.com/withstudiocms/docs/issues/new/choose) oder die [Pakete](https://github.com/withstudiocms/studiocms/issues/new/choose), um deine Fragen zu stellen.
+:::
+
+## Übersetzungen der Pakete
+
+Aktueller Stand der Übersetzung:
 
 <img src="https://badges.awesome-crowdin.com/translation-16993424-776180-update.png" alt="Status der Übersetzung" />
 
-Besuche [unser i18n-Dashboard](https://i18n.studiocms.dev), um die Übersetzung von StudioCMS in deine Sprache zu unterstützen. Wenn deine Sprache nicht aufgeführt ist, kannst du sie im Dashboard hinzufügen.
+Besuche [unser i18n-Dashboard](https://i18n.studiocms.dev), um bei der Übersetzung der StudioCMS-Pakete in deine Sprache zu helfen. Wenn deine Sprache nicht aufgeführt ist, kannst du sie im Dashboard hinzufügen.
 
-Wenn du die Übersetzungen lieber direkt in das Repository einbringen möchtest, werden sie im Verzeichnis [`packages/studiocms/src/lib/i18n/translations`](https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/src/lib/i18n/translations/) gespeichert. Die englischen Übersetzungen findest du in der Datei [`en-us.json`](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/lib/i18n/translations/en-us.json).
+Wenn du die Übersetzungen lieber direkt in das Repository einbringen möchtest, werden sie im Verzeichnis [`packages/studiocms/src/lib/i18n/translations`](https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/src/lib/i18n/translations/) gespeichert. Die englischen Übersetzungen findest du in der Datei [`en.json`](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/lib/i18n/translations/en.json).
+
+Egal, wo du übersetzt (Crowdin oder GitHub), die Informationen werden automatisch synchronisiert und sind in der nächsten Version verfügbar.
 
 <ReadMore>
-StudioCMS nutzt [Crowdin](https://crowdin.com/) für die Verwaltung von Übersetzungen auf GitHub. Wenn du Crowdin noch nicht kennst, findest du auf der Website von Crowdin den [Leitfaden für Übersetzer](https://support.crowdin.com/for-translators/).
+Alle StudioCMS-Pakete nutzen [Crowdin](https://crowdin.com/) für die Verwaltung von Übersetzungen auf GitHub. Wenn du Crowdin noch nicht kennst, findest du die [Anleitung für Übersetzer](https://support.crowdin.com/for-translators/) auf der Website von Crowdin.
 </ReadMore>
 
 Sobald die Übersetzungen hinzugefügt wurden, werden sie zur [StudioCMS i18n-Konfiguration](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/lib/i18n/index.ts#L8) hinzugefügt und sind in der nächsten Version verfügbar.
 
-## Dokumentation
+## Übersetzung der Dokumentation
+
+StudioCMS arbeitet aktiv daran, seine Dokumentation in mehrere Sprachen zu übersetzen.
+
+Zurzeit versuchen wir, die StudioCMS-Dokumentation in die folgenden Sprachen zu übersetzen:
+
+- Spanisch
+- Französisch
+- Deutsch
+- Koreanisch
+
+Ein großes Lob an unsere großartigen Übersetzerinnen und Übersetzer in der Community, die ihre Zeit opfern, um unsere Website in den oben genannten Sprachen verfügbar zu machen. Wir würden gerne jede Sprache unterstützen, aber wir müssen uns auf die Sprachen konzentrieren, für die wir bereits Leute haben, die bereit sind, zu übersetzen und die Dinge auf dem neuesten Stand zu halten. Wenn wir eine neue Sprache einführen, müssen wir ein Team zusammenstellen und mit mehreren Codebasen jonglieren. Deshalb führen wir nur solche Sprachen ein, die wir vorher genehmigt haben und für die wir bereits ein Team haben, das die Übersetzung der gesamten Seite in Angriff nimmt.
+
+### Erste Schritte
+
+Schau bei unserem [Übersetzungs-Tracker](https://i18n.docs.studiocms.dev) vorbei, um den Live-Status jeder Seite zu sehen - was aktuell ist, was überarbeitet werden muss und welche PRs noch auf eine Überprüfung warten. Er zieht unsere lokale Git-Historie heran, um die Zeitstempel aller Übersetzungen zu vergleichen und den Status jeder Seite automatisch zu aktualisieren.
+
+Du kannst auch direkt in GitHub einsteigen: Filtere die offenen PRs deiner Sprache nach dem i18n-Label, suche nach Tippfehlern oder Fehlübersetzungen und gib ihnen eine Bewertung. Das ist eine tolle Möglichkeit, um herauszufinden, wie StudioCMS mit i18n umgeht!
+
+### Aufbau der Dokumentation
+
+Das docs-Repository enthält drei verschiedene Arten von übersetzbaren Inhalten: docs-Seiten und UI-Strings. Der folgende Dateibaum zeigt, wo diese im Repository zu finden sind.
+
+<FileTree>
+
+- ...
+- src/
+  - ...
+  - content/
+    - docs/ MDX-Seiteninhalt, ein Verzeichnis pro Sprache
+      - de/
+      - en/
+      - es/
+      - ...
+    - i18n/ UI-String-Übersetzungen, eine Datei pro Sprache
+      - de.json
+      - en.json
+      - es.json
+      - ...
+  - starlight-sidebar/ UI-String-Übersetzungen für die Sidebar, eine Datei pro Sprache
+    - de.json
+    - en.json
+    - es.json
+    - ...
+- astro.config.ts
+- package.json
+- ...
+
+</FileTree>
+
+### Übersetzungsprozess
+
+Bereit zum Eintauchen? Hier erfährst du, wie du im Repo findest, was du brauchst:
+
+1. **Seitenspezifischer Inhalt** (Seitentitel, Haupttext, usw.)
+
+   ➤ Gehe zu `src/content/docs/{language}/{page-slug}.mdx`
+
+2. **Gemeinsamer Text** (Suchmodal, rechte Seitenleiste, Links zum „nächsten Artikel“, Tutorials usw.)
+
+   ➤ Gehe zu `src/content/i18n/{language}.json`
+
+3. **Primäre Seitenleistenübersetzungen**
+
+   ➤ Gehe zu `src/starlight-sidebar/{language}.json`
+
+
+Wenn du deine Zieldatei gefunden hast, sieh dir den [Übersetzungs-Tracker](https://i18n.docs.studiocms.dev/) und bestehende PRs an, vielleicht arbeitet ja schon jemand daran. Wenn du Zeit hast, melde dich im `docs-i18n`-Kanal in Discord, damit niemand doppelte Arbeit macht!
+
+:::note
+Bist du dir nicht sicher, ob etwas übersetzt werden sollte oder nicht? Wie funktioniert eine bestimmte Komponente? Schau in unsere [Referenz](/de/config-reference/).
+:::
 
-**Bald!** Wir arbeiten daran, die StudioCMS-Dokumentation zu übersetzen. Wenn du daran interessiert bist, uns dabei zu helfen, melde dich bitte bei uns auf [Discord](https://chat.studiocms.dev)
+:::caution
+Nicht alle unsere Seiten sind übersetzungsreif. Wir geben neue Seiten je nach ihrer Stabilität zur Übersetzung frei, also übersetze keine Seiten, die keinen „Diese Seite übersetzen“-Button im Bereich „Beitragen“ in der rechten Seitenleiste haben.
+:::
@@ -0,0 +1,157 @@
+---
+i18nReady: true
+title: Selbstgehosteter libSQL-Server
+description: Hoste deinen eigenen sqld libSQL Server mit Docker
+---
+
+import ReadMore from '~/components/ReadMore.astro'
+import { PackageManagers } from 'starlight-package-managers'
+import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components';
+
+Das Projekt `sqld` („SQL daemon“) ist ein Servermodus für libSQL, der von Turso entwickelt wurde.  In diesem Leitfaden wird beschrieben, wie du `sqld` für dein StudioCMS-Projekt einrichtest und konfigurierst, damit es in einem Docker-Container funktioniert.
+
+<ReadMore>Mehr über `sqld` erfährst du in deren [Dokumentation][sql-docs]</ReadMore>
+
+## Voraussetzungen
+
+- [Docker und Docker Compose][docker-docs] (entweder auf einem Server oder lokal ausgeführt)
+- [OpenSSL][openssl-docs] installiert
+- StudioCMS CLI (verfügbar im Stammverzeichnis deines StudioCMS-Projekts)
+
+Die endgültige Dateistruktur wird etwa so aussehen, wenn du lokal testest:
+
+<FileTree>
+
+- docker-compose.yml
+- data/
+- keys/
+- mein-studiocms-project/
+  - astro.config.mjs
+  - studiocms.config.mjs
+  - package.json
+  - src/
+
+</FileTree>
+
+## Private und öffentliche Schlüssel generieren
+
+Führe im Verzeichnis `keys` den folgenden Befehl aus, um ein neues PKCS#8-kodiertes Ed25519-Schlüsselpaar zu erstellen: 
+
+```bash  
+openssl genpkey -algorithm Ed25519 -out ./libsql.pem  
+```  
+
+Dann extrahiere den öffentlichen Schlüssel mit: 
+
+```bash
+openssl pkey -in ./libsql.pem -pubout -out ./libsql.pub
+```
+
+Dadurch wird ein neues PKCS#8-Schlüsselpaar erzeugt, das für den `sqld`-Server verwendet wird.
+
+## Erstelle dein JWT-Token
+
+Navigiere zu deinem studiocms-Projektverzeichnis und führe den folgenden Befehl aus:
+
+<PackageManagers pkg='studiocms' type='run' args='crypto gen-jwt "../keys/libsql.pem" -c "iss=admin" -e 31556926' />
+
+Die Ausgabe ist das mit deinem privaten Schlüssel verschlüsselte JWT-Auth-Token, das für die libSQL-Authentifizierung verwendet wird. Beachte, dass das Token 1 Jahr lang gültig ist!
+
+### Aktualisiere deine StudioCMS `.env` mit den folgenden Angaben:
+
+```sh
+ASTRO_DB_REMOTE_URL=http://localhost:8080 # Dies sollte auf deinen Docker-Server/dein lokales System zeigen
+ASTRO_DB_APP_TOKEN= # füge hier dein base64URL kodiertes JWT Auth-Token ein
+```
+
+## Einrichten des Docker-Containers
+
+Erstelle eine neue Datei `docker-compose.yml` außerhalb des StudioCMS-Projektverzeichnisses für die libSQL-Instanz. An dieser Stelle hast du zwei Möglichkeiten, die libSQL-Authentifizierung zu konfigurieren:
+
+- Verwendung der öffentlichen Schlüsseldatei selbst
+- Verwendung des JWT-Tokens als Umgebungsvariable (derselbe ASTRO_DB_APP_TOKEN-Wert, den du in deiner .env-Datei verwendet hast)
+
+<Tabs>
+
+<TabItem label="Datei mit öffentlichem Schlüssel">
+
+```yml
+services:
+  libsql:
+    image: ghcr.io/tursodatabase/libsql-server:latest
+    platform: linux/amd64
+    ports:
+      - "8080:8080"
+      - "5001:5001"
+    environment:
+      - SQLD_NODE=primary
+      - SQLD_AUTH_JWT_KEY_FILE=/home/.ssh/libsql.pub
+    volumes:
+      - ./data/libsql:/var/lib/sqld
+      - ./keys/libsql.pub:/home/.ssh/libsql.pub
+```
+
+</TabItem>
+
+<TabItem label="JWT-Token">
+
+```yml
+services:
+  libsql:
+    image: ghcr.io/tursodatabase/libsql-server:latest
+    platform: linux/amd64
+    ports:
+      - "8080:8080"
+      - "5001:5001"
+    environment:
+      - SQLD_NODE=primary
+      - SQLD_AUTH_JWT_KEY=füge dein JWT-Token hier ein
+    volumes:
+      - ./data/libsql:/var/lib/sqld
+```
+
+</TabItem>
+
+</Tabs>
+
+<Aside type="note" title="Bereitstellen auf Coolify?">
+[Coolify](https://coolify.io) Benutzer: Verwende unser [GitHub Gist](https://gist.github.com/Adammatthiesen/bfe7c78b2e73996fb3ef1b36ed606a57) für eine Coolify-kompatible Docker Compose-Konfiguration, die libSQL direkt über deine Domain ohne das Port-Suffix `:8080` zugänglich macht.
+</Aside>
+
+## Alles in Gang setzen
+
+<Steps>
+
+1. Starte den Docker Container
+
+   Führen Sie im Basisverzeichnis (oder auf dem Server, wenn Sie diesen Weg gewählt haben) den folgenden Befehl aus, um den libSQL Server Container zu starten:
+
+   ```sh
+   docker compose up -d
+   ```
+
+2. Synchronisiere dein StudioCMS-Datenbankschema:
+
+   Wechsle in dein StudioCMS-Projektverzeichnis und führe den folgenden Befehl aus:
+
+   <PackageManagers type="exec" args="astro db push --remote" />
+
+3. Folge der Ersteinrichtung für deine neue Datenbank.
+
+   - Siehe [Erste Schritte][getting-started]
+
+   :::note
+   Wenn dies nicht das erste Mal ist, dass du ein StudioCMS-Projekt einrichtest, musst du eventuell die Option `dbStartPage` in deiner `studiocms.config.mjs` aktivieren
+   :::
+
+</Steps>
+
+## Abschließende Überlegungen
+
+Wenn du nach einer Möglichkeit suchst, deine eigene libSQL-Datenbank mit StudioCMS zu hosten, ist `sqld` eine praktikable Option und nicht sehr kompliziert, wenn du es richtig machst. Wenn du diese Anleitung befolgst, erhältst du einen sicheren libSQL-Server, den du neben deinem StudioCMS-Projekt verwenden kannst
+
+{/* Links */}
+[sql-docs]: https://github.com/tursodatabase/libsql/blob/main/docs/USER_GUIDE.md
+[docker-docs]: https://docs.docker.com/get-started/get-docker/
+[openssl-docs]: https://docs.openssl.org/3.2/man7/ossl-guide-introduction/#getting-and-installing-openssl
+[getting-started]: /de/start-here/getting-started/#erstmalige-einrichtung-oder-bei-aktualisierungen-wenn-das-tabellenschema-aktualisiert-wird
@@ -0,0 +1,20 @@
+---
+i18nReady: true
+title: Leitfäden & Tutorials
+description: Leitfäden und Tutorials für StudioCMS
+---
+
+## Leitfäden zum Beitragen
+
+- [Erste Schritte](/de/guides/contributing/getting-started/) - Erfahre die Grundlagen des Beitragens zu StudioCMS
+- [Codebeiträge](/de/guides/contributing/code-contributions/) - Erfahre, wie du Code zu StudioCMS beisteuern kannst
+- [Übersetzungen](/de/guides/contributing/translations/) - Erfahre, wie du Übersetzungen zu StudioCMS beisteuern kannst
+
+## Aktualisierungs-Anleitung
+
+- [Anmerkungen zu Releases](/de/guides/upgrade/release-notes/) - Automatisierte Anmerkungen zu Releases, die aus den StudioCMS Changelogs generiert werden
+- In der Seitenleiste findest du weitere Optionen für diese Kategorie, wie z.B. die spezifischen Versionsanleitungen.
+
+## Datenbanken
+
+- [Selbstgehosteter libSQL-Server](/de/guides/database/sqld-server/) - Hoste deinen eigenen libSQL-Server mit Docker
@@ -0,0 +1,35 @@
+---
+i18nReady: true
+title: "Aktualisieren: 0.1.0-beta.16"
+description: Aktualisiere StudioCMS auf Beta.16
+sidebar:
+  label: 0.1.0-beta.16
+  badge:
+    text: NEU
+    variant: success
+  order: 999999
+---
+
+import ReadMore from '~/components/ReadMore.astro'
+import QuickUpdate from '~/components/QuickUpdate.astro'
+
+<QuickUpdate />
+
+## Bahnbrechende Veränderungen
+
+- Aktualisierte Mindestversion von Astro auf `Astro v5.7.1`
+- Aktualisierte Passwortsicherheit
+   - Die Benutzer/innen sollten angewiesen werden, ihre Passwörter nach der Aktualisierung zu aktualisieren, da die Unterstützung für das Hashing von alten Passwörtern in Zukunft entfernt wird.
+
+## Neue Merkmale/Funktionalität
+
+- CLI Aktualisierungen/Änderungen
+   - Neuer Befehl: `studiocms add <plugin>` zum schnellen Hinzufügen neuer Plugins zu deinem StudioCMS-Projekt.
+   - Neuer Befehl: `studiocms crypto [command]` für neue Sicherheitsprogramme.
+   - Neuer Befehl: `studiocms crypto gen-jwt <key-file>` zum Erzeugen von JWT-Tokens über die CLI.
+   - Fix: Die Bearbeitung von Nutzern über die CLI ist jetzt dank des neuen partiellen db drizzle Schemas für Nutzer und Berechtigungen möglich.
+
+<ReadMore>Weitere Informationen über die neuen CLI-Befehle findest du in der Dokumentation [Das CLI][cli-docs]</ReadMore>
+
+{/* Links */}
+[cli-docs]: /de/how-it-works/cli/