複数言語用JSONファイルの文章順序統一化

[Morichan]

改善詳細 / Details of Improvement

assets/locales/ ディレクトリ下の文章ファイルにおける各文章は、各言語ごとにバラバラな場所で設定をしており、文章順序の統一がとれていません。
また、一旦は統一が取れても、今後文章追加／修正などにより、すぐに統一が崩れる恐れがあります。

スクリーンショット / Screenshot

なし

期待する見せ方・挙動 / Expected behavior

• 各言語のJSONファイルで、変換文章の順序などが統一できること
• 各言語のJSONファイルが変更された際に、GitHub Actionなどで異常修正が検知できること

動作環境・ブラウザ / Environment

• macOS / Windows / Linux / iOS / Android
• Chrome / Safari / Firefox / Edge / Internet Explorer

補足

本家である東京都版サイトでは、Transifexというサービスで各言語対応することにより、統一化が図られているようです。
しかし、宮崎県版では対応言語が少なく、また開発者も少ないため、そこまで大掛かりなシステムに頼る必要もないと思います。

[oriverk]

まず、やさしい版を中心に不要な行と判断したものは同意を得ずに、既に削除したものがあります。まずお詫びします。

議論するべき事

• i18n用の英語版、やさしい版、日本語版のjsonに於ける不要or現在不使用の行をどうするか
  • 行数 =>ja.json: 325行、en.json: 340行、ja-Hira.json: 309行
  • 不要・不使用な行
    • 東京版からフォークしVue側を宮崎県用に編集し、json側に宮崎県用の行はしたが、東京版用の『労働者向け』記事などが削除編集されずに残存。その他、クルーズ等の文言
    • 東京=>宮崎等へ一括置換した際に発生した、現実には存在しないニュース、宮崎県組織、私鉄が存在しており、表示される文は修正してますが、不使用な文は存在しており、そこは消してよいのではと思ってます。
    • 現在、宮崎県版では不使用のカード：特に東京版TOPの『都営地下鉄』や『都庁来庁者数』のカード用のi18nのjsonデータ。（Vueファイルは残しても翻訳作業に支障はない）

現状の翻訳作業と感じ。

誤訳等を見つけた際は、その場所のVue側の文言を探し、jsonファイル中を検索して編集、無ければ追加。しかしながら指摘の通り、json編集者により行の追加の仕方（または場所）が違うことにより、各言語で順序の違いが発生してます。東京版由来の不使用行と使用する行のキーが数文字しか変わらない等発生しているので、i18nのjsonから不使用分を出来るだけ削除し、全体の行数を減らせると嬉しいです。。

[Morichan]

私が頭の中で考えていることを、ここに書きます。

---

まず、開発メンバーを2種類に分けます。
あくまで役割としてであり、この人はずっとこの役割、と決めるものではありません。

• 主要開発メンバーは、基本的にja.jsonファイルを触る
• 別途、言語ファイル編集メンバーが、ja.json以外のJSONファイルを触る

次に、開発フローです。

1. 主要開発メンバーは、新しいテキストの文章をvueファイルなどに追加した場合、手動でja.jsonに同じ文章の項目を追加（以降、新規項目と呼ぶ）する。
2. developmentブランチに上記ja.jsonが取り込まれると、新規項目の欄だけ追加した他JSONファイルを自動生成する。（ここは手動でも良いが、GitHub Actionで自動化することが理想的）
3. 言語ファイル編集メンバーは、新規プルリクとして、空欄の他JSONファイルを追加する。

---

これにより、以下のことが期待できます。

• 主要開発メンバーは機能追加／修正に集中できる
• 各言語ファイルの項目漏れ／ズレが（自動化により）無くなる