Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions es/guides/linking.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,24 @@ Enlaza a otras páginas de tu documentación usando rutas relativas a la raíz.
- [Custom components](/customize/react-components)
```

Evita las rutas relativas como `../api-playground/overview`—se rompen cuando las páginas se mueven y son más difíciles de revisar.
Mintlify resuelve las rutas relativas (`./` y `../`) según la ubicación del archivo fuente en el directorio de tu proyecto. Esto funciona para enlaces, imágenes y elementos JSX como las etiquetas `<Card>` y `<a>`.

```mdx
- [Página hermana](./sibling-page)
- [Página de la sección superior](../other-page)
```

Para los archivos `index.mdx`, las rutas relativas se resuelven desde el directorio que contiene el archivo de índice. Por ejemplo, un enlace `./setup` en `guides/getting-started/index.mdx` se resuelve a `/guides/getting-started/setup`.

Los enlaces conservan los fragmentos y las cadenas de consulta.

```mdx
[Instrucciones de configuración](./setup#step-1)
```

<Tip>
Las rutas relativas a la raíz (que comienzan con `/`) funcionan mejor para los enlaces internos porque siguen siendo correctas si mueves la página que enlaza a un directorio diferente.
</Tip>

<div id="anchor-links">
## Enlaces de anclaje
Expand Down Expand Up @@ -224,7 +241,9 @@ Consulta [Redirecciones](/es/create/redirects) para más información.

<AccordionGroup>
<Accordion title="¿Debo usar rutas relativas a la raíz o URLs absolutas para enlaces internos?">
Las rutas relativas a la raíz (que comienzan con `/`) son la opción correcta para enlaces internos en Mintlify. Funcionan de manera consistente sin importar dónde se encuentre la página que enlaza en tu directorio, y no se rompen si tu dominio de documentación cambia. Las URLs absolutas para enlaces internos crean una fragilidad innecesaria.
Las rutas relativas a la raíz (que comienzan con `/`) son la opción más común para enlaces internos en Mintlify. Funcionan de manera consistente sin importar dónde se encuentre la página que enlaza en tu directorio, y no se rompen si tu dominio de documentación cambia. Las URLs absolutas para enlaces internos crean una fragilidad innecesaria.

Puedes usar rutas relativas (`./` y `../`), pero debido a que se resuelven según la ubicación del archivo fuente, pueden romperse con mayor frecuencia.
</Accordion>

<Accordion title="¿Cómo mantengo estables los enlaces de anclaje cuando actualizo los encabezados?">
Expand Down
23 changes: 21 additions & 2 deletions fr/guides/linking.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,24 @@ Liez vers d'autres pages de votre documentation en utilisant des chemins relatif
- [Custom components](/customize/react-components)
```

Évitez les chemins relatifs comme `../api-playground/overview`—ils se cassent lorsque les pages sont déplacées et sont plus difficiles à vérifier lors de la revue.
Mintlify résout les chemins relatifs (`./` et `../`) en fonction de l'emplacement du fichier source dans le répertoire de votre projet. Cela fonctionne pour les liens, les images et les éléments JSX comme les balises `<Card>` et `<a>`.

```mdx
- [Page voisine](./sibling-page)
- [Page de la section parente](../other-page)
```

Pour les fichiers `index.mdx`, les chemins relatifs sont résolus à partir du répertoire qui contient le fichier d'index. Par exemple, un lien `./setup` dans `guides/getting-started/index.mdx` est résolu en `/guides/getting-started/setup`.

Les liens préservent les fragments et les chaînes de requête.

```mdx
[Instructions de configuration](./setup#step-1)
```

<Tip>
Les chemins relatifs à la racine (commençant par `/`) fonctionnent mieux pour les liens internes car ils restent corrects si vous déplacez la page source vers un autre répertoire.
</Tip>

<div id="anchor-links">
## Liens d'ancrage
Expand Down Expand Up @@ -224,7 +241,9 @@ Consultez [Redirections](/fr/create/redirects) pour plus d'informations.

<AccordionGroup>
<Accordion title="Dois-je utiliser des chemins relatifs à la racine ou des URLs absolues pour les liens internes ?">
Les chemins relatifs à la racine (commençant par `/`) sont le bon choix pour les liens internes dans Mintlify. Ils fonctionnent de manière cohérente quel que soit l'emplacement de la page source dans votre répertoire, et ils ne se cassent pas si votre domaine de documentation change. Les URLs absolues pour les liens internes créent une fragilité inutile.
Les chemins relatifs à la racine (commençant par `/`) sont le choix le plus courant pour les liens internes dans Mintlify. Ils fonctionnent de manière cohérente quel que soit l'emplacement de la page source dans votre répertoire, et ils ne se cassent pas si votre domaine de documentation change. Les URLs absolues pour les liens internes créent une fragilité inutile.

Vous pouvez utiliser des chemins relatifs (`./` et `../`), mais comme ils sont résolus en fonction de l'emplacement du fichier source, ils peuvent se casser plus fréquemment.
</Accordion>

<Accordion title="Comment maintenir les liens d'ancrage stables lorsque je mets à jour les titres ?">
Expand Down
23 changes: 21 additions & 2 deletions zh/guides/linking.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,24 @@ keywords: ["文档链接", "内部链接", "锚点链接", "断链", "深层链
- [Custom components](/customize/react-components)
```

避免使用相对路径,如 `../api-playground/overview`——当页面移动时它们会断裂,而且在审查时更难扫描。
Mintlify 根据源文件在项目目录中的位置解析相对路径(`./` 和 `../`)。这适用于链接、图像以及 `<Card>` 和 `<a>` 等 JSX 元素。

```mdx
- [同级页面](./sibling-page)
- [上级部分页面](../other-page)
```

对于 `index.mdx` 文件,相对路径从包含索引文件的目录开始解析。例如,`guides/getting-started/index.mdx` 中的 `./setup` 链接会解析为 `/guides/getting-started/setup`。

链接会保留片段和查询字符串。

```mdx
[设置说明](./setup#step-1)
```

<Tip>
根相对路径(以 `/` 开头)在内部链接上表现更好,因为即使你将链接页面移动到其他目录,它们也能保持正确。
</Tip>

<div id="anchor-links">
## 锚点链接
Expand Down Expand Up @@ -224,7 +241,9 @@ mint broken-links

<AccordionGroup>
<Accordion title="内部链接应该使用根相对路径还是绝对 URL?">
根相对路径(以 `/` 开头)是 Mintlify 中内部链接的正确选择。无论链接页面在目录中的位置如何,它们都能一致地工作,而且如果你的文档域名更改也不会断裂。内部链接使用绝对 URL 会造成不必要的脆弱性。
根相对路径(以 `/` 开头)是 Mintlify 中内部链接最常见的选择。无论链接页面在目录中的位置如何,它们都能一致地工作,而且如果你的文档域名更改也不会断裂。内部链接使用绝对 URL 会造成不必要的脆弱性。

你可以使用相对路径(`./` 和 `../`),但由于它们是根据源文件的位置解析的,可能会更频繁地断裂。
</Accordion>

<Accordion title="更新标题时如何保持锚点链接稳定?">
Expand Down
Loading