Cómo agregar y administrar idiomas

Dale un lugar claro a cada idioma en el CMS

Un registro de idioma de PostnHost indica al CMS qué idiomas soporta tu publicación. También suministra el código usado en las URLs localizadas y el atributo lang del HTML de la página.

Tres partes relacionadas funcionan juntas:

• Registros de idioma hacen que un idioma esté disponible en el CMS.
• Traducciones de contenido proporcionan artículos, páginas y categorías localizadas.
• Archivos de locale o anulaciones I18n traducen texto público compartido como etiquetas de navegación y mensajes de estado vacíos.

Agregar una parte no crea automáticamente las otras dos.

Agregar un idioma

1. Abre Idiomas desde la navegación del CMS.
2. Selecciona Nuevo idioma.
3. Introduce el nombre público, por ejemplo “Español”.
4. Introduce el código de idioma correspondiente, por ejemplo es.
5. Activa Idioma predeterminado solo cuando deba ser el idioma principal del sitio.
6. Crea el idioma.

Mantén el código breve y consistente. Se convierte en parte de rutas localizadas como /es, así que cambiarlo más tarde puede alterar las URLs públicas.

La lista de Idiomas identifica el idioma predeterminado y muestra los recuentos de contenido original y de traducciones.

Comprender el idioma predeterminado

Cada sitio debería tener un idioma predeterminado. Es el idioma principal de publicación y el idioma de respaldo cuando no se solicita una versión localizada. Cámbialo solo como parte de un plan intencional a nivel del sitio para el idioma y las URL.

Usa la lista de idiomas y la página de detalles

Las dos insignias de recuento muestran el contenido escrito originalmente en ese idioma y las variantes traducidas en ese idioma. Selecciona el nombre de un idioma o su acción de visualización para ver el contenido asociado con más detalle.

Un idioma puede existir antes de que las traducciones estén listas, por lo que un recuento cero es normal. Crea las traducciones por separado del artículo, página o categoría que sirve como contenido fuente.

Si la página de detalles advierte que no existe un archivo de locale, el registro de idioma está disponible pero el texto de la interfaz pública compartida no está completamente preparado para ese código. Usa la configuración opcional para desarrolladores que aparece más abajo.

Antes de editar un código o eliminar un idioma, revisa su contenido y traducciones. Esos cambios pueden afectar las rutas localizadas y los registros asociados.

Cuando no se necesita configuración de desarrollador

PostnHost incluye archivos de locale públicos para inglés, francés, alemán, japonés, coreano, portugués, polaco, español y ruso: en, fr, de, ja, ko, pt, pl, es, y ru.

Si el código elegido ya está disponible en la aplicación anfitriona, puedes crear el registro de idioma correspondiente en el panel, añadir traducciones de contenido y personalizar el texto compartido en Configuración → I18n.

Agregar más idiomas

Esta sección es solo para un código de idioma que la aplicación anfitriona aún no soporta. Pide a un desarrollador con acceso a la aplicación Rails que lo complete.

Agrega el nuevo código preservando la lista de locales existente:

# config/application.rb
config.i18n.default_locale = :en
config.i18n.available_locales = %i[en fr de ja ko pt pl es ru it]
config.i18n.fallbacks = [:en]

Genera un archivo de locale para la aplicación anfitriona con ese mismo código:

bin/rails g postnhost:locale it

1. Traduce las claves relevantes bajo postnhost.public en config/locales/it.yml.
2. Reinicia Rails después de cambiar config/application.rb.
3. Crea el registro de idioma correspondiente en PostnHost con el código it.
4. Añade las traducciones de artículos, páginas y categorías por separado.

El registro de idioma, la entrada de available_locales y el nombre de archivo de locale deben usar el mismo código. Una discrepancia puede causar texto de interfaz faltante o rutas localizadas inesperadas. Mantén el inglés como idioma de respaldo, o utiliza un mapa de respaldo que finalmente desemboque en el idioma predeterminado.

Verifica el nuevo idioma

• Abre su índice localizado, por ejemplo /es o /it.
• Comprueba el selector de idioma público.
• Revisa el texto compartido en Configuración → I18n.
• Publica y abre al menos un elemento de contenido traducido.