Instalar en cualquier sitio web

Cualquier sitio al que puedas agregar una etiqueta de script se conecta a Universally a través del tipo de proyecto Cualquier sitio web. Agregas una línea al <head> de cada página, luego eliges cómo se servirán las páginas traducidas: en el navegador del visitante en las mismas direcciones (JavaScript), o en un subdominio por idioma como fr.example.com (Subdominio). La línea es necesaria en ambos modos.

Antes de empezar

• Acceso al <head> de cada página. En un creador de sitios web, esa es la caja de código del encabezado en la configuración. En tus propios archivos, es la plantilla que cada página comparte.
• 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.
• Para el modo Subdominio, acceso al DNS de tu dominio. Cada idioma necesita tres registros.

Crear el proyecto

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

Elige cómo se servirán las páginas traducidas

La pantalla de Instrucciones de configuración pregunta "¿Cómo se deben servir las páginas traducidas?" y ofrece estas tarjetas:

Tarjeta	Ejemplo	Lo que dice la tarjeta
JavaScript	tusitio.com	La instalación más rápida, sin cambios en el DNS, funciona en cualquier plataforma. Sin visibilidad en motores de búsqueda y solo páginas públicas.
Subdominio	fr.tusitio.com	Seguro y rápido. Nunca toca tu tráfico en vivo y funciona en cualquier registrador.
Dominio		Deshabilitado, marcado como Próximamente.

No se elige ninguna tarjeta por ti, y Continuar permanece deshabilitado hasta que elijas. Tu sitio sigue funcionando exactamente como está: nada cambia hasta el paso final, y tú decides cuándo sucede.

Elige JavaScript si deseas la configuración más rápida y no necesitas páginas traducidas en los resultados de búsqueda. Consulta el modo de servicio de JavaScript para ver qué traduce y qué no. Elige Subdominio si deseas que cada idioma tenga su propia dirección.

Un proyecto de JavaScript puede moverse a subdominios más tarde desde su página de Configuración. Un proyecto de Subdominio no puede volver a JavaScript.

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. Pégalo en cualquier lugar entre las etiquetas <head> y </head>, en cada página. En un creador de sitios web, usa la caja de código del encabezado de todo el sitio en la configuración. En tus propios archivos, usa la plantilla que cada página comparte.
3. Guarda y publica el cambio.

En el modo JavaScript, la línea renderiza el selector de idioma y traduce cada página. En el modo Subdominio, renderiza el selector que enlaza tus subdominios de idioma. Los botones Marcar como completado en la pantalla se almacenan en tu navegador y no bloquean nada.

Publica y verifica la conexión

Guardado no está en vivo en la mayoría de los creadores, y la verificación solo ve lo que está publicado.

1. Publica tu sitio.
2. Haz clic en Verificar conexión.

La verificación carga tu página de inicio y busca la línea. Encontrada 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, porque tu sitio empieza a servir traducciones una vez que agregas idiomas.

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

Agregar idiomas en modo JavaScript

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 idiomas todavía muestra Formato de URL, pero el valor no se usa en modo JavaScript porque tus URLs nunca cambian. Ver Agregar y quitar idiomas.

Agregar idiomas en modo Subdominio

El paso de idiomas muestra la tarjeta Idiomas en su lugar.

1. Haz clic en Agregar subdominio para idioma.
2. En Agregar idioma de destino, elige Idioma y Región, luego un formato de Subdominio. Francés con Código de idioma en example.com se convierte en fr.example.com.
3. Agrega los tres registros DNS que muestra la fila en quien administre tu dominio, y espera a que la fila diga Activo.

Los registros, sus estados y las verificaciones se cubren en Subdominios de idioma.

Verificar que funcionó

• Modo JavaScript: abre tu sitio en una ventana privada. El selector se encuentra en la esquina inferior derecha. Elige un idioma y la página se recarga en él en la misma dirección.
• Modo Subdominio: abre https://fr.example.com/ una vez que su fila esté Activa. Sirve tu sitio traducido y el selector enlaza los nombres de host de los idiomas.

Si no funciona

• Cargamos tu dominio pero la línea no estaba en la página: el cambio no se guardó ni se publicó, un host o CDN todavía sirve una copia en caché, o la línea fue a algún lugar que no fuera el <head>. La verificación solo mira tu página de inicio.
• No pudimos cargar tu dominio en absoluto: el sitio está fuera de línea, detrás de un inicio de sesión, bloqueando la solicitud o el dominio en el proyecto es incorrecto.
• Esa línea pertenece a un proyecto diferente: reemplázala con la línea de la página de Configuración de este proyecto, luego verifica de nuevo.
• Un subdominio de idioma se queda en Verificando o Fallido: ver Subdominios de idioma.

Más casos se encuentran en Las traducciones no aparecen.