Đặt câu hỏi và nhận tóm tắt tài liệu bằng cách tham chiếu trang này và nhà cung cấp AI bạn chọn
Lịch sử phiên bản
- "Cập nhật cách sử dụng API useIntlayer của Solid sang truy cập thuộc tính trực tiếp"v8.9.04/5/2026
- "Thêm lệnh init"v7.5.930/12/2025
- "Cập nhật tích hợp Astro, cấu hình và cách sử dụng"v6.2.03/10/2025
Nội dung của trang này đã được dịch bằng AI.
Xem phiên bản mới nhất của nội dung gốc bằng tiếng AnhNếu bạn có ý tưởng để cải thiện tài liệu này, vui lòng đóng góp bằng cách gửi pull request trên GitHub.
Liên kết GitHub tới tài liệuSao chép Markdown của tài liệu vào bộ nhớ tạm
Dịch trang web Astro của bạn với Intlayer | Đa ngôn ngữ (i18n)
Mục lục
Intlayer là gì?
Intlayer là một thư viện đa ngôn ngữ (i18n) mã nguồn mở sáng tạo được thiết kế để đơn giản hóa việc hỗ trợ nhiều ngôn ngữ trong các ứng dụng web hiện đại.
Với Intlayer, bạn có thể:
- Quản lý bản dịch dễ dàng: Sử dụng các từ điển khai báo ở cấp độ thành phần.
- Bản địa hóa động các metadata, route và nội dung.
- Đảm bảo hỗ trợ TypeScript: Với các kiểu dữ liệu được tạo tự động để tự động hoàn thành và phát hiện lỗi tốt hơn.
- Tận dụng các tính năng nâng cao: Như phát hiện ngôn ngữ động và chuyển đổi ngôn ngữ.
Hướng dẫn từng bước để cấu hình Intlayer trong Astro
Xem mẫu ứng dụng trên GitHub.
Bước 1: Cài đặt các phụ thuộc
Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
npm install intlayer astro-intlayer# tùy chọn: nếu bạn muốn thêm hỗ trợ React islandsnpm install react react-dom react-intlayer @astrojs/reactintlayer Gói cốt lõi cung cấp các công cụ i18n để quản lý cấu hình, bản dịch, khai báo nội dung, chuyển mã và các lệnh CLI.
astro-intlayer Plugin tích hợp Astro để kết nối Intlayer với trình đóng gói Vite; nó cũng bao gồm middleware để phát hiện ngôn ngữ ưa thích của người dùng, quản lý cookie và xử lý chuyển hướng URL.
Bước 2: Cấu hình dự án của bạn
Tạo một file cấu hình để xác định các ngôn ngữ của ứng dụng:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = { internationalization: { locales: [ Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH, Locales.VIETNAMESE, // Các ngôn ngữ khác của bạn ], defaultLocale: Locales.ENGLISH, },};export default config;Thông qua file cấu hình này, bạn có thể thiết lập các URL bản địa hóa, chuyển hướng middleware, tên cookie, vị trí và phần mở rộng của các khai báo nội dung, tắt log Intlayer trong console, v.v. Để biết danh sách đầy đủ các tham số có sẵn, hãy xem tài liệu cấu hình.
Bước 3: Tích hợp Intlayer vào cấu hình Astro của bạn
Thêm plugin intlayer vào cấu hình Astro của bạn.
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
// @ts-checkimport { intlayer } from "astro-intlayer";import { defineConfig } from "astro/config";// https://astro.build/configexport default defineConfig({ integrations: [intlayer()],});Plugin tích hợp intlayer() được sử dụng để tích hợp Intlayer với Astro. Nó đảm bảo việc tạo các file khai báo nội dung và theo dõi chúng trong chế độ phát triển. Nó xác định các biến môi trường Intlayer bên trong ứng dụng Astro và cung cấp các alias để tối ưu hóa hiệu suất.
Bước 4: Khai báo nội dung của bạn
Tạo và quản lý các khai báo nội dung của bạn để lưu trữ các bản dịch:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
import { t, type Dictionary } from "intlayer";import type { ReactNode } from "react";const appContent = { key: "app", content: { title: t({ en: "Hello World", fr: "Bonjour le monde", es: "Hola mundo", vi: "Xin chào thế giới", }), },} satisfies Dictionary;export default appContent;Các khai báo nội dung có thể được định nghĩa ở bất kỳ đâu trong ứng dụng của bạn, miễn là chúng nằm trongcontentDir(mặc định là./src) và khớp với phần mở rộng của file khai báo nội dung (mặc định là.content.{json,ts,tsx,js,jsx,mjs,cjs}).
Để biết thêm thông tin, hãy xem tài liệu khai báo nội dung.
Bước 5: Sử dụng nội dung trong Astro
Bạn có thể sử dụng các từ điển trực tiếp trong các file .astro bằng cách sử dụng các hàm hỗ trợ cốt lõi được xuất từ intlayer.
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
---import { getIntlayer, getLocaleFromPath, getLocalizedUrl, defaultLocale, localeMap, getHTMLTextDir, type LocalesValues,} from "intlayer";import LocaleSwitcher from "../components/LocaleSwitcher.astro";// Get the current locale from the URL (e.g. /es/about -> 'es')const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;// Get the content for the 'app' dictionaryconst { title } = getIntlayer("app", locale);---<!doctype html><html lang={locale} dir={getHTMLTextDir(locale)}> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width" /> <link rel="icon" type="image/svg+xml" href="/favicon.svg" /> <title>{title}</title> <!-- Canonical link: Tells search engines which is the primary version of this page --> <link rel="canonical" href={new URL(getLocalizedUrl(Astro.url.pathname, locale), Astro.site)} /> <!-- Hreflang: Tell Google about all localized versions --> { localeMap(({ locale: mapLocale }) => ( <link rel="alternate" hreflang={mapLocale} href={new URL( getLocalizedUrl(Astro.url.pathname, mapLocale), Astro.site )} /> )) } <!-- x-default: Fallback for users in unmatched languages --> <link rel="alternate" hreflang="x-default" href={new URL( getLocalizedUrl(Astro.url.pathname, defaultLocale), Astro.site )} /> </head> <body> <header> <LocaleSwitcher /> </header> <main> <h1>{title}</h1> </main> </body></html>Bước 6: Định tuyến bản địa hóa
Tạo các đoạn route động (ví dụ: src/pages/[locale]/index.astro) để phục vụ các trang bản địa hóa:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
---import { getIntlayer } from "intlayer";const { title } = getIntlayer('app');---<h1>{title}</h1>Tích hợp Astro thêm middleware Vite giúp định tuyến nhận biết ngôn ngữ và định nghĩa môi trường trong quá trình phát triển. Bạn cũng có thể sử dụng logic của riêng mình hoặc các công cụ intlayer như getLocalizedUrl để liên kết giữa các ngôn ngữ.
Bước 7: Tiếp tục sử dụng Framework yêu thích của bạn
Tiếp tục xây dựng ứng dụng của bạn bằng cách sử dụng framework mà bạn chọn.
- Intlayer + React: Intlayer với React
- Intlayer + Vue: Intlayer với Vue
- Intlayer + Svelte: Intlayer với Svelte
- Intlayer + Solid: Intlayer với Solid
- Intlayer + Preact: Intlayer với Preact
Cấu hình TypeScript
Intlayer sử dụng cơ chế mở rộng module (module augmentation) để tận dụng TypeScript, làm cho cơ sở mã của bạn mạnh mẽ hơn.
Đảm bảo cấu hình TypeScript của bạn bao gồm các kiểu dữ liệu được tạo tự động.
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
{ // ... cấu hình TypeScript hiện tại của bạn "include": [ // ... cấu hình TypeScript hiện tại của bạn ".intlayer/**/*.ts", // Bao gồm các kiểu dữ liệu được tạo tự động ],}Cấu hình Git
Khuyên bạn nên bỏ qua các file được tạo bởi Intlayer. Điều này ngăn chúng được commit vào kho lưu trữ Git của bạn.
Để làm điều đó, hãy thêm các hướng dẫn sau vào file .gitignore của bạn:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
# Bỏ qua các file được tạo bởi Intlayer.intlayerTiện ích mở rộng VS Code
Để cải thiện trải nghiệm phát triển của bạn với Intlayer, bạn có thể cài đặt tiện ích mở rộng Intlayer chính thức cho VS Code.
Cài đặt từ VS Code Marketplace
Tiện ích này sẽ cung cấp:
- Tự động hoàn thành cho các khóa dịch.
- Phát hiện lỗi thời gian thực cho các bản dịch còn thiếu.
- Xem trước trực tiếp nội dung đã dịch.
- Các hành động nhanh để tạo và cập nhật bản dịch dễ dàng.
Để biết thêm thông tin về cách sử dụng tiện ích này, hãy xem tài liệu tiện ích VS Code.
(Tùy chọn) Bước 1 : Trích xuất nội dung các thành phần của bạn
Nếu bạn có một cơ sở mã hiện có, việc chuyển đổi hàng nghìn tệp có thể tốn nhiều thời gian.
Để đơn giản hóa quy trình này, Intlayer đề xuất một trình biên dịch / trình trích xuất để chuyển đổi các thành phần của bạn và trích xuất nội dung.
Để thiết lập, bạn có thể thêm phần compiler vào tệp intlayer.config.ts của mình:
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
import { type IntlayerConfig } from "intlayer";
const config: IntlayerConfig = {
// ... Phần còn lại của cấu hình
compiler: {
/**
* Cho biết trình biên dịch có nên được bật hay không.
*/
enabled: true,
/**
* Xác định đường dẫn các tệp đầu ra
*/
output: ({ fileName, extension }) => `./${fileName}${extension}`,
/**
* Cho biết các thành phần có nên được lưu sau khi chuyển đổi hay không. Bằng cách đó, trình biên dịch có thể được chạy chỉ một lần để chuyển đổi ứng dụng, sau đó có thể được gỡ bỏ.
*/
saveComponents: false,
/**
* Tiền tố khóa từ điển
*/
dictionaryKeyPrefix: "",
},
};
export default config;Chạy trình trích xuất để chuyển đổi các thành phần và trích xuất nội dung
Sao chép đoạn mã vào khay nhớ tạm (clipboard)
npx intlayer extractTìm hiểu sâu hơn
Nếu bạn muốn tìm hiểu thêm, bạn cũng có thể triển khai Visual Editor hoặc sử dụng CMS để quản lý nội dung bên ngoài.