Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
  • ¿Algo no está bien?
#2,256 1 comentario 1 reacción 0 asignados Ver en GitHub

Los mantenedores suelen responder en 4 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
lua
Área
internationalization

Línea de trabajo

Empieza revisando el fork enlazado PathOfBuilding-PoE2-i18n y su parche source-only contra el commit upstream b8048682, especialmente los commits de i18n aislados. Comprueba cómo la capa de visualización/búsqueda de Lua y el parche de entrada CJK de SimpleGraphic abordan la visualización, la entrada, la búsqueda y el fallback de fuentes. Se considera terminado cuando un mecanismo genérico de catálogo PO admite esas tres superficies, mientras que los datos de builds, los códigos de importación/exportación, los valores de trade y los cálculos permanecen raw.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Lua
Estrellas
1.9k
Forks
456
Merge medio
6 d 6 h
PR fusionados (30 d)
25

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de PathOfBuildingCommunity/PathOfBuilding-PoE2

Todos los issues de PathOfBuildingCommunity/PathOfBuilding-PoE2

Issues similares

Más issues de Lua

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.