@intlayer/docs 8.4.8 → 8.4.9

package/docs/cs/introduction.md

@@ -0,0 +1,216 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Úvod
+description: Zjistěte, jak Intlayer funguje. Podívejte se na kroky používané Intlayer ve vaší aplikaci. Podívejte se, co dělají různé balíčky.
+keywords:
+  - Úvod
+  - Začínáme
+  - Intlayer
+  - Aplikace
+  - Balíčky
+slugs:
+  - doc
+  - get-started
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: "Iniciace historie"
+---
+
+# Dokumentace Intlayer
+
+Vítejte v oficiální dokumentaci Intlayer! Zde najdete vše, co potřebujete k integraci, konfiguraci a ovládnutí Intlayer pro všechny vaše potřeby internacionalizace (i18n), ať už pracujete s Next.js, React, Vite, Express nebo jiným prostředím JavaScriptu.
+
+## Úvod
+
+### Co je Intlayer?
+
+**Intlayer** je knihovna pro internacionalizaci navržená speciálně pro JavaScriptové vývojáře. Umožňuje deklaraci vašeho obsahu kdekoli ve vašem kódu. Převádí deklaraci vícejazyčného obsahu do strukturovaných slovníků, které lze snadno integrovat do vašeho kódu. S využitím TypeScriptu dělá **Intlayer** váš vývoj silnějším a efektivnějším.
+
+Intlayer také poskytuje volitelný vizuální editor, který vám umožní snadno upravovat a spravovat váš obsah. Tento editor je užitečný zejména pro vývojáře, kteří preferují vizuální rozhraní pro správu obsahu, nebo pro týmy generující obsah, aniž by se musely starat o kód.
+
+### Příklad použití
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Hlavní funkce
+
+Intlayer nabízí řadu funkcí přizpůsobených potřebám moderního webového vývoje. Níže jsou uvedeny klíčové funkce s odkazy na podrobnou dokumentaci pro každou z nich:
+
+- **Podpora internacionalizace**: Zvyšte globální dosah své aplikace s vestavěnou podporou internacionalizace.
+- **Vizuální editor**: Vylepšete svůj vývojový proces pomocí pluginů editoru navržených pro Intlayer. Podívejte se na [Průvodce vizuálním editorem](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_visual_editor.md).
+- **Flexibilita konfigurace**: Přizpůsobte si nastavení pomocí rozsáhlých možností konfigurace popsaných v [Průvodci konfigurací](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/configuration.md).
+- **Pokročilé CLI nástroje**: Spravujte své projekty efektivně pomocí příkazového řádku Intlayeru. Prozkoumejte možnosti v [Dokumentaci pro CLI nástroje](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/cli/index.md).
+
+## Základní pojmy
+
+### Slovník (Dictionary)
+
+Organizujte svůj vícejazyčný obsah v blízkosti svého kódu, aby bylo vše konzistentní a udržovatelné.
+
+- **[Začínáme](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/content_file.md)**  
+  Naučte se základy deklarace obsahu v Intlayeru.
+
+- **[Překlad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/translation.md)**  
+  Pochopte, jak jsou překlady generovány, ukládány a používány ve vaší aplikaci.
+
+- **[Výčet (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/enumeration.md)**  
+  Snadno spravujte opakované nebo pevné sady dat napříč různými jazyky.
+
+- **[Podmínka (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/condition.md)**  
+  Naučte se používat podmíněnou logiku v Intlayeru k vytváření dynamického obsahu.
+
+- **[Vkládání (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/insertion.md)**
+  Zjistěte, jak vkládat hodnoty do řetězce pomocí zástupných symbolů pro vkládání.
+
+- **[Získávání funkcí (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/function_fetching.md)**  
+  Podívejte se, jak dynamicky získávat obsah pomocí vlastní logiky tak, aby odpovídal pracovnímu postupu vašeho projektu.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/markdown.md)**  
+  Naučte se používat Markdown v Intlayeru k vytváření bohatého obsahu.
+
+- **[Vkládání souborů (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/file.md)**  
+  Zjistěte, jak vkládat externí soubory do Intlayeru a používat je v editoru obsahu.
+
+- **[Vnořování (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/nesting.md)**  
+  Pochopte, jak vnořovat obsah v Intlayeru a vytvářet složité struktury.
+
+### Prostředí a integrace
+
+Intlayer jsme vytvořili s ohledem na flexibilitu a nabízíme bezproblémovou integraci napříč populárními frameworky a nástroji pro sestavení:
+
+- **[Intlayer s Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nextjs_16.md)**
+- **[Intlayer s Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nextjs_15.md)**
+- **[Intlayer s Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nextjs_14.md)**
+- **[Intlayer s Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer s React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_create_react_app.md)**
+- **[Intlayer s Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_vite+react.md)**
+- **[Intlayer s React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_react_router_v7.md)**
+- **[Intlayer s Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_tanstack.md)**
+- **[Intlayer s React Native a Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_react_native+expo.md)**
+- **[Intlayer s Lynx a React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_lynx+react.md)**
+- **[Intlayer s Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_vite+preact.md)**
+- **[Intlayer s Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_vite+vue.md)**
+- **[Intlayer s Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nuxt.md)**
+- **[Intlayer s Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_vite+svelte.md)**
+- **[Intlayer se SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_svelte_kit.md)**
+- **[Intlayer s Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_express.md)**
+- **[Intlayer s NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_nestjs.md)**
+- **[Intlayer s Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_hono.md)**
+- **[Intlayer s Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_angular.md)**
+
+Každý průvodce integrací obsahuje osvědčené postupy pro používání funkcí Intlayer, jako je **server-side rendering**, **dynamické směrování** nebo **client-side rendering**, abyste mohli udržovat rychlou aplikaci vhodnou pro SEO a s vysokou škálovatelností.
+
+## Přispívání a zpětná vazba
+
+Vážíme si síly open-source a vývoje řízeného komunitou. Pokud byste chtěli navrhnout vylepšení, přidat nového průvodce nebo opravit jakékoli problémy v našich dokumentech, neváhejte odeslat Pull Request nebo otevřít problém v našem [GitHub repozitáři](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Jste připraveni překládat svou aplikaci rychleji a efektivněji?** Ponořte se do našich dokumentů a začněte používat Intlayer ještě dnes. Zažijte robustní, efektivní přístup k internacionalizaci, který udržuje váš obsah uspořádaný a váš tým produktivnější.

package/docs/de/CI_CD.md

@@ -18,7 +18,7 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: Historie initialisieren
+    changes: "Historie initialisieren"
 ---
 
 # Automatische Generierung von Übersetzungen in einer CI/CD-Pipeline

package/docs/de/agent_skills.md

@@ -15,7 +15,7 @@ slugs:
 history:
   - version: 8.1.0
     date: 2026-02-09
-    changes: Init history
+    changes: "Init history"
 ---
 
 # Agent Skills

package/docs/de/autoFill.md

@@ -18,13 +18,13 @@ slugs:
 history:
   - version: 6.0.0
     date: 2025-09-20
-    changes: Globale Konfiguration hinzugefügt
+    changes: "Globale Konfiguration hinzugefügt"
   - version: 6.0.0
     date: 2025-09-17
-    changes: Variable `{{fileName}}` hinzugefügt
+    changes: "Variable `{{fileName}}` hinzugefügt"
   - version: 5.5.10
     date: 2025-06-29
-    changes: Historie initialisiert
+    changes: "Historie initialisiert"
 ---
 
 # Übersetzungen der Deklarationsdatei für automatisches Ausfüllen von Inhalten

package/docs/de/bundle_optimization.md

@@ -18,7 +18,7 @@ slugs:
 history:
   - version: 6.0.0
     date: 2025-11-25
-    changes: Initiale Historie
+    changes: "Initiale Historie"
 ---
 
 # Optimierung der i18n-Bündelgröße & Leistung

package/docs/de/cli/build.md

@@ -16,7 +16,7 @@ slugs:
 history:
   - version: 8.1.5
     date: 2026-02-23
-    changes: checkTypes-Option hinzugefügt
+    changes: "checkTypes-Option hinzugefügt"
 ---
 
 # Wörterbücher erstellen

package/docs/de/cli/ci.md

@@ -19,7 +19,7 @@ slugs:
 history:
   - version: 7.5.11
     date: 2026-01-06
-    changes: CI-Befehl hinzufügen
+    changes: "CI-Befehl hinzufügen"
 ---
 
 # CI-Befehl

package/docs/de/cli/index.md

@@ -19,43 +19,43 @@ slugs:
 history:
   - version: 7.5.11
     date: 2026-01-06
-    changes: Projekte-Listen-Befehl hinzugefügt
+    changes: "Projekte-Listen-Befehl hinzugefügt"
   - version: 7.5.9
     date: 2025-12-30
-    changes: Init-Befehl hinzugefügt
+    changes: "Init-Befehl hinzugefügt"
   - version: 7.2.3
     date: 2025-11-22
-    changes: Transform-Befehl hinzugefügt
+    changes: "Transform-Befehl hinzugefügt"
   - version: 7.1.0
     date: 2025-11-05
-    changes: Option skipIfExists zum translate-Befehl hinzugefügt
+    changes: "Option skipIfExists zum translate-Befehl hinzugefügt"
   - version: 6.1.4
     date: 2025-01-27
-    changes: Aliase für CLI-Argumente und Befehle hinzugefügt
+    changes: "Aliase für CLI-Argumente und Befehle hinzugefügt"
   - version: 6.1.3
     date: 2025-10-05
-    changes: Build-Option zu Befehlen hinzugefügt
+    changes: "Build-Option zu Befehlen hinzugefügt"
   - version: 6.1.2
     date: 2025-09-26
-    changes: Versionsbefehl hinzugefügt
+    changes: "Versionsbefehl hinzugefügt"
   - version: 6.1.0
     date: 2025-09-26
-    changes: Setze verbose-Option standardmäßig auf true über CLI
+    changes: "Setze verbose-Option standardmäßig auf true über CLI"
   - version: 6.1.0
     date: 2025-09-23
-    changes: Watch-Befehl und with-Option hinzugefügt
+    changes: "Watch-Befehl und with-Option hinzugefügt"
   - version: 6.0.1
     date: 2025-09-23
-    changes: Editor-Befehl hinzugefügt
+    changes: "Editor-Befehl hinzugefügt"
   - version: 6.0.0
     date: 2025-09-17
-    changes: Content-Test- und Listen-Befehl hinzugefügt
+    changes: "Content-Test- und Listen-Befehl hinzugefügt"
   - version: 5.5.11
     date: 2025-07-11
-    changes: Dokumentation der CLI-Befehlsparameter aktualisiert
+    changes: "Dokumentation der CLI-Befehlsparameter aktualisiert"
   - version: 5.5.10
     date: 2025-06-29
-    changes: Historie initialisiert
+    changes: "Historie initialisiert"
 ---
 
 # Intlayer CLI

package/docs/de/cli/init.md

@@ -16,7 +16,7 @@ slugs:
 history:
   - version: 7.5.9
     date: 2025-12-30
-    changes: Init-Befehl hinzugefügt
+    changes: "Init-Befehl hinzugefügt"
 ---
 
 # Intlayer initialisieren

package/docs/de/cli/list.md

@@ -16,10 +16,10 @@ slugs:
 history:
   - version: 7.5.12
     date: 2026-01-06
-    changes: Absolute Ausgabeoption zum Listen-Befehl hinzugefügt
+    changes: "Absolute Ausgabeoption zum Listen-Befehl hinzugefügt"
   - version: 7.5.11
     date: 2026-01-06
-    changes: JSON-Ausgabeoption zum Listen-Befehl hinzugefügt
+    changes: "JSON-Ausgabeoption zum Listen-Befehl hinzugefügt"
 ---
 
 # Inhaltsdeklarationsdateien auflisten

package/docs/de/cli/list_projects.md

@@ -17,7 +17,7 @@ slugs:
 history:
   - version: 7.5.12
     date: 2026-01-06
-    changes: Absolute Ausgabeoption zum Befehl list projects hinzufügen
+    changes: "Absolute Ausgabeoption zum Befehl list projects hinzufügen"
 ---
 
 # Intlayer-Projekte auflisten

package/docs/de/compiler.md

@@ -22,13 +22,13 @@ slugs:
 history:
   - version: 8.2.0
     date: 2026-03-10
-    changes: Update compiler options, add FilePathPattern support
+    changes: "Update compiler options, add FilePathPattern support"
   - version: 8.1.7
     date: 2026-02-25
-    changes: Compiler-Optionen aktualisieren
+    changes: "Compiler-Optionen aktualisieren"
   - version: 7.3.1
     date: 2025-11-27
-    changes: Release Compiler
+    changes: "Release Compiler"
 ---
 
 # Intlayer Compiler | Automatisierte Inhaltsextraktion für i18n