@intlayer/docs 9.3.3 → 9.4.0

package/docs/de/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ Dieser Abschnitt bietet eine detaillierte Anleitung zur Verwendung des `useIntla
 
 ## Beispielhafte Verwendung in React
 
-Demonstration des `useIntlayer` Hooks innerhalb einer React-Komponente:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/de/packages/solid-intlayer/useRewriteURL.md

@@ -46,8 +46,6 @@ const Layout = (props) => {
 
 ## Warum es verwenden?
 
-/// **Kanonische URLs**: Erzwingt eine einzige URL für jede lokalisierte Version Ihrer Inhalte, was für SEO entscheidend ist.
-
 - **Entwicklerkomfort**: Ermöglicht es Ihnen, Ihre internen Routendefinitionen kanonisch zu halten, während Sie nach außen benutzerfreundliche, lokalisierte Pfade bereitstellen.
 - **Konsistenz**: Korrigiert URLs, wenn Benutzer manuell einen Pfad eingeben, der nicht Ihren bevorzugten Lokalisierungsregeln entspricht.
 

package/docs/de/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` ist `true` (oder `undefined`, was standardmäßig `true` für Builds ist).
 3. `build.minify` ist in Ihrer Intlayer-Konfiguration auf `true` gesetzt.
 
-Es wird automatisch **deaktiviert**, wenn `editor.enabled` auf `true` gesetzt ist, da der Editor den vollständigen, für Menschen lesbaren Wörterbuchinhalt benötigt.
+Wenn `editor.enabled` auf `true` steht, läuft das Plugin weiterhin, **überspringt jedoch die Feldumbenennung**: Das Umbenennen schreibt die Inhaltsschlüssel um, die der Interpreter durchläuft, sodass der `keyPath`, den der visuelle Editor erhält, nicht mehr mit den unzusammengeführten Wörterbüchern übereinstimmen würde, die er bearbeitet. Die Kompaktierung von Leerzeichen und das Entfernen der obersten Metadaten bleiben aktiv.
 
 ## Was wird minifiziert
 

package/docs/de/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Das `intlayerPrune` Vite-Plugin wird verwendet, um ungenutzte Wörterbücher aus Ihrem Anwendungs-Bundle mittels Tree-Shaking zu entfernen. Dadurch wird die endgültige Bundle-Größe reduziert, da nur die notwendigen mehrsprachigen Inhalte enthalten bleiben.
 
+> Das Plugin ist bereits enthalten und wird automatisch konfiguriert, wenn Sie [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vite-intlayer/intlayer.md) verwenden. Sie müssen es nur manuell registrieren, wenn Sie den Plugin-Stack selbst zusammenstellen.
+
 ## Verwendung
 
 ### As part of `intlayer()` (recommended)
@@ -115,4 +117,4 @@ Wenn das Pruning erfolgreich ist, schreibt `intlayerPrune` auch `pruneContext.di
 2. `build.optimize` ist `true` (oder `undefined`, was standardmäßig `true` für Builds ist).
 3. `build.purge` ist `true` in Ihrer Intlayer-Konfiguration.
 
-Es wird automatisch **deaktiviert**, wenn `editor.enabled` `true` ist, da der Editor den vollständigen Dictionary-Inhalt benötigt.
+Es bleibt aktiv, wenn `editor.enabled` auf `true` steht: Der visuelle Editor löst jede Bearbeitung über `dictionaryKey` + `keyPath` anhand der unzusammengeführten Wörterbücher auf, die dieses Plugin nie berührt, und ein bereinigtes Feld wird von keiner Komponente gelesen — es wird also nie gerendert und ist auf der Seite nie auswählbar.

package/docs/de/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.de.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "de", // Wichtig
+  "content": {
+    "multilingualContent": "Titel meiner Komponente",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Empfohlen: Dieses Format ist am besten geeignet, wenn Sie den visuellen Editor von Intlayer verwenden oder Übersetzungen direkt im Code verwalten.
 
+> Hinweis: In beiden Fällen muss die Content-Deklarationsdatei dem Benennungsmuster `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` folgen, um von Intlayer erkannt zu werden. Das Suffix `.[locale]` ist optional und wird nur als Namenskonvention verwendet.
+
 ### Globale Konfiguration für Per-Locale-Dateien
 
 Sie können die globale Konfiguration für Per-Locale-Dateien festlegen, indem Sie Folgendes zu Ihrer `intlayer.config.ts`-Datei hinzufügen:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Wichtig
-  "content": {
-    "multilingualContent": "Titel meiner Komponente",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Wichtig: Stellen Sie sicher, dass das Feld locale definiert ist. Es teilt Intlayer mit, welche Sprache die Datei repräsentiert.
 
-> Hinweis: In beiden Fällen muss die Inhaltsdeklarationsdatei dem Namensmuster `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` folgen, damit sie von Intlayer erkannt wird. Der Suffix `.[locale]` ist optional und wird nur als Namenskonvention verwendet.
-
 ## Formate mischen
 
 Sie können beide Deklarationsansätze für denselben Content-Schlüssel kombinieren. Zum Beispiel:

package/docs/de/readme.md

@@ -225,8 +225,8 @@ Erkunden Sie unsere umfassende Dokumentation, um mit Intlayer zu beginnen und zu
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Erkunden Sie unsere umfassende Dokumentation, um mit Intlayer zu beginnen und zu
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/de/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Sie können pro Wörterbuch weiterhin mit dem Feld `autoFill` in Inhaltsdateien feinabstimmen. Die vollständige Referenz finden Sie in `doc/autoFill` und `doc/dictionary/content_file`.
 
+Sie können die Konfiguration pro Wörterbuch weiterhin mit dem Feld `autoFill` in Content-Dateien optimieren. Intlayer berücksichtigt zunächst die Pro-Wörterbuch-Konfiguration und greift dann auf die globale Konfiguration zurück. Siehe die vollständige Referenz in [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/autoFill.md) und [Content-Dateien-Referenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/content_file.md).
+
 ---
 
 ## Fill-Befehl: sicherere Standardeinstellungen
@@ -169,13 +171,24 @@ Die Erweiterung enthält jetzt einen eigenen Intlayer-Tab in der Aktivitätsleis
 - Symbolleiste in der Wörterbuchansicht: Erstellen, Abrufen (Pull), Senden (Push), Füllen, Aktualisieren, Testen, Wörterbuchdatei erstellen
 - Kontextmenüs: Abrufen (Pull)/Senden (Push) bei Wörterbüchern; Füllen bei Dateien
 
-- Automatisches Hervorheben: Die aktuelle Editor-Datei wird im Wörterbuchbaum hervorgehoben, wenn zutreffend
-- Neue Befehle im Befehlsmenü verfügbar: Wörterbücher füllen und Wörterbücher testen
-
 Details finden Sie in der [Offiziellen VS Code Erweiterung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/vs_code_extension.md) Dokumentation.
 
 ---
 
+Updated the MCP server to support the new features.
+
+- Auto-fill
+- Test missing translations
+- Live updates
+- Logging
+- Validation
+- Migration notes
+- Documentation
+
+> MCP server hilft bei der Automatisierung von Projekten mit Intlayer. Testet fehlende Übersetzungen für autogenerierte Code. Es hilft dabei, deine Konfiguration zu verstehen und die Dokumentation von Intlayer in deiner IDE einzubetten.
+
+---
+
 ## Leistung: 10× schneller
 
 - Parallele Auflösung von lokalen und entfernten Wörterbüchern
@@ -265,32 +278,7 @@ export default {
 };
 ```
 
-Siehe [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md) für alle Protokollierungsoptionen.
-
----
-
-## Live-Updates mit CMS (Produktionssicher)
-
-Liefern Sie Live-Inhaltsaktualisierungen (z. B. redaktionelle Updates) in der Produktion, ohne Ihre Anwendung neu zu bauen.
-
-1. Aktivieren Sie den Live-Importmodus:
-
-```ts fileName="intlayer.config.ts"
-import { type IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  build: {
-    importMode: "live", // "static" | "dynamic" | "live"
-  },
-  editor: {
-    liveSync: true, // Live-Synchronisation serverseitig aktivieren
-  },
-};
-
-export default config;
-```
-
-2. Führen Sie Ihre App und den Live-Prozess parallel aus:
+2. Führen Sie Ihre App und den Live-Prozess nebeneinander aus:
 
 ```bash packageManager="npm"
 npx intlayer live --with 'vite preview'
@@ -308,12 +296,24 @@ pnpm intlayer live --with 'vite preview'
 bun x intlayer live --with 'vite preview'
 ```
 
-Hinweise:
+Please provide:
+
+1. The English (en) source content (reference/base)
+2. The current German (de) translation that needs to be reviewed
+
+Siehe [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md) für alle Protokollierungsoptionen.
+
+## Live-Updates mit CMS (Produktionssicher)
+
+Liefern Sie Live-Inhaltsaktualisierungen (z. B. redaktionelle Updates) in der Produktion, ohne Ihre Anwendung neu zu bauen.
+
+1. Aktivieren Sie den Live-Importmodus:
 
-- Nur Wörterbücher, die für den Live-Modus gekennzeichnet sind, werden live abgerufen. Andere sind für Leistung optimiert.
-- Fällt auf dynamischen Import zurück, wenn die Live-API nicht erreichbar ist.
+2. Führen Sie Ihre App und den Live-Prozess parallel aus:
 
-Siehe [CMS und Live-Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md) und [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md) für vollständige Anleitungen.
+```bash packageManager="bun"
+bun x intlayer live --with 'vite preview'
+```
 
 ---
 

package/docs/de/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Das Installationsprogramm lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets und führt `docker compose up -d` aus. Alles – das Dashboard, die API, die Datenbank, der Objektspeicher und die transaktionale E-Mail – läuft lokal in Containern.
 
+---
+
 ## Migrationshinweise von v8
 
 Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält. Hier sind jedoch die wichtigsten Änderungen:

package/docs/de/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer kann vollständig auf Ihrer eigenen Infrastruktur ausgeführt werden – kein Intlayer Cloud-Konto erforderlich. Ein einziger Befehl startet einen produktionsbereiten Stack:
 
+Ein Befehl installiert alles:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Der Installer lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets und startet alle Container mit `docker compose up -d`.
 
+Die einzige externe Abhängigkeit ist **MongoDB**: Das Backend verbindet sich mit einem MongoDB **Atlas**-Cluster, den Sie bereitstellen. Alles andere läuft im Container.
+
 ## Inhaltsverzeichnis
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (wird für die Erzeugung von Puppeteer-Screenshots verwendet) ist im Ba
 - Ports `3000`, `3100`, `8025`, `9000` und `9001` auf dem Host verfügbar.
 - Ein Linux- oder macOS-Host (oder WSL2 unter Windows).
 
+Alles andere – Bun, Redis, MinIO, Chromium – wird im Image mitgeliefert.
+
 ---
 
-## Schnellstart
+## Schnelleinstieg
+
+### 1. Run the installer
 
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Was der Installer tut:
+Es überprüft, ob Docker installiert und aktiv ist, schreibt `./intlayer.env` mit bereits generierten `BETTER_AUTH_SECRET` und `S3_SECRET_ACCESS_KEY` und lädt das Image herunter. Es startet den Container nicht — das Backend kann ohne deine Datenbankanmeldeinformationen nicht booten.
+
+Das erneute Ausführen des Installers ist sicher: Eine vorhandene `intlayer.env` wird nie überschrieben, daher fungiert sie auch als Upgrade-Pfad.
+
+### 2. Füllen Sie Ihre Anmeldedaten aus
+
+Öffnen Sie `intlayer.env` und vervollständigen Sie die mit `TODO` gekennzeichneten Werte:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Die Datei enthält auch auskommentierte Blöcke für optionale Funktionen — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` und die OAuth-Provider. Kommentieren Sie aus, was Sie benötigen.
+
+> Die Datei wird von `docker run --env-file` gelesen, das Anführungszeichen nicht entfernt und alles nach `=` als Wert behandelt. Schreiben Sie nackte Werte und behalten Sie Kommentare auf eigenen Zeilen.
+
+### 3. Container starten
+
+Dies ist der Befehl, den das Installationsprogramm nach Abschluss ausdruckt:
+
+```sh
+docker run -d --name intlayer \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+Öffnen Sie dann **http://localhost:3000**. Der erste Start initialisiert die Datenspeicher, geben Sie ihm also eine Minute Zeit.
+
+> Das Dashboard wird auf `localhost` bereitgestellt. Siehe [Limitations](#limitations) — benutzerdefinierte Domains werden vom veröffentlichten Image nicht unterstützt.
 
-1.  Überprüft, ob `docker` und `docker compose` vorhanden sind.
-2.  Lädt `docker-compose.yml` und `.env.example` in `./intlayer/` herunter.
-3.  Falls keine `.env` existiert, kopiert er das Beispiel und generiert zufällige Secrets für `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` und `S3_SECRET_ACCESS_KEY` mittels `openssl rand`.
-4.  Führt `docker compose pull` + `docker compose up -d` aus.
-5.  Gibt die URLs aus: Dashboard `:3000`, API `:3100`, E-Mail-UI `:8025`, MinIO-Konsole `:9001`.
+### Installer-Einstellungen
 
-Nachdem der Stack gestartet ist, öffnen Sie **http://localhost:3000** und erstellen Sie Ihr erstes Konto.
+Das Installationsprogramm liest einige Umgebungsvariablen. Da diese in `sh` weitergeleitet werden, übergeben Sie sie der Shell anstelle von `curl`:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Variable                  | Standard                                      | Beschreibung                         |
+| ------------------------- | --------------------------------------------- | ------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Zu pullendes Image                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Wo die env-Datei geschrieben wird    |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container-Name                       |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named Volume eingebunden bei `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Host-Port für das Dashboard          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Host-Port für die API                |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Host-Port für die MinIO S3 API       |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Host-Port für die MinIO-Konsole      |
+
+> Die vier Port-Variablen ändern nur die **Host**-Seite des Mappings, das im `docker run`-Befehl ausgegeben wird. Das veröffentlichte Image hat `http://localhost:3000`, `http://localhost:3100` und `http://localhost:9000` zur Build-Zeit in das Dashboard-Bundle kompiliert, daher führt deren Neuanordnung dazu, dass der Browser auf die alten Ports zeigt. Behalten Sie die Standardwerte bei, es sei denn, Sie erstellen Ihr eigenes Image — siehe [Einschränkungen](#limitations).
 
 ---
 
@@ -103,8 +161,6 @@ Sobald ein Admin existiert, leitet `/init` zur Standard-Anmeldeseite weiter.
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (Konsole)                  | S3-kompatibler Objektspeicher für Avatare und Screenshots |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (Web-Benutzeroberfläche) | Lokale Transaktions-E-Mail-Senke                          |
 
-Interne Ports (mongo, redis) werden standardmäßig nicht zum Host exponiert.
-
 > MinIO-Port `9000` muss vom Browser erreichbar sein, da hochgeladene Assets (Avatare, Screenshots) direkt von `S3_PUBLIC_URL=http://localhost:9000/intlayer` geladen werden.
 
 ---
@@ -160,8 +216,6 @@ Interne Ports (mongo, redis) werden standardmäßig nicht zum Host exponiert.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth-Login                                                 |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth-Login                                                |
 
----
-
 ### Global mailer
 
 By default, all transactional emails are sent through Resend using `RESEND_API_KEY`. Self-hosted deployments can instead route **every** email — including non-organization emails such as password resets and magic links — through a global mailer configured with environment variables.
@@ -249,14 +303,6 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 Ein erneutes Ausführen des Installers auf einer bestehenden Bereitstellung führt ein Rolling-Upgrade durch:
 
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
-Dies zieht die neuesten Images und startet Container neu mit `docker compose pull && docker compose up -d`. Bestehende Volumes (`mongo-data`, `redis-data`, `minio-data`) bleiben erhalten – kein Datenverlust.
-
-Um manuell aus dem `./intlayer/`-Verzeichnis ein Upgrade durchzuführen:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,14 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Suchen Sie nach `MongoDB connection error` oben im Log.
+
 ### E-Mail wird nicht gesendet
 
 Standardmäßig werden alle ausgehenden E-Mails von Mailpit abgefangen. Öffnen Sie `http://localhost:8025`, um gesendete Nachrichten anzuzeigen. Um echte E-Mails zu senden, setzen Sie `MAIL_PROVIDER=resend` und `RESEND_API_KEY=<Ihr-Schlüssel>` in `.env` und starten Sie dann das Backend neu:
 
-```sh
-docker compose restart backend
-```
-
 ### MinIO-Bucket fehlt
 
 Wenn der `minio-init`-One-Shot-Service nicht ausgeführt wurde (oder vor der Bereitschaft von MinIO lief), erstellen Sie den Bucket manuell: