@intlayer/docs 8.4.5 → 8.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/blog/en/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  2. package/blog/en-GB/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  3. package/blog/es/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  4. package/blog/id/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  5. package/blog/it/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  6. package/blog/ja/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  7. package/blog/ko/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  8. package/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  9. package/blog/vi/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  10. package/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  11. package/dist/cjs/generated/docs.entry.cjs +20 -0
  12. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  13. package/dist/esm/generated/docs.entry.mjs +20 -0
  14. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  15. package/dist/types/generated/docs.entry.d.ts +1 -0
  16. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  17. package/docs/ar/intlayer_with_storybook.md +521 -0
  18. package/docs/bn/intlayer_with_hono.md +428 -0
  19. package/docs/de/intlayer_with_storybook.md +521 -0
  20. package/docs/en/configuration.md +160 -508
  21. package/docs/en/intlayer_with_storybook.md +521 -0
  22. package/docs/en-GB/intlayer_with_storybook.md +521 -0
  23. package/docs/es/configuration.md +387 -754
  24. package/docs/es/intlayer_with_storybook.md +521 -0
  25. package/docs/fr/configuration.md +384 -757
  26. package/docs/fr/intlayer_with_storybook.md +521 -0
  27. package/docs/hi/intlayer_with_storybook.md +521 -0
  28. package/docs/id/intlayer_with_storybook.md +521 -0
  29. package/docs/it/intlayer_with_storybook.md +521 -0
  30. package/docs/ja/intlayer_with_storybook.md +521 -0
  31. package/docs/ko/intlayer_with_storybook.md +521 -0
  32. package/docs/pl/intlayer_with_storybook.md +521 -0
  33. package/docs/pt/intlayer_with_storybook.md +521 -0
  34. package/docs/ru/intlayer_with_storybook.md +521 -0
  35. package/docs/tr/intlayer_with_storybook.md +521 -0
  36. package/docs/uk/intlayer_with_storybook.md +521 -0
  37. package/docs/ur/intlayer_with_hono.md +428 -0
  38. package/docs/vi/intlayer_with_storybook.md +521 -0
  39. package/docs/zh/intlayer_with_storybook.md +521 -0
  40. package/package.json +6 -6
  41. package/src/generated/docs.entry.ts +20 -0
  42. package/docs/ar/configuration.md +0 -1124
  43. package/docs/de/configuration.md +0 -1296
  44. package/docs/en-GB/configuration.md +0 -1123
  45. package/docs/hi/configuration.md +0 -1118
  46. package/docs/id/configuration.md +0 -1235
  47. package/docs/it/configuration.md +0 -1301
  48. package/docs/ja/configuration.md +0 -1121
  49. package/docs/ko/configuration.md +0 -1121
  50. package/docs/pl/configuration.md +0 -1226
  51. package/docs/pt/configuration.md +0 -1293
  52. package/docs/ru/configuration.md +0 -1112
  53. package/docs/tr/configuration.md +0 -1114
  54. package/docs/uk/configuration.md +0 -1241
  55. package/docs/vi/configuration.md +0 -1263
  56. package/docs/zh/configuration.md +0 -1115
@@ -115,14 +115,12 @@ Here's a comparison of the JavaScript bundle size loaded by the browser for a mu
115
115
 
116
116
  If we don't need any formatter in the application, the list of exported functions after tree-shaking will be:
117
117
 
118
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 180.6 kB -> 78.6 kB (gzip))
118
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 180.6 kB -> 15.24 kB (gzip))
119
119
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 101.3 kB -> 31.4 kB (gzip))
120
120
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (Bundle size is 80.7 kB -> 25.5 kB (gzip))
121
121
 
122
122
  These functions are only wrappers around React context/state, so the total impact of the i18n library on bundle size is minimal.
123
123
 
124
- > Intlayer is slightly bigger than `next-intl` and `next-i18next` because it includes more logic in the `useIntlayer` function. This is related to markdown and `intlayer-editor` integration.
125
-
126
124
  ## Content and Translations
127
125
 
128
126
  This part is often ignored by developers, but let's consider the case of an application composed of 10 pages in 10 languages. Let's assume that each page integrates 100% unique content to simplify the calculation (in reality, much content is redundant between pages, e.g., page title, header, footer, etc.).
@@ -123,14 +123,12 @@ Here is a comparison of the JavaScript bundle size loaded by the browser for a m
123
123
 
124
124
  If we do not require any formatter in the application, the list of exported functions after tree-shaking will be:
125
125
 
126
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 180.6 kB -> 78.6 kB (gzip))
126
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 180.6 kB -> 15.24 kB (gzip))
127
127
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (Bundle size is 101.3 kB -> 31.4 kB (gzip))
128
128
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (Bundle size is 80.7 kB -> 25.5 kB (gzip))
129
129
 
130
130
  These functions are merely wrappers around React context/state, so the overall impact of the i18n library on bundle size is minimal.
131
131
 
132
- > Intlayer is slightly larger than `next-intl` and `next-i18next` because it incorporates more logic in the `useIntlayer` function. This is related to markdown and `intlayer-editor` integration.
133
-
134
132
  ## Content and Translations
135
133
 
136
134
  This part is often ignored by developers, but let us consider the case of an application composed of 10 pages in 10 languages. Let us assume that each page integrates 100% unique content to simplify the calculation (in reality, much content is redundant between pages, e.g., page title, header, footer, etc.).
@@ -123,14 +123,12 @@ Aquí hay una comparación del tamaño del bundle de JavaScript cargado por el n
123
123
 
124
124
  Si no necesitamos ningún formateador en la aplicación, la lista de funciones exportadas después del tree-shaking será:
125
125
 
126
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (El tamaño del paquete es 180.6 kB -> 78.6 kB (gzip))
126
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (El tamaño del paquete es 180.6 kB -> 15.24 kB (gzip))
127
127
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (El tamaño del paquete es 101.3 kB -> 31.4 kB (gzip))
128
128
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (El tamaño del paquete es 80.7 kB -> 25.5 kB (gzip))
129
129
 
130
130
  Estas funciones son solo envoltorios alrededor del contexto/estado de React, por lo que el impacto total de la biblioteca i18n en el tamaño del paquete es mínimo.
131
131
 
132
- > Intlayer es ligeramente más grande que `next-intl` y `next-i18next` porque incluye más lógica en la función `useIntlayer`. Esto está relacionado con la integración de markdown y `intlayer-editor`.
133
-
134
132
  ## Contenido y Traducciones
135
133
 
136
134
  Esta parte a menudo es ignorada por los desarrolladores, pero consideremos el caso de una aplicación compuesta por 10 páginas en 10 idiomas. Supongamos que cada página integra un contenido 100% único para simplificar el cálculo (en realidad, mucho contenido es redundante entre páginas, por ejemplo, título de la página, encabezado, pie de página, etc.).
@@ -115,14 +115,12 @@ Berikut adalah perbandingan ukuran bundle JavaScript yang dimuat oleh browser un
115
115
 
116
116
  Jika kita tidak memerlukan formatter apapun dalam aplikasi, daftar fungsi yang diekspor setelah tree-shaking adalah:
117
117
 
118
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Ukuran bundle adalah 180.6 kB -> 78.6 kB (gzip))
118
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Ukuran bundle adalah 180.6 kB -> 15.24 kB (gzip))
119
119
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (Ukuran bundle adalah 101.3 kB -> 31.4 kB (gzip))
120
120
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (Ukuran bundle adalah 80.7 kB -> 25.5 kB (gzip))
121
121
 
122
122
  Fungsi-fungsi ini hanya pembungkus di sekitar konteks/state React, sehingga dampak total dari pustaka i18n pada ukuran bundle adalah minimal.
123
123
 
124
- > Intlayer sedikit lebih besar daripada `next-intl` dan `next-i18next` karena mencakup lebih banyak logika dalam fungsi `useIntlayer`. Ini terkait dengan integrasi markdown dan `intlayer-editor`.
125
-
126
124
  ## Konten dan Terjemahan
127
125
 
128
126
  Bagian ini sering diabaikan oleh pengembang, tetapi mari kita pertimbangkan kasus sebuah aplikasi yang terdiri dari 10 halaman dalam 10 bahasa. Mari kita asumsikan bahwa setiap halaman mengintegrasikan konten yang 100% unik untuk menyederhanakan perhitungan (dalam kenyataannya, banyak konten yang berulang antar halaman, misalnya judul halaman, header, footer, dll.).
@@ -129,14 +129,12 @@ Ecco un confronto della dimensione del bundle JavaScript caricato dal browser pe
129
129
 
130
130
  Se non abbiamo bisogno di alcun formatter nell'applicazione, l'elenco delle funzioni esportate dopo il tree-shaking sarà:
131
131
 
132
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (La dimensione del bundle è 180.6 kB -> 78.6 kB (gzip))
132
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (La dimensione del bundle è 180.6 kB -> 15.24 kB (gzip))
133
133
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (La dimensione del bundle è 101.3 kB -> 31.4 kB (gzip))
134
134
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (La dimensione del bundle è 80.7 kB -> 25.5 kB (gzip))
135
135
 
136
136
  Queste funzioni sono solo wrapper attorno al contesto/stato di React, quindi l'impatto totale della libreria i18n sulla dimensione del bundle è minimo.
137
137
 
138
- > Intlayer è leggermente più grande di `next-intl` e `next-i18next` perché include più logica nella funzione `useIntlayer`. Questo è legato all'integrazione con markdown e `intlayer-editor`.
139
-
140
138
  ## Contenuti e Traduzioni
141
139
 
142
140
  Questa parte è spesso ignorata dagli sviluppatori, ma consideriamo il caso di un'applicazione composta da 10 pagine in 10 lingue. Supponiamo che ogni pagina integri contenuti unici al 100% per semplificare il calcolo (in realtà, molti contenuti sono ridondanti tra le pagine, ad esempio titolo della pagina, intestazione, piè di pagina, ecc.).
@@ -131,14 +131,12 @@ Next.jsは国際化されたルーティング(例:ロケールセグメン
131
131
 
132
132
  アプリケーション内でフォーマッターを必要としない場合、ツリーシェイキング後にエクスポートされる関数のリストは以下のようになります:
133
133
 
134
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`、(バンドルサイズは180.6 kB -> 78.6 kB(gzip))
134
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`、(バンドルサイズは180.6 kB -> 15.24 kB(gzip))
135
135
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`、(バンドルサイズは101.3 kB -> 31.4 kB(gzip))
136
136
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`、(バンドルサイズは80.7 kB -> 25.5 kB(gzip))
137
137
 
138
138
  これらの関数はReactのコンテキスト/ステートのラッパーに過ぎないため、i18nライブラリがバンドルサイズに与える影響は最小限です。
139
139
 
140
- > Intlayerは、`useIntlayer`関数により多くのロジックを含んでいるため、`next-intl`や`next-i18next`よりわずかに大きくなっています。これはマークダウンや`intlayer-editor`の統合に関連しています。
141
-
142
140
  ## コンテンツと翻訳
143
141
 
144
142
  この部分は開発者によってしばしば無視されますが、10ページで構成され、10言語に対応したアプリケーションの場合を考えてみましょう。計算を簡単にするために、各ページが100%ユニークなコンテンツを統合していると仮定します(実際には、ページタイトル、ヘッダー、フッターなど、ページ間で重複するコンテンツが多くあります)。
@@ -123,14 +123,12 @@ Next.js는 국제화된 라우팅(예: 로케일 세그먼트)을 기본적으
123
123
 
124
124
  애플리케이션에서 포매터가 필요하지 않은 경우, 트리 쉐이킹 후 내보내지는 함수 목록은 다음과 같습니다:
125
125
 
126
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (번들 크기 180.6 kB -> 78.6 kB (gzip))
126
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (번들 크기 180.6 kB -> 15.24 kB (gzip))
127
127
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (번들 크기 101.3 kB -> 31.4 kB (gzip))
128
128
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (번들 크기 80.7 kB -> 25.5 kB (gzip))
129
129
 
130
130
  이 함수들은 React 컨텍스트/상태를 감싸는 래퍼에 불과하므로, i18n 라이브러리가 번들 크기에 미치는 전체 영향은 미미합니다.
131
131
 
132
- > Intlayer는 `useIntlayer` 함수에 더 많은 로직이 포함되어 있어 `next-intl` 및 `next-i18next`보다 약간 더 큽니다. 이는 마크다운과 `intlayer-editor` 통합과 관련이 있습니다.
133
-
134
132
  ## 콘텐츠 및 번역
135
133
 
136
134
  이 부분은 개발자들이 종종 무시하지만, 10개의 페이지와 10개의 언어로 구성된 애플리케이션의 경우를 생각해 봅시다. 계산을 단순화하기 위해 각 페이지가 100% 고유한 콘텐츠를 통합한다고 가정해 보겠습니다(실제로는 페이지 간에 중복되는 콘텐츠가 많습니다. 예: 페이지 제목, 헤더, 푸터 등).
@@ -115,14 +115,12 @@ Next.js надає вбудовану підтримку інтернаціон
115
115
 
116
116
  Якщо в застосунку нам не потрібен жоден formatter, список експортованих функцій після tree-shaking буде:
117
117
 
118
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Розмір бандла 180.6 kB -> 78.6 kB (gzip))
118
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Розмір бандла 180.6 kB -> 15.24 kB (gzip))
119
119
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (Розмір бандла 101.3 kB -> 31.4 kB (gzip))
120
120
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (Розмір бандла 80.7 kB -> 25.5 kB (gzip))
121
121
 
122
122
  Ці функції, лише обгортки над React context/state, тому загальний вплив бібліотеки i18n на розмір бандла мінімальний.
123
123
 
124
- > Intlayer трохи більший, ніж `next-intl` та `next-i18next`, оскільки він містить більше логіки в функції `useIntlayer`. Це пов'язано з інтеграцією markdown та `intlayer-editor`.
125
-
126
124
  ## Контент та переклади
127
125
 
128
126
  Цей аспект часто ігнорують розробники, але розгляньмо випадок застосунку, що складається з 10 сторінок у 10 мовах. Припустимо для спрощення розрахунків, що кожна сторінка містить 100% унікального контенту (на практиці багато контенту дублюється між сторінками, наприклад заголовок сторінки, header, footer тощо).
@@ -115,14 +115,12 @@ Dưới đây là so sánh kích thước bundle JavaScript được trình duy
115
115
 
116
116
  Nếu chúng ta không cần bất kỳ bộ định dạng nào trong ứng dụng, danh sách các hàm được xuất sau khi tree-shaking sẽ là:
117
117
 
118
- - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Kích thước bundle là 180.6 kB -> 78.6 kB (gzip))
118
+ - **next-intlayer**: `useIntlayer`, `useLocale`, `NextIntlClientProvider`, (Kích thước bundle là 180.6 kB -> 15.24 kB (gzip))
119
119
  - **next-intl**: `useTranslations`, `useLocale`, `NextIntlClientProvider`, (Kích thước bundle là 101.3 kB -> 31.4 kB (gzip))
120
120
  - **next-i18next**: `useTranslation`, `useI18n`, `I18nextProvider`, (Kích thước bundle là 80.7 kB -> 25.5 kB (gzip))
121
121
 
122
122
  Các hàm này chỉ là các wrapper quanh React context/state, vì vậy tổng ảnh hưởng của thư viện i18n lên kích thước bundle là rất nhỏ.
123
123
 
124
- > Intlayer hơi lớn hơn một chút so với `next-intl` và `next-i18next` vì nó bao gồm nhiều logic hơn trong hàm `useIntlayer`. Điều này liên quan đến tích hợp markdown và `intlayer-editor`.
125
-
126
124
  ## Nội dung và Bản dịch
127
125
 
128
126
  Phần này thường bị các nhà phát triển bỏ qua, nhưng hãy xem xét trường hợp một ứng dụng gồm 10 trang với 10 ngôn ngữ. Giả sử mỗi trang chứa 100% nội dung duy nhất để đơn giản hóa phép tính (trong thực tế, nhiều nội dung bị trùng lặp giữa các trang, ví dụ: tiêu đề trang, đầu trang, chân trang, v.v.).
@@ -131,14 +131,12 @@ Next.js 为你内置了国际化路由支持(例如区域段)。但该功能
131
131
 
132
132
  如果应用中不需要任何格式化器,tree-shaking 后导出的函数列表将是:
133
133
 
134
- - **next-intlayer**: `useIntlayer`,`useLocale`,`NextIntlClientProvider`,(包大小为 180.6 kB -> 78.6 kB(gzip))
134
+ - **next-intlayer**: `useIntlayer`,`useLocale`,`NextIntlClientProvider`,(包大小为 180.6 kB -> 15.24 kB(gzip))
135
135
  - **next-intl**: `useTranslations`,`useLocale`,`NextIntlClientProvider`,(包大小为 101.3 kB -> 31.4 kB(gzip))
136
136
  - **next-i18next**: `useTranslation`,`useI18n`,`I18nextProvider`,(包大小为 80.7 kB -> 25.5 kB(gzip))
137
137
 
138
138
  这些函数只是围绕 React 上下文/状态的包装器,因此 i18n 库对包大小的总体影响很小。
139
139
 
140
- > Intlayer 比 `next-intl` 和 `next-i18next` 略大,因为它在 `useIntlayer` 函数中包含了更多逻辑。这与 markdown 和 `intlayer-editor` 的集成有关。
141
-
142
140
  ## 内容和翻译
143
141
 
144
142
  这部分内容常常被开发者忽视,但让我们考虑一个由10个页面和10种语言组成的应用程序的情况。为了简化计算,假设每个页面都包含100%独特的内容(实际上,许多内容在页面之间是冗余的,例如页面标题、页眉、页脚等)。
@@ -1386,6 +1386,26 @@ const docsEntry = {
1386
1386
  vi: readLocale("intlayer_with_react_router_v7_fs_routes.md", "vi"),
1387
1387
  uk: readLocale("intlayer_with_react_router_v7_fs_routes.md", "uk")
1388
1388
  },
1389
+ "./docs/en/intlayer_with_storybook.md": {
1390
+ en: readLocale("intlayer_with_storybook.md", "en"),
1391
+ ru: readLocale("intlayer_with_storybook.md", "ru"),
1392
+ ja: readLocale("intlayer_with_storybook.md", "ja"),
1393
+ fr: readLocale("intlayer_with_storybook.md", "fr"),
1394
+ ko: readLocale("intlayer_with_storybook.md", "ko"),
1395
+ zh: readLocale("intlayer_with_storybook.md", "zh"),
1396
+ es: readLocale("intlayer_with_storybook.md", "es"),
1397
+ de: readLocale("intlayer_with_storybook.md", "de"),
1398
+ ar: readLocale("intlayer_with_storybook.md", "ar"),
1399
+ it: readLocale("intlayer_with_storybook.md", "it"),
1400
+ "en-GB": readLocale("intlayer_with_storybook.md", "en-GB"),
1401
+ pt: readLocale("intlayer_with_storybook.md", "pt"),
1402
+ hi: readLocale("intlayer_with_storybook.md", "hi"),
1403
+ tr: readLocale("intlayer_with_storybook.md", "tr"),
1404
+ pl: readLocale("intlayer_with_storybook.md", "pl"),
1405
+ id: readLocale("intlayer_with_storybook.md", "id"),
1406
+ vi: readLocale("intlayer_with_storybook.md", "vi"),
1407
+ uk: readLocale("intlayer_with_storybook.md", "uk")
1408
+ },
1389
1409
  "./docs/en/intlayer_with_svelte_kit.md": {
1390
1410
  en: readLocale("intlayer_with_svelte_kit.md", "en"),
1391
1411
  ru: readLocale("intlayer_with_svelte_kit.md", "ru"),