Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Added an i18n layer (tested with Chinese) — feel free to use

オープン
#2,256 コメント 1 件 リアクション 1 件 担当者 0 名 GitHub で見る

メンテナーはふだん 4 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
静か
技術スタック
lua

調査の方向性

まず、リンクされた PathOfBuilding-PoE2-i18n フォークと、upstream のコミット b8048682 に対するその source-only パッチを確認します。特に、分離された i18n コミットを確認してください。Lua の表示/検索レイヤーと SimpleGraphic の CJK 入力パッチが、表示、入力、検索、フォントフォールバックにどのように対応しているかを確認します。完了条件は、汎用的な PO カタログ機構がこれら 3 つのサーフェスをサポートし、ビルドデータ、インポート/エクスポートコード、trade の値、計算は raw のまま維持されることです。

索引モデルが issue の本文から書いたものです。

説明

What

Add an internationalization (i18n) mechanism to PoB2 — a generic framework so the program can be displayed, typed, and searched in any language, driven by plain-text PO catalogs. Not a specific language; the mechanism itself.

Why

Localizing PoB2 was never hard technically — the blocker is volume: tens of thousands of strings no single maintainer can translate. That's understandable, and it's why upstream never shipped translations. But that volume is exactly the part that doesn't need a developer. The one-time developer job is adding the i18n layer; after that, translating is ordinary text-editing the community can crowdsource, in any language.

The mechanism (three sides)

A real localization needs more than display, so the mechanism covers all three:

  • Display — UI, items, skills, passives, stat lines render in the chosen language at display boundaries.
  • Input — input fields patched so non-ASCII (CJK) text can be typed directly; the base engine couldn't accept this before.
  • Search — search matches translated text too, so entries are findable by their localized name.

Plus Unicode font fallback for CJK glyph rendering. Data boundaries stay raw: builds, import/export codes, trade values, and calculation internals remain English, so everything stays upstream-compatible.

Reference / proof

I built a working fork and used Chinese (zh_TW) as the test case to prove the mechanism end-to-end (display + input + search), including a portable build people can run:
https://github.com/woolkingx/PathOfBuilding-PoE2-i18n
Chinese is just the test vehicle — the same layer works for any language.

  • Lua display/search layer + engine-level CJK input patch (SimpleGraphic).
  • Source-only patch against upstream b8048682; the i18n change is isolated in its own commits for easy review.

Feel free to use any of it if it's useful.

主要言語
Lua
スター
1.9k
フォーク
456
平均マージ
6日 6時間
マージ済み PR(30日)
25

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

PathOfBuildingCommunity/PathOfBuilding-PoE2 のほかの issue

PathOfBuildingCommunity/PathOfBuilding-PoE2 の issue をすべて見る

似ている issue

Lua の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。