Asigna las páginas de documentos traducidos según el contenido y el propósito que comparten, y luego registra la URL exacta de cada idioma. No pasa nada si los slugs son distintos. Este flujo de trabajo para Mac ayuda a un editor de documentos públicos a crear esa correspondencia y preparar enlaces lingüísticos y anotaciones de búsqueda precisos.

Por qué no es necesario que los slugs coincidan

Supongamos que un documento en inglés explica cómo organizar una cuadrícula de cuadrados de colores. Su traducción al francés explica la misma tarea, pero las dos direcciones terminan de forma distinta. Google permite explícitamente usar palabras localizadas en las URL y recomienda direcciones distintas para las diferentes versiones lingüísticas. No hace falta cambiar el nombre de las traducciones para que sus rutas coincidan. Administrar sitios multirregionales y multilingües.

Hay dos preguntas distintas que responder: «¿Son idénticas estas URL?» y «¿Son estos documentos traducciones entre sí?». El estándar URL de WHATWG define la igualdad de las URL mediante la comparación de las URL serializadas. Esa comparación no establece una relación de traducción entre direcciones distintas. Para este flujo de trabajo, determina la relación a partir de los documentos y luego regístrala explícitamente. Estándar URL, equivalencia de URL.

Los ejemplos que siguen son direcciones sintéticas de documentos públicos bajo example.com; ilustran una correspondencia propuesta, no páginas activas obtenidas de la web. La tarea consiste en vincular instrucciones equivalentes en inglés y francés, conservando la dirección existente de cada página.

Crea un registro de correspondencias en tu Mac

Empieza con un par de documentos. Mantén abierta la página original y su traducción propuesta en pestañas separadas de Safari, junto con un documento local de correspondencias. Necesitas el texto completo de ambas versiones y, para la implementación final, acceso a los ajustes de publicación que controlen las relaciones entre idiomas o los metadatos de las páginas.

Captura las direcciones exactas

En Safari, pulsa Command-L para seleccionar el campo de búsqueda inteligente y luego Command-C para copiar la dirección. Repite el proceso con la traducción cuando termine de cargarse. Apple documenta ambos atajos. Registrar la dirección a la que llegas tras navegar también te permite detectar un destino inesperado. Atajos de teclado y gestos en Safari en el Mac.

Para una colección pequeña, TextEdit es suficiente. Crea un documento nuevo, elige Formato > Convertir en texto sin formato y guárdalo como translation-map.txt. Convertir un documento de texto enriquecido existente elimina su formato, así que usa un documento nuevo para este registro. Estos pasos siguen las instrucciones de TextEdit de Apple. Crear, abrir y convertir documentos en TextEdit en el Mac.

Usa un identificador estable que describa la tarea subyacente. El siguiente es un registro ilustrativo completo, no un archivo de configuración que un sistema de publicación vaya a leer automáticamente:

ID del documento: tile-grid
Tarea del lector: Organizar una cuadrícula de cuatro columnas con cuadrados de colores
URL en inglés: https://example.com/en/docs/arrange-tiles
URL en francés: https://example.com/fr/guides/disposer-les-carres
Código de idioma del inglés: en
Código de idioma del francés: fr
Comprobación del alcance: Mismas instrucciones, diagrama y edición del documento
Decisión de correspondencia: Par de traducciones

El identificador te ofrece un punto de referencia cuando cambian los títulos o los slugs. Mantén las direcciones en campos separados en lugar de deducir una a partir de la otra. Sustituir /en/ por /fr/ en este ejemplo produciría una dirección no verificada y no encontraría la ruta real de la traducción.

Comprueba si los documentos permiten realizar la misma tarea

Compara la introducción, las instrucciones, las etiquetas del diagrama, los ejemplos y la edición. No es necesario que los títulos traducidos se parezcan palabra por palabra. En su lugar, pregúntate si un lector que elige el otro idioma recibiría instrucciones equivalentes para la misma actividad.

Usa esta tabla de decisiones antes de añadir una página al mapa. Es una ayuda editorial basada en la necesidad de identificar versiones alternativas del mismo contenido:

Lo que encuentras Decisión de correspondencia
Las mismas instrucciones para la cuadrícula y la misma edición, con el texto traducido Regístralas como un par de traducciones
Una página trata sobre cuadrículas; la otra, sobre elegir colores Mantén los documentos separados
Una traducción describe una edición anterior Resuelve la diferencia de edición antes de agruparlas
Solo está traducida la navegación No registres el documento principal como totalmente traducido
No existe un documento equivalente Deja ese idioma fuera del mapa de este documento

Por ejemplo, una página de presentación en francés que enlace a varias actividades de dibujo no sustituiría las instrucciones específicas en inglés para la cuadrícula. Registra la traducción que falta como una tarea de contenido pendiente. Un destino general puede servir para la navegación, pero no proporciona el documento equivalente que requiere esta correspondencia.

Conecta las páginas asignadas para lectores y Google

Tu registro local es la fuente editorial de la relación. Las páginas publicadas también necesitan una forma de expresarla. Empieza con enlaces de idioma visibles que lleven a los lectores directamente a la página equivalente asignada. Google recomienda enlazar las versiones lingüísticas para que los lectores puedan elegir y aconseja no redirigir automáticamente a los visitantes según el idioma que se les presuponga. Administrar sitios multirregionales y multilingües.

Para las anotaciones de búsqueda, Google admite tres métodos equivalentes: elementos HTML, encabezados de respuesta HTTP y mapas de sitio XML. Elige un método que sea fácil de mantener. Cada versión lingüística debe identificarse y señalar sus alternativas mediante URL completas, con enlaces recíprocos. Indicar a Google las versiones localizadas de tu página.

Prepara los enlaces alternativos para páginas HTML

El estándar HTML de WHATWG define alternate con un valor distinto de hreflang como indicación de una traducción. Este es un fragmento de metadatos HTML para el par sintético; debe ir dentro del elemento head existente de cada página. No es un documento HTML completo. Estándar HTML, tipo de enlace «alternate».

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

Incluye el mismo par en ambas páginas. Las URL de destino siguen siendo distintas, incluidos sus slugs. La documentación de Google exige enlaces de retorno y admite códigos que indican solo el idioma, como en y fr. Indicar a Google las versiones localizadas de tu página.

Usa un método de publicación compatible para los PDF

Un PDF no puede recibir el fragmento anterior dentro de un head HTML. Google documenta el uso de encabezados de respuesta HTTP Link para archivos que no son HTML. Para un par de PDF sintéticos, el campo de encabezado completo sería: Indicar a Google las versiones localizadas de tu página.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

Configura ese campo en la respuesta de cada PDF. RFC 8288 define la sintaxis de enlace HTTP, incluido el destino entre corchetes angulares y el parámetro hreflang. Estos son ajustes de respuesta; escribir el encabezado en el texto visible del PDF no los configura. RFC 8288: Enlaces web.

Si tu sistema de publicación no permite editar metadatos HTML ni encabezados de respuesta, Google también admite un mapa de sitio con anotaciones de idioma. Cada entrada de URL enumera todas las versiones, incluida ella misma. Usa la estructura de mapa de sitio documentada mediante tu sistema de publicación o su administrador. Un archivo local de correspondencias no implementa por sí solo ninguno de estos métodos. Indicar a Google las versiones localizadas de tu página.

Mantén separadas las relaciones de traducción, las redirecciones y las URL canónicas

Una alternativa lingüística, una URL duplicada preferida y una página trasladada representan relaciones distintas. Distinguirlas evita que un cambio de correspondencia bienintencionado aleje a los lectores del documento que eligieron.

Mecanismo Propósito documentado Aplicación en esta tarea
rel="alternate" con hreflang Identificar alternativas lingüísticas Vincular las traducciones asignadas
rel="canonical" Indicar una URL preferida entre páginas duplicadas o muy similares Gestionar direcciones duplicadas dentro del idioma correspondiente
Location en una respuesta de redirección Identificar el destino de la redirección Gestionar una dirección que se ha trasladado
Content-Language Describir el público lingüístico al que se dirige la representación Etiquetar el público de la respuesta
Content-Location Identificar el recurso que corresponde a la representación incluida Describir la ubicación de la representación

Google recomienda usar una URL canónica en el mismo idioma que hreflang o, si no existe, la mejor alternativa. Para estos documentos traducidos distintos, una implementación sencilla consiste en que cada URL preferida de idioma tenga una etiqueta canónica que apunte a sí misma. Evita que la URL canónica en francés apunte al inglés solo porque el texto se escribió primero en inglés. Cómo especificar una URL canónica con rel="canonical" y otros métodos.

RFC 9110 define por separado Location en las respuestas de redirección, Content-Language y Content-Location. Este último es metadato de la representación, no un sustituto de la URL de destino. Ninguno de esos campos enumera por sí solo el par de traducciones de este documento; conserva los enlaces alternativos para expresar esa relación. RFC 9110: Semántica de HTTP.

Verifica cada dirección y mantén el mapa

Antes de entregar el mapa para su implementación, realiza las siguientes comprobaciones. Repítelas con el contenido publicado después de cualquier cambio posterior; un registro correcto y unos metadatos publicados correctos son cosas distintas.

  1. Abre ambas direcciones registradas y compara el contenido real de los documentos.
  2. Sigue el enlace de idioma visible del inglés al francés y luego vuelve. Comprueba que cada destino sea la página equivalente específica.
  3. Compara las URL alternativas configuradas con el registro de correspondencias, carácter por carácter.
  4. Confirma que ambas versiones se identifiquen como parte del mismo conjunto de traducción, incluida cada una de ellas.
  5. Comprueba por separado los ajustes canónicos de cada idioma.
  6. Si cambia una dirección, actualiza el mapa y todas las referencias a esa dirección dentro del par.

Ten cuidado al normalizar las URL. RFC 9110 indica que el esquema y el host no distinguen entre mayúsculas y minúsculas, mientras que los demás componentes sí las distinguen según sus reglas de normalización. No conviertas una ruta a minúsculas ni elimines una barra final solo para que dos registros parezcan coherentes; conserva el destino verificado. RFC 9110, normalización y comparación de HTTP(S).

Para el par sintético, el resultado útil es un registro estable de tile-grid que conecte dos direcciones exactas, con contenido equivalente y enlaces funcionales en ambas direcciones. Guarda ese registro con las notas de mantenimiento del documento para que una futura traducción o cambio de slug permita actualizar la relación de forma deliberada.

Fuentes