Instalar en Duda

Un sitio de Duda se conecta a Universally con una etiqueta de script en el Encabezado HTML de todo el sitio. La etiqueta muestra el selector de idioma y traduce cada página en el navegador del visitante, por lo que tus URL permanecen iguales en cada idioma y no hay que cambiar el DNS. El modo de servicio de JavaScript explica cómo funciona la traducción y qué omite.

Antes de empezar

• Un plan Team de Duda o superior. El código personalizado está disponible en planes Team y superiores.
• El rol de Propietario o Administrador en tu espacio de trabajo de Universally, para crear el proyecto y ver su fragmento. Los editores ven "Pídele a un administrador del proyecto el fragmento de instalación de este proyecto" en lugar de la línea.
• Un sitio publicado en tu propio dominio. La verificación de conexión solo ve el sitio publicado.

Crear el proyecto

1. Inicia un nuevo proyecto. En Selecciona tu tecnología, elige Duda.
2. Completa Dominio, el dominio completo en el que está publicado tu sitio, como ejemplo.com. Si el dominio aún no se resuelve, verás una advertencia y podrás continuar.
3. Completa Nombre del proyecto, verifica Idioma de origen (Inglés (EE. UU.) por defecto) y haz clic en Siguiente.

Los proyectos de Duda no tienen modo de servicio para elegir, por lo que la siguiente pantalla es Agregar el fragmento. Los subdominios de idioma aún no están disponibles para los sitios de Duda: tu sitio se traduce mediante el fragmento, en sus propias direcciones.

Añadir el fragmento

El paso Agregar el fragmento muestra tu línea dentro de una página de ejemplo. El panel completa la clave de tu proyecto:

<script src="https://scripts.universally.com/p/YOUR_PUBLIC_KEY/s.js" async></script>

1. Haz clic en Copiar línea. Copia solo la etiqueta de script y el botón cambia a Copiado.
2. En Duda, abre Más › Configuración › Encabezado HTML.
3. Pega la línea y guarda.

Usa el campo Encabezado HTML de todo el sitio para que el script se cargue en cada página. Los botones Marcar como completo en la pantalla se guardan en tu navegador y no bloquean nada.

Publica y verifica la conexión

1. Guarda el código, luego Publica o Vuelve a publicar en el dominio que ingresaste en Universally. La verificación de conexión solo ve el sitio publicado.
2. De vuelta en Universally, haz clic en Verificar conexión.

La verificación carga tu página de inicio y busca la línea. Encontrado significa que la línea está en tu dominio, pertenece a este proyecto y no hay nada más que instalar.

Nada cambia para tus visitantes todavía. La línea solo carga el archivo de Universally y tu sitio comienza a servir traducciones una vez que agregas idiomas en el siguiente paso.

Continuar y Lo haré más tarde avanzan a Agregar idiomas, y nada queda pendiente en la verificación. La línea permanece en la página Configuración del proyecto, bajo La línea que tu sitio necesita.

Añadir idiomas

1. En Agregar idiomas, responde "¿A qué idiomas quieres traducir?" con al menos un idioma de destino.
2. Haz clic en Finalizar. Permanece deshabilitado hasta que el proyecto tenga un idioma.

El diálogo de idioma todavía muestra Formato de URL, pero el valor no se usa en Duda porque tus URL nunca cambian. Cada fila de idioma en Todos los idiomas tiene un interruptor En vivo. Consulta Agregar y quitar idiomas.

Verificar que funcionó

1. Abre tu sitio publicado en una ventana privada. Un visitante por primera vez se empareja automáticamente con el idioma de su navegador, por lo que un navegador configurado en uno de tus idiomas de destino ve la página traducida.
2. Encuentra el selector de idioma en la esquina inferior derecha, con banderas y nombres de idioma.
3. Elige un idioma. La página se recarga en ese idioma, en la misma dirección.

Para ver cuánto de una página se tradujo, añade ?uni_debug=1 a su URL y abre la consola del navegador.

Si no funciona

• Cargamos tu dominio pero la línea no estaba en la página: el código no se guardó o el sitio no se volvió a publicar desde entonces. Vuelve a publicar y verifica de nuevo. Una copia en caché en tu host o CDN también puede ocultar la línea por un tiempo, y la verificación solo mira tu página de inicio.
• Esa línea pertenece a un proyecto diferente: la línea de otro proyecto está en el sitio. Reemplázala con la línea de la página Configuración de este proyecto, y luego vuelve a comprobar.
• No aparece ningún selector: el proyecto aún no tiene ningún idioma de destino activo. Añade uno, o activa su interruptor Activo.
• El selector aparece pero parte del texto permanece en el idioma de origen: la página está detrás de un inicio de sesión o una contraseña, o JavaScript añade el texto después de que la página se carga. Consulta Modo de servicio de JavaScript.

Hay más casos en Las traducciones no aparecen y El selector no es visible.