diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx index 5b1d24990..11857aaa5 100644 --- a/es/cli/commands.mdx +++ b/es/cli/commands.mdx @@ -554,7 +554,11 @@ mint broken-links [flags] El comando analiza los archivos `.mdx` y `.md` en busca de enlaces y excluye los archivos que coinciden con los patrones de [.mintignore](/es/organize/mintignore). No se verifican los enlaces dentro de archivos de especificación OpenAPI (`.yaml`, `.yml`, `.json`). Los enlaces que apuntan a archivos ignorados se reportan como rotos. -Los enlaces relativos (`./`, `../`) y los enlaces de anclaje (`#`) dentro de un snippet se verifican en cada página que renderiza el snippet. El comando solo reporta uno de estos enlaces si está roto en al menos una de esas páginas. Con `--check-anchors`, los encabezados dentro de un snippet cuentan como anclajes en las páginas que lo renderizan. +El comando verifica los enlaces e imágenes de Markdown, incluidos los enlaces de estilo referencia como `[text][id]`. También verifica el `href` de los componentes `` y `` y el `src` de las etiquetas `` y ``, ya sea que estén escritos como una cadena simple o como un valor fijo entre llaves, como `href={"/quickstart"}`. Los valores calculados a partir de variables no se verifican. + +Los enlaces sin `/` inicial, como `quickstart` o `../quickstart`, se resuelven desde el directorio de la página que los contiene, de la misma forma en que los resuelve un navegador. Para enlazar desde la raíz de tu sitio, comienza la ruta con `/`. + +Para los enlaces sin `/` inicial y los enlaces de anclaje (`#`) dentro de un snippet, el comando verifica cada página que renderiza el snippet. El comando solo reporta uno de estos enlaces si está roto en al menos una de esas páginas. Con `--check-anchors`, los encabezados dentro de un snippet cuentan como anclajes en las páginas que lo renderizan. | Flag | Descripción | | --- | --- | diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx index 22b133da2..19b03bca1 100644 --- a/fr/cli/commands.mdx +++ b/fr/cli/commands.mdx @@ -554,7 +554,11 @@ mint broken-links [flags] La commande analyse les liens des fichiers `.mdx` et `.md` et exclut les fichiers correspondant aux motifs [.mintignore](/fr/organize/mintignore). Les liens contenus dans les fichiers de spécification OpenAPI (`.yaml`, `.yml`, `.json`) ne sont pas vérifiés. Les liens pointant vers des fichiers ignorés sont signalés comme cassés. -Les liens relatifs (`./`, `../`) et les liens d'ancre (`#`) à l'intérieur d'un snippet sont vérifiés sur chaque page qui affiche le snippet. La commande signale un de ces liens uniquement s'il est cassé sur au moins une de ces pages. Avec `--check-anchors`, les titres à l'intérieur d'un snippet comptent comme des ancres sur les pages qui l'affichent. +La commande vérifie les liens et images Markdown, y compris les liens de style référence comme `[text][id]`. Elle vérifie aussi le `href` des composants `` et `` ainsi que le `src` des balises `` et ``, qu'ils soient écrits sous forme de chaîne simple ou de valeur fixe entre accolades, comme `href={"/quickstart"}`. Les valeurs calculées à partir de variables ne sont pas vérifiées. + +Les liens sans `/` initial, comme `quickstart` ou `../quickstart`, sont résolus à partir du répertoire de la page qui les contient, de la même manière qu'un navigateur les résout. Pour créer un lien depuis la racine de votre site, commencez le chemin par `/`. + +Pour les liens sans `/` initial et les liens d'ancre (`#`) à l'intérieur d'un snippet, la commande vérifie chaque page qui affiche le snippet. La commande signale un de ces liens uniquement s'il est cassé sur au moins une de ces pages. Avec `--check-anchors`, les titres à l'intérieur d'un snippet comptent comme des ancres sur les pages qui l'affichent. | Flag | Description | | --- | --- | diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx index a2ed6f9d1..83b5d0211 100644 --- a/zh/cli/commands.mdx +++ b/zh/cli/commands.mdx @@ -554,7 +554,11 @@ mint broken-links [flags] 该命令会扫描 `.mdx` 和 `.md` 文件中的链接，并排除匹配 [.mintignore](/zh/organize/mintignore) 模式的文件。OpenAPI 规范文件（`.yaml`、`.yml`、`.json`）中的链接不会被检查。指向被忽略文件的链接会被报告为断链。 -代码片段中的相对链接（`./`、`../`）和锚点链接（`#`）会针对每个渲染该代码片段的页面进行检查。只有当此类链接在其中至少一个页面上失效时，该命令才会报告它。使用 `--check-anchors` 时，代码片段中的标题会被视为渲染该代码片段的页面上的锚点。 +该命令会检查 Markdown 链接和图片，包括 `[text][id]` 这类引用式链接。它还会检查 `` 和 `` 组件的 `href`，以及 `` 和 `` 标签的 `src`，无论它们是写成普通字符串，还是写成花括号中的固定值（例如 `href={"/quickstart"}`）。由变量计算得出的值不会被检查。 + +不以 `/` 开头的链接（例如 `quickstart` 或 `../quickstart`）会从包含它们的页面所在目录进行解析，与浏览器的解析方式相同。若要从站点根目录进行链接，请以 `/` 作为路径开头。 + +对于代码片段中不以 `/` 开头的链接和锚点链接（`#`），该命令会检查每个渲染该代码片段的页面。只有当此类链接在其中至少一个页面上失效时，该命令才会报告它。使用 `--check-anchors` 时，代码片段中的标题会被视为渲染该代码片段的页面上的锚点。 | 选项 | 描述 | | --- | --- |