<p>Godot Engineで翻訳機能を使う上で、よくあるのはCSVだけど<strong>poファイル</strong>を使ってやってみます。</p>
<h2 id="%E3%81%BE%E3%81%9A%E3%81%AF%E7%92%B0%E5%A2%83%E3%81%8C%E5%BF%85%E8%A6%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%9A%E3%81%AF%E7%92%B0%E5%A2%83%E3%81%8C%E5%BF%85%E8%A6%81" aria-hidden="true"></a> まずは環境が必要</h2>
<ol>
<li>pipのインストール</li>
<li>gettextのインストール</li>
<li>pybabelのインストール</li>
<li>PoEditのインストール</li>
</ol>
<p>めっちゃインストールしますが、気にせず進めます。<br>
pipのインストールはPythonの環境なので割愛します。</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p>ほぼ<a href="https://docs.godotengine.org/ja/stable/tutorials/i18n/localization_using_gettext.html" target="_blank" rel="nofollow noopener noreferrer">公式ドキュメントのgettextを使ったローカライズ</a>ページの内容です。</p>
</div></aside>
<h2 id="%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99">
<a class="header-anchor-link" href="#%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99" aria-hidden="true"></a> 事前準備</h2>
<p>プロジェクトフォルダのサブフォルダとして<code>res:Resource/Translation</code>というフォルダを作成しました。<br>
この中で作業します。</p>
<p>エクスプローラーのパスの部分で<code>cmd</code>と入力してEnterを押すと、そのパスに移動した状態でコマンドプロンプトが立ち上がります。</p>
<h2 id="gettext%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#gettext%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> gettextのインストール</h2>
<p>Windowsでは<a href="https://mlocati.github.io/articles/gettext-iconv-windows.html" target="_blank" rel="nofollow noopener noreferrer">こちら</a>からダウンロード・インストールします。<br>
後でいろいろ使います。</p>
<h2 id="pybabel%EF%BC%88%EF%BC%86babel-godot%EF%BC%89%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#pybabel%EF%BC%88%EF%BC%86babel-godot%EF%BC%89%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> pybabel（＆babel-godot）のインストール</h2>
<div class="code-block-container"><pre><code>pip3 install babel babel-godot
</code></pre></div><p><code>pip</code>が実行できればこれでインストールは終わります。</p>
<h3 id="%E6%A4%9C%E7%B4%A2%E7%94%A8%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%AE%9A%E7%BE%A9">
<a class="header-anchor-link" href="#%E6%A4%9C%E7%B4%A2%E7%94%A8%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%AE%9A%E7%BE%A9" aria-hidden="true"></a> 検索用のファイル定義</h3>
<p>公式ドキュメントでは<code>babelrc</code>として定義されていますが、<code>pybabel</code>でプロジェクトから翻訳対象の文言を検索するのに使う定義ファイルです。</p>
<div class="code-block-container"><pre><code>[python: **.gd]
encoding = utf-8

[godot_scene: **.tscn]
encoding = utf-8
</code></pre></div><p>ファイル名は<code>babelrc</code>として、拡張子はないテキストデータにしました。<br>
これで、スクリプト内と、シーン内に書かれた内容を検索対象に含めました。</p>
<h3 id="pot%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%EF%BC%88%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%EF%BC%89%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#pot%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%EF%BC%88%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%EF%BC%89%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> potファイル（テンプレート）の作成</h3>
<div class="code-block-container"><pre><code>pybabel extract -F babelrc -k text -k LineEdit/placeholder_text -k tr -o godot-l10n.pot .
</code></pre></div><p>このままだとパスを指定していないので抽出されないですが、基本的なテンプレートだけできます。</p>
<h2 id="po%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#po%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> poファイルの作成</h2>
<div class="code-block-container"><pre><code>msginit --no-translator --input=godot-l10n.pot --locale=ja
</code></pre></div><p>まずは日本語の翻訳データとして<code>ja.po</code>を作ります。<br>
翻訳データというか、<strong>キーの割り当て確認ためのデータにします。</strong></p>
<h3 id="%E3%83%90%E3%83%83%E3%83%81%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#%E3%83%90%E3%83%83%E3%83%81%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> バッチファイルの作成</h3>
<div class="code-block-container"><pre><code>pybabel extract --input-dirs ..\..\ -F babelrc -k text -k LineEdit/placeholder_text -k tr -o godot-l10n.pot
msgmerge --update --backup=none ja.po godot-l10n.pot
pause
</code></pre></div><p><code>--input-dirs</code>で抽出対象ディレクトリを指定して、後はプロジェクト内の<code>text</code>で指定しているものなどを翻訳対象として抽出します。<br>
そして、抽出されたデータを、先程作った<code>ja.po</code>にマージします。</p>
<h2 id="poedit%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#poedit%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> PoEditをインストール</h2>
<p>インストールしたら関連付けされるので<code>ja.po</code>を開きます。</p>
<h3 id="%E6%96%87%E5%AD%97%E3%82%A8%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89%E8%A8%AD%E5%AE%9A%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E6%96%87%E5%AD%97%E3%82%A8%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89%E8%A8%AD%E5%AE%9A%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B" aria-hidden="true"></a> 文字エンコード設定を変更する</h3>
<p><code>翻訳＞プロパティ</code>のウィンドウから<code>文字符号化法</code>をUTF-8に変更します。<br>
変更しないとGodotで読み込んだ時にエラーが出ます。</p>
<h3 id="mo%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AF%E4%B8%8D%E8%A6%81%E3%81%AA%E3%81%AE%E3%81%A7%E5%87%BA%E5%8A%9B%E3%81%97%E3%81%AA%E3%81%84%E3%82%88%E3%81%86%E3%81%AB%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#mo%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AF%E4%B8%8D%E8%A6%81%E3%81%AA%E3%81%AE%E3%81%A7%E5%87%BA%E5%8A%9B%E3%81%97%E3%81%AA%E3%81%84%E3%82%88%E3%81%86%E3%81%AB%E3%81%99%E3%82%8B" aria-hidden="true"></a> moファイルは不要なので出力しないようにする</h3>
<p><code>ファイル＞設定</code>のウィンドウから<code>一般タブ＞編集＞保存する際にMOファイルを自動コンパイル</code>のチェックを外します。</p>
<h2 id="godot-engine%E3%81%A7po%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%82%80">
<a class="header-anchor-link" href="#godot-engine%E3%81%A7po%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%82%80" aria-hidden="true"></a> Godot Engineでpoファイルを読み込む</h2>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--NswYcOku--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/53a04dc831c197a01e84648a.png%3Fsha%3Dffec39b15a3a26eb6a9dbea493b69cf8834296fd" alt loading="lazy" class="md-img"><br>
<code>プロジェクト＞プロジェクト設定</code>から<code>ローカライズタブ&gt;翻訳タブ&gt;追加</code>で、作った<code>ja.po</code>を読み込みます。</p>
<h3 id="%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E5%86%85%E3%81%AE%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E8%AA%BF%E6%95%B4">
<a class="header-anchor-link" href="#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E5%86%85%E3%81%AE%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E8%AA%BF%E6%95%B4" aria-hidden="true"></a> プロジェクト内のテキストの調整</h3>
<p><strong>そのまま日本語文字を入れておいたら勝手に翻訳してくれるのが楽</strong>だとは思いますが、色々不都合が出るので、プロジェクト内のテキストにはキーを入れるようにしています。</p>
<div class="code-block-container"><pre class="language-python"><code class="language-python">func _ready<span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">:</span>
	footer<span class="token punctuation">.</span>set_key_help<span class="token punctuation">(</span>tr<span class="token punctuation">(</span><span class="token string">"_KEY_System_Accept"</span><span class="token punctuation">)</span><span class="token punctuation">,</span> load<span class="token punctuation">(</span><span class="token string">"res://Resources/Textures/PadButtonA.png"</span><span class="token punctuation">)</span><span class="token punctuation">)</span>
	footer<span class="token punctuation">.</span>set_key_help<span class="token punctuation">(</span>tr<span class="token punctuation">(</span><span class="token string">"_KEY_System_Back"</span><span class="token punctuation">)</span><span class="token punctuation">,</span> load<span class="token punctuation">(</span><span class="token string">"res://Resources/Textures/PadButtonB.png"</span><span class="token punctuation">)</span><span class="token punctuation">)</span>
</code></pre></div><p><code>tr()</code>で指定した文字は抽出対象担っているので、<code>_KEY_System_Accept</code>は<code>決定</code>という文字になります。</p>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--Z6ppbT7---/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/d15c67115d5ab48b243f00cb.png%3Fsha%3D0f13ffa9778db3e68bf650673c7343ae50693c6b" alt loading="lazy" class="md-img"></p>
<p>そのまま日本語を翻訳対象にすると、例えば色々なところで使っている<strong>ニュアンスの違う「戻る」という文言が同じキーとみなされて分けるのに面倒くさいことになります。</strong></p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> おわりに</h2>
<p>プロジェクトで何かを変更した際に、バッチファイルを実行するとプロジェクトでの変更が翻訳ファイルにマージされます。<br>
poファイルが更新されると、<code>PoEdit</code>を立ち上げていても自動更新してくれますので、編集も便利ですね。</p>
<p>ここからさらに自動化する事もできますが、個人的にはここまでで十分です。</p>


Godot Engineの翻訳機能を使う

potファイル（テンプレート）の作成

pybabel（＆babel-godot）のインストール

文字エンコード設定を変更する

moファイルは不要なので出力しないようにする

プロジェクト内のテキストの調整

Godot Engineでpoファイルを読み込む

Discussion