@intlayer/docs 9.4.0-canary.0 → 9.4.1

package/docs/vi/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Hàm `getLocalizedPath` chuyển đổi một canonical path (đường dẫn nội bộ của ứng dụng) thành phiên bản đã được địa phương hóa dựa trên locale và các quy tắc rewrite được cung cấp. Hàm này đặc biệt hữu ích để tạo các URL thân thiện với SEO thay đổi theo ngôn ngữ.
 
+Đây là đối tác tương đối của [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocalizedUrl.md) — đối với input tương đối, cả hai đều trả về giá trị giống nhau. Không giống như `getLocalizedUrl`, nó không bao giờ trả về URL tuyệt đối: cấu hình `domains` bị bỏ qua, vì vậy một locale được phục vụ từ domain của nó vẫn tạo ra một đường dẫn. Input tuyệt đối được chấp nhận, nhưng nguồn gốc của nó bị loại bỏ — chỉ đường dẫn, chuỗi truy vấn và hash được giữ lại.
+
 **Tính năng chính:**
 
 - Hỗ trợ tham số route động bằng cú pháp `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Kiểu**: `string`
   - **Bắt buộc**: Có
 
-- `locale: Locales`
-  - **Mô tả**: Locale đích mà đường dẫn sẽ được nội địa hóa.
-  - **Kiểu**: `Locales`
-  - **Bắt buộc**: Có
-
 ### Tham số tùy chọn
 
+- `locale?: Locales`
+  - **Description**: Ngôn ngữ đích mà đường dẫn sẽ được địa phương hóa.
+  - **Type**: `Locales`
+  - **Default**: Ngôn ngữ mặc định của cấu hình dự án của bạn.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Mô tả**: Một đối tượng định nghĩa các quy tắc rewrite tùy chỉnh. Nếu không được cung cấp, nó mặc định là thuộc tính `routing.rewrite` từ cấu hình dự án của bạn.
   - **Kiểu**: `RoutingConfig['rewrite']`
   - **Mặc định**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — các locale được hỗ trợ. **Default**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — locale mặc định. **Default**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — cách locale xuất hiện trong đường dẫn. **Default**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — các quy tắc rewrite tùy chỉnh. **Default**: `configuration.routing.rewrite`
+
 ---
 
 ## Trả về
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Kiểu**: `string`
 - **Mô tả**: Đường dẫn đã được nội địa hóa cho locale được chỉ định.
 
+Kiểu được thu hẹp từ các quy tắc rewrite được khai báo trong cấu hình của bạn, vì vậy trình chỉnh sửa hiển thị đường dẫn đã được giải quyết thay vì một `string` đơn thuần:
+
+```typescript codeFormat="typescript"
+// Cấu hình: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (không có quy tắc rewrite nào khớp, chỉ áp dụng prefix)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Cùng một narrowing này chảy vào [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocalizedUrl.md), áp dụng các quy tắc rewrite trước khi thêm tiền tố locale.
+
+Hai trường hợp vẫn được mở rộng thành `string`, vì chúng không thể được giải quyết tại thời điểm biên dịch:
+
+- a path that is not a string literal (e.g. one built from a variable);
+- a path matched by a rule using a multi-segment or optional parameter (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Ví dụ sử dụng
@@ -126,8 +155,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Kết quả: "/contactez-nous"
 ```
 
----
-
 ### Bỏ qua Locale
 
 Khi không có locale nào được cung cấp, đường dẫn được bản địa hóa cho locale mặc định được cấu hình:

package/docs/vi/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### Tham số tùy chọn
 
+- `options?: object`
+  - **Description**: Đối tượng cấu hình cho hành vi localization của URL.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
 - `locales?: Locales[]`
   - **Mô tả**: Mảng các locale được hỗ trợ. Nếu không cung cấp, sẽ sử dụng các locale đã cấu hình trong cấu hình dự án của bạn.
   - **Kiểu**: `Locales[]`
@@ -112,38 +117,6 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Kết quả: "/about" hoặc "/en/about" (tùy thuộc vào thiết lập prefixDefault của bạn)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-// Cung cấp rõ ràng tất cả các tham số tùy chọn
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Kết quả: "/fr/about" cho locale tiếng Pháp
-// Kết quả: "/about" cho locale mặc định (tiếng Anh)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-// Cung cấp rõ ràng tất cả các tham số tùy chọn
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Kết quả: "/fr/about" cho locale tiếng Pháp
-// Kết quả: "/about" cho locale mặc định (tiếng Anh)
-```
-
 ### Advanced Usage (With Optional Parameters)
 
 You can override the default configuration by providing the optional `options` parameter:
@@ -245,6 +218,12 @@ getLocalizedUrl(
 - **Locale Không Hỗ Trợ:**
   - Đối với các locale không nằm trong danh sách `locales`, hàm sẽ không áp dụng tiền tố nào.
 
+- **Các chế độ định tuyến:**
+  - `'prefix-no-default'`: Locale mặc định không có tiền tố, những locale khác có (ví dụ: `/about`, `/fr/about`)
+  - `'prefix-all'`: Tất cả các locale đều có tiền tố (ví dụ: `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Không có tiền tố locale trong URL (locale được xử lý ở nơi khác)
+  - `'search-params'`: Locale được chỉ định qua tham số truy vấn (ví dụ: `/about?locale=fr`)
+
 ---
 
 ## Sử Dụng Trong Ứng Dụng

package/docs/vi/packages/intlayer/getMultilingualUrls.md

@@ -31,6 +31,14 @@ author: aymericzip
 
 Hàm `getMultilingualUrls` tạo ra một ánh xạ các URL đa ngôn ngữ bằng cách thêm tiền tố URL đã cho với mỗi ngôn ngữ được hỗ trợ. Hàm có thể xử lý cả URL tuyệt đối và tương đối, áp dụng tiền tố ngôn ngữ phù hợp dựa trên cấu hình được cung cấp hoặc mặc định.
 
+**Các Tính Năng Chính:**
+
+- Chỉ 1 tham số là bắt buộc: `url`
+- Object `options` tùy chọn với `locales`, `defaultLocale`, và `mode`
+- Sử dụng cấu hình quốc tế hóa của dự án của bạn làm mặc định
+- Hỗ trợ nhiều chế độ định tuyến: `prefix-no-default`, `prefix-all`, `no-prefix`, và `search-params`
+- Trả về một object ánh xạ với tất cả các locale làm khóa và các URL tương ứng của chúng làm giá trị
+
 ---
 
 ## Chữ Ký Hàm
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Các Chế Độ Định Tuyến Khác Nhau
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **Ngôn ngữ không được hỗ trợ:**
   - Chỉ những ngôn ngữ được cung cấp trong mảng `locales` mới được xem xét để tạo URL.
 
+- **Các Chế độ Định tuyến:**
+  - `'prefix-no-default'`: Ngôn ngữ mặc định không có tiền tố, các ngôn ngữ khác có (ví dụ: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Tất cả các ngôn ngữ đều có tiền tố (ví dụ: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Không có tiền tố ngôn ngữ trong URL (tất cả các ngôn ngữ trả về cùng một URL)
+  - `'search-params'`: Ngôn ngữ được chỉ định thông qua tham số truy vấn (ví dụ: `/dashboard?locale=fr`)
+
 ---
 
 ## Sử dụng trong các ứng dụng

package/docs/vi/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Hàm `getTranslationContent` lấy nội dung tương ứng với một locale cụ thể từ một tập hợp nội dung ngôn ngữ có thể tùy chỉnh. Nếu locale được chỉ định không được tìm thấy, hàm sẽ mặc định trả về nội dung của locale mặc định được cấu hình trong dự án.
 
+Để biết thêm chi tiết về cách khai báo translations, hãy xem [tài liệu Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/translation.md).
+
 ## Tham số
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/vi/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ Trong `next-intlayer`, locale hiện tại được quản lý thông qua các c
 
 #### Ví dụ:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## Lỗi Thường Gặp và Khắc Phục Sự Cố

package/docs/vi/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Hướng dẫn thiết lập các tệp khai báo nội dung có sẵn [tại đ
 
 Dưới đây là cách bạn có thể triển khai hook `useIntlayer` trong một trang Next.js để tải nội dung đa ngôn ngữ một cách động dựa trên locale hiện tại của ứng dụng:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

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

@@ -30,8 +30,6 @@ Phần này cung cấp hướng dẫn chi tiết về cách sử dụng hook `us
 
 ## Ví dụ sử dụng trong React
 
-Dưới đây là ví dụ về cách sử dụng hook `useDictionary` trong một component React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

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

@@ -77,6 +77,34 @@ Tất cả các khóa trong từ điển phải được khai báo trong các t
 
 Ví dụ về cách sử dụng hook `useI18n` trong các thành phần React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

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

@@ -31,48 +31,6 @@ Hook `useIntlayer` cho phép bạn truy xuất nội dung được bản địa
 
 ## Ví dụ sử dụng trong React
 
-Minh họa hook `useIntlayer` trong một component React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/vi/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Plugin Vite `intlayerPrune` được sử dụng để thực hiện tree-shaking và loại bỏ các từ điển không được sử dụng khỏi bundle ứng dụng của bạn. Điều này giúp giảm kích thước bundle cuối cùng bằng cách chỉ bao gồm nội dung đa ngôn ngữ cần thiết.
 
+> Plugin đã được bao gồm và cấu hình tự động khi bạn sử dụng [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayer.md). Bạn chỉ cần đăng ký nó theo cách thủ công nếu bạn đang soạn plugin stack của riêng mình.
+
 ## Cách sử dụng
 
 ### Như một phần của `intlayer()` (được khuyến nghị)

package/docs/vi/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.vi.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "vi", // Quan trọng
+  "content": {
+    "multilingualContent": "Tiêu đề của thành phần của tôi",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Khuyến nghị: Định dạng này là tốt nhất khi sử dụng trình chỉnh sửa trực quan của Intlayer hoặc quản lý bản dịch trực tiếp trong mã.
 
+> Lưu ý: Trong cả hai trường hợp, tệp khai báo nội dung phải tuân theo mẫu đặt tên `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` để được Intlayer nhận diện. Hậu tố `.[locale]` là tùy chọn và chỉ được sử dụng như một quy ước đặt tên.
+
 ### Cấu hình toàn cầu cho các tệp theo từng Locale
 
 Bạn có thể cấu hình cấu hình toàn cầu cho các tệp theo từng locale bằng cách thêm nội dung sau vào tệp `intlayer.config.ts` của bạn:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Quan trọng
-  "content": {
-    "multilingualContent": "Tiêu đề của thành phần của tôi",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Quan trọng: Hãy chắc chắn rằng trường locale được định nghĩa. Nó cho Intlayer biết ngôn ngữ mà file đại diện.
 
-> Lưu ý: Trong cả hai trường hợp, file khai báo nội dung phải tuân theo mẫu đặt tên `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` để được Intlayer nhận diện. Phần hậu tố `.[locale]` là tùy chọn và chỉ được sử dụng như một quy ước đặt tên.
-
 ## Kết hợp các định dạng
 
 Bạn có thể kết hợp cả hai cách khai báo cho cùng một khóa nội dung. Ví dụ:

package/docs/vi/readme.md

@@ -225,8 +225,8 @@ Khám phá tài liệu toàn diện của chúng tôi để bắt đầu với I
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Khám phá tài liệu toàn diện của chúng tôi để bắt đầu với I
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/vi/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer có thể chạy hoàn toàn trên hạ tầng của riêng bạn — không yêu cầu tài khoản Intlayer Cloud. Chỉ một lệnh duy nhất sẽ khởi động một stack sẵn sàng cho production:
 
+Một lệnh cài đặt mọi thứ:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Trình cài đặt sẽ tải xuống `docker-compose.yml` và `.env`, tự động tạo các secret cần thiết, và khởi động tất cả các container với `docker compose up -d`.
 
+Sự phụ thuộc duy nhất bên ngoài là **MongoDB**: backend kết nối với một cluster **Atlas** MongoDB mà bạn cung cấp. Mọi thứ khác chạy bên trong container.
+
 ## Mục lục
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (được sử dụng để tạo ảnh chụp màn hình Puppeteer) đ
 - Các cổng `3000`, `3100`, `8025`, `9000`, và `9001` phải khả dụng trên host.
 - Host chạy Linux hoặc macOS (hoặc WSL2 trên Windows).
 
+Mọi thứ khác — Bun, Redis, MinIO, Chromium — đều được đóng gói trong image.
+
 ---
 
 ## Bắt đầu nhanh
 
-Pull và chạy image được công bố, cung cấp thông tin xác thực và bí mật MongoDB Atlas của bạn:
+### 1. Chạy trình cài đặt
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Nó xác minh Docker đã được cài đặt và đang chạy, ghi `./intlayer.env` với `BETTER_AUTH_SECRET` và `S3_SECRET_ACCESS_KEY` đã được tạo sẵn, và kéo image. Nó không khởi động container — backend không thể khởi động mà không có thông tin đăng nhập cơ sở dữ liệu của bạn.
+
+Chạy lại trình cài đặt là an toàn: một `intlayer.env` hiện có sẽ không bao giờ bị ghi đè, vì vậy nó cũng đóng vai trò là đường dâng cập nhật.
+
+### 2. Điền thông tin đăng nhập của bạn
+
+Mở `intlayer.env` và hoàn thành các giá trị được đánh dấu `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Tệp này cũng chứa các khối được comment cho các tính năng tùy chọn — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, và các nhà cung cấp OAuth. Bỏ comment những tính năng bạn cần.
+
+> Tệp được đọc bởi `docker run --env-file`, tệp này không loại bỏ dấu ngoặc kép và xem mọi thứ sau `=` là giá trị. Viết các giá trị không có dấu ngoặc kép, và giữ các comment trên các dòng riêng biệt.
+
+### 3. Khởi động container
+
+Đây là lệnh mà trình cài đặt in ra khi hoàn thành:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Sau đó mở **http://localhost:3000**.
+Sau đó mở **http://localhost:3000**. Lần khởi động đầu tiên sẽ khởi tạo các datastores, vì vậy hãy chờ một phút.
 
-> Dashboard được phục vụ trên `localhost`. Xem [Limitations](#limitations) — các miền tùy chỉnh không được hỗ trợ bởi image được công bố.
+> Dashboard được phục vụ trên `localhost`. Xem [Limitations](#limitations) — các custom domains không được hỗ trợ bởi image được công bố.
 
----
+### Cài đặt Installer
 
-## Bắt đầu nhanh
+Installer đọc một số biến môi trường. Vì nó được pipe vào `sh`, hãy truyền chúng cho shell thay vì cho `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                      |
+| ------------------------- | --------------------------------------------- | -------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image để pull                    |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Nơi ghi file env                 |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Tên container                    |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume mounted tại `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Host port cho dashboard          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Host port cho API                |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Host port cho MinIO S3 API       |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Host port cho MinIO console      |
+
+> Bốn biến port chỉ thay đổi phía **host** của mapping được in trong lệnh `docker run`. Image được công bố có `http://localhost:3000`, `http://localhost:3100` và `http://localhost:9000` được biên dịch vào dashboard bundle tại thời điểm build, vì vậy việc ánh xạ lại chúng làm cho trình duyệt chỉ đến các port cũ. Giữ các giá trị mặc định trừ khi bạn đang xây dựng image của riêng mình — xem [Limitations](#limitations).
+
+---
+
+## Bắt đầu nhanh
+
 Những gì trình cài đặt thực hiện:
 
 1.  Kiểm tra xem `docker` và `docker compose` có tồn tại không.
@@ -117,8 +163,6 @@ Sau khi stack hoạt động, mở **http://localhost:3000** và tạo tài kho
 | **minio**   | `minio/minio`                              | `9000` (S3), `9001` (console)  | Lưu trữ đối tượng tương thích S3 cho avatar và ảnh chụp màn hình |
 | **mailpit** | `axllent/mailpit`                          | `1025` (SMTP), `8025` (web UI) | Nơi nhận email giao dịch cục bộ                                  |
 
-Các cổng nội bộ (mongo, redis) không được phơi bày ra host theo mặc định.
-
 > Cổng MinIO `9000` phải có thể truy cập được bởi trình duyệt vì các tài sản được tải lên (avatars, ảnh chụp màn hình) được tải trực tiếp từ `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Các cổng nội bộ (mongo, redis) không được phơi bày ra host theo m
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Đăng nhập LinkedIn OAuth                                       |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Đăng nhập Atlassian OAuth                                      |
 
----
-
 ### Mailer toàn cầu
 
 Theo mặc định, tất cả các email giao dịch được gửi qua Resend sử dụng `RESEND_API_KEY`. Các triển khai tự lưu trữ có thể thay vào đó định tuyến **mọi** email — bao gồm các email không thuộc tổ chức như đặt lại mật khẩu và liên kết ma thuật — qua một mailer toàn cầu được định cấu hình bằng các biến môi trường.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Nâng cấp
 
-Chạy lại trình cài đặt trên một triển khai hiện có sẽ thực hiện nâng cấp cuốn chiếu (rolling upgrade):
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Thao tác này sẽ kéo các image mới nhất và khởi động lại các container với `docker compose pull && docker compose up -d`. Các volume hiện có (`mongo-data`, `redis-data`, `minio-data`) được bảo toàn — không mất dữ liệu.
 
-Để nâng cấp thủ công từ bên trong thư mục `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Tìm kiếm `MongoDB connection error` gần phía trên của log.
+
 ### Dashboard không thể kết nối tới API
 
 Xác minh rằng `VITE_BACKEND_URL` khớp với URL mà backend có thể truy cập được từ **trình duyệt** (không phải mạng Docker). Nếu bạn đã thay đổi cổng backend hoặc thêm reverse proxy, hãy build lại image dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Thiếu MinIO bucket
 
 Nếu dịch vụ một lần chạy `minio-init` không chạy (hoặc chạy trước khi MinIO sẵn sàng), hãy tạo bucket thủ công: