feat: german translation (#22)

Author: Philipinho

docusaurus.config.ts

@@ -35,7 +35,11 @@ const config: Config = {
   // may want to replace "en" with "zh-Hans".
   i18n: {
     defaultLocale: "en",
-    locales: ["en"],
+    locales: ["en", "de"],
+    localeConfigs: {
+      en: { label: "English", htmlLang: "en" },
+      de: { label: "Deutsch", htmlLang: "de" },
+    },
   },
 
   presets: [
@@ -104,6 +108,10 @@ const config: Config = {
           label: "GitHub",
           position: "right",
         },
+        {
+          type: "localeDropdown",
+          position: "right",
+        },
       ],
     },
     algolia: {

i18n/de/code.json

@@ -0,0 +1,14 @@
+{
+  "title": {
+    "message": "Blog",
+    "description": "The title for the blog used in SEO"
+  },
+  "description": {
+    "message": "Blog",
+    "description": "The description for the blog used in SEO"
+  },
+  "sidebar.title": {
+    "message": "Neueste Beiträge",
+    "description": "The label for the left sidebar"
+  }
+}

i18n/de/docusaurus-plugin-content-blog/options.json

@@ -0,0 +1,34 @@
+{
+  "version.label": {
+    "message": "Aktuell",
+    "description": "The label for version current"
+  },
+  "sidebar.tutorialSidebar.category.Self-Hosting": {
+    "message": "Self-Hosting",
+    "description": "The label for category Self-Hosting in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Reverse Proxy": {
+    "message": "Reverse Proxy",
+    "description": "The label for category Reverse Proxy in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.AI": {
+    "message": "AI",
+    "description": "The label for category AI in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.User Guide": {
+    "message": "Benutzerhandbuch",
+    "description": "The label for category User Guide in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Authentication": {
+    "message": "Authentifizierung",
+    "description": "The label for category Authentication in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Pages": {
+    "message": "Seiten",
+    "description": "The label for category Pages in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Bases": {
+    "message": "Bases",
+    "description": "The label for category Bases in sidebar tutorialSidebar"
+  }
+}

i18n/de/docusaurus-plugin-content-docs/current.json

@@ -0,0 +1,9 @@
+{
+  "label": "Erste Schritte",
+  "position": 1,
+  "link": {
+    "type": "generated-index",
+    "description": "Erfahren Sie, was Docmost ist und wie Sie es in Betrieb nehmen."
+  },
+  "collapsed": false
+}

i18n/de/docusaurus-plugin-content-docs/current/getting-started/_category_.json

@@ -0,0 +1,91 @@
+---
+slug: /
+sidebar_position: 1
+---
+
+# Einführung
+
+Willkommen bei **Docmost**, einer Open-Source-, Enterprise-tauglichen Software für kollaborative Wikis und Dokumentation.
+Konzipiert für nahtlose Echtzeit-Zusammenarbeit, können mehrere Benutzer gleichzeitig in Echtzeit an derselben Seite arbeiten, ohne sich gegenseitig zu überschreiben.
+
+Docmost ist eine Open-Source-Alternative zu Lösungen wie Notion und Confluence. Ob Sie ein Wiki, eine Wissensdatenbank oder umfangreiche Projektdokumentation verwalten – Docmost bietet Ihnen die Werkzeuge, die Sie benötigen, um Wissen mühelos zu erstellen, gemeinsam zu bearbeiten und zu teilen. Docmost ist vollständig selbst gehostet und kann in abgeschotteten (Air-Gapped) Umgebungen ohne externe Abhängigkeiten betrieben werden.
+
+Docmost unterstützt Bereiche. Sie können je nach Bedarf Bereiche für verschiedene Teams, Projekte oder Abteilungen erstellen. Jeder Bereich verfügt über eigene Berechtigungen. Mit einer optionalen Enterprise Edition skaliert Docmost, um den Anforderungen größerer Organisationen mit SSO, AI, API-Zugriff und mehr gerecht zu werden.
+
+![img](/img/home_image.png)
+
+## Funktionen
+
+- **Kollaborativer Echtzeit-Editor**: Arbeiten Sie gemeinsam in Echtzeit an Seiten.
+- **Bases** (Tabellen- und Kanban-Ansichten) (Enterprise): Organisieren Sie Inhalte als strukturierte Datenbanken mit Eigenschaften, Filtern, Sortierungen und Formeln.
+- **Bereiche**: Organisieren Sie Ihre Seiten nach Team, Projekten oder Abteilungen für eine bessere Zusammenarbeit.
+- **Berechtigungsverwaltung**: Steuern Sie den Zugriff auf Inhalte einfach mit intuitiven Berechtigungen auf Arbeitsbereichs- und Bereichsebene.
+- **Gruppen**: Gewähren Sie Benutzern einheitliche Berechtigungen über Gruppen.
+- **Verschachtelte Navigation**: Verschachteln, sortieren und ziehen Sie Seiten per Drag-and-Drop über die Seitenleiste.
+- **Tabellen**: Fügen Sie Tabellen ein und bearbeiten Sie diese mit anpassbaren Spaltenbreiten, zusammenführbaren Zellen, Kopfzeilen/-spalten und Zellhintergrundfarben.
+- **Diagramme**: Integrierte Unterstützung für die Diagramm-Werkzeuge Draw.io, Excalidraw und Mermaid.
+- **Mathematische Gleichungen**: Schreiben Sie mathematische Gleichungen inline und als Block mit KaTeX.
+- **Hinweise und Umschaltblöcke**: Strukturieren Sie Ihre Inhalte mit Hinweismeldungen und einklappbaren Umschaltblöcken.
+- **Synchronisierte Blöcke**: Verwenden Sie denselben Inhalt auf mehreren Seiten mit Blöcken, die synchron bleiben.
+- **Seitenbeschriftungen**: Organisieren und kategorisieren Sie Seiten mit anpassbaren Beschriftungen.
+- **Kommentare**: Fügen Sie Seiten Kommentare hinzu, um die Kommunikation und das Feedback zu verbessern.
+- **Seitenverlauf**: Verfolgen Sie Änderungen mit einem umfassenden Versionsverlauf und stellen Sie frühere Versionen wieder her.
+- **Öffentliches Teilen**: Teilen Sie Ihre Seiten öffentlich, sodass jeder mit dem Link sie ansehen kann.
+- **Suche**: Volltextsuche über alle Seiten hinweg mit Bereichs- und Typfiltern.
+- **Dateianhänge**: Hängen Sie Dateien an Ihre Seiten an, um sie einfach nachzuschlagen und zu teilen.
+- **Import / Export**: Importieren und exportieren Sie Seiten in den Formaten Markdown und HTML.
+  - ZIP-Archiv-Import
+  - Notion-Import
+  - Confluence-Import (Enterprise)
+  - PDF- & DOCX-Import (Enterprise)
+- **Druck als PDF**: Erstellen Sie PDF-Versionen von Seiten über den Druckdialog des Browsers.
+- **@-Erwähnungen**: Erwähnen Sie Teammitglieder und verlinken Sie direkt im Editor auf Seiten.
+- **Markdown-Tastenkürzel**: Geben Sie Markdown-Syntax direkt im Editor ein, und sie wird automatisch in Rich Text umgewandelt.
+- **Tastenkombinationen**: Vollständiger Satz an Tastenkombinationen für Formatierung, Navigation und Editor-Aktionen.
+- **Dunkler Modus**: Wechseln Sie zwischen hellem, dunklem und systemabhängigem Design.
+- **Lese-/Bearbeitungsmodus**: Legen Sie einen Standard-Seitenmodus fest, um versehentliche Änderungen zu verhindern.
+- **Übersetzungen**: Verfügbar in mehr als 12 Sprachen. 🇺🇸 🇨🇳 🇫🇷 🇩🇪 🇮🇹 🇯🇵 🇰🇷 🇧🇷 🇷🇺 🇪🇸 🇳🇱 🇺🇦
+
+## Authentifizierung
+- E-Mail und Passwort
+- LDAP (Enterprise)
+- SSO über SAML / OIDC (Enterprise)
+- MFA über TOTP (Enterprise)
+
+## Funktionen der Enterprise Edition
+- **Bases** (Tabellen- und Kanban-Ansichten) — Organisieren Sie Inhalte als strukturierte Datenbanken mit Eigenschaften, Filtern, Sortierungen und Formeln.
+- **SSO** (SAML 2.0 / OIDC) — Integrieren Sie Microsoft Entra ID, Okta, OneLogin und mehr.
+- **LDAP** — Authentifizieren Sie Benutzer gegen Ihr LDAP-Verzeichnis.
+- **SCIM-Bereitstellung** — Automatisieren Sie die Bereitstellung, Aktualisierung und Deaktivierung von Benutzern und Gruppen über Ihren Identitätsanbieter.
+- **MFA** (TOTP) — Multi-Faktor-Authentifizierung mit Authenticator-Apps.
+- **AI** — AI-Chat, AI-gestützte Schreibhilfe (Ask AI), AI-gestützte Suche (AI Answers) und MCP. Verwenden Sie Cloud-Modelle oder lokale LLMs.
+- **API** — REST-API mit persönlichen API-Schlüsseln und Admin-Schlüsselverwaltung.
+- **Volltextsuche in Anhängen** — Durchsuchen Sie Inhalte in PDF- und DOCX-Dateianhängen.
+- **Kommentare auflösen** — Markieren Sie Kommentar-Threads als aufgelöst.
+- **Öffentliches Teilen deaktivieren** — Steuern Sie das öffentliche Teilen auf Arbeitsbereichs- oder Bereichsebene.
+- **Confluence-Importer** — Importieren Sie Confluence-Bereiche unter Beibehaltung von Formatierung, Hierarchie und Anhängen.
+- **DOCX-Importer** — Importieren Sie Microsoft-Word-Dokumente.
+- **PDF-Importer** — Importieren Sie PDF-Dateien in Seiten.
+- **Vorlagen** — Erstellen und verwenden Sie Seitenvorlagen in Ihrem gesamten Arbeitsbereich.
+- **Berechtigungen auf Seitenebene** — Steuern Sie den Zugriff mit granularen Anzeige- und Bearbeitungsberechtigungen für einzelne Seiten und Bereiche.
+- **Seitenverifizierung & Freigabe-Workflow** — Prüfen, verifizieren und genehmigen Sie Inhalte, um sicherzustellen, dass die Dokumentation korrekt und aktuell bleibt.
+- **Priorisierter Support** — Direkter E-Mail-Support.
+- Sie können einen kostenlosen Testlizenzschlüssel unter [https://customers.docmost.com](https://customers.docmost.com) generieren.
+- [<a href="mailto:sales@docmost.com?subject=Docmost Enterprise Edition.">Enterprise Edition erwerben</a>].
+
+## FAQ
+**Wie installiere ich Docmost?**  
+Wir haben eine Installationsanleitung für Sie geschrieben. Sie finden sie auf der [Installationsseite](./installation).
+
+**Gibt es eine Cloud-Version, falls ich es nicht selbst hosten möchte?**  
+Ja! Sie können mit unserer Cloud-Version unter [https://app.docmost.com](https://app.docmost.com/create?ref=docs) loslegen.
+
+**Welche Lizenz verwendet Docmost?**  
+Docmost ist unter der Open-Source-Lizenz [AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html) 3.0 lizenziert.<br />
+Enterprise-Funktionen sind unter einer Enterprise-Lizenz (Enterprise Edition) verfügbar.
+
+**Gibt es eine Enterprise-Version?**
+Ja, wir haben eine Enterprise-Version mit SSO-Integration. Sie können einen Business- oder Enterprise-Testlizenzschlüssel unter [https://customers.docmost.com](https://customers.docmost.com) erhalten. Für den Kauf wenden Sie sich an <a href="mailto:sales@docmost.com">sales@docmost.com</a>.
+
+**Haben Sie noch weitere Fragen?**  
+Schreiben Sie gerne eine E-Mail an den Gründer: philip@docmost.com.

i18n/de/docusaurus-plugin-content-docs/current/introduction.md

@@ -0,0 +1,8 @@
+{
+  "label": "Self-Hosting",
+  "position": 2,
+  "link": {
+    "type": "generated-index"
+  },
+  "collapsed": false
+}

i18n/de/docusaurus-plugin-content-docs/current/self-hosting/_category_.json

@@ -0,0 +1,5 @@
+{
+  "label": "AI",
+  "position": 5,
+  "collapsed": true
+}

i18n/de/docusaurus-plugin-content-docs/current/self-hosting/ai/_category_.json

@@ -0,0 +1,200 @@
+---
+tags:
+   - Enterprise
+---
+
+# AI-Suche einrichten
+
+Die AI-gestützte Suche und der AI Chat in Docmost verwenden Vektor-Embeddings, um eine semantische Suche über Ihren gesamten Arbeitsbereich zu ermöglichen. Dies ist eine Enterprise-Funktion, die einen gültigen Lizenzschlüssel erfordert.
+
+## Voraussetzungen
+
+1. **PostgreSQL mit der pgvector-Erweiterung** - Erforderlich für die Speicherung von Vektor-Embeddings
+2. **AI-Anbieter-Konto** - OpenAI, Google Gemini oder selbst gehostetes Ollama
+
+## pgvector installieren
+
+### Docker-Einrichtung
+:::warning
+Da das standardmäßige PostgreSQL-Compose-Image von Docmost auf Alpine basiert und pgvector keinen Alpine-Build hat, können Sie keinen sauberen In-Place-Austausch durchführen. Stattdessen müssen Sie Ihre Daten migrieren.
+:::
+
+Sie können Ihr PostgreSQL-Image auf den von pgvector mitgelieferten PostgreSQL-Build umstellen.  
+
+Wenn Sie Docmost bereits eingerichtet haben, sollten Sie zunächst ein Backup Ihrer PostgreSQL-Datenbank erstellen und diese dann in das pgvector-PostgreSQL-Image importieren.  
+
+Siehe die pgvector-Docker-Anleitung: https://github.com/pgvector/pgvector#docker  
+
+### Manuelle Installation
+Wenn Sie eine Nicht-Docker-Installation von Postgres verwenden, können Sie die pgvector-Erweiterung manuell installieren.
+Siehe die pgvector-Installationsanleitung: https://github.com/pgvector/pgvector#installation
+
+## Unterstützte AI-Anbieter
+
+Docmost unterstützt drei AI-Anbieter: OpenAI (Azure OpenAI), Google Gemini und Ollama (lokale LLMs).
+
+### Anbieterkonfiguration
+
+Alle Anbieter benötigen diese grundlegenden Umgebungsvariablen:
+
+```bash
+AI_DRIVER=<provider>           # openai, openai-compatible, gemini, or ollama
+AI_EMBEDDING_MODEL=<model>     # Model used for generating embeddings
+AI_COMPLETION_MODEL=<model>    # Model used for answering questions 
+```
+
+**Wichtig:** `AI_EMBEDDING_DIMENSION` ist optional und wird automatisch aus den voreingestellten Modellen erkannt. Legen Sie es nur dann manuell fest, wenn Sie ein benutzerdefiniertes Modell verwenden, das nicht in der Voreinstellungsliste enthalten ist.
+Die unterstützten Werte sind `768`, `1024`, `1536`, `2000` und `3072`.
+
+`AI_EMBEDDING_SUPPORTS_MRL` ist optional und steuert, ob der Parameter `dimensions` an die API des Embedding-Modells gesendet wird. Die meisten modernen Embedding-Modelle unterstützen Matryoshka Representation Learning (MRL) und akzeptieren einen `dimensions`-Parameter zur Steuerung der Ausgabegröße. Einige Modelle geben jedoch Embeddings mit fester Größe zurück und geben einen Fehler aus, wenn `dimensions` übergeben wird.
+
+- Wenn nicht festgelegt, wird standardmäßig die Modellvoreinstellung verwendet, sofern verfügbar, andernfalls standardmäßig `true`.
+- Auf `true` setzen, um die Dimension an die Modell-API zu senden.
+- Auf `false` setzen, um das Senden zu überspringen — die Dimension wird weiterhin für den pgvector-Index verwendet.
+
+
+---
+
+## OpenAI-Konfiguration
+
+Unterstützt die OpenAI API, Azure OpenAI und jeden OpenAI-kompatiblen Anbieter.
+:::tip
+Setzen Sie `AI_DRIVER=openai`, um die offizielle OpenAI API oder Azure zu verwenden.   
+Wenn Sie einen anderen kompatiblen Anbieter verwenden, setzen Sie `AI_DRIVER=openai-compatible`.
+:::
+
+### Umgebungsvariablen
+
+```bash
+AI_DRIVER=openai #or openai-compatible
+OPENAI_API_KEY=sk-proj-xxxxx
+AI_EMBEDDING_MODEL=text-embedding-3-small
+AI_COMPLETION_MODEL=gpt-4o-mini
+```
+
+**Optional:**
+```bash
+OPENAI_API_URL=https://api.openai.com/v1  # For Azure or custom endpoints
+```
+
+### Voreingestellte OpenAI-Modelle
+
+| Modell |
+|-------|
+| `text-embedding-3-small` |
+| `text-embedding-3-large` |
+| `text-embedding-ada-002` |
+
+### Beispiel
+
+```bash
+AI_DRIVER=openai
+OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxx
+AI_EMBEDDING_MODEL=text-embedding-3-small
+AI_COMPLETION_MODEL=gpt-4o-mini
+```
+
+### OpenAI-kompatibles Beispiel
+
+Für Drittanbieter, die das OpenAI-API-Format implementieren, aber benutzerdefinierte Embedding-Modelle verwenden:
+
+```bash
+AI_DRIVER=openai-compatible
+OPENAI_API_KEY=your-api-key
+OPENAI_API_URL=https://api.your-provider.com/v1
+AI_EMBEDDING_MODEL=your-custom-embedding-model
+AI_COMPLETION_MODEL=your-completion-model
+```
+
+---
+
+## Google-Gemini-Konfiguration
+
+### Umgebungsvariablen
+
+```bash
+AI_DRIVER=gemini
+GEMINI_API_KEY=AIzaSyxxxxx
+AI_EMBEDDING_MODEL=gemini-embedding-001
+AI_COMPLETION_MODEL=gemini-2.5-flash
+```
+
+### Voreingestellte Gemini-Modelle
+
+| Modell |
+|-------|
+| `gemini-embedding-001` |
+
+---
+
+## Ollama-Konfiguration
+Die AI-Suche und Embeddings von Docmost unterstützen lokale LLMs über Ollama.  
+Ollama-Docker-Installationsanleitung: https://docs.ollama.com/docker
+
+:::tip
+Sie können je nach Bedarf und Rechenkapazität jedes von OLLAMA unterstützte Modell verwenden.
+:::
+
+### Umgebungsvariablen
+
+```bash
+AI_DRIVER=ollama
+OLLAMA_API_URL=http://localhost:11434
+AI_EMBEDDING_MODEL=nomic-embed-text
+AI_COMPLETION_MODEL=qwen2.5:7b
+```
+
+### Voreingestellte Ollama-Embedding-Modelle
+
+| Modell |
+|-------|
+| `nomic-embed-text` |
+| `qwen3-embedding` |
+
+### Ollama einrichten
+
+1. Ollama installieren: https://ollama.com/download
+2. Embedding-Modell abrufen:
+   ```bash
+   ollama pull nomic-embed-text
+   ```
+3. Completion-Modell abrufen:
+   ```bash
+   ollama pull qwen2.5:7b
+   ```
+
+### Beispiel
+
+```bash
+AI_DRIVER=ollama
+OLLAMA_API_URL=http://localhost:11434
+AI_EMBEDDING_MODEL=nomic-embed-text
+AI_COMPLETION_MODEL=qwen2.5:7b
+AI_EMBEDDING_DIMENSION=768
+```
+
+Verwenden Sie für Docker-Bereitstellungen den Ollama-Container:
+```yaml
+services:
+  ollama:
+    image: ollama/ollama:latest
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama_data:/root/.ollama
+```
+
+Setzen Sie dann `OLLAMA_API_URL=http://ollama:11434` in Ihrem Docmost-Container.
+
+---
+
+## AI-Suche im Arbeitsbereich aktivieren
+
+Nachdem Sie Ihren AI-Anbieter konfiguriert haben:
+
+1. Melden Sie sich bei Docmost als Arbeitsbereich-Administrator an
+2. Gehen Sie zu **Einstellungen** → **AI settings**
+3. Aktivieren Sie **AI-powered search (AI Answers)**
+4. Warten Sie, bis der Hintergrundjob Embeddings für vorhandene Seiten generiert hat (Sie können dies über die Logs überwachen, wenn die Umgebungsvariable _DEBUG_MODE: true_ gesetzt ist)
+
+**Hinweis:** Embeddings werden asynchron generiert. Neue Seiten erhalten Embeddings bei der Erstellung/Aktualisierung nach 10 Minuten. Vorhandene Seiten werden zur Verarbeitung in die Warteschlange gestellt, wenn die AI-Suche aktiviert wird.