@intlayer/docs 8.4.10 → 8.5.1

package/docs/vi/intlayer_with_vite+vue.md

@@ -431,14 +431,14 @@ module.exports = appContent;
 
 ```javascript fileName=main.js
 import { createApp } from "vue";
-import { installIntlayer } from "vue-intlayer";
+import { intlayer } from "vue-intlayer";
 import App from "./App.vue";
 import "./style.css";
 
 const app = createApp(App);
 
 // Tiêm provider ở cấp cao nhất
-installIntlayer(app);
+app.use(intlayer);
 
 // Gắn ứng dụng
 app.mount("#app");
@@ -619,7 +619,7 @@ import {
   localeFlatMap,
   type Locale,
 } from 'intlayer';
-import { createIntlayerClient } from 'vue-intlayer';
+import { createIntlayerClient } from "vue-intlayer";
 import { createRouter, createWebHistory } from 'vue-router';
 import HomeView from './views/home/HomeView.vue';
 import RootView from './views/root/Root.vue';
@@ -709,7 +709,11 @@ import { intlayer, intlayerProxy } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -720,7 +724,11 @@ import { intlayer, intlayerProxy } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -731,7 +739,11 @@ const { intlayer, intlayerProxy } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -1001,7 +1013,7 @@ import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";
 
 const app = createApp(App);
 
-installIntlayer(app);
+app.use(intlayer);
 
 const md = new MarkdownIt({
   html: true, // cho phép thẻ HTML

package/docs/vi/packages/react-intlayer/MarkdownRenderer.md

@@ -28,7 +28,7 @@ Component `MarkdownRenderer` hiển thị nội dung markdown bằng các compon
 ## Sử dụng
 
 ```tsx
-import { MarkdownRenderer } from "react-intlayer";
+import { MarkdownRenderer } from "react-intlayer/markdown";
 
 const MyComponent = () => (
   <MarkdownRenderer># My Title My content</MarkdownRenderer>

package/docs/vi/packages/svelte-intlayer/useRewriteURL.md

@@ -29,7 +29,7 @@ Gọi hook bên trong một component Svelte.
 
 ```svelte
 <script>
-  import { useRewriteURL } from 'svelte-intlayer';
+  import { useRewriteURL } from "svelte-intlayer";
 
   // Tự động sửa /fr/tests thành /fr/essais trên thanh địa chỉ nếu tồn tại quy tắc rewrite
   useRewriteURL();

package/docs/vi/releases/v8.md

@@ -69,7 +69,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { MarkdownRenderer } from "react-intlayer";
+    import { MarkdownRenderer } from "react-intlayer/markdown";
 
     <MarkdownRenderer
       forceBlock={true}
@@ -84,7 +84,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useMarkdownRenderer } from "react-intlayer";
+    import { useMarkdownRenderer } from "react-intlayer/markdown";
 
     const renderMarkdown = useMarkdownRenderer({
       components: {
@@ -98,7 +98,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderMarkdown } from "react-intlayer";
+    import { renderMarkdown } from "react-intlayer/markdown";
 
     const html = renderMarkdown("# My Title", {
       forceBlock: true
@@ -112,7 +112,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```vue
     <script setup>
-    import { MarkdownRenderer } from "vue-intlayer";
+    import { MarkdownRenderer } from "vue-intlayer/markdown";
     </script>
 
     <template>
@@ -127,7 +127,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { MarkdownRenderer } from "svelte-intlayer";
+      import { MarkdownRenderer } from "svelte-intlayer/markdown";
     </script>
 
     <MarkdownRenderer forceBlock={true} value="# My Title" />
@@ -137,7 +137,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { useMarkdownRenderer } from "svelte-intlayer";
+      import { useMarkdownRenderer } from "svelte-intlayer/markdown";
       const render = useMarkdownRenderer();
     </script>
 
@@ -148,7 +148,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { renderMarkdown } from "svelte-intlayer";
+      import { renderMarkdown } from "svelte-intlayer/markdown";
     </script>
 
     {@html renderMarkdown("# My Title")}
@@ -179,7 +179,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { MarkdownRenderer } from "solid-intlayer";
+    import { MarkdownRenderer } from "solid-intlayer/markdown";
 
     <MarkdownRenderer forceBlock={true}>
       {"# My Title"}
@@ -189,7 +189,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useMarkdownRenderer } from "solid-intlayer";
+    import { useMarkdownRenderer } from "solid-intlayer/markdown";
 
     const render = useMarkdownRenderer();
 
@@ -199,7 +199,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderMarkdown } from "solid-intlayer";
+    import { renderMarkdown } from "solid-intlayer/markdown";
 
     return <div>{renderMarkdown("# My Title")}</div>;
     ```
@@ -210,7 +210,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { MarkdownRenderer } from "preact-intlayer";
+    import { MarkdownRenderer } from "preact-intlayer/markdown";
 
     <MarkdownRenderer forceBlock={true}>
       {"# My Title"}
@@ -220,7 +220,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useMarkdownRenderer } from "preact-intlayer";
+    import { useMarkdownRenderer } from "preact-intlayer/markdown";
 
     const render = useMarkdownRenderer();
 
@@ -230,7 +230,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderMarkdown } from "preact-intlayer";
+    import { renderMarkdown } from "preact-intlayer/markdown";
 
     return <div>{renderMarkdown("# My Title")}</div>;
     ```
@@ -246,7 +246,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { HTMLRenderer } from "react-intlayer";
+    import { HTMLRenderer } from "react-intlayer/html";
 
     <HTMLRenderer
       components={{
@@ -260,7 +260,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useHTMLRenderer } from "react-intlayer";
+    import { useHTMLRenderer } from "react-intlayer/html";
 
     const renderHTML = useHTMLRenderer({
       components: {
@@ -274,7 +274,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderHTML } from "react-intlayer";
+    import { renderHTML } from "react-intlayer/html";
 
     const html = renderHTML("<p>Hello World</p>");
     ```
@@ -286,7 +286,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```vue
     <script setup>
-    import { HTMLRenderer } from "vue-intlayer";
+    import { HTMLRenderer } from "vue-intlayer/html";
     </script>
 
     <template>
@@ -301,7 +301,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { HTMLRenderer } from "svelte-intlayer";
+      import { HTMLRenderer } from "svelte-intlayer/html";
     </script>
 
     <HTMLRenderer value="<p>Hello World</p>" />
@@ -311,7 +311,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { useHTMLRenderer } from "svelte-intlayer";
+      import { useHTMLRenderer } from "svelte-intlayer/html";
       const render = useHTMLRenderer();
     </script>
 
@@ -322,7 +322,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
     ```svelte
     <script>
-      import { renderHTML } from "svelte-intlayer";
+      import { renderHTML } from "svelte-intlayer/html";
     </script>
 
     {@html renderHTML("<p>Hello World</p>")}
@@ -345,7 +345,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { HTMLRenderer } from "solid-intlayer";
+    import { HTMLRenderer } from "solid-intlayer/html";
 
     <HTMLRenderer>
       {"<p>Hello World</p>"}
@@ -355,7 +355,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useHTMLRenderer } from "solid-intlayer";
+    import { useHTMLRenderer } from "solid-intlayer/html";
 
     const render = useHTMLRenderer();
 
@@ -365,7 +365,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderHTML } from "solid-intlayer";
+    import { renderHTML } from "solid-intlayer/html";
 
     return <div>{renderHTML("<p>Hello World</p>")}</div>;
     ```
@@ -376,7 +376,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **1. Sử dụng Thành phần (Component):**
 
     ```tsx
-    import { HTMLRenderer } from "preact-intlayer";
+    import { HTMLRenderer } from "preact-intlayer/html";
 
     <HTMLRenderer>
       {"<p>Hello World</p>"}
@@ -386,7 +386,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **2. Sử dụng Hook:**
 
     ```tsx
-    import { useHTMLRenderer } from "preact-intlayer";
+    import { useHTMLRenderer } from "preact-intlayer/html";
 
     const render = useHTMLRenderer();
 
@@ -396,7 +396,7 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
     **3. Sử dụng Hàm tiện ích:**
 
     ```tsx
-    import { renderHTML } from "preact-intlayer";
+    import { renderHTML } from "preact-intlayer/html";
 
     return <div>{renderHTML("<p>Hello World</p>")}</div>;
     ```
@@ -1032,7 +1032,7 @@ Intlayer v8 bao gồm một lớp cache mới cho trình biên dịch Markdown v
    
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
-    import {intlayer, intlayerCompiler} from 'vite-intlayer';
+    import { intlayer, intlayerCompiler } from "vite-intlayer";
 
     export default defineConfig({
       plugins: [intlayer(), intlayerCompiler()],

package/docs/zh/compiler.md

@@ -207,8 +207,11 @@ const config: IntlayerConfig = {
     output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * 指示转换后是否应保存组件。
-     * 这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     * 指示在转换后是否应保存组件。
+     *
+     * - 如果为 `true`，编译器将重写磁盘中的组件文件。因此转换将是永久性的，编译器将跳过下一次进程的转换。这样，编译器可以在转换应用后被移除。
+     *
+     * - 如果为 `false`，编译器仅在构建输出中将 `useIntlayer()` 函数调用注入代码中，并保持基础代码库不变。转换将仅在内存中进行。
      */
     saveComponents: false,
 
@@ -286,7 +289,9 @@ export default config;
 - **saveComponents**:
   - _类型_: `boolean`
   - _默认值_: `false`
-  - _描述_: 指示转换后是否应保存组件。
+  - _描述_: 指示在转换后是否应保存组件。
+    - 如果为 `true`，编译器将重写磁盘中的组件文件。转换将是永久性的，编译器随后可以被移除。
+    - 如果为 `false`，编译器仅在构建输出中将 `useIntlayer()` 函数调用注入代码中，并保持基础代码库不变。转换将仅在内存中进行。
 
 ### 填充缺失的翻译
 

package/docs/zh/configuration.md

@@ -518,7 +518,10 @@ const config: IntlayerConfig = {
 
     /**
      * 转换组件后是否保存它们。
-     * 这样，可以运行一次编译器来转换应用程序，然后将其删除。
+     *
+     * - 如果为 `true`，编译器将重写磁盘中的组件文件。因此转换将是永久性的，编译器将跳过下一次进程的转换。这样，编译器可以在转换应用后被移除。
+     *
+     * - 如果为 `false`，编译器仅在构建输出中将 `useIntlayer()` 函数调用注入代码中，并保持基础代码库不变。转换将仅在内存中进行。
      */
     saveComponents: false,