@intlayer/docs 7.0.7 → 7.0.8-canary.0

package/frequent_questions/fr/build_error_CI_CD.md

@@ -15,8 +15,7 @@ keywords:
   - prébuild
   - automatisation
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - build-error-ci-cd
 ---
 

package/frequent_questions/fr/bun_set_up.md

@@ -10,8 +10,7 @@ keywords:
   - configuration
   - gestionnaire de paquets
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - bun-set-up
 ---
 

package/frequent_questions/fr/customized_locale_list.md

@@ -15,8 +15,7 @@ keywords:
   - langue
   - liste
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - customized-locale-list
 ---
 

package/frequent_questions/fr/domain_routing.md

@@ -15,8 +15,7 @@ keywords:
   - vite
   - framework
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - domain-routing
 ---
 

package/frequent_questions/fr/esbuild_error.md

@@ -14,8 +14,7 @@ keywords:
   - react-native
   - lynx
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - esbuild-error
 ---
 

package/frequent_questions/fr/get_locale_cookie.md

@@ -15,8 +15,7 @@ keywords:
   - react-intlayer
   - vue-intlayer
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - get-locale-cookie
 ---
 

package/frequent_questions/fr/intlayer_command_undefined.md

@@ -15,8 +15,7 @@ keywords:
   - next.js
   - vite
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - intlayer-command-undefined
 ---
 

package/frequent_questions/fr/locale_incorect_in_url.md

@@ -15,8 +15,7 @@ keywords:
   - prefixDefault
   - noPrefix
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - locale-incorect-in-url
 ---
 

package/frequent_questions/fr/static_rendering.md

@@ -15,8 +15,7 @@ keywords:
   - middleware
   - configuration
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - static-rendering
 ---
 
@@ -31,7 +30,6 @@ slugs:
   next-intl recherche la locale actuelle à partir d'un en-tête disponible uniquement dans la requête (`x-next-intl-locale`) via `headers()`. Comme `headers()` est une **API dynamique**, tout composant qui l'utilise perd l'optimisation statique. ([Next Intl][1], [Next.js][2])
 
 - **Solution officielle (boilerplate)**
-
   1. Exporter `generateStaticParams` avec toutes les locales supportées.
   2. Appeler `setRequestLocale(locale)` dans **chaque** layout/page _avant_ d'appeler `useTranslations`. ([Next Intl][1])
      Cela supprime la dépendance à l'en-tête, mais vous avez maintenant du code supplémentaire à maintenir et une API instable en production.

package/frequent_questions/fr/translated_path_url.md

@@ -15,8 +15,7 @@ keywords:
   - locale
   - url
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - translated-path-url
 ---
 

package/frequent_questions/fr/unknown_command.md

@@ -15,8 +15,7 @@ keywords:
   - redémarrer
   - local
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - unknown-command
 ---
 

package/frequent_questions/hi/SSR_Next_no_[locale].md

@@ -15,8 +15,7 @@ keywords:
   - prefixDefault
   - noPrefix
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - ssr-next-no-[locale]
 ---
 

package/frequent_questions/hi/array_as_content_declaration.md

@@ -9,8 +9,7 @@ keywords:
   - declaration
   - intlayer
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - array-as-content-declaration
 ---
 

package/frequent_questions/hi/build_dictionaries.md

@@ -15,8 +15,7 @@ keywords:
   - next.js
   - vite
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - build-dictionaries
 ---
 

package/frequent_questions/hi/build_error_CI_CD.md

@@ -15,8 +15,7 @@ keywords:
   - prebuild
   - automation
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - build-error-ci-cd
 ---
 

package/frequent_questions/hi/bun_set_up.md

@@ -10,8 +10,7 @@ keywords:
   - कॉन्फ़िगरेशन
   - पैकेज प्रबंधक
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - bun-set-up
 ---
 

package/frequent_questions/hi/customized_locale_list.md

@@ -15,8 +15,7 @@ keywords:
   - लोकल
   - सूची
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - customized-locale-list
 ---
 

package/frequent_questions/hi/domain_routing.md

@@ -15,8 +15,7 @@ keywords:
   - vite
   - फ्रेमवर्क
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - domain-routing
 ---
 

package/frequent_questions/hi/esbuild_error.md

@@ -14,8 +14,7 @@ keywords:
   - react-native
   - lynx
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - esbuild-error
 ---
 

package/frequent_questions/hi/get_locale_cookie.md

@@ -15,8 +15,7 @@ keywords:
   - react-intlayer
   - vue-intlayer
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - get-locale-cookie
 ---
 

package/frequent_questions/hi/intlayer_command_undefined.md

@@ -15,8 +15,7 @@ keywords:
   - next.js
   - vite
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - intlayer-command-undefined
 ---
 

package/frequent_questions/hi/locale_incorect_in_url.md

@@ -15,8 +15,7 @@ keywords:
   - prefixDefault
   - noPrefix
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - locale-incorect-in-url
 ---
 

package/frequent_questions/hi/static_rendering.md

@@ -15,8 +15,7 @@ keywords:
   - मिडलवेयर
   - कॉन्फ़िगरेशन
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - static-rendering
 ---
 
@@ -31,7 +30,6 @@ slugs:
   next-intl वर्तमान लोकल को केवल अनुरोध-हेडर (`x-next-intl-locale`) से `headers()` के माध्यम से देखता है। क्योंकि `headers()` एक **गतिशील API** है, कोई भी कंपोनेंट जो इसे छूता है, स्थैतिक अनुकूलन खो देता है। ([Next Intl][1], [Next.js][2])
 
 - **आधिकारिक समाधान (बॉयलरप्लेट)**
-
   1. हर समर्थित लोकल के साथ `generateStaticParams` निर्यात करें।
   2. `useTranslations` कॉल करने से _पहले_ **हर** लेआउट/पेज में `setRequestLocale(locale)` कॉल करें। ([Next Intl][1])
      इससे हेडर निर्भरता हट जाती है, लेकिन अब आपके पास अतिरिक्त कोड बनाए रखने के लिए होता है और उत्पादन में एक अस्थिर API होती है।

package/frequent_questions/hi/translated_path_url.md

@@ -15,8 +15,7 @@ keywords:
   - locale
   - url
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - translated-path-url
 ---
 

package/frequent_questions/hi/unknown_command.md

@@ -15,8 +15,7 @@ keywords:
   - पुनःप्रारंभ
   - स्थानीय
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - unknown-command
 ---
 

package/frequent_questions/id/SSR_Next_no_[locale].md

@@ -0,0 +1,104 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Apakah mungkin menggunakan Intlayer dengan Next.js tanpa `[locale]` di jalur halaman?
+description: Pelajari cara menggunakan Intlayer dengan Next.js tanpa `[locale]` di jalur halaman.
+keywords:
+  - locale
+  - path
+  - intlayer
+  - next.js
+  - vite
+  - framework
+  - middleware
+  - configuration
+  - prefixDefault
+  - noPrefix
+slugs:
+  - frequent-questions
+  - ssr-next-no-[locale]
+---
+
+# Apakah mungkin menggunakan Intlayer dengan Next.js tanpa `[locale]` di jalur halaman?
+
+Ya, memungkinkan untuk menggunakan Intlayer dengan Next.js tanpa `[locale]` di jalur halaman. Namun, hal ini tidak disarankan karena memisahkan halaman Anda memungkinkan untuk memicu lebih banyak kata kunci di mesin pencari. SSR Anda juga mungkin terpengaruh.
+
+Jika Anda ingin melakukannya, ikuti langkah yang sama seperti yang dijelaskan dalam panduan [Intlayer dengan Next.js](https://intlayer.org/doc/environment/nextjs),
+
+- tanpa `src/middleware.ts`
+- tanpa `generateStaticParams`
+
+```tsx fileName="src/app/layout.tsx"
+import type { FC, PropsWithChildren } from "react";
+
+const LocaleLayout: FC<PropsWithChildren> = ({ children }) => (
+  <html lang={undefined} dir={undefined}>
+    <body className={inter.className}>{children}</body>
+  </html>
+);
+
+export default LocaleLayout;
+```
+
+```tsx fileName="src/app/page.tsx"
+import type { FC } from "react";
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { PageContent } from "@components/pageContent";
+import { type NextPageIntlayer, IntlayerClientProvider } from "next-intlayer";
+import { IntlayerServerProvider } from "next-intlayer/server";
+
+const Page: FC = () => {
+  return (
+    <IntlayerServerProvider>
+      <PageContent />
+      <ServerComponentExample />
+
+      <IntlayerClientProvider>
+        <ClientComponentExample />
+      </IntlayerClientProvider>
+    </IntlayerServerProvider>
+  );
+};
+
+export default Page;
+```
+
+```tsx fileName="src/component/pageContent.ts"
+"use client";
+
+import { type FC } from "react";
+import { useIntlayer } from "next-intlayer";
+import { useHTMLLanguage } from "@hooks/htmlTextDir";
+
+const PageContent: FC = () => {
+  useHTMLLanguage();
+  const content = useIntlayer("page");
+
+  return (
+    <>
+      <p>{content.getStarted.main}</p>
+      <code>{content.getStarted.pageLink}</code>
+    </>
+  );
+};
+```
+
+```tsx fileName="src/hooks/htmlTextDir.ts"
+"use client";
+
+import { useEffect } from "react";
+import { getHTMLTextDir } from "intlayer";
+import { useLocale } from "next-intlayer";
+
+export const useHTMLLanguage = () => {
+  const { locale } = useLocale();
+
+  useEffect(() => {
+    if (!document) return;
+
+    document.documentElement.lang = locale; // mengatur atribut bahasa dokumen HTML
+    document.documentElement.dir = getHTMLTextDir(locale); // mengatur arah teks dokumen HTML berdasarkan locale
+  }, [locale]);
+};
+```

package/frequent_questions/id/array_as_content_declaration.md

@@ -0,0 +1,71 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Bisakah saya menggunakan array sebagai deklarasi konten?
+description: Pelajari cara menggunakan array sebagai deklarasi konten.
+keywords:
+  - array
+  - konten
+  - deklarasi
+  - intlayer
+slugs:
+  - frequent-questions
+  - array-as-content-declaration
+---
+
+# Bisakah saya menggunakan array sebagai deklarasi konten?
+
+Ya, Anda dapat menggunakan array sebagai deklarasi konten.
+
+```ts
+import { t, type Dictionary } from "intlayer";
+
+const exampleContent = {
+  key: "example",
+  content: {
+    test: t({
+      en: ["Test", "Test2", "Test3"],
+      fr: ["Test", "Test2", "Test3"],
+      es: ["Test", "Test2", "Test3"],
+    }),
+  },
+};
+
+export default exampleContent;
+```
+
+Kemudian Anda dapat menggunakan konten seperti ini:
+
+```tsx
+import { useIntlayer } from "react-intlayer";
+
+const Example = () => {
+  const content = useIntlayer("example");
+
+  return (
+    <div>
+      {content.test.map((item) => (
+        <div key={item.value}>{item}</div>
+      ))}
+    </div>
+  );
+};
+```
+
+```vue
+<script setup lang="ts">
+import { useIntlayer } from "vue-intlayer";
+
+const content = useIntlayer("example");
+</script>
+
+<template>
+  <div>
+    <div v-for="item in content.test" :key="item.value">
+      {{ item }}
+    </div>
+  </div>
+</template>
+```
+
+`.value` memungkinkan Anda untuk mendapatkan nilai dari konten, bukan yang dibungkus oleh `IntlayerNode`.

package/frequent_questions/id/build_dictionaries.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Cara membangun kamus?
+description: Pelajari cara membangun kamus.
+keywords:
+  - membangun
+  - kamus
+  - intlayer
+  - perintah
+  - watch
+  - vscode
+  - plugin
+  - framework
+  - next.js
+  - vite
+slugs:
+  - frequent-questions
+  - build-dictionaries
+---
+
+# Membangun Kamus
+
+## Cara Membangun Kamus
+
+Intlayer menyediakan alat baris perintah untuk membangun kamus.
+
+```bash
+npx intlayer dictionaries build
+```
+
+Perintah ini:
+
+- Memindai semua file deklarasi konten (`.content.{ts,tsx,js,mjs,cjs,json,...}`) dalam proyek Anda.
+- Menghasilkan kamus dan menyimpannya di folder `.intlayer/dictionary`.
+
+### Mode Watch
+
+Jika Anda ingin secara otomatis memperbarui kamus saat terjadi perubahan pada file deklarasi konten, jalankan perintah berikut:
+
+```bash
+npx intlayer dictionaries build --watch
+```
+
+Dalam mode ini, Intlayer akan memindai dan membangun kamus setiap kali terjadi perubahan pada file deklarasi konten dan secara otomatis memperbarui folder `.intlayer/dictionary`.
+
+### Menggunakan ekstensi VSCode
+
+Anda juga dapat menggunakan [ekstensi Intlayer VSCode](https://github.com/aymericzip/intlayer/tree/main/docs/id/vs_code_extension.md) untuk meningkatkan pengalaman Intlayer Anda di VSCode.
+
+### Menggunakan plugin untuk framework aplikasi favorit Anda
+
+Jika Anda menggunakan framework seperti Next.js (Webpack / Turbopack), Vite, atau React Native, Lynx, dll. Intlayer menyediakan plugin yang dapat Anda gunakan untuk mengintegrasikan Intlayer ke dalam aplikasi Anda.
+
+Intlayer akan membangun kamus sebelum proses build aplikasi Anda.
+Dengan cara yang sama, dalam mode pengembangan, Intlayer akan memantau perubahan pada file deklarasi konten Anda dan membangun ulang kamus secara otomatis.
+
+Jadi, lihat dokumentasi spesifik dari framework Anda untuk mempelajari cara mengintegrasikan plugin tersebut.

package/frequent_questions/id/build_error_CI_CD.md

@@ -0,0 +1,74 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Kesalahan Build di CI/CD
+description: Pelajari cara memperbaiki kesalahan build yang terjadi di lingkungan CI/CD.
+keywords:
+  - build
+  - error
+  - ci
+  - cd
+  - pipeline
+  - intlayer
+  - dictionaries
+  - next.js
+  - prebuild
+  - automation
+slugs:
+  - frequent-questions
+  - build-error-ci-cd
+---
+
+# Kesalahan saat build di CI/CD
+
+Jika Anda mendapatkan kesalahan seperti ini di 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
+```
+
+Berikut beberapa solusi:
+
+## 1. Kamus yang hilang
+
+Pastikan bahwa kamus dibangun pada tahap build.
+
+Seringkali build berhasil secara lokal tetapi tidak di CI/CD. Alasannya adalah karena secara lokal, direktori `.intlayer` ada, tetapi di CI/CD tidak ada karena dikecualikan dari build.
+
+Anda dapat memperbaikinya dengan menambahkan skrip prebuild di `package.json` proyek Anda.
+
+```json5 fileName=package.json
+{
+  // ...
+  "scripts": {
+    "prebuild": "npx intlayer dictionaries build", // Akan dijalankan sebelum build
+    "build": "next build",
+  },
+}
+```
+
+> Perlu dicatat bahwa jika Anda menggunakan fungsi `withIntlayer`, atau plugin bundler setara untuk framework Anda, skrip prebuild akan dijalankan sebelum build.
+
+## 2. Variabel lingkungan yang hilang saat build / runtime
+
+Dalam sebuah container, atau platform yang melakukan auto-deploy, disarankan untuk mengecualikan file `.env` dari build.
+
+```text fileName=".gitignore or .dockerignore"
+# Variabel lingkungan
+.env
+**/.env
+.env.*
+**/.env.*
+```
+
+Jika variabel lingkungan Anda tidak tersedia saat build, maka akan terjadi error.
+
+```ts
+import { Metadata } from "next";
+
+export const generateMetadata = async ({ params }): Promise<Metadata> => ({
+  metadataBase: new URL(process.env.NEXT_PUBLIC_URL),
+});
+```
+
+Kemungkinan ini tidak terkait dengan Intlayer. Jadi periksa variabel lingkungan Anda saat build di platform CI/CD Anda.

package/frequent_questions/id/bun_set_up.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Saya mendapatkan error module not found saat menggunakan bun
+description: Memperbaiki error saat menggunakan bun.
+keywords:
+  - bun
+  - module not found
+  - intlayer
+  - konfigurasi
+  - package manager
+slugs:
+  - frequent-questions
+  - bun-set-up
+---
+
+# Saya mendapatkan error module not found saat menggunakan bun
+
+## Deskripsi Masalah
+
+Saat menggunakan bun, Anda mungkin menemui error seperti ini:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Alasan
+
+Intlayer menggunakan `require` secara internal. Dan bun membatasi fungsi require untuk hanya menyelesaikan paket dari paket `@intlayer/config`, bukan seluruh proyek.
+
+## Solusi
+
+### Berikan fungsi `require` dalam konfigurasi
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // berikan fungsi require dalam konfigurasi build
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // sertakan fungsi require saat menggunakan withIntlayer
+});
+
+export default configuration;
+```