@intlayer/docs 5.5.11 → 5.6.0

package/frequent_questions/en-GB/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Build Error in CI/CD
+description: Learn how to fix build errors that occur in CI/CD environments.
+keywords:
+  - build
+  - error
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dictionaries
+  - next.js
+  - prebuild
+  - automation
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# Error on build on CI/CD
+
+If you get an error like this on Next.js:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+Here are some solutions:
+
+## 1. Missing dictionaries
+
+Ensure that the dictionaries are built at the stage of the build.
+
+It's frequent that the build works locally but not on CI/CD. The reason is that locally, the `.intlayer` directory is present, but on CI/CD, it is not as it is excluded from the build.
+
+You can fix this by adding a prebuild script in the `package.json` of your project.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // Will run before the build
+    "build": "next build",
+  },
+}
+```
+
+> Note that if you use the `withIntlayer` function, or the equivalent bundler plugin for your framework, the prebuild script will be run before the build.
+
+## 2. Missing environment variables at build / run time
+
+In a container, or auto-deployed platform, it is recommended to exclude the `.env` file from the build.
+
+```text fileName=".gitignore or .dockerignore"
+# Environment variables
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+If your environment variables are not available at build time, an error will be thrown.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+It is probably not related to Intlayer. Therefore, check your environment variables at build time on your CI/CD platform.

package/frequent_questions/es/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Error de compilación en CI/CD
+description: Aprende cómo solucionar errores de compilación que ocurren en entornos CI/CD.
+keywords:
+  - compilación
+  - error
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - diccionarios
+  - next.js
+  - prebuild
+  - automatización
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# Error en la compilación en CI/CD
+
+Si obtienes un error como este en Next.js:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+Aquí algunas soluciones:
+
+## 1. Diccionarios faltantes
+
+Asegúrate de que los diccionarios se construyan en la etapa de compilación.
+
+Es frecuente que la compilación funcione localmente pero no en CI/CD. La razón es que localmente, el directorio `.intlayer` está presente, pero en CI/CD no, ya que está excluido de la compilación.
+
+Puedes solucionarlo agregando un script de precompilación en el `package.json` de tu proyecto.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // Se ejecutará antes de la compilación
+    "build": "next build",
+  },
+}
+```
+
+> Ten en cuenta que si usas la función `withIntlayer`, o el plugin equivalente para el empaquetador de tu framework, el script de precompilación se ejecutará antes de la compilación.
+
+## 2. Variables de entorno faltantes en tiempo de compilación / ejecución
+
+En un contenedor, o plataforma de despliegue automático, se recomienda excluir el archivo `.env` de la compilación.
+
+```text fileName=".gitignore or .dockerignore"
+# Variables de entorno
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+Si tus variables de entorno no están disponibles en tiempo de compilación, se generará un error.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+Probablemente no esté relacionado con Intlayer. Así que verifica tus variables de entorno en tiempo de compilación en tu plataforma CI/CD.

package/frequent_questions/fr/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Erreur de build en CI/CD
+description: Apprenez comment corriger les erreurs de build qui surviennent dans les environnements CI/CD.
+keywords:
+  - build
+  - erreur
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dictionnaires
+  - next.js
+  - prébuild
+  - automatisation
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# Erreur lors du build en CI/CD
+
+Si vous obtenez une erreur comme celle-ci sur Next.js :
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+Voici quelques solutions :
+
+## 1. Dictionnaires manquants
+
+Assurez-vous que les dictionnaires sont construits lors de l'étape de build.
+
+Il est fréquent que le build fonctionne localement mais pas en CI/CD. La raison est qu'en local, le répertoire `.intlayer` est présent, mais en CI/CD, il ne l'est pas car il est exclu du build.
+
+Vous pouvez corriger cela en ajoutant un script de prébuild dans le `package.json` de votre projet.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // S'exécutera avant le build
+    "build": "next build",
+  },
+}
+```
+
+> Notez que si vous utilisez la fonction `withIntlayer`, ou le plugin bundler équivalent pour votre framework, le script de prébuild sera exécuté avant le build.
+
+## 2. Variables d'environnement manquantes au moment du build / de l'exécution
+
+Dans un conteneur, ou une plateforme à déploiement automatique, il est recommandé d'exclure le fichier `.env` du build.
+
+```text fileName=".gitignore or .dockerignore"
+# Variables d'environnement
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+Si vos variables d'environnement ne sont pas disponibles au moment du build, une erreur sera levée.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+Cela n'est probablement pas lié à Intlayer. Vérifiez donc vos variables d'environnement au moment du build sur votre plateforme CI/CD.

package/frequent_questions/hi/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CD में बिल्ड त्रुटि
+description: जानें कि CI/CD वातावरण में होने वाली बिल्ड त्रुटियों को कैसे ठीक करें।
+keywords:
+  - build
+  - error
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dictionaries
+  - next.js
+  - prebuild
+  - automation
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# CI/CD में बिल्ड पर त्रुटि
+
+यदि आपको Next.js में इस प्रकार की त्रुटि मिलती है:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+यहाँ कुछ समाधान दिए गए हैं:
+
+## 1. डिक्शनरी गायब हैं
+
+सुनिश्चित करें कि डिक्शनरी बिल्ड के चरण में बनाई गई हैं।
+
+यह सामान्य है कि बिल्ड स्थानीय रूप से काम करता है लेकिन CI/CD पर नहीं। इसका कारण यह है कि स्थानीय रूप से, `.intlayer` निर्देशिका मौजूद होती है, लेकिन CI/CD पर यह बिल्ड से बाहर रखी जाती है।
+
+आप इसे अपने प्रोजेक्ट के `package.json` में एक प्रीबिल्ड स्क्रिप्ट जोड़कर ठीक कर सकते हैं।
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // बिल्ड से पहले चलेगा
+    "build": "next build",
+  },
+}
+```
+
+> ध्यान दें कि यदि आप `withIntlayer` फ़ंक्शन का उपयोग करते हैं, या अपने फ्रेमवर्क के लिए समकक्ष बंडलर प्लगइन, तो प्रीबिल्ड स्क्रिप्ट बिल्ड से पहले चलेगा।
+
+## 2. बिल्ड / रन टाइम पर पर्यावरण चर गायब हैं
+
+कंटेनर या ऑटो-डिप्लॉयड प्लेटफ़ॉर्म में, यह अनुशंसित है कि `.env` फ़ाइल को बिल्ड से बाहर रखा जाए।
+
+```text fileName=".gitignore or .dockerignore"
+# पर्यावरण चर
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+यदि आपके पर्यावरण चर बिल्ड समय पर उपलब्ध नहीं हैं, तो एक त्रुटि उत्पन्न होगी।
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+यह संभवतः Intlayer से संबंधित नहीं है। इसलिए अपने CI/CD प्लेटफ़ॉर्म पर बिल्ड समय पर अपने पर्यावरण चर की जांच करें।

package/frequent_questions/it/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Errore di build in CI/CD
+description: Scopri come risolvere gli errori di build che si verificano negli ambienti CI/CD.
+keywords:
+  - build
+  - errore
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dizionari
+  - next.js
+  - prebuild
+  - automazione
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# Errore di build in CI/CD
+
+Se ricevi un errore come questo su Next.js:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+Ecco alcune soluzioni:
+
+## 1. Dizionari mancanti
+
+Assicurati che i dizionari siano costruiti nella fase di build.
+
+È frequente che la build funzioni localmente ma non su CI/CD. Il motivo è che localmente la directory `.intlayer` è presente, mentre su CI/CD non lo è perché è esclusa dalla build.
+
+Puoi risolvere aggiungendo uno script di prebuild nel `package.json` del tuo progetto.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // Verrà eseguito prima della build
+    "build": "next build",
+  },
+}
+```
+
+> Nota che se usi la funzione `withIntlayer`, o il plugin bundler equivalente per il tuo framework, lo script di prebuild verrà eseguito prima della build.
+
+## 2. Variabili d'ambiente mancanti al momento della build o dell'esecuzione
+
+In un container, o su una piattaforma con deploy automatico, è consigliato escludere il file `.env` dalla build.
+
+```text fileName=".gitignore or .dockerignore"
+# Variabili d'ambiente
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+Se le tue variabili d'ambiente non sono disponibili al momento della build, verrà generato un errore.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+Probabilmente non è correlato a Intlayer. Quindi verifica le tue variabili d'ambiente al momento della build sulla tua piattaforma CI/CD.

package/frequent_questions/ja/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CDでのビルドエラー
+description: CI/CD環境で発生するビルドエラーの修正方法を学びます。
+keywords:
+  - ビルド
+  - エラー
+  - ci
+  - cd
+  - パイプライン
+  - intlayer
+  - 辞書
+  - next.js
+  - プレビルド
+  - 自動化
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# CI/CDでのビルドエラー
+
+Next.jsで以下のようなエラーが発生した場合：
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+いくつかの解決策を紹介します：
+
+## 1. 辞書が不足している
+
+ビルドの段階で辞書がビルドされていることを確認してください。
+
+ローカルではビルドが成功するのに、CI/CDでは失敗することがよくあります。その理由は、ローカル環境では `.intlayer` ディレクトリが存在しますが、CI/CDではビルドから除外されているためです。
+
+これを修正するには、プロジェクトの `package.json` にプリビルドスクリプトを追加してください。
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // ビルドの前に実行されます
+    "build": "next build",
+  },
+}
+```
+
+> `withIntlayer` 関数や、フレームワーク用の同等のバンドラープラグインを使用している場合は、プリビルドスクリプトがビルド前に自動的に実行されます。
+
+## 2. ビルド時／実行時の環境変数が不足している
+
+コンテナや自動デプロイプラットフォームでは、`.env` ファイルをビルドから除外することが推奨されます。
+
+```text fileName=".gitignore or .dockerignore"
+# 環境変数
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+ビルド時に環境変数が利用できない場合、エラーが発生します。
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+これはおそらく Intlayer に関連する問題ではありません。CI/CD プラットフォーム上のビルド時に環境変数を確認してください。

package/frequent_questions/ja/intlayer_command_undefined.md

@@ -144,7 +144,7 @@ npm --version
 11. **権限の問題を確認する**  
     権限エラーが発生している場合は、以下を試してください：
 
-````bash
+```bash
 # Unix系システムの場合
 sudo npm install -g intlayer
 
@@ -152,5 +152,5 @@ sudo npm install -g intlayer
 mkdir ~/.npm-global
 npm config set prefix '~/.npm-global'
 # ~/.profile または ~/.bashrc に以下を追加：
-export PATH=~/.npm-global/bin:$PATH```
-````
+export PATH=~/.npm-global/bin:$PATH
+```

package/frequent_questions/ko/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CD에서 빌드 오류
+description: CI/CD 환경에서 발생하는 빌드 오류를 해결하는 방법을 알아보세요.
+keywords:
+  - 빌드
+  - 오류
+  - ci
+  - cd
+  - 파이프라인
+  - intlayer
+  - 사전
+  - next.js
+  - 사전빌드
+  - 자동화
+slugs:
+  - doc
+  - faq
+  - build-error-ci-cd
+---
+
+# CI/CD에서 빌드 오류
+
+Next.js에서 다음과 같은 오류가 발생한다면:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+몇 가지 해결책은 다음과 같습니다:
+
+## 1. 사전 누락
+
+빌드 단계에서 사전이 빌드되었는지 확인하세요.
+
+로컬에서는 빌드가 잘 되지만 CI/CD에서는 작동하지 않는 경우가 자주 있습니다. 그 이유는 로컬에서는 `.intlayer` 디렉토리가 존재하지만, CI/CD에서는 빌드에서 제외되기 때문입니다.
+
+프로젝트의 `package.json`에 사전 빌드(prebuild) 스크립트를 추가하여 이를 해결할 수 있습니다.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // 빌드 전에 실행됩니다
+    "build": "next build",
+  },
+}
+```
+
+> `withIntlayer` 함수나 프레임워크에 맞는 번들러 플러그인을 사용하는 경우, 사전 빌드 스크립트가 빌드 전에 자동으로 실행됩니다.
+
+## 2. 빌드/실행 시 환경 변수 누락
+
+컨테이너나 자동 배포 플랫폼에서는 `.env` 파일을 빌드에서 제외하는 것이 권장됩니다.
+
+```text fileName=".gitignore or .dockerignore"
+# 환경 변수
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+빌드 시 환경 변수가 사용 불가능하면 오류가 발생합니다.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL), // 환경 변수에서 URL을 가져옵니다
+});
+```
+
+이는 아마도 Intlayer와 관련이 없을 것입니다. 따라서 CI/CD 플랫폼에서 빌드 시 환경 변수를 확인하세요.

package/frequent_questions/ko/intlayer_command_undefined.md

@@ -144,7 +144,7 @@ npm --version
 11. **권한 문제 확인하기**  
     권한 오류가 발생하는 경우:
 
-````bash
+```bash
 # 유닉스 기반 시스템용
 sudo npm install -g intlayer
 
@@ -152,5 +152,5 @@ sudo npm install -g intlayer
 mkdir ~/.npm-global
 npm config set prefix '~/.npm-global'
 # ~/.profile 또는 ~/.bashrc에 다음을 추가하세요:
-export PATH=~/.npm-global/bin:$PATH```
-````
+export PATH=~/.npm-global/bin:$PATH
+```

package/frequent_questions/pt/build_error_CI_CD.md

@@ -0,0 +1,75 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Erro de Build em CI/CD
+description: Aprenda como corrigir erros de build que ocorrem em ambientes CI/CD.
+keywords:
+  - build
+  - erro
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dicionários
+  - next.js
+  - prebuild
+  - automação
+slugs:
+  - doc
+  - faq
+  - erro-build-ci-cd
+---
+
+# Erro no build em CI/CD
+
+Se você receber um erro como este no Next.js:
+
+```text
+Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error
+```
+
+Aqui estão algumas soluções:
+
+## 1. Dicionários ausentes
+
+Certifique-se de que os dicionários sejam construídos na etapa de build.
+
+É frequente que o build funcione localmente, mas não no CI/CD. A razão é que localmente o diretório `.intlayer` está presente, mas no CI/CD não está, pois é excluído do build.
+
+Você pode corrigir isso adicionando um script de prebuild no `package.json` do seu projeto.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // Será executado antes do build
+    "build": "next build",
+  },
+}
+```
+
+> Note que se você usar a função `withIntlayer`, ou o plugin bundler equivalente para seu framework, o script de prebuild será executado antes do build.
+
+## 2. Variáveis de ambiente ausentes no momento do build / execução
+
+Em um container, ou plataforma de implantação automática, é recomendado excluir o arquivo `.env` do build.
+
+```text fileName=".gitignore or .dockerignore"
+# Variáveis de ambiente
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+Se suas variáveis de ambiente não estiverem disponíveis no momento do build, um erro será lançado.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+Provavelmente não está relacionado ao Intlayer. Então, verifique suas variáveis de ambiente no momento do build na sua plataforma CI/CD.