Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta
  • Qualcosa non va?
#2,256 1 commento 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 4 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
lua
Ambito
internationalization

Direzione di ricerca

Inizia esaminando il fork collegato PathOfBuilding-PoE2-i18n e la sua patch source-only rispetto al commit upstream b8048682, in particolare i commit i18n isolati. Verifica come il livello Lua di visualizzazione/ricerca e la patch di input CJK di SimpleGraphic gestiscono visualizzazione, input, ricerca e fallback dei font. Il lavoro è completo quando un meccanismo generico basato su cataloghi PO supporta queste tre superfici, mentre i dati delle build, i codici di import/export, i valori di trade e i calcoli rimangono raw.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
Lua
Stelle
1.9k
Fork
456
Merge medio
6g 6h
PR unite (30g)
25

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di PathOfBuildingCommunity/PathOfBuilding-PoE2

Tutte le issue di PathOfBuildingCommunity/PathOfBuilding-PoE2

Issue simili

Altre issue su Lua

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.