インストールと最初の翻訳
最短手順
セクションタイトル “最短手順”- Lingui とフレームワーク用パッケージをインストールします。
- アプリが素の
.ts、.js、.tsx、.jsxで Lingui マクロを使うなら、unplugin-lingui-macroを追加します。 - フレームワーク用の統合またはプラグインを追加します。
- フレームワークパッケージの
defineConfigヘルパーを使って、lingui.config.jsまたはlingui.config.tsを作成します。 - フレームワーク用のエクストラクタを追加します。フレームワーク固有のオプションが必要なら、
framework.svelteまたはframework.astroに配置します。 - ページに
tまたはTransを 1 つ置きます。 - メッセージを増やす前に、まず 1 回だけ抽出とコンパイルを実行します。
まず適切な記述場所を選ぶ
セクションタイトル “まず適切な記述場所を選ぶ”.svelteではlingui-for-svelte/macroから始めます。.astroではlingui-for-astro/macroから始めます。- 素の JavaScript または TypeScript では
@lingui/core/macroとunplugin-lingui-macroから始めます。 詳しくは プレーンな JS/TS でのセットアップ を参照してください。
最初のメッセージの確認項目
セクションタイトル “最初のメッセージの確認項目”- ビルド時にマクロが消えていること
- メッセージがカタログへ抽出されていること
- 対象ロケールで翻訳結果が表示されること
この 3 つのどれかが失敗しているなら、ページを増やす前にその段階を先に調べてください。