Internacionalización (i18n)

Este documento registra la estructura de localización actual de The Pool y el flujo de trabajo admitido para agregar idiomas en una bifurcación.

La ubicación secundaria enviada inmediatamente es español, pero el objetivo real es hacer que la localización futura sea sencilla sin código personalizado para las superficies compartidas propiedad del sitio.

Lo que existe ahora

El modelo i18n actual cubre:

configuración regional estructurada en _config.yml
catálogos de traducción compartidos en _data/i18n/
asistentes de URL con reconocimiento regional y un selector de idioma de pie de página compartido
rutas públicas localizadas para:
- /
- /about/
- /terms/
- /campaigns/:slug/
- /embed/campaign/
- /pledge-success/
- /pledge-cancelled/
- /manage/
- /community/
- /admin/
- /creator-campaign-checklist/
- páginas de la comunidad de seguidores
copia localizada en tiempo de ejecución propiedad del sitio para carrito, pago, gestión de compromiso, autenticación de administrador/panel de control/vistas previas de informes/exploración de seguidores/vista previa de contenido, flujos de la comunidad, cuentas regresivas de la campaña (incluido el estado del tiempo restante del lector de pantalla), recordatorios de lanzamiento de la próxima campaña, videos destacados/estados de carga y títulos de inserción, avance de la comunidad de seguidores en Chrome, pestañas del diario, controles de la fase de producción, etiquetas de galería, texto de estado de estadísticas en vivo e inserción de la campaña. constructor/widget
El cambio de idioma del administrador conserva el estado de vista seguro, como los filtros de campaña y los hashes, pero elimina los tokens de enlace mágico admin_login antes de vincularlos al idioma alternativo.
etiquetas de sección de complementos de campaña localizadas tanto en el carrito como en Manage Pledge, además de una copia de ayuda para el pago, como resúmenes de los botones del carrito, etiquetas de ubicación fiscal y una copia del siguiente paso del pago alojado
Cambio de pie de página de campaña localizado y formato de fecha de campaña localizado para Chrome de campaña pública
Etiquetas localizadas de enlaces para compartir de campañas, además de texto de intención de compartir con conocimiento del estado para campañas próximas, activas, financiadas y finalizadas.
Correos electrónicos de apoyo de Worker localizados y enlaces /manage/ / /community/:slug/ localizados basados en preferredLang persistente
rutas localizadas de tarjetas compartidas de campañas de trabajadores como /share/campaign/:slug.png?lang=es
metadatos públicos localizados y sugerencias de lenguaje de datos estructurados en páginas públicas y páginas de campaña localizadas

El inglés sigue siendo la configuración regional predeterminada. El español es el lugar secundario preclasificado.

Modelo de configuración

La configuración regional canónica se encuentra en _config.yml:

i18n:
  default_lang: en
  supported_langs:
    - en
    - es
  language_labels:
    en: English
    es: Español
  pages:
    home:
      en: /
      es: /es/
    about:
      en: /about/
      es: /es/about/
    terms:
      en: /terms/
      es: /es/terms/
    manage:
      en: /manage/
      es: /es/manage/
    admin:
      en: /admin/
      es: /es/admin/
    community_index:
      en: /community/
      es: /es/community/
    creator_campaign_checklist:
      en: /creator-campaign-checklist/
      es: /es/creator-campaign-checklist/
    pledge_success:
      en: /pledge-success/
      es: /es/pledge-success/
    pledge_cancelled:
      en: /pledge-cancelled/
      es: /es/pledge-cancelled/

Este modelo mantiene intencionalmente la localización predecible para las bifurcaciones:

un idioma predeterminado
una lista de idiomas admitidos
un mapa con etiqueta de visualización
un mapa de ruta seleccionado para páginas compartidas con reconocimiento regional

Las páginas de campaña son la principal excepción: se generan a partir de la colección de campañas, por lo que sus rutas localizadas se derivan de slugs de campaña y generan localized_paths en lugar de entradas i18n.pages escritas a mano.

Fuentes de traducción

1. UI compartida y copia en tiempo de ejecución

Las cadenas compartidas propiedad del sitio se encuentran en un archivo YAML por configuración regional:

Esto incluye:

etiquetas de navegación
botones
etiquetas de estado
progreso/metatexto
carrito/pagar/Administrar copia en tiempo de ejecución de promesa
Pestañas del panel de administración, filtros, etiquetas de formulario generadas, etiquetas de opciones, texto de ayuda, copia de carga de medios, copia de informe/soporte/análisis/marketing y controles del editor de contenido
Etiquetas de la sección de complementos de la campaña y copia auxiliar de pago alojada/personalizada.
copia en tiempo de ejecución de la comunidad
cuenta regresiva de la campaña / video-heroe / comunidad-de-seguidores / diario / fase-de-producción / galería / copia de estadísticas en vivo
Formulario de recordatorio del lanzamiento de la próxima campaña, estado y copia por correo electrónico
Etiquetas para compartir de campaña y mensajes con intención de compartir para Bluesky, X, Threads, Facebook, SMS y correo electrónico.
creador de inserción de campaña/copia de widget
Copia del correo electrónico del partidario del trabajador

El inglés es el archivo fuente canónico y la configuración regional alternativa.

2. Páginas escritas de formato largo

La copia de página de formato largo debe utilizar archivos fuente localizados en lugar de intentar forzar cada párrafo en YAML.

Ejemplos:

Ese mismo patrón debería usarse para futuras páginas con mucho contenido.

Modelo de enrutamiento

El sitio utiliza un modelo estático de prefijo local:

el idioma predeterminado permanece en las URL canónicas
- /
- /about/
- /terms/
- /manage/
- /community/
- /creator-campaign-checklist/
Los idiomas no predeterminados viven bajo un prefijo local.
- /es/
- /es/about/
- /es/terms/
- /es/campaigns/{slug}/
- /es/embed/campaign/
- /es/manage/
- /es/community/
- /es/creator-campaign-checklist/

Esto mantiene el modelo de implementación de Jekyll/GitHub Pages simple y predecible.

Las rutas de recopilación de campañas ahora se generan en ambas configuraciones regionales, por lo que el selector de idioma del pie de página puede permanecer disponible en las páginas de la campaña en lugar de desaparecer o vincularse nuevamente a la ruta del idioma predeterminado.

Ayudantes y plomería en tiempo de ejecución

Ayudantes locales compartidos:

Cargas útiles de configuración regional en tiempo de ejecución:

Localización del panel de administración:

La copia estática del shell de administración en /_layouts/admin.html usa el asistente de traducción Liquid compartido
La copia de administración en tiempo de ejecución está incluida en el catálogo de administración completo emitido por runtime-messages-json.html.
Los campos de Configuración y Campañas generados provienen de Worker JSON, pero assets/js/admin-dashboard.js los localiza con claves deterministas:
- settings_section_* para secciones de la barra lateral de configuración de nivel superior
- settings_field_*_label, settings_field_*_help y settings_field_*_placeholder para configuraciones de plataforma editables
- settings_readonly_*_label y settings_readonly_*_help para diagnósticos de solo lectura de plataforma y filas de estado secreto
- campaign_field_*_label y campaign_field_*_help para configuraciones de campaña y colecciones propiedad de la campaña
- campaign_readonly_*_label y campaign_readonly_*_help para filas de solo lectura de campaña
- Teclas settings_option_*, campaign_option_* y genéricas option_* para opciones de selección/casilla de verificación
Los controles del editor de contenido, el estado/errores de carga de medios por etapas, las etiquetas de configuración de medios/texto de ayuda, la configuración de la galería y los controles de subtítulos flotantes de la galería también están localizados en tiempo de ejecución; actualice inglés y español juntos al agregar un nuevo control de medios de administración
el trabajador debe seguir devolviendo valores estables del campo path; el cliente deriva claves i18n de esas rutas para que las bifurcaciones puedan agregar campos sin duplicar el código de renderizado
los datos de campaña creados por el creador, los cuerpos del diario, los nombres de complementos, las opciones de decisión y otro contenido guardado se muestran como creados; el catálogo compartido solo localiza la interfaz de usuario del panel circundante

Comportamiento actual importante:

el selector de idioma del pie de página es la superficie de cambio de configuración regional compartida
conserva la cadena de consulta actual y el hash
Las URL tokenizadas como /manage/?t=... pueden cambiar a /es/manage/?t=... sin perder el acceso al compromiso.
Stripe se inicializa con la configuración regional actual donde sea compatible, por lo que las etiquetas de campo propiedad de Stripe y la validación también se pueden localizar
Los resúmenes de activación del carrito y la copia auxiliar de ubicación de impuestos provienen del catálogo local compartido, por lo que el pago personalizado sigue siendo traducible sin cadenas codificadas separadas.
Las plantillas de campañas públicas ahora enrutan cadenas de Chrome compartidas a través de datos locales en lugar de inglés codificado cuando sea práctico, incluido el CTA/estado de carga del video principal, títulos insertados de video principal, copia de adelanto de la comunidad de seguidores, copia de estado/formulario de recordatorio de lanzamiento, diario cromado, etiquetas de la fase de producción, etiquetas de accesibilidad de la galería, copia del compromiso de la barra lateral de la campaña, texto de estado del lector de pantalla de cuenta regresiva y fechas de la campaña localizadas.
Las páginas de campaña utilizan etiquetas para compartir localizadas y texto de intención de compartir con reconocimiento del estado, al tiempo que dejan los títulos y anuncios publicitarios de las campañas escritos por los creadores tal como fueron escritos.
Las páginas de campaña ahora exponen el cambio de idioma del pie de página localizado a través de la campaña generada localized_paths
el generador de inserción de campaña alojada y el widget extraen sus cadenas de generador/tiempo de ejecución del catálogo de configuración regional compartido y conservan los enlaces de retorno de la campaña que tienen en cuenta la configuración regional.
Los metadatos públicos y JSON-LD ahora también siguen el idioma de la página activa, la ruta de inicio localizada y el conjunto de idiomas admitidos para que las páginas localizadas no emitan sugerencias de rastreo solo en inglés por accidente.
Las páginas localizadas de formato largo, como Acerca de y Términos, aún usan traducciones de archivos fuente, por lo que los barridos de documentos/contenido deben mantener esos archivos específicos de la configuración regional sincronizados manualmente.

Comportamiento del correo electrónico del trabajador

Los correos electrónicos de apoyo de los trabajadores reutilizan el mismo catálogo local y persisten preferredLang.

Archivos relevantes:

Comportamiento práctico:

Si no se captura ninguna preferencia local, los correos electrónicos vuelven al inglés.
si un partidario se compromete o administra desde /es/..., el trabajador puede persistir preferredLang=es
Los correos electrónicos de los seguidores y las URL de enlaces mágicos utilizan el modelo de ruta en español, como /es/manage/?t=....
Los correos electrónicos de recordatorio de lanzamiento utilizan el preferredLang persistente del registro y se vinculan a la ruta de la campaña localizada cuando hay una disponible.
Las tarjetas compartidas de campaña también se pueden solicitar según la configuración regional, como /share/campaign/sunder.png?lang=es

Qué hace y qué no hace un archivo YAML de configuración regional

Agregar un nuevo archivo YAML de configuración regional es suficiente para:

sitio compartido chrome
mensajes compartidos de tiempo de ejecución/navegador
Copia del correo electrónico de apoyo del trabajador

No es suficiente para un sitio completamente traducido por sí solo.

El soporte completo de idiomas también necesita:

el idioma agregado a i18n.supported_langs
su etiqueta agregada a i18n.language_labels
rutas localizadas agregadas a i18n.pages
páginas de origen localizadas para cualquier contenido de formato largo que realmente desee traducir

Flujo de trabajo de bifurcación recomendado

Copie /_data/i18n/en.yml a /_data/i18n/{lang}.yml.
Agregue el idioma al bloque i18n en /_config.yml.
Agregue rutas de páginas públicas localizadas a i18n.pages.
Agregue páginas de origen localizadas para contenido de formato largo como /about/, /terms/, /manage/ o páginas de índice de la comunidad seleccionadas cuando sea necesario.
Verifique las rutas de recopilación generadas, como /es/campaigns/{slug}/, y cualquier ruta de inserción con reconocimiento regional que exponga su implementación.
Para cambios en el panel de administración, agregue claves admin coincidentes en cada archivo local antes del envío. En particular, los campos generados necesitan las claves deterministas settings_field_*, settings_readonly_*, campaign_field_* o campaign_readonly_* descritas anteriormente.
Ejecute la pila local y verifique tanto la copia de la IU compartida como las rutas localizadas, incluidas /admin/ y /es/admin/ cuando las cadenas de la IU del administrador cambiaron:

npm run podman:doctor
./scripts/dev.sh --podman

Límites actuales

Todavía intencionalmente fuera del alcance de este modelo:

traducción automática de cuerpos de campaña, entradas de diario o contenido de publicaciones de la comunidad escritos por creadores
traducción automática de configuraciones de campaña guardadas creadas por el administrador, nombres de complementos, opciones de decisión, etiquetas de referencia u otro contenido almacenado como datos de campaña/plataforma
reglas de impuestos, envío o precios específicos de la localidad
un canal de traducción automática en el repositorio