npm - @intlayer/docs - Versions diffs - 7.5.6 → 7.5.7 - Mend

@intlayer/docs 7.5.6 → 7.5.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 (173) hide show

package/blog/ar/intlayer_with_i18next.md +4 -4
package/blog/ar/intlayer_with_next-i18next.md +4 -4
package/blog/ar/intlayer_with_next-intl.md +4 -4
package/blog/ar/intlayer_with_react-i18next.md +4 -4
package/blog/ar/intlayer_with_react-intl.md +4 -4
package/blog/ar/intlayer_with_vue-i18n.md +4 -4
package/blog/de/intlayer_with_i18next.md +4 -4
package/blog/de/intlayer_with_next-i18next.md +4 -4
package/blog/de/intlayer_with_next-intl.md +4 -4
package/blog/de/intlayer_with_react-i18next.md +4 -4
package/blog/de/intlayer_with_react-intl.md +4 -4
package/blog/de/intlayer_with_vue-i18n.md +4 -4
package/blog/en/intlayer_with_i18next.md +4 -4
package/blog/en/intlayer_with_next-i18next.md +4 -4
package/blog/en/intlayer_with_next-intl.md +4 -4
package/blog/en/intlayer_with_react-i18next.md +4 -4
package/blog/en/intlayer_with_react-intl.md +4 -4
package/blog/en/intlayer_with_vue-i18n.md +4 -4
package/blog/en-GB/intlayer_with_i18next.md +4 -4
package/blog/en-GB/intlayer_with_next-i18next.md +4 -4
package/blog/en-GB/intlayer_with_next-intl.md +4 -4
package/blog/en-GB/intlayer_with_react-i18next.md +4 -4
package/blog/en-GB/intlayer_with_react-intl.md +4 -4
package/blog/en-GB/intlayer_with_vue-i18n.md +4 -4
package/blog/es/intlayer_with_i18next.md +4 -4
package/blog/es/intlayer_with_next-i18next.md +4 -4
package/blog/es/intlayer_with_next-intl.md +4 -4
package/blog/es/intlayer_with_react-i18next.md +4 -4
package/blog/es/intlayer_with_react-intl.md +4 -4
package/blog/es/intlayer_with_vue-i18n.md +4 -4
package/blog/fr/intlayer_with_i18next.md +4 -4
package/blog/fr/intlayer_with_next-i18next.md +4 -4
package/blog/fr/intlayer_with_next-intl.md +4 -4
package/blog/fr/intlayer_with_react-i18next.md +4 -4
package/blog/fr/intlayer_with_react-intl.md +4 -4
package/blog/fr/intlayer_with_vue-i18n.md +4 -4
package/blog/hi/intlayer_with_i18next.md +4 -4
package/blog/hi/intlayer_with_next-i18next.md +4 -4
package/blog/hi/intlayer_with_next-intl.md +4 -4
package/blog/hi/intlayer_with_react-i18next.md +4 -4
package/blog/hi/intlayer_with_react-intl.md +4 -4
package/blog/hi/intlayer_with_vue-i18n.md +4 -4
package/blog/id/intlayer_with_i18next.md +4 -4
package/blog/id/intlayer_with_next-i18next.md +4 -4
package/blog/id/intlayer_with_next-intl.md +4 -4
package/blog/id/intlayer_with_react-i18next.md +4 -4
package/blog/id/intlayer_with_react-intl.md +4 -4
package/blog/id/intlayer_with_vue-i18n.md +4 -4
package/blog/it/intlayer_with_i18next.md +4 -4
package/blog/it/intlayer_with_next-i18next.md +4 -4
package/blog/it/intlayer_with_next-intl.md +4 -4
package/blog/it/intlayer_with_react-i18next.md +4 -4
package/blog/it/intlayer_with_react-intl.md +4 -4
package/blog/it/intlayer_with_vue-i18n.md +4 -4
package/blog/ja/intlayer_with_i18next.md +4 -4
package/blog/ja/intlayer_with_next-i18next.md +4 -4
package/blog/ja/intlayer_with_next-intl.md +4 -4
package/blog/ja/intlayer_with_react-i18next.md +4 -4
package/blog/ja/intlayer_with_react-intl.md +4 -4
package/blog/ja/intlayer_with_vue-i18n.md +4 -4
package/blog/ko/intlayer_with_i18next.md +4 -4
package/blog/ko/intlayer_with_next-i18next.md +4 -4
package/blog/ko/intlayer_with_next-intl.md +4 -4
package/blog/ko/intlayer_with_react-i18next.md +4 -4
package/blog/ko/intlayer_with_react-intl.md +4 -4
package/blog/ko/intlayer_with_vue-i18n.md +4 -4
package/blog/pl/intlayer_with_i18next.md +4 -4
package/blog/pl/intlayer_with_next-i18next.md +4 -4
package/blog/pl/intlayer_with_next-intl.md +4 -4
package/blog/pl/intlayer_with_react-i18next.md +4 -4
package/blog/pl/intlayer_with_react-intl.md +4 -4
package/blog/pl/intlayer_with_vue-i18n.md +4 -4
package/blog/pt/intlayer_with_i18next.md +4 -4
package/blog/pt/intlayer_with_next-i18next.md +4 -4
package/blog/pt/intlayer_with_next-intl.md +4 -4
package/blog/pt/intlayer_with_react-i18next.md +4 -4
package/blog/pt/intlayer_with_react-intl.md +4 -4
package/blog/pt/intlayer_with_vue-i18n.md +4 -4
package/blog/ru/intlayer_with_i18next.md +4 -4
package/blog/ru/intlayer_with_next-i18next.md +4 -4
package/blog/ru/intlayer_with_next-intl.md +4 -4
package/blog/ru/intlayer_with_react-i18next.md +4 -4
package/blog/ru/intlayer_with_react-intl.md +4 -4
package/blog/ru/intlayer_with_vue-i18n.md +4 -4
package/blog/tr/intlayer_with_i18next.md +4 -4
package/blog/tr/intlayer_with_next-i18next.md +4 -4
package/blog/tr/intlayer_with_next-intl.md +4 -4
package/blog/tr/intlayer_with_react-i18next.md +4 -4
package/blog/tr/intlayer_with_react-intl.md +4 -4
package/blog/tr/intlayer_with_vue-i18n.md +4 -4
package/blog/vi/intlayer_with_i18next.md +4 -4
package/blog/vi/intlayer_with_next-i18next.md +4 -4
package/blog/vi/intlayer_with_next-intl.md +4 -4
package/blog/vi/intlayer_with_react-i18next.md +4 -4
package/blog/vi/intlayer_with_react-intl.md +4 -4
package/blog/vi/intlayer_with_vue-i18n.md +4 -4
package/blog/zh/intlayer_with_i18next.md +4 -4
package/blog/zh/intlayer_with_next-i18next.md +4 -4
package/blog/zh/intlayer_with_next-intl.md +4 -4
package/blog/zh/intlayer_with_react-i18next.md +4 -4
package/blog/zh/intlayer_with_react-intl.md +4 -4
package/blog/zh/intlayer_with_vue-i18n.md +4 -4
package/docs/ar/intlayer_with_next-i18next.md +3 -3
package/docs/ar/intlayer_with_next-intl.md +3 -3
package/docs/ar/intlayer_with_react_router_v7.md +72 -16
package/docs/ar/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/de/intlayer_with_next-i18next.md +3 -3
package/docs/de/intlayer_with_next-intl.md +3 -3
package/docs/de/intlayer_with_react_router_v7.md +72 -15
package/docs/de/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/en/configuration.md +1 -0
package/docs/en/intlayer_with_next-i18next.md +3 -3
package/docs/en/intlayer_with_next-intl.md +3 -3
package/docs/en/intlayer_with_react_router_v7.md +74 -15
package/docs/en/intlayer_with_react_router_v7_fs_routes.md +98 -19
package/docs/en-GB/configuration.md +1 -0
package/docs/en-GB/intlayer_with_next-i18next.md +3 -3
package/docs/en-GB/intlayer_with_next-intl.md +3 -3
package/docs/en-GB/intlayer_with_react_router_v7.md +73 -16
package/docs/en-GB/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/es/intlayer_with_next-i18next.md +3 -3
package/docs/es/intlayer_with_next-intl.md +3 -3
package/docs/es/intlayer_with_react_router_v7.md +72 -15
package/docs/es/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/fr/intlayer_with_next-i18next.md +3 -3
package/docs/fr/intlayer_with_next-intl.md +3 -3
package/docs/fr/intlayer_with_react_router_v7.md +72 -15
package/docs/fr/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/hi/intlayer_with_next-i18next.md +3 -3
package/docs/hi/intlayer_with_next-intl.md +3 -3
package/docs/hi/intlayer_with_react_router_v7.md +72 -16
package/docs/hi/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/id/intlayer_with_next-i18next.md +3 -3
package/docs/id/intlayer_with_next-intl.md +3 -3
package/docs/id/intlayer_with_react_router_v7.md +72 -15
package/docs/id/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/it/intlayer_with_next-i18next.md +3 -3
package/docs/it/intlayer_with_next-intl.md +3 -3
package/docs/it/intlayer_with_react_router_v7.md +72 -15
package/docs/it/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/ja/intlayer_with_next-i18next.md +3 -3
package/docs/ja/intlayer_with_next-intl.md +3 -3
package/docs/ja/intlayer_with_react_router_v7.md +72 -15
package/docs/ja/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/ko/intlayer_with_next-i18next.md +3 -3
package/docs/ko/intlayer_with_next-intl.md +3 -3
package/docs/ko/intlayer_with_react_router_v7.md +72 -15
package/docs/ko/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/pl/intlayer_with_next-i18next.md +3 -3
package/docs/pl/intlayer_with_next-intl.md +3 -3
package/docs/pl/intlayer_with_react_router_v7.md +45 -13
package/docs/pl/intlayer_with_react_router_v7_fs_routes.md +94 -18
package/docs/pt/intlayer_with_next-i18next.md +3 -3
package/docs/pt/intlayer_with_next-intl.md +3 -3
package/docs/pt/intlayer_with_react_router_v7.md +79 -46
package/docs/pt/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/ru/intlayer_with_next-i18next.md +3 -3
package/docs/ru/intlayer_with_next-intl.md +3 -3
package/docs/ru/intlayer_with_react_router_v7.md +72 -15
package/docs/ru/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/tr/intlayer_with_next-i18next.md +3 -3
package/docs/tr/intlayer_with_next-intl.md +3 -3
package/docs/tr/intlayer_with_react_router_v7.md +72 -15
package/docs/tr/intlayer_with_react_router_v7_fs_routes.md +95 -19
package/docs/vi/intlayer_with_next-i18next.md +3 -3
package/docs/vi/intlayer_with_next-intl.md +3 -3
package/docs/vi/intlayer_with_react_router_v7.md +72 -15
package/docs/vi/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/docs/zh/intlayer_with_next-i18next.md +3 -3
package/docs/zh/intlayer_with_next-intl.md +3 -3
package/docs/zh/intlayer_with_react_router_v7.md +72 -15
package/docs/zh/intlayer_with_react_router_v7_fs_routes.md +2 -0
package/package.json +6 -6

package/docs/vi/intlayer_with_react_router_v7.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-04
-updatedAt: 2025-10-03
+updatedAt: 2025-12-27
 title: Cách dịch ứng dụng React Router v7 của bạn – hướng dẫn i18n 2025
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào ứng dụng React Router v7 của bạn bằng Intlayer. Theo dõi hướng dẫn toàn diện này để làm cho ứng dụng của bạn đa ngôn ngữ với định tuyến nhận biết locale.
 keywords:
@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-router-v7-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 7.5.6
+    date: 2025-12-27
+    changes: Cập nhật Layout và xử lý 404
   - version: 6.1.5
     date: 2025-10-03
     changes: Cập nhật tài liệu
@@ -181,10 +184,8 @@ Thiết lập cấu hình routing với các route nhận biết ngôn ngữ:
 import { layout, route, type RouteConfig } from "@react-router/dev/routes";
 export default [
-  layout("routes/layout.tsx", [
-    route("/:lang?", "routes/page.tsx"), // Trang chủ có hỗ trợ đa ngôn ngữ
-    route("/:lang?/about", "routes/about/page.tsx"), // Trang about có hỗ trợ đa ngôn ngữ
-  ]),
+  route("/:lang?", "routes/page.tsx"), // Trang chủ có hỗ trợ đa ngôn ngữ
+  route("/:lang?/about", "routes/about/page.tsx"), // Trang about có hỗ trợ đa ngôn ngữ
 ] satisfies RouteConfig;
 ```
@@ -194,19 +195,50 @@ Thiết lập root layout và các layout theo ngôn ngữ cụ thể:
 #### Root Layout
-```tsx fileName="app/routes/layout.tsx"
+```tsx fileName="app/root.tsx"
+import { getLocaleFromPath } from "intlayer";
 import { IntlayerProvider } from "react-intlayer";
-import { Outlet } from "react-router";
+import {
+  data,
+  Meta,
+  Scripts,
+  ScrollRestoration,
+  useLoaderData,
+} from "react-router";
+import type { Route } from "./+types/root";
-import type { Route } from "./+types/layout";
+// ... Unchanged App, links and ErrorBoundary code
-export default function RootLayout({ params }: Route.ComponentProps) {
-  const { locale } = params;
+export async function loader({ request }: Route.LoaderArgs) {
+  const locale = getLocaleFromPath(request.url);
+  if (!locale) {
+    throw data("Language not supported", { status: 404 });
+  }
+  return { locale };
+}
+export function Layout({
+  children,
+}: { children: React.ReactNode } & Route.ComponentProps) {
+  const data = useLoaderData<typeof loader>();
+  const { locale } = data ?? {};
   return (
-    <IntlayerProvider locale={locale}>
-      <Outlet />
-    </IntlayerProvider>
+    <html lang={locale}>
+      <head>
+        <meta charSet="utf-8" />
+        <meta content="width=device-width, initial-scale=1" name="viewport" />
+        <Meta />
+        <Links />
+      </head>
+      <body>
+        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>
+        <ScrollRestoration />
+        <Scripts />
+      </body>
+    </html>
   );
 }
 ```
@@ -318,9 +350,34 @@ Truy cập các từ điển nội dung của bạn trong toàn bộ ứng dụn
 #### Trang Chủ Đã Được Địa Phương Hóa
-```tsx fileName="app/routes/[lang]/page.tsx"
+```tsx fileName="app/routes/page.tsx"
+import { getIntlayer, validatePrefix } from "intlayer";
 import { useIntlayer } from "react-intlayer";
-import { LocalizedLink } from "~/components/localized-link";
+import { data } from "react-router";
+import { LocaleSwitcher } from "~/components/locale-switcher";
+import { Navbar } from "~/components/navbar";
+import type { Route } from "./+types/page";
+export const loader = ({ params }: Route.LoaderArgs) => {
+  const { locale } = params;
+  const { isValid } = validatePrefix(locale);
+  if (!isValid) {
+    throw data("Locale not supported", { status: 404 });
+  }
+};
+export const meta: Route.MetaFunction = ({ params }) => {
+  const content = getIntlayer("page", params.locale);
+  return [
+    { title: content.title },
+    { content: content.description, name: "description" },
+  ];
+};
 export default function Page() {
   const { title, description, aboutLink } = useIntlayer("page");

package/docs/vi/intlayer_with_react_router_v7_fs_routes.md CHANGED Viewed

@@ -32,6 +32,8 @@ history:
 Hướng dẫn này trình bày cách tích hợp **Intlayer** để thực hiện quốc tế hóa liền mạch trong các dự án React Router v7 với định tuyến nhận biết locale, hỗ trợ TypeScript và các thực hành phát triển hiện đại.
+Đối với định tuyến phía máy khách, hãy tham khảo hướng dẫn [Intlayer với React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_react_router_v7.md).
 ## Table of Contents
 <TOC/>

package/docs/zh/intlayer_with_next-i18next.md CHANGED Viewed

@@ -553,15 +553,15 @@ Intlayer 帮助你保持 JSON 翻译同步，测试缺失的键，并在需要
 安装 intlayer 依赖：
 ```bash packageManager="npm"
-npm install intlayer @intlayer/sync-json-plugin  -D
+npm install intlayer @intlayer/sync-json-plugin --save-dev
 ```
 ```bash packageManager="pnpm"
-pnpm add intlayer @intlayer/sync-json-plugin  -D
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
 ```
 ```bash packageManager="yarn"
-yarn add intlayer @intlayer/sync-json-plugin  -D
+yarn add intlayer @intlayer/sync-json-plugin --dev
 ```
 ```ts fileName="intlayer.config.ts"

package/docs/zh/intlayer_with_next-intl.md CHANGED Viewed

@@ -393,15 +393,15 @@ export const config = {
 安装 intlayer 依赖：
 ```bash packageManager="npm"
-npm install intlayer @intlayer/sync-json-plugin  -D
+npm install intlayer @intlayer/sync-json-plugin --save-dev
 ```
 ```bash packageManager="yarn"
-yarn add intlayer @intlayer/sync-json-plugin  -D
+yarn add intlayer @intlayer/sync-json-plugin --dev
 ```
 ```bash packageManager="pnpm"
-pnpm add intlayer @intlayer/sync-json-plugin  -D
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
 ```
 创建 intlayer 配置文件：

package/docs/zh/intlayer_with_react_router_v7.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-04
-updatedAt: 2025-10-03
+updatedAt: 2025-12-27
 title: 如何翻译您的React Router v7应用 – i18n指南 2025
 description: 学习如何使用 Intlayer 为您的 React Router v7 应用添加国际化（i18n）。按照本综合指南，使您的应用支持多语言和基于区域的路由。
 keywords:
@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-router-v7-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 7.5.6
+    date: 2025-12-27
+    changes: 更新布局和处理404
   - version: 6.1.5
     date: 2025-10-03
     changes: 更新文档
@@ -174,10 +177,8 @@ export default defineConfig({
 import { layout, route, type RouteConfig } from "@react-router/dev/routes";
 export default [
-  layout("routes/layout.tsx", [
-    route("/:lang?", "routes/page.tsx"), // 本地化主页
-    route("/:lang?/about", "routes/about/page.tsx"), // 本地化关于页面
-  ]),
+  route("/:lang?", "routes/page.tsx"), // 本地化主页
+  route("/:lang?/about", "routes/about/page.tsx"), // 本地化关于页面
 ] satisfies RouteConfig;
 ```
@@ -187,19 +188,50 @@ export default [
 #### 根布局
-```tsx fileName="app/routes/layout.tsx"
+```tsx fileName="app/root.tsx"
+import { getLocaleFromPath } from "intlayer";
 import { IntlayerProvider } from "react-intlayer";
-import { Outlet } from "react-router";
+import {
+  data,
+  Meta,
+  Scripts,
+  ScrollRestoration,
+  useLoaderData,
+} from "react-router";
+import type { Route } from "./+types/root";
-import type { Route } from "./+types/layout";
+// ... Unchanged App, links and ErrorBoundary code
-export default function RootLayout({ params }: Route.ComponentProps) {
-  const { locale } = params;
+export async function loader({ request }: Route.LoaderArgs) {
+  const locale = getLocaleFromPath(request.url);
+  if (!locale) {
+    throw data("Language not supported", { status: 404 });
+  }
+  return { locale };
+}
+export function Layout({
+  children,
+}: { children: React.ReactNode } & Route.ComponentProps) {
+  const data = useLoaderData<typeof loader>();
+  const { locale } = data ?? {};
   return (
-    <IntlayerProvider locale={locale}>
-      <Outlet />
-    </IntlayerProvider>
+    <html lang={locale}>
+      <head>
+        <meta charSet="utf-8" />
+        <meta content="width=device-width, initial-scale=1" name="viewport" />
+        <Meta />
+        <Links />
+      </head>
+      <body>
+        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>
+        <ScrollRestoration />
+        <Scripts />
+      </body>
+    </html>
   );
 }
 ```
@@ -311,9 +343,34 @@ export const useLocalizedNavigate = () => {
 #### 本地化主页
-```tsx fileName="app/routes/[lang]/page.tsx"
+```tsx fileName="app/routes/page.tsx"
+import { getIntlayer, validatePrefix } from "intlayer";
 import { useIntlayer } from "react-intlayer";
-import { LocalizedLink } from "~/components/localized-link";
+import { data } from "react-router";
+import { LocaleSwitcher } from "~/components/locale-switcher";
+import { Navbar } from "~/components/navbar";
+import type { Route } from "./+types/page";
+export const loader = ({ params }: Route.LoaderArgs) => {
+  const { locale } = params;
+  const { isValid } = validatePrefix(locale);
+  if (!isValid) {
+    throw data("Locale not supported", { status: 404 });
+  }
+};
+export const meta: Route.MetaFunction = ({ params }) => {
+  const content = getIntlayer("page", params.locale);
+  return [
+    { title: content.title },
+    { content: content.description, name: "description" },
+  ];
+};
 export default function Page() {
   const { title, description, aboutLink } = useIntlayer("page");

package/docs/zh/intlayer_with_react_router_v7_fs_routes.md CHANGED Viewed

@@ -32,6 +32,8 @@ history:
 本指南演示了如何在 React Router v7 项目中集成 **Intlayer**，实现无缝国际化，支持基于区域的路由、TypeScript 支持以及现代开发实践。
+对于客户端路由，请参阅 [Intlayer 与 React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_router_v7.md) 指南。
 ## Table of Contents
 <TOC/>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "7.5.6",
+  "version": "7.5.7",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,13 +73,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "7.5.6",
-    "@intlayer/core": "7.5.6",
-    "@intlayer/types": "7.5.6"
+    "@intlayer/config": "7.5.7",
+    "@intlayer/core": "7.5.7",
+    "@intlayer/types": "7.5.7"
   },
   "devDependencies": {
-    "@intlayer/api": "7.5.6",
-    "@intlayer/cli": "7.5.6",
+    "@intlayer/api": "7.5.7",
+    "@intlayer/cli": "7.5.7",
     "@types/node": "25.0.3",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",