Ajukan pertanyaan Anda dan dapatkan ringkasan dokumen dengan merujuk halaman ini dan penyedia AI pilihan Anda
Riwayat Versi
- "Perbarui penggunaan API useIntlayer Solid ke akses properti langsung"v8.9.04/5/2026
- "Tambahkan perintah init"v7.5.930/12/2025
- "Memperkenalkan validatePrefix dan menambah langkah 14: Menangani halaman 404 dengan rute terlokalisasi."v7.4.011/12/2025
- "Menambah langkah 13: Mengambil locale di server actions Anda (Opsional)"v7.3.95/12/2025
- "Menambah langkah 13: Adaptasi Nitro"v7.2.318/11/2025
- "Memperbaiki default prefix dengan menambahkan fungsi getPrefix, gunakan useLocalizedNavigate, LocaleSwitcher dan LocalizedLink."v7.1.017/11/2025
- "Perbarui dokumen"v6.5.23/10/2025
- "Ditambahkan untuk TanStack Start"v5.8.19/9/2025
Konten halaman ini diterjemahkan menggunakan AI.
Lihat versi terakhir dari konten aslinya dalam bahasa InggrisIf you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.
GitHub link to the documentationCopy doc Markdown to clipboard
Terjemahkan situs web TanStack Start Anda menggunakan Intlayer | Internasionalisasi (i18n)
Daftar Isi
Panduan ini mendemonstrasikan cara mengintegrasikan Intlayer untuk internasionalisasi yang mulus dalam proyek TanStack Start dengan routing yang mendukung locale, dukungan TypeScript, dan praktik pengembangan modern.
Mengapa Intlayer dibandingkan alternatif?
Dibandingkan dengan solusi utama seperti react-i18next atau use-intl, atau paraglide, Intlayer adalah solusi yang hadir dengan pengoptimalan terintegrasi seperti:
Intlayer sepenuhnya dioptimalkan untuk TanStack Start, menyediakan perutean multibahasa, manajemen cookie, pembuatan peta situs, pemuatan konten dinamis, dan semua fitur yang diperlukan untuk meningkatkan upaya internasionalisasi Anda (i18n).
Daripada memuat file JSON berukuran besar ke halaman Anda, muat saja konten yang diperlukan. Intlayer membantu mengurangi ukuran bundle dan halaman Anda hingga 50%.
Mencakup konten aplikasi Anda memfasilitasi pemeliharaan untuk aplikasi berskala besar. Anda dapat menduplikasi atau menghapus satu folder fitur tanpa beban mental untuk meninjau seluruh basis kode konten Anda. Selain itu, Intlayer diketik sepenuhnya untuk memastikan keakuratan konten Anda.
Menempatkan konten bersama mengurangi konteks yang diperlukan dengan Model Bahasa Besar (LLM). Intlayer juga dilengkapi dengan serangkaian alat, seperti CLI untuk menguji terjemahan yang hilang,LSP, MCP, dan agent skill, untuk menjadikan pengalaman pengembang (DX) lebih lancar bagi agen AI.
Gunakan otomatisasi untuk menerjemahkan dalam saluran CI/CD Anda menggunakan LLM pilihan Anda dengan biaya penyedia AI Anda. Intlayer juga menawarkan compiler untuk mengotomatiskan ekstraksi konten, serta platform web untuk membantu menerjemahkan di latar belakang.
Menghubungkan file JSON berukuran besar ke komponen dapat menyebabkan masalah kinerja dan reaktivitas. Intlayer mengoptimalkan pemuatan konten Anda pada waktu pembuatan.
Lebih dari sekedar solusi i18n, Intlayer menyediakan editor visual yang dihosting sendiri dan CMS lengkap untuk membantu Anda mengelola konten multibahasa secara real-time, membuat kolaborasi dengan penerjemah, copywriter, dan anggota tim lainnya menjadi lancar. Konten dapat disimpan secara lokal dan/atau jarak jauh.
Panduan Langkah-demi-Langkah untuk Mengatur Intlayer dalam Aplikasi TanStack Start
Lihat Template Aplikasi di GitHub.
Buat Proyek
Mulailah dengan membuat proyek TanStack Start baru dengan mengikuti panduan Memulai proyek baru di situs web TanStack Start.
Pasang Paket Intlayer
Pasang paket yang diperlukan menggunakan manajer paket pilihan Anda:
bashSalin kodeSalin kode ke clipboard
npm install intlayer react-intlayernpm install vite-intlayer --save-devnpx intlayer initintlayer
Paket inti yang menyediakan alat internasionalisasi untuk manajemen konfigurasi, terjemahan, deklarasi konten, transpiler, dan perintah CLI.
react-intlayer Paket yang mengintegrasikan Intlayer dengan aplikasi React. Ini menyediakan context provider dan hook untuk internasionalisasi React.
vite-intlayer Termasuk plugin Vite untuk mengintegrasikan Intlayer dengan Vite bundler, serta middleware untuk mendeteksi locale yang disukai pengguna, mengelola cookie, dan menangani pengalihan URL.
Konfigurasi proyek Anda
Buat file konfigurasi untuk mengonfigurasi bahasa aplikasi Anda:
intlayer.config.tsSalin kodeSalin kode ke clipboard
import type { IntlayerConfig } from "intlayer";import { Locales } from "intlayer";const config: IntlayerConfig = { internationalization: { defaultLocale: Locales.ENGLISH, locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], },};export default config;Melalui file konfigurasi ini, Anda dapat mengatur URL yang dilokalkan, pengalihan middleware, nama cookie, lokasi dan ekstensi deklarasi konten Anda, menonaktifkan log Intlayer di konsol, dan banyak lagi. Untuk daftar lengkap parameter yang tersedia, lihat dokumentasi konfigurasi.
Integrasikan Intlayer dalam Konfigurasi Vite Anda
Tambahkan plugin intlayer ke dalam konfigurasi Anda:
vite.config.tsSalin kodeSalin kode ke clipboard
import { tanstackStart } from "@tanstack/react-start/plugin/vite";import viteReact from "@vitejs/plugin-react";import { nitro } from "nitro/vite";import { defineConfig } from "vite";import { intlayer } from "vite-intlayer";const config = defineConfig({ plugins: [ nitro(), intlayer(), tanstackStart({ router: { routeFileIgnorePattern: ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$", }, }), viteReact(), ],});export default config;Plugin Vite
intlayer()digunakan untuk mengintegrasikan Intlayer dengan Vite. Ini memastikan pembuatan file deklarasi konten dan memantaunya dalam mode pengembangan. Plugin ini mendefinisikan variabel lingkungan Intlayer di dalam aplikasi Vite. Selain itu, ini menyediakan alias untuk mengoptimalkan kinerja.Buat Layout Root
Konfigurasikan layout root Anda untuk mendukung internasionalisasi dengan menggunakan
useParamsuntuk mendeteksi locale saat ini dan mengatur atributlangdandirpada taghtml.src/routes/__root.tsxSalin kodeSalin kode ke clipboard
import { createRootRouteWithContext, HeadContent, Scripts,} from "@tanstack/react-router";import { defaultLocale, getHTMLTextDir } from "intlayer";import { type ReactNode } from "react";import { IntlayerProvider } from "react-intlayer";import { Route as LocaleRoute } from "./{-$locale}/route";export const Route = createRootRouteWithContext<{}>()({ head: () => ({ meta: [ { charSet: "utf-8", }, { content: "width=device-width, initial-scale=1", name: "viewport", }, { title: "TanStack Start Starter", }, ], }), shellComponent: RootDocument,});function RootDocument({ children }: { children: ReactNode }) { const params = LocaleRoute.useParams(); const locale = params?.locale ?? defaultLocale; return ( <html dir={getHTMLTextDir(locale)} lang={locale}> <head> <HeadContent /> </head> <body> <IntlayerProvider locale={locale}>{children}</IntlayerProvider> <Scripts /> </body> </html> );}Jika Anda ingin menggunakan konten Anda dalam atribut
string, sepertialt,title,href,aria-label, dll., Anda harus memanggil nilai fungsi tersebut, seperti:htmlSalin kodeSalin kode ke clipboard
<img src="{content.image.src.value}" alt="{content.image.value}" /><img src="{content.image.src.toString()}" alt="{content.image.toString()}" /><img src="{String(content.image.src)}" alt="{String(content.image)}" />Buat Layout Locale
Buat layout yang menangani awalan locale dan melakukan validasi.
src/routes/{-$locale}/route.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";import { validatePrefix } from "intlayer";export const Route = createFileRoute("/{-$locale}")({ beforeLoad: ({ params }) => { const localeParam = params.locale; // Validasi awalan locale const { isValid, localePrefix } = validatePrefix(localeParam); if (!isValid) { throw redirect({ to: "/{-$locale}/404", params: { locale: localePrefix }, }); } }, component: Outlet,});Di sini,
{-$locale}adalah parameter rute dinamis yang digantikan dengan locale saat ini. Notasi ini membuat slot bersifat opsional, memungkinkannya bekerja dengan mode perutean seperti'prefix-no-default'dll.Sadari bahwa slot ini dapat menyebabkan masalah jika Anda menggunakan beberapa segmen dinamis dalam rute yang sama (misalnya,
/{-$locale}/other-path/$anotherDynamicPath/...). Untuk mode'prefix-all', Anda mungkin lebih suka mengganti slot menjadi$localesebagai gantinya. Untuk mode'no-prefix'atau'search-params', Anda dapat menghapus slot sepenuhnya.Deklarasikan Konten Anda
Buat dan kelola deklarasi konten Anda untuk menyimpan terjemahan:
src/contents/page.content.tsSalin kodeSalin kode ke clipboard
import type { Dictionary } from "intlayer";import { t } from "intlayer";const appContent = { content: { links: { about: t({ en: "About", es: "Acerca de", fr: "À propos", }), home: t({ en: "Home", es: "Inicio", fr: "Accueil", }), }, meta: { title: t({ en: "Welcome to Intlayer + TanStack Router", es: "Bienvenido a Intlayer + TanStack Router", fr: "Bienvenue à Intlayer + TanStack Router", }), description: t({ en: "This is an example of using Intlayer with TanStack Router", es: "Este es un ejemplo de uso de Intlayer con TanStack Router", fr: "Ceci est un exemple d'utilisation d'Intlayer dengan TanStack Router", }), }, }, key: "app",} satisfies Dictionary;export default appContent;Deklarasi konten Anda dapat ditentukan di mana saja dalam aplikasi Anda segera setelah mereka dimasukkan ke dalam direktori
contentDir(secara default,./app). Dan cocok dengan ekstensi file deklarasi konten (secara default,.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}).Untuk detail lebih lanjut, lihat dokumentasi deklarasi konten.
Buat Komponen dan Hook yang Menyadari Locale
Buat komponen
LocalizedLinkuntuk navigasi yang menyadari locale:src/components/localized-link.tsxSalin kodeSalin kode ke clipboard
import type { FC } from "react";import { Link, type LinkComponentProps } from "@tanstack/react-router";import { useLocale } from "react-intlayer";import { getPrefix } from "intlayer";export const LOCALE_ROUTE = "{-$locale}" as const;export type To = StripLocalePrefix<LinkComponentProps["to"]>;export type StripLocalePrefix<T extends string | undefined> = T extends | `/${typeof LOCALE_ROUTE}/` | `/${typeof LOCALE_ROUTE}` ? "/" : T extends `/${typeof LOCALE_ROUTE}/${infer Rest}` ? `/${Rest}` : T;type LocalizedLinkProps = { to?: To;} & Omit<LinkComponentProps, "to">;export const LocalizedLink: FC<LocalizedLinkProps> = (props) => { const { locale } = useLocale(); const { localePrefix } = getPrefix(locale); return ( <Link {...props} params={{ locale: localePrefix, ...(typeof props?.params === "object" ? props?.params : {}), }} to={`/${LOCALE_ROUTE}${props.to}` as LinkComponentProps["to"]} /> );};Komponen ini memiliki dua tujuan:
- Menghapus awalan
{-$locale}yang tidak perlu dari URL. - Menyuntikkan parameter locale ke dalam URL untuk memastikan pengguna langsung diarahkan ke rute yang terlokalisasi.
Kemudian kita dapat membuat hook
useLocalizedNavigateuntuk navigasi secara terprogram:src/hooks/useLocalizedNavigate.tsxSalin kodeSalin kode ke clipboard
import { useNavigate } from "@tanstack/react-router";import { getPrefix } from "intlayer";import { useLocale } from "react-intlayer";import type { StripLocalePrefix } from "@/components/localized-link";import type { FileRouteTypes } from "@/routeTree.gen";type NavigateFn = ReturnType<typeof useNavigate>;type BaseNavigateOptions = Parameters<NavigateFn>[0];type LocalizedTo = StripLocalePrefix<FileRouteTypes["to"]>;export type LocalizedNavigateOptions = Omit< BaseNavigateOptions, "to" | "params"> & { to: LocalizedTo; params?: Omit<NonNullable<BaseNavigateOptions["params"]>, "locale">;};type LocalizedNavigate = ( options: LocalizedNavigateOptions) => ReturnType<NavigateFn>;export const useLocalizedNavigate = () => { const navigate = useNavigate(); const { locale } = useLocale(); const localizedNavigate: LocalizedNavigate = (args: any) => { const { localePrefix } = getPrefix(locale); if (typeof args === "string") { return navigate({ to: `/${LOCALE_ROUTE}${args}`, params: { locale: localePrefix }, }); } const { to, ...rest } = args; const localizedTo = `/${LOCALE_ROUTE}${to}` as any; return navigate({ to: localizedTo, params: { locale: localePrefix, ...rest } as any, }); }; return localizedNavigate;};- Menghapus awalan
Manfaatkan Intlayer di Halaman Anda
Akses kamus konten Anda di seluruh aplikasi Anda:
Halaman Beranda yang Terlokalisasi
src/routes/{-$locale}/index.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute } from "@tanstack/react-router";import { getIntlayer } from "intlayer";import { useIntlayer } from "react-intlayer";import LocaleSwitcher from "@/components/locale-switcher";import { LocalizedLink } from "@/components/localized-link";import { useLocalizedNavigate } from "@/hooks/useLocalizedNavigate";export const Route = createFileRoute("/{-$locale}/")({ component: RouteComponent,});function RouteComponent() { const content = useIntlayer("app"); const navigate = useLocalizedNavigate(); return ( <div> <div> {content.title} <LocaleSwitcher /> <div> <LocalizedLink to="/">{content.links.home}</LocalizedLink> <LocalizedLink to="/about">{content.links.about}</LocalizedLink> </div> <div> <button onClick={() => navigate({ to: "/" })}> {content.links.home} </button> <button onClick={() => navigate({ to: "/about" })}> {content.links.about} </button> </div> </div> </div> );}Untuk mempelajari lebih lanjut tentang hook
useIntlayer, lihat dokumentasi.Buat Komponen Locale Switcher
Buat komponen untuk memungkinkan pengguna mengganti bahasa:
src/components/locale-switcher.tsxSalin kodeSalin kode ke clipboard
import { useLocation } from "@tanstack/react-router";import { getHTMLTextDir, getLocaleName, getPathWithoutLocale, getPrefix, Locales,} from "intlayer";import type { FC } from "react";import { useLocale } from "react-intlayer";import { LocalizedLink, type To } from "./localized-link";export const LocaleSwitcher: FC = () => { const { pathname } = useLocation(); const { availableLocales, locale, setLocale } = useLocale(); const pathWithoutLocale = getPathWithoutLocale(pathname); return ( <ol> {availableLocales.map((localeEl) => ( <li key={localeEl}> <LocalizedLink aria-current={localeEl === locale ? "page" : undefined} onClick={() => setLocale(localeEl)} params={{ locale: getPrefix(localeEl).localePrefix }} to={pathWithoutLocale as To} > <span> {/* Locale - misalnya FR */} {localeEl} </span> <span> {/* Bahasa dalam Locale-nya sendiri - misalnya Français */} {getLocaleName(localeEl, locale)} </span> <span dir={getHTMLTextDir(localeEl)} lang={localeEl}> {/* Bahasa dalam Locale saat ini - misalnya Francés dengan locale saat ini diatur ke Locales.SPANISH */} {getLocaleName(localeEl)} </span> <span dir="ltr" lang={Locales.ENGLISH}> {/* Bahasa dalam bahasa Inggris - misalnya French */} {getLocaleName(localeEl, Locales.ENGLISH)} </span> </LocalizedLink> </li> ))} </ol> );};Untuk mempelajari lebih lanjut tentang hook
useLocale, lihat dokumentasi.Manajemen Atribut HTML
Seperti yang terlihat pada Langkah 5, Anda dapat mengelola atribut
langdandirdari taghtmlmenggunakanuseParamsdi komponen root Anda. Ini memastikan bahwa atribut yang benar diatur pada server dan klien.src/routes/__root.tsxSalin kodeSalin kode ke clipboard
function RootDocument({ children }: { children: ReactNode }) { const params = LocaleRoute.useParams(); const locale = params?.locale ?? defaultLocale; return ( <html dir={getHTMLTextDir(locale)} lang={locale}> {/* ... */} </html> );}Tambahkan middleware
Anda juga dapat menggunakan
intlayerProxyuntuk menambahkan routing sisi server ke aplikasi Anda. Plugin ini akan secara otomatis mendeteksi locale saat ini berdasarkan URL dan mengatur cookie locale yang sesuai. Jika tidak ada locale yang ditentukan, plugin akan menentukan locale yang paling sesuai berdasarkan preferensi bahasa browser pengguna. Jika tidak ada locale yang terdeteksi, itu akan dialihkan ke locale default.Perhatikan bahwa untuk menggunakan
intlayerProxydi produksi, Anda perlu mengganti paketvite-intlayerdaridevDependencieskedependencies.vite.config.tsSalin kodeSalin kode ke clipboard
import { tanstackStart } from "@tanstack/react-start/plugin/vite";import viteReact from "@vitejs/plugin-react";import { nitro } from "nitro/vite";import { defineConfig } from "vite";import { intlayer, intlayerProxy } from "vite-intlayer";export default defineConfig({ plugins: [ intlayerProxy(), // Proxy harus ditempatkan sebelum server jika Anda menggunakan Nitro nitro(), intlayer(), tanstackStart({ router: { routeFileIgnorePattern: ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$", }, }), viteReact(), ],});Internasionalisasi Metadata Anda
Anda juga dapat menggunakan hook
getIntlayeruntuk mengakses kamus konten Anda di seluruh aplikasi Anda:src/routes/{-$locale}/index.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute } from "@tanstack/react-router";import { getIntlayer } from "intlayer";export const Route = createFileRoute("/{-$locale}/")({ component: RouteComponent, head: ({ params }) => { const { locale } = params; const path = "/"; // The path for this route const metaContent = getIntlayer("app", locale); return { links: [ // Canonical link: Points to the current localized page { rel: "canonical", href: getLocalizedUrl(path, locale) }, // Hreflang: Tell Google about all localized versions ...localeMap(({ locale: mapLocale }) => ({ rel: "alternate", hrefLang: mapLocale, href: getLocalizedUrl(path, mapLocale), })), // x-default: For users in unmatched languages // Define the default fallback locale (usually your primary language) { rel: "alternate", hrefLang: "x-default", href: getLocalizedUrl(path, defaultLocale), }, ], meta: [ { title: metaContent.title }, { name: "description", content: metaContent.meta.description }, ], }; },});Ambil locale dalam server actions Anda
Anda mungkin ingin mengakses locale saat ini dari dalam server actions atau endpoint API Anda. Anda dapat melakukannya menggunakan pembantu
getLocaledariintlayer.Berikut adalah contoh menggunakan fungsi server TanStack Start:
src/routes/{-$locale}/index.tsxSalin kodeSalin kode ke clipboard
import { createServerFn } from "@tanstack/react-start";import { getRequestHeader, getRequestHeaders,} from "@tanstack/react-start/server";import { getCookie, getIntlayer, getLocale } from "intlayer";export const getLocaleServer = createServerFn().handler(async () => { const locale = await getLocale({ // Dapatkan cookie dari permintaan (default: 'INTLAYER_LOCALE') getCookie: (name) => { const cookieString = getRequestHeader("cookie"); return getCookie(name, cookieString); }, // Dapatkan header dari permintaan (default: 'x-intlayer-locale') // Fallback menggunakan negosiasi Accept-Language getHeader: (name) => getRequestHeader(name), }); // Ambil beberapa konten menggunakan getIntlayer() const content = getIntlayer("app", locale); return { locale, content };});Kelola halaman tidak ditemukan
Ketika seorang pengguna mengunjungi halaman yang tidak ada, Anda dapat menampilkan halaman tidak ditemukan yang disesuaikan dan awalan locale dapat mempengaruhi cara halaman tidak ditemukan dipicu.
Memahami Penanganan 404 TanStack Router dengan Awalan Locale
Di TanStack Router, menangani halaman 404 dengan rute yang dilokalisasi memerlukan pendekatan berlapis:
- Rute 404 khusus: Rute khusus untuk menampilkan UI 404
- Validasi tingkat rute: Memvalidasi awalan locale dan mengalihkan yang tidak valid ke 404
- Rute catch-all: Menangkap setiap jalur yang tidak cocok dalam segmen locale
src/routes/{-$locale}/404.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute } from "@tanstack/react-router";// Ini membuat rute /[locale]/404 khusus// Ini digunakan baik sebagai rute langsung maupun diimpor sebagai komponen di file lainexport const Route = createFileRoute("/{-$locale}/404")({ component: NotFoundComponent,});// Diekspor secara terpisah sehingga dapat digunakan kembali dalam notFoundComponent dan rute catch-allexport function NotFoundComponent() { return ( <div> <h1>404</h1> </div> );}src/routes/{-$locale}/route.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";import { validatePrefix } from "intlayer";import { NotFoundComponent } from "./404";export const Route = createFileRoute("/{-$locale}")({ // beforeLoad berjalan sebelum rute merender (di server maupun klien) // Ini adalah tempat yang ideal untuk memvalidasi awalan locale beforeLoad: ({ params }) => { const localeParam = params.locale; // validatePrefix memeriksa apakah locale valid sesuai dengan konfigurasi intlayer Anda const { isValid, localePrefix } = validatePrefix(localeParam); if (!isValid) { // Awalan locale tidak valid - alihkan ke halaman 404 dengan awalan locale yang valid throw redirect({ to: "/{-$locale}/404", params: { locale: localePrefix }, }); } }, component: Outlet, // notFoundComponent dipanggil ketika rute anak tidak ada // misal, /en/non-existent-page memicu ini dalam layout /en notFoundComponent: NotFoundComponent,});src/routes/{-$locale}/$.tsxSalin kodeSalin kode ke clipboard
import { createFileRoute } from "@tanstack/react-router";import { NotFoundComponent } from "./404";// Rute $ (splat/catch-all) cocok dengan jalur mana pun yang tidak cocok dengan rute lain// misal, /en/some/deeply/nested/invalid/path// Ini memastikan SEMUA jalur yang tidak cocok dalam suatu locale menampilkan halaman 404// Tanpa ini, jalur dalam yang tidak cocok mungkin menampilkan halaman kosong atau kesalahanexport const Route = createFileRoute("/{-$locale}/$")({ component: NotFoundComponent,});Konfigurasi TypeScript
Intlayer menggunakan augmentasi modul untuk mendapatkan manfaat TypeScript dan membuat basis kode Anda lebih kuat.
Pastikan konfigurasi TypeScript Anda menyertakan tipe yang dihasilkan secara otomatis:
tsconfig.jsonSalin kodeSalin kode ke clipboard
{ // ... konfigurasi yang ada include: [ // ... include yang ada ".intlayer/**/*.ts", // Sertakan tipe yang dihasilkan otomatis ],}Ekstrak konten komponen Anda
OpsionalJika Anda memiliki basis kode yang ada, mengubah ribuan file bisa memakan waktu lama.
Untuk memudahkan proses ini, Intlayer mengusulkan compiler / extractor untuk mengubah komponen Anda dan mengekstrak kontennya.
Untuk mengaturnya, Anda dapat menambahkan bagian
compilerdi fileintlayer.config.tsAnda:intlayer.config.tsSalin kodeSalin kode ke clipboard
import { type IntlayerConfig } from "intlayer"; const config: IntlayerConfig = { // ... Sisa konfigurasi Anda compiler: { /** * Menunjukkan apakah compiler harus diaktifkan. */ enabled: true, /** * Menentukan jalur file output */ output: ({ fileName, extension }) => `./${fileName}${extension}`, /** * Menunjukkan apakah komponen harus disimpan setelah diubah. Dengan begitu, compiler dapat dijalankan satu kali saja untuk mengubah aplikasi, lalu dapat dihapus. */ saveComponents: false, /** * Prefiks kunci kamus */ dictionaryKeyPrefix: "", }, }; export default config;Jalankan extractor untuk mengubah komponen Anda dan mengekstrak kontennya
bashSalin kodeSalin kode ke clipboard
npx intlayer extract
Konfigurasi Git
Disarankan untuk mengabaikan file yang dihasilkan oleh Intlayer. Ini memungkinkan Anda menghindari melakukan commit ke repositori Git Anda.
Untuk melakukan ini, Anda dapat menambahkan instruksi berikut ke file .gitignore Anda:
Salin kode ke clipboard
# Abaikan file yang dihasilkan oleh Intlayer.intlayerEkstensi VS Code
Untuk meningkatkan pengalaman pengembangan Anda dengan Intlayer, Anda dapat menginstal Ekstensi VS Code Intlayer resmi.
Instal dari VS Code Marketplace
Ekstensi ini menyediakan:
- Autocompletion untuk kunci terjemahan.
- Deteksi kesalahan waktu nyata untuk terjemahan yang hilang.
- Pratinjau inline dari konten yang diterjemahkan.
- Tindakan cepat untuk dengan mudah membuat dan memperbarui terjemahan.
Untuk detail lebih lanjut tentang cara menggunakan ekstensi, lihat dokumentasi Ekstensi VS Code Intlayer.
Melangkah Lebih Jauh
Untuk melangkah lebih jauh, Anda dapat mengimplementasikan editor visual atau mengeksternalisasi konten Anda menggunakan CMS.