Skip to main content
Las páginas relacionadas muestran una sección de Temas relacionados en la parte inferior de cada página de documentación, ayudando a los lectores a descubrir contenido conectado. Las sugerencias pueden provenir de recomendaciones basadas en búsqueda, de enlaces que seleccionas en el frontmatter de la página o de una combinación de ambos. Las páginas relacionadas son un add-on de la implementación. Habilítalo en tu panel:
  1. Abre tu panel y ve a Configuración > Add-ons.
  2. Encuentra Temas relacionados y actívalo.
  3. Selecciona un modo y, opcionalmente, establece un límite en cuántas páginas se muestran.

​
Modos

​
mode
Las sugerencias se generan a partir del índice de búsqueda de tus documentos usando el título de la página actual. Las anulaciones en el frontmatter siguen teniendo prioridad cuando se configuran. Usa este modo cuando quieras que las páginas relacionadas se actualicen automáticamente a medida que agregas contenido.
​
mode
Solo se muestran las páginas listadas en el frontmatter related de una página. Las páginas sin un campo related no muestran ninguna sección de Temas relacionados. Usa este modo cuando quieras control editorial total.

​
Límite

Establece cuántas páginas relacionadas mostrar. El valor predeterminado es 5 y el máximo es 10. El límite se aplica a las sugerencias automáticas; las entradas manuales están limitadas al máximo.

​
Configurar por página con frontmatter

Usa el campo de frontmatter related para anular o proporcionar la lista de páginas relacionadas para una sola página. Esto funciona tanto en el modo Automático como en el Manual.
​
array | false
Una lista de páginas relacionadas, o false para ocultar la sección Temas relacionados en esta página.Cada entrada puede ser:
  • Una ruta relativa a la raíz de otra página en tus documentos: /api-playground/overview
  • Una URL absoluta a un sitio externo: https://example.com/docs
  • Un objeto Title: link para establecer una etiqueta explícita
Los títulos e íconos para las rutas internas se infieren de tu navegación cuando no se establecen explícitamente. Los enlaces externos se abren en una nueva pestaña.

​
Ejemplos

Selecciona una lista de páginas internas:
Combina páginas internas, enlaces externos y títulos personalizados:
Oculta la sección Temas relacionados en una página específica:

​
Cómo se generan las sugerencias

En el modo Automático, las páginas relacionadas se generan a partir del índice de búsqueda de tus documentos usando el título de la página actual como consulta. Los resultados se filtran por el idioma y la versión de la página cuando corresponde, y la página actual se excluye. Para las implementaciones con autenticación de usuario final, las sugerencias automáticas están deshabilitadas para evitar filtrar contenido entre contextos de usuario. Usa el campo de frontmatter related para mostrar sugerencias seleccionadas en implementaciones autenticadas por usuario.

​
Cuando las sugerencias no aparecen

Si la sección Temas relacionados aparece vacía en una página en el modo Automático:
  • El índice de búsqueda puede que aún no esté listo. Las sugerencias automáticas se reconstruyen después de cada despliegue, así que espera unos minutos después de publicar contenido nuevo y recarga la página.
  • Es posible que tu documentación no contenga suficiente contenido similar para que Mintlify pueda recomendar. Las sugerencias automáticas se obtienen del mismo idioma y versión de la página, por lo que un conjunto pequeño de documentos o una localización poco poblada puede no devolver coincidencias.
  • La autenticación de usuario final está habilitada. En su lugar, selecciona sugerencias con el campo de frontmatter related.
  • La página usa related: false y la sección está oculta intencionalmente.
  • Páginas: Configura los metadatos de la página con frontmatter.
  • Enlaces: Mejores prácticas para conectar páginas entre sí.
  • Búsqueda: Configura cómo se clasifican y filtran los resultados de búsqueda.