コンテンツへスキップ

はじめに

Lunaria はオープンソースプロジェクト向けの ローカライゼーション管理ツールチェーン であり、メンテナーやコントリビューターがスムーズかつ効率的なローカライゼーションワークフローを構築するために必要なツールを提供します。

なぜ Lunaria なのか?

メンテナーとして、ローカライゼーションの管理はこれまで常に困難でした。ローカライゼーションプラットフォームに移行することでコンテンツの所有権を譲り渡すか、変更の追跡が信頼できないまま諦めるか、というジレンマがありました。しかし今、それらの課題をすべて解決する新しいワークフローが登場しました。このワークフローは Git によって駆動されています。

選択されたファイルへのすべてのコミットは、ローカライゼーションダッシュボードの構築に利用され、各ファイルに対して「完了」「古くなった」「欠落している」といった状態を明確に表示します。ダッシュボードから、メンテナーはプロジェクト全体のローカライゼーション状況を詳細に把握できる一方で、コントリビューターは必要な情報(不足しているファイルへのリンク、古くなったコンテンツに追加すべきコミットリストなど)を迅速に得ることができ、効率的に支援できます。

クイックスタート

プロジェクトに追加する

既存のプロジェクトに Lunaria を追加するには、好みのパッケージマネージャーを使用して @lunariajs/core をプロジェクトの依存関係にインストールしてください:

ターミナルウィンドウ
npm install @lunariajs/core

その後、lunaria init を実行して Lunaria を設定します。いくつかの質問に答えるプロンプトが表示され、自動的に回答内容が新しい lunaria.config.json ファイルに反映されます:

ターミナルウィンドウ
npx lunaria init

プロジェクトの構造によっては、初期化時に lunaria sync が正常に実行された場合、最初のローカライゼーションダッシュボードを作成するためのすべての要件が揃っている可能性があります。

lunaria.config.jsonrepositorydefaultLocalelocales、または files フィールドのいずれかが欠けている場合、構成リファレンスガイド を参照して設定を行った後、以下の手順に従ってください。

最初のダッシュボードを作成する

ローカライゼーションダッシュボードを構築するには、lunaria init によって追加された lunaria:build スクリプトを実行します:

ターミナルウィンドウ
npm run lunaria:build

デフォルトでは、ローカライゼーションダッシュボードは ./dist/lunaria/ ディレクトリ内の index.html ファイルに生成されます。このファイルは任意のホスティングプラットフォームにデプロイでき、コントリビューター間で共有可能です。

ブラウザで確認する

ダッシュボードのビルド後、lunaria:preview を実行して http://localhost:3000/ でプレビューサーバーを起動できます:

ターミナルウィンドウ
npm run lunaria:preview

次のステップ

おめでとうございます!あなたのプロジェクトのローカライゼーションは、もうすべて Lunaria で完全に追跡されています! 🌛

Lunaria にはプロジェクトに最適な形にカスタマイズできる複数の機能が備わっています。以下は、次の読むべきページの一例です。順番は自由です: