Hecho con Chinaski

Modos de URL

Un sitio Chinaski multilingüe puede presentar sus idiomas en tres formas de URL diferentes. Cuál está en efecto se decide por la configuración Modo de URL de Idioma (Configuración → Enlaces Permanentes), y principalmente se decide para ti: el modo sigue el número de idiomas que configures. Esta página explica cada modo y las reglas alrededor de ellos.

Los tres modos

  • Ruta, el código de idioma es el primer segmento de ruta: https://example.com/en/about, https://example.com/es/sobre. Cada idioma se compila en su propio directorio en la salida. Este es el predeterminado para sitios multilingües.
  • Ninguno, sin código de idioma en ninguna parte de la URL. El contenido vive directamente bajo la raíz del dominio en un árbol de salida único. Este es el modo para sitios monolingües, un sitio de un solo idioma siempre lo usa.
  • Subdominio, el idioma se convierte en su propio subdominio: una publicación que es https://en.example.com/blog/hello en inglés es https://es.example.com/blog/hola en español. Las URLs canónicas de las páginas, alternativas hreflang, entradas del mapa del sitio, e incluso los enlaces de Vista del administrador todos usan el host por idioma automáticamente.

No lo estableces, mayormente, sigue tu lista de idiomas

El modo se deriva, no es independiente. Cuando cambias tus idiomas activos, el modo se recomputa para ti:

  • Más de un idioma → ruta (a menos que hayas elegido explícitamente subdominio, que se conserva).
  • Exactamente un idioma → ninguno.

Un valor obsoleto no puede acechar: la configuración se normaliza cada vez que cambian los idiomas, en guardados de enlaces permanentes, y una vez más cuando se carga la aplicación. Esto guarda contra un modo "ruta" obsoleto en un sitio monolingüe, que serviría 404s. Si estableces subdominio para tu sitio multilingüe, permanece así hasta que lo cambies, nunca se aplana silenciosamente.

No necesitas hacer nada después de cambiar idiomas: el modo se ajusta a sí mismo al guardar, y guardar la pestaña de Enlaces Permanentes siempre desencadena una reconstrucción para que el árbol de salida coincida.

Qué cambia en tu servidor

Cuando el modo es ninguno, todo se sirve desde el directorio de salida raíz. Con modo de ruta o subdominio, la raíz del servidor web desplegado apunta al directorio del idioma predeterminado en su lugar (el código de idioma predeterminado está incorporado en la raíz del documento del servidor web). Un despliegue estándar sincroniza esto automáticamente, los scripts de despliegue actualizan la configuración del sitio nginx a la raíz correcta y recargan el servicio.

Si usas modo subdominio con tu propio proxy inverso, tu alojamiento debe responder a cada <lang>.your-domain.com, el generador genera las URLs correctas, pero tu proxy necesita las reglas de host coincidentes.

Interacciones con otras configuraciones

  • Redirección de inicio, con contenido multilingüe, la raíz del dominio puede redirigir al blog u otro lugar; establécelo en la pestaña de Enlaces Permanentes. Reconstrucción requerida después de cambiar.
  • Alternativas hreflang, se generan enlaces alternos por idioma en modos ruta y subdominio cuando se configura una URL del Sitio; un sitio monolingüe (ninguno) no tiene alternativas por definición.
  • URLs Canónicas, en modo subdominio cada canónica de idioma se sienta en su propio subdominio; de lo contrario todas las canónicas comparten el dominio único que estableces como URL del Sitio.
Lee este sitio en