このウェブサイトは、モダンな静的サイトジェネレーターであるDocusaurusを使用して構築されています。
$ pnpm install
$ pnpm start
このコマンドはローカル開発サーバーを起動し、ブラウザウィンドウを開きます。ほとんどの変更はサーバーを再起動することなくライブで反映されます。
$ pnpm build
このコマンドは静的コンテンツを build
ディレクトリに生成し、任意の静的コンテンツホスティングサービスを使用して配信することができます。
まず最初に、ターゲット言語にちなんで名付けられた新しいブランチを作成し、切り替えます。
git checkout -b new-locale
これにより、新しいローカリゼーション作業のためのブランチが作成され、切り替わります。
新しいロケールを追加するには、新しいロケールでDocusaurus設定ファイルを更新します。
const config = {
i18n: {
defaultLocale: 'en',
locales: ['en', 'new-locale'],
},
'new-lang': {
label: 'Language'
}
};
翻訳したい各ドキュメント、ページ、またはブログ投稿に対して、ターゲット言語のバージョンを作成します。これらのファイルをDocusaurusプロジェクトの i18n
フォルダ内の適切なディレクトリに配置します。例えば、ドキュメントのスペイン語翻訳を追加するには、翻訳ファイルを i18n/es/docusaurus-plugin-content-docs/current/your-doc.md
に配置します。
サイトのテーマやUIの一部であるラベル、ボタンなどの静的テキストの翻訳を追加するには、同じ i18n
ディレクトリを使用します。これらの翻訳は通常、ロケール es
用の i18n/es/code.json
ファイルに入れます。
ローカライズバージョンをテストするには、次のコマンドを実行します。
pnpm start --locale new-locale
プルリクエストを作成し、テストおよびレビューを待ちます。すべてが承認されると、マージされます。
git push origin new-language-branch
すべてのコミットメッセージは小文字で記述され、次の形式に従う必要があります:
- 言語
lang: changes
例: lang | ru: 説明を修正
- その他の変更
type of change | what was changed: changes
例: deps: 依存関係を更新