Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Cambiado

- **Libros más fieles al original:** el pedido de libros ya no dice «Escribe de forma clara y natural». Esa frase empujaba al modelo a reescribir en vez de traducir: sin ella, el chrF del banco de libros subió 1,45 (IC 0,80 a 2,12). Vale para todos los libros guía, en JSON o en archivos de idioma.
- **La memoria distingue cada modpack y recuerda lo dudoso:**
- Cada traducción se guarda con su modpack y con su calidad: «ok», o el motivo por el que se aceptó con dudas.
- Un modpack siempre usa lo suyo. De otro modpack solo usa lo que quedó bien: un término del glosario que no se cumplió en un pack ya no se copia a todos los demás.
Expand Down Expand Up @@ -98,6 +99,7 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Corregido

- **Los libros guía que viven en los archivos de idioma se traducían como interfaz.** Desde Patchouli 1.20 casi todos los libros usan claves de idioma (`"i18n": true`), igual que Modonomicon, y la app los mandaba al motor como textos de menú, sueltos. Ahora sus claves («occultism.book.entries…», «…guide.entry…») se traducen como libro, con el título de la entrada y el texto anterior como contexto, y entran en la revisión de misiones y libros. Los nombres de objetos y los textos de menús o tooltips siguen como interfaz. Lo ya traducido de esas claves se vuelve a pedir una vez, con el tono de libro.
- **El glosario exigía términos donde la palabra tenía otro sentido:** «lead the way» pedía «Correa», «the power signal» pedía «Poder» y «the target» pedía «Diana». Ahora la app mira en el inglés y el español del juego y de los mods cómo se traduce cada palabra cuando va en minúscula. Si casi nunca sale con el término del glosario, ese término solo se manda y se exige cuando el texto lo usa como nombre: es todo el texto, va con mayúscula a mitad de frase o el texto es un nombre en estilo título. Las palabras que sí se traducen igual («fire» → «fuego») se siguen exigiendo, y los términos del usuario siempre.
- **Términos de un mod a medio traducir** («Almacen Portable de Energía», «slot de los Muslos») ya no entran en el glosario: se descarta el término que deja en español una palabra inglesa que no sale en ningún texto en español del juego ni de los mods. Los nombres de los mods de la instancia («estilo Create») no cuentan.
- **Artículo con el género equivocado** al cambiar un término que quedó en inglés: «Usa el Wrench» pasa a «Usa la Llave inglesa», no a «el Llave inglesa». Si no se sabe el género, no se cambia y queda como duda.
Expand Down
23 changes: 23 additions & 0 deletions docs/calidad.md
Original file line number Diff line number Diff line change
Expand Up @@ -547,6 +547,29 @@ corridas, US$ 0,11:
- Coincide con la investigación: elegir entre salidas ayuda sobre todo cuando el modelo duda más. Por eso el
máximo queda como opción y el perfil por defecto es el equilibrado.

## 15 de noviembre de 2026 · libros guía en los archivos de idioma, y un tono que estorbaba

Desde Patchouli 1.20 casi todos los libros guardan su texto en los archivos de idioma (`"i18n": true`), igual que
Modonomicon, y la app los traducía como textos de interfaz. Ahora sus claves se traducen como libro, con el título de
la entrada y el texto anterior como contexto.

Al medirlo apareció otra cosa: con el tono de libro de entonces («Escribe de forma clara y natural»), los 116 textos
del banco salían peor que como interfaz. La frase empujaba a reescribir. Se quitó: el tono de libro ahora solo
describe qué son los textos, como el de interfaz.

Gemini 3.8 Flash, dos corridas por condición (US$ 0,15 en total):

| Banco de libros | chrF (corridas 1 y 2) |
|---|---|
| Como interfaz (lo que pasaba con las claves de idioma) | 68,3 · 67,6 |
| Como libro, con «clara y natural» | 66,6 · 67,6 |
| Como libro, sin esa frase (ahora) | 68,8 · 68,3 |

| Comparación pareada | Diferencia |
|---|---|
| Sin la frase contra con la frase | **+1,45** (IC 95 %: +0,80 a +2,12) → mejora |
| Sin la frase contra como interfaz | +0,60 (IC 95 %: −0,03 a +1,28), no se distingue del ruido |

## Cómo repetirlo

```
Expand Down
37 changes: 31 additions & 6 deletions src/traductor_es/modulos/base.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
from __future__ import annotations

import re
from collections.abc import Callable, Mapping, Sequence
from collections.abc import Callable, Iterable, Mapping, Sequence
from dataclasses import dataclass, field
from pathlib import Path
from typing import Protocol
Expand Down Expand Up @@ -69,6 +69,8 @@ def pack_listo(self) -> PackSalida:
class Pieza:
texto: str
pista: str = ""
#: Otro ámbito que el del módulo (vacío: el del módulo). Lo usan las claves de libro del módulo de mods.
ambito: str = ""


@dataclass(slots=True)
Expand Down Expand Up @@ -127,7 +129,7 @@ def con_vecindad(piezas: Sequence[Pieza], es_titulo: Callable[[Pieza], bool]) ->
partes.append(f"dentro de «{titulo}»")
if anterior:
partes.append(f"viene después de «{anterior}»")
salida.append(Pieza(p.texto, " · ".join(partes)))
salida.append(Pieza(p.texto, " · ".join(partes), p.ambito))
anterior = _recortar(p.texto)
return salida

Expand All @@ -152,9 +154,32 @@ def reunir_pistas(piezas: list[Pieza]) -> dict[str, str]:
return {texto: " | ".join(vistas) for texto, vistas in por_texto.items()}


def por_ambito(piezas: Iterable[Pieza], ambito: str) -> dict[str, list[Pieza]]:
"""Las piezas por ámbito (el suyo o el del módulo), en orden: cada ámbito se traduce con su tono."""
grupos: dict[str, list[Pieza]] = {}
for p in piezas:
grupos.setdefault(p.ambito or ambito, []).append(p)
return grupos


def ambito_de(modulo: Modulo, texto: str) -> str:
"""El ámbito con que se traduce un texto del módulo (el del módulo, salvo que el módulo diga otro)."""
propio = getattr(modulo, "ambito_de", None)
return str(propio(texto)) if callable(propio) else modulo.ambito


def pendientes_de(traductor: Traductor, modulo: Modulo, textos: Iterable[str]) -> list[str]:
"""Lo que habría que mandar al motor de esos textos del módulo, cada uno en su ámbito."""
grupos: dict[str, list[str]] = {}
for t in textos:
grupos.setdefault(ambito_de(modulo, t), []).append(t)
return [n for ambito, del_ambito in grupos.items() for n in traductor.pendientes(del_ambito, ambito)]


def traducir_modulo(modulo: Modulo, traductor: Traductor) -> Resumen:
"""Recolecta los textos del módulo, los traduce (memoria, glosario o motor) y escribe el resultado."""
piezas = modulo.recolectar()
pistas = reunir_pistas(piezas)
resultado = traductor.traducir([p.texto for p in piezas], modulo.ambito, pistas)
return modulo.escribir(resultado.traducciones)
traducciones: dict[str, str] = {}
for ambito, piezas in por_ambito(modulo.recolectar(), modulo.ambito).items():
resultado = traductor.traducir([p.texto for p in piezas], ambito, reunir_pistas(piezas))
traducciones.update(resultado.traducciones)
return modulo.escribir(traducciones)
3 changes: 2 additions & 1 deletion src/traductor_es/modulos/libros.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@

Todos buscan primero el archivo en el idioma del juego y, si no está, usan el inglés archivo por archivo
(comprobado en el código de cada mod). Por eso se escriben solo los archivos que faltan en cada variante.
Modonomicon y los libros de Patchouli con `i18n` usan claves de idioma: los traduce el módulo de mods.
Modonomicon y los libros de Patchouli con `i18n` usan claves de idioma: los traduce el módulo de mods, con
el ámbito de libro (ver `mods.es_clave_de_libro`).
"""

from __future__ import annotations
Expand Down
48 changes: 46 additions & 2 deletions src/traductor_es/modulos/mods.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,12 @@

from __future__ import annotations

import re
from collections.abc import Mapping
from pathlib import Path

from ..fuentes.recursos import Pendiente
from .base import Contexto, Pieza, Resumen, contar
from .base import Contexto, Pieza, Resumen, con_vecindad, contar
from .cambios import Lugar

AMBITO = "ui"
Expand Down Expand Up @@ -159,6 +160,29 @@ def pista_con_contexto(
return " · ".join(partes)


#: Ámbito de los textos de libros que viven en los archivos de idioma (Patchouli con `i18n`, Modonomicon…).
AMBITO_LIBRO = "libro"
#: Una clave de libro tiene uno de estos tramos («mysticalagriculture.guide.entry…», «occultism.book.…»).
_CLAVE_DE_LIBRO = re.compile(r"(^|[._])(book|books|guide|guidebook|lexicon|codex|journal|manual)([._]|$)", re.I)
_NO_ES_LIBRO = ("options.", "config.", "key.", "gui.", "tooltip.", "item.", "block.", "itemgroup.", "creativetab.")
#: Un texto de libro de hasta estas palabras y sin punto final es un título (de entrada, de página o de categoría).
_PALABRAS_TITULO = 6


def es_clave_de_libro(clave: str) -> bool:
"""¿La clave es texto de un libro guía («occultism.book.entries.ritual.page1»)? No los nombres de objetos ni los
textos de menús o tooltips («item.m.guide_book», «gui.m.book_title»)."""
bajo = clave.lower()
return bool(_CLAVE_DE_LIBRO.search(bajo)) and not bajo.startswith(_NO_ES_LIBRO) and not es_nombre(clave)


def _es_titulo_de_libro(p: Pieza, clave: str) -> bool:
texto = p.texto.strip()
return clave.lower().endswith((".name", ".title", ".category")) or (
len(texto.split()) <= _PALABRAS_TITULO and not texto.endswith((".", "!", "?", ":"))
)


def _salto_nuevo(original: str, traduccion: str) -> bool:
return any(c in traduccion and c not in original for c in ("\r", "\n"))

Expand All @@ -170,6 +194,7 @@ class Mods:
def __init__(self, ctx: Contexto) -> None:
self.ctx = ctx
self._pendientes: list[Pendiente] = []
self._ambitos: dict[str, str] = {} #: texto → ámbito, para los que no son de interfaz

def detectar(self) -> bool:
return True
Expand All @@ -187,14 +212,33 @@ def recolectar(self) -> list[Pieza]:
juego = textos_del_juego(tabla.textos("minecraft", "en_us"), tabla.textos("minecraft", self.ctx.dialecto))
por_mod: dict[str, Mapping[str, str]] = {}
piezas: list[Pieza] = []
# Los libros guía de los archivos de idioma van como libro, con el título y el texto anterior (por libro)
libros: dict[str, list[tuple[Pieza, str]]] = {}
for p in self._pendientes:
if p.existente is None:
textos = por_mod.get(p.namespace)
if textos is None:
textos = por_mod[p.namespace] = tabla.textos(p.namespace, "en_us")
piezas.append(Pieza(p.ingles, pista_con_contexto(p.namespace, p.clave, textos, juego)))
if es_clave_de_libro(p.clave):
libros.setdefault(p.namespace, []).append((Pieza(p.ingles, f"{p.namespace}: {p.clave}"), p.clave))
else:
piezas.append(Pieza(p.ingles, pista_con_contexto(p.namespace, p.clave, textos, juego)))
self._ambitos = {}
for del_libro in libros.values():
claves = {id(pieza): clave for pieza, clave in del_libro}
con_contexto = con_vecindad(
[pieza for pieza, _ in del_libro],
lambda q, claves=claves: _es_titulo_de_libro(q, claves.get(id(q), "")),
)
for pieza in con_contexto:
piezas.append(Pieza(pieza.texto, pieza.pista, AMBITO_LIBRO))
self._ambitos[pieza.texto] = AMBITO_LIBRO

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Count pending work separately for each scope

When the same English string is pending under both a book key and a regular UI key, _ambitos can store only one scope for that string, and pendientes_de receives only the strings. It therefore checks the book scope for both occurrences and misses pending UI work, underreporting the analysis and estimated translation cost even though execution translates both scopes.

Useful? React with 👍 / 👎.

return piezas

def ambito_de(self, texto: str) -> str:
"""El ámbito de un texto que juntó `recolectar` («libro» para los libros guía; si no, interfaz)."""
return self._ambitos.get(texto, AMBITO)

def lugares(self) -> list[Lugar]:
"""Por mod (espacio de nombres), {clave: inglés} de lo que la app traduce (tras `recolectar`)."""
por_mod: dict[str, dict[str, str]] = {}
Expand Down
3 changes: 1 addition & 2 deletions src/traductor_es/motores/instrucciones.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,7 @@
"Deben ser breves; los nombres van con mayúscula inicial como en el original.",
"mision": "Son misiones de un modpack: títulos, subtítulos y descripciones que guían al jugador. "
"Usa un tono cercano y tutea al jugador.",
"libro": "Son páginas de libros guía dentro del juego que explican mecánicas, objetos y recetas. "
"Escribe de forma clara y natural.",
"libro": "Son páginas de libros guía dentro del juego que explican mecánicas, objetos y recetas.",
"script": "Son mensajes y tooltips que el modpack muestra al jugador.",
}

Expand Down
Loading
Loading