Esta documentación explica cómo utilizar la localización detallada (verbose localization) para encontrar claves de traducción de texto personalizado en Discourse.
Nivel de usuario requerido: Administrador
Encontrar una clave de traducción usando la localización detallada
La localización detallada es una herramienta potente en Discourse que ayuda a los administradores a encontrar claves de traducción para texto personalizado de manera más efectiva. Esto es particularmente útil cuando necesitas traducir texto que aparece en múltiples lugares de la interfaz de usuario de Discourse.
Resumen
Esta guía cubre:
- Habilitar la localización detallada.
- Usar la localización detallada para identificar claves de traducción.
- Aplicaciones prácticas y casos de uso comunes.
Habilitar la localización detallada
Hay varias maneras de habilitar la localización detallada, dependiendo de tu configuración.
Usando la Barra de Herramientas de Desarrollador (recomendado)
La Barra de Herramientas de Desarrollador de Discourse incluye un interruptor incorporado para la localización detallada. Este es el método más fácil y funciona tanto en sitios autohospedados como en los alojados.
- Abre la consola de desarrollador de tu navegador en tu sitio de Discourse.
- Ejecuta:
enableDevTools() - La página se recargará y aparecerá una barra de herramientas de desarrollador en el lado izquierdo de la pantalla.
- Haz clic en el icono
(desplazamiento) en la barra de herramientas para activar la localización detallada. - La página se recargará con la localización detallada activada.
El estado de la barra de herramientas de desarrollador se almacena en el almacenamiento local de tu navegador, y el estado de la localización detallada se almacena en el almacenamiento de sesión. Otros usuarios no se verán afectados.
Usando la consola del navegador directamente
- Abre el inspector web de tu navegador en tu sitio de Discourse.
- Ve a la pestaña de la consola.
- Introduce el siguiente comando de JavaScript en el símbolo del sistema:
I18n.enableVerboseLocalizationSession() - Deberías ver una respuesta similar a:
Usando la consola de rails (solo autohospedado)
La configuración del sitio verbose_localization existe pero es una configuración de sitio oculta. No se puede encontrar en la interfaz de administración bajo “Todas las configuraciones del sitio”. Para habilitarla globalmente para todos los usuarios en una instancia autohospedada:
- Accede a la consola de rails.
- Ejecuta:
SiteSetting.verbose_localization = true
Esto habilita la localización detallada para todos los usuarios del sitio. Prefiere los métodos basados en sesión anteriores para evitar saturar la interfaz de usuario para otros usuarios.
Usar la localización detallada para encontrar una clave de traducción
Cuando la localización detallada está activada, verás números mostrados después de todo el texto personalizable en tu sitio.
Pasos para identificar una clave de traducción
- Navega al área que contiene el texto que deseas actualizar. Por ejemplo, si estás buscando cambiar la palabra “Name” (Nombre):
- Busca el número de traducción asociado en la consola de tu navegador:
- Anota la clave de traducción identificada, como
user.name.title. - Ve a la barra lateral de Administración e introduce
site texts(Textos del sitio) en la barra de búsqueda - Introduce la clave de traducción en el cuadro de búsqueda:
- Haz clic en el botón Editar del texto y actualiza el texto según sea necesario.
Mejores prácticas
- Usa la localización detallada específica de la sesión para evitar saturar la interfaz de usuario para otros usuarios durante las tareas de traducción.
- Documenta las claves de traducción usadas frecuentemente para referencia futura.
- Comprueba regularmente las actualizaciones en la documentación de Discourse para mantenerte informado sobre las nuevas características de localización.
Problemas comunes y soluciones
Problema: Marcadores de traducción visibles para todos los usuarios
Solución: Asegúrate de habilitar la localización detallada exclusivamente para tu sesión si otros usuarios no deberían verla. Usa la Barra de Herramientas de Desarrollador o el método de la consola I18n.enableVerboseLocalizationSession() en lugar de la configuración global del sitio.
Problema: Dificultad para encontrar la clave de traducción correcta
Solución: Utiliza los marcadores de localización detallada y la consola con precisión, y verifica con la página Personalizar Textos del Sitio.
Preguntas frecuentes
P: ¿Se puede restringir la localización detallada a administradores o personal?
R: Los números de localización detallada pueden ocultarse a usuarios no técnicos habilitándola en sesiones individuales a través de la Barra de Herramientas de Desarrollador o la consola del navegador.
P: ¿Cómo se pueden verificar las traducciones de cadenas?
R: Después de identificar y actualizar la clave de traducción, revisa los cambios en la interfaz de usuario en una nueva sesión o pestaña del navegador.