Genere etiquetas hreflang para páginas multilingües

Añada cada código regional y su URL absoluta, indique si lo desea un destino general x-default y obtenga tanto registros individuales como un bloque HTML completo. La herramienta valida la sintaxis, normaliza las mayúsculas convencionales, rechaza duplicados y escapa las URL de forma segura. Resulta útil para sitios multilingües, catálogos internacionales, portales de documentación y flujos editoriales que necesitan declarar alternativas de manera coherente.

Prepare un mapa completo de idiomas

Cree una fila por cada página equivalente del mismo conjunto multilingüe o multirregional. Cada fila requiere un código de idioma y una URL HTTP o HTTPS absoluta. Un código básico como es o fr es adecuado si una única página atiende a todas las personas que hablan ese idioma. Añada una región, como es-MX o fr-CA, cuando cambien los precios, la disponibilidad, la ortografía o las condiciones legales. Un subtipo de escritura de cuatro letras distingue alfabetos, por ejemplo zh-Hans o sr-Latn. El generador admite un idioma de dos o tres letras, una escritura opcional y una región opcional de dos letras o tres dígitos. Además, normaliza las mayúsculas habituales para evitar un marcado incoherente. Incluya la página actual junto con sus alternativas: el conjunto debe describirse entero, no limitarse a enlaces salientes. Use URL canónicas, indexables y acordes con el idioma o mercado indicado. El orden de las filas se conserva para que el resultado sea estable y fácil de revisar en el control de versiones.

Elija x-default de forma consciente

Utilice el campo opcional x-default para la página que deba recibir a quienes no encajen en ninguna versión lingüística o regional declarada. Puede ser un selector de idioma, una portada internacional o una versión neutral que permita elegir. No introduzca x-default como fila ordinaria: el campo específico evita declaraciones duplicadas o ambiguas y coloca el destino al final. Puede dejarlo vacío si no existe una alternativa general útil. El HTML devuelto contiene un elemento link por correspondencia y, si se indica, otro para x-default. Inserte el bloque completo en head en todas las páginas del conjunto, o envíe cabeceras Link equivalentes si su aplicación administra las alternativas por HTTP. Mantenga siempre la reciprocidad: cada página debe identificarse a sí misma y al mismo grupo de alternativas. Esta herramienta genera la declaración, pero no comprueba si las páginas remotas publican enlaces recíprocos, son indexables o redirigen. Para ello necesita una auditoría o rastreo independiente.

Valide, publique y mantenga el resultado

Los códigos mal formados se rechazan en lugar de publicarse silenciosamente. Así se detectan guiones bajos, espacios externos, componentes de idioma ausentes, subtipos adicionales no admitidos o x-default dentro de la lista. También se rechazan duplicados después de normalizar, por lo que en-us y en-US no pueden competir. Las URL deben ser absolutas y usar HTTP o HTTPS; las rutas relativas y otros esquemas no sirven para identificar páginas rastreables. Cuando la entrada sea válida, copie el campo html en su plantilla o consuma el array links si su framework genera los metadatos de head. Cada registro ofrece el valor hreflang normalizado, la URL original y la etiqueta terminada. Regenere el bloque cuando cambien las rutas, se abra un mercado o se mueva el destino general. Trate este mapa como configuración mantenida del sitio. En automatizaciones, guarde la entrada junto a las rutas y compare el resultado durante el despliegue. Cada solicitud API cuesta $0.002; el navegador sirve para trabajos puntuales y la API determinista para publicaciones repetibles.