Skip to content

Commit 006662d

Browse files
docs: translate indexing toggle updates into es, fr, zh and fix anchors
1 parent d6af8b3 commit 006662d

20 files changed

Lines changed: 353 additions & 8 deletions

‎es.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -459,7 +459,9 @@
459459
"es/help-center/preview-deployment-not-created-for-fork-branch",
460460
"es/help-center/branch-missing-from-editor-branch-list",
461461
"es/help-center/style-card-icons-with-custom-css",
462-
"es/help-center/can-i-rename-my-deployment-or-organization"
462+
"es/help-center/can-i-rename-my-deployment-or-organization",
463+
"es/help-center/llms-txt-returns-404-but-llms-full-txt-works",
464+
"es/help-center/site-search-returns-no-results"
463465
]
464466
}
465467
]

‎es/ai/llmstxt.mdx‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,10 @@ El archivo `llms-full.txt` reúne todo tu sitio de documentación en un único a
120120

121121
Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Visualiza tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. Mintlify también aloja el archivo en `/.well-known/llms-full.txt` para garantizar la compatibilidad con herramientas que siguen la convención `.well-known`.
122122

123+
<Note>
124+
La opción [Don't index project](/es/optimize/seo#disable-indexing-for-the-entire-project) devuelve `404` para `llms.txt`, pero no afecta a `llms-full.txt`.
125+
</Note>
126+
123127
<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Abrir el llms-full.txt de este sitio.</PreviewButton>
124128

125129
<div id="custom-files">
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: "llms.txt devuelve 404 pero llms-full.txt funciona"
3+
description: "Diagnostica por qué el llms.txt de tu sitio devuelve un error 404 mientras llms-full.txt carga, normalmente por la opción Don't index project."
4+
keywords: ["llms.txt 404", "llms.txt not found", "llms-full.txt works", "no llms.txt", "don't index project", "noindex"]
5+
---
6+
7+
Mintlify aloja automáticamente un archivo [`llms.txt`](/es/ai/llmstxt) en la raíz de cada sitio de documentación. Si `https://yourdocs.com/llms.txt` devuelve `404` mientras `https://yourdocs.com/llms-full.txt` carga con normalidad, la causa más probable es la opción **Don't index project**.
8+
9+
<div id="check-the-dont-index-project-setting">
10+
## Comprueba la opción Don't index project
11+
</div>
12+
13+
Cuando activas **Don't index project** en la página [Add-ons](https://app.mintlify.com/settings/deployment/addons) de tu panel, Mintlify devuelve `404` para `llms.txt` y `/.well-known/llms.txt`. La opción no bloquea `llms-full.txt`, que sigue disponible. Esta discrepancia hace que la ausencia de `llms.txt` parezca un error del despliegue cuando en realidad es un comportamiento configurado.
14+
15+
La exportación en Markdown de cada página (la URL `.md`) también conserva su referencia a `/llms.txt` mientras la opción está activada, aunque esa URL devuelva `404`.
16+
17+
Para restaurar `llms.txt`:
18+
19+
1. Abre la página [Add-ons](https://app.mintlify.com/settings/deployment/addons) de tu panel.
20+
2. Desactiva **Don't index project**.
21+
3. Espera a que se complete el redespliegue. Activar o desactivar la indexación redespliega tu sitio, y el cambio surte efecto una vez finalizado el redespliegue.
22+
23+
Consulta [Desactivar la indexación de todo el proyecto](/es/optimize/seo#disable-indexing-for-the-entire-project) para conocer todo lo demás que controla esta opción.
24+
25+
<div id="other-causes">
26+
## Otras causas
27+
</div>
28+
29+
Si **Don't index project** está desactivada y `llms.txt` sigue devolviendo `404`:
30+
31+
- **Autenticación**: en los sitios totalmente autenticados, tanto `llms.txt` como `llms-full.txt` requieren autenticación. Las solicitudes no autenticadas fallan para ambos archivos, no solo para `llms.txt`. Consulta [llms.txt](/es/ai/llmstxt) para ver cómo la autenticación afecta a cada archivo.
32+
- **Enrutamiento del proxy inverso**: si sirves tu documentación a través de un proxy inverso con una lista de rutas permitidas, confirma que el proxy reenvía `/llms.txt` y `/.well-known/llms.txt`. Consulta [Proxy inverso](/es/deploy/reverse-proxy#routing-configuration).
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: "Solucionar que la búsqueda del sitio no devuelva resultados"
3+
description: "Diagnostica por qué la búsqueda integrada de tu documentación no devuelve resultados, a menudo por hidden: true en una versión de docs.json."
4+
keywords: ["search returns no results", "empty search", "search broken", "hidden version", "search index empty", "site search"]
5+
---
6+
7+
Si la búsqueda integrada de tu sitio de documentación de Mintlify no devuelve resultados para ninguna consulta, incluidos los títulos exactos de las páginas, lo más probable es que tus páginas estén excluidas del índice de búsqueda por un ajuste `hidden` en tu `docs.json`.
8+
9+
<div id="check-for-hidden-true-on-a-version-or-other-top-level-navigation-element">
10+
## Busca `hidden: true` en una versión u otro elemento de navegación de nivel superior
11+
</div>
12+
13+
Establecer `hidden: true` en una versión, un anclaje, un menú desplegable, un idioma o un producto en tu `docs.json` excluye del índice de búsqueda todas las páginas que contiene. Si ese elemento contiene todas tus páginas, como tu única versión, el índice de búsqueda queda vacío y todas las búsquedas devuelven nada. El sitio en sí sigue funcionando porque las páginas ocultas permanecen accesibles por URL directa.
14+
15+
```json Example: this hides every page from search
16+
"navigation": {
17+
"versions": [
18+
{
19+
"version": "v1",
20+
"hidden": true,
21+
"groups": [...]
22+
}
23+
]
24+
}
25+
```
26+
27+
Para solucionarlo, elige una de las siguientes opciones:
28+
29+
- Elimina `hidden: true` de la versión o del otro elemento.
30+
- Mantén el elemento oculto en la navegación, pero devuelve sus páginas a la búsqueda y la indexación estableciendo `seo.indexing: "all"` en tu `docs.json`:
31+
32+
```json
33+
"seo": {
34+
"indexing": "all"
35+
}
36+
```
37+
38+
A diferencia de las pestañas y los grupos, las versiones y otros elementos de navegación de nivel superior no admiten la inclusión mediante `searchable: true`. Consulta [Páginas ocultas](/es/organize/hidden-pages#search-seo-and-ai-indexing) para ver el comportamiento completo de visibilidad e indexación de cada ubicación de `hidden`.
39+
40+
La búsqueda se vuelve a indexar cuando tu sitio se reconstruye, así que envía el cambio de `docs.json` y espera a que se complete el despliegue antes de volver a probar.
41+
42+
<div id="other-causes">
43+
## Otras causas
44+
</div>
45+
46+
- **Pestañas o grupos ocultos**: `hidden: true` en una pestaña o un grupo también excluye sus páginas de la búsqueda. En pestañas y grupos, puedes añadir `searchable: true` junto a `hidden: true` para que las páginas descendientes sigan siendo localizables. Consulta [Incluir páginas bajo pestañas o grupos ocultos específicos](/es/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups).
47+
- **Páginas ausentes de la navegación**: las páginas que no aparecen en la navegación de tu `docs.json` se excluyen de la búsqueda de forma predeterminada.
48+
- **Frontmatter de la página**: `hidden: true`, `noindex: true` o `searchable: false` en el frontmatter de una página excluyen esa página de la búsqueda del sitio.

‎es/optimize/seo.mdx‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -472,7 +472,7 @@ Cuando se activa, Mintlify:
472472

473473
- Renderiza todas las páginas con las metaetiquetas robots `noindex, nofollow`.
474474
- Devuelve un `sitemap.xml` vacío.
475-
- Devuelve `404` para `llms.txt` y `llms-full.txt`.
475+
- Devuelve `404` para `llms.txt`, incluso en `/.well-known/llms.txt`.
476476
- Elimina tus páginas de [Mintlify Index](/es/search-index), de modo que los agentes de código ya no puedan recuperar tu contenido allí.
477477
- Sirve un `robots.txt` que bloquea todo el sitio:
478478

@@ -484,6 +484,10 @@ Cuando se activa, Mintlify:
484484

485485
Tu búsqueda integrada en el producto, el [asistente](/es/assistant/index) y el [servidor MCP](/es/ai/model-context-protocol) siguen funcionando. Para eliminar páginas de esas superficies, usa `noindex: true` o `searchable: false` en páginas individuales.
486486

487+
<Note>
488+
**Don't index project** no bloquea [`llms-full.txt`](/es/ai/llmstxt#llms-fulltxt), que sigue disponible en `/llms-full.txt`. La exportación en Markdown de cada página también conserva su referencia a `/llms.txt`, aunque ese archivo devuelva `404` mientras la opción está activada. Si tu `llms.txt` devuelve `404` pero `llms-full.txt` funciona, revisa esta opción. Consulta [Solucionar que llms.txt devuelva 404 mientras llms-full.txt funciona](/es/help-center/llms-txt-returns-404-but-llms-full-txt-works).
489+
</Note>
490+
487491
Usa esta opción cuando quieras mantener un despliegue en línea para revisión interna, pruebas o uso compartido limitado, pero no quieras que aparezca en los resultados públicos de búsqueda ni que se utilice como datos de entrenamiento o de recuperación para herramientas de IA.
488492

489493
<Note>

‎es/organize/hidden-pages.mdx‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,30 @@ Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `do
102102
]
103103
```
104104

105+
<div id="hide-a-version-or-other-top-level-navigation-element">
106+
### Ocultar una versión u otro elemento de navegación de nivel superior
107+
</div>
108+
109+
Las versiones, los anclajes, los menús desplegables, los idiomas y los productos también aceptan la propiedad `hidden`. Establecer `hidden: true` en uno de estos elementos lo elimina de la navegación renderizada y excluye todas las páginas que contiene de la búsqueda del sitio, los sitemaps, la indexación en motores de búsqueda y el contexto de IA.
110+
111+
```json highlight={4}
112+
"versions": [
113+
{
114+
"version": "v1",
115+
"hidden": true,
116+
"groups": [...]
117+
},
118+
{
119+
"version": "v2",
120+
"groups": [...]
121+
}
122+
]
123+
```
124+
125+
<Warning>
126+
Si estableces `hidden: true` en tu única versión, o en la versión que contiene todas tus páginas, el índice de búsqueda de tu sitio queda vacío y las búsquedas no devuelven resultados. A diferencia de las pestañas y los grupos, las versiones no admiten `searchable: true`. Para que las versiones ocultas vuelvan a la búsqueda y la indexación, elimina `hidden: true` de la versión o establece `seo.indexing: "all"` en tu `docs.json`. Consulta [Solucionar que la búsqueda del sitio no devuelva resultados](/es/help-center/site-search-returns-no-results).
127+
</Warning>
128+
105129
<div id="search-seo-and-ai-indexing">
106130
## Búsqueda, SEO e indexación de IA
107131
</div>
@@ -113,6 +137,7 @@ La siguiente tabla resume cómo cada propiedad afecta la visibilidad y la indexa
113137
| Propiedad | Navegación lateral | Búsqueda del sitio | Sitemap | Indexación en motores de búsqueda | Contexto del assistant de IA | `llms.txt` |
114138
|---|---|---|---|---|---|---|
115139
| `hidden: true` (frontmatter de la página) | Oculta | Excluida | Excluida | Excluida | Excluida | Excluida |
140+
| `hidden: true` (versión u otro elemento de navegación de nivel superior) | Oculta | Excluida | Excluida | Excluida | Excluida | Excluida |
116141
| Página no listada en `docs.json` | Oculta | Excluida | Excluida | Excluida solo del sitemap | Excluida | Excluida |
117142
| `noindex: true` (frontmatter de la página) | Visible | Excluida | Excluida | Excluida | Excluida | Excluida |
118143
| `searchable: false` (frontmatter de la página) | Visible | Excluida | Incluida | Incluida | Excluida | Incluida |

‎fr.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -459,7 +459,9 @@
459459
"fr/help-center/preview-deployment-not-created-for-fork-branch",
460460
"fr/help-center/branch-missing-from-editor-branch-list",
461461
"fr/help-center/style-card-icons-with-custom-css",
462-
"fr/help-center/can-i-rename-my-deployment-or-organization"
462+
"fr/help-center/can-i-rename-my-deployment-or-organization",
463+
"fr/help-center/llms-txt-returns-404-but-llms-full-txt-works",
464+
"fr/help-center/site-search-returns-no-results"
463465
]
464466
}
465467
]

‎fr/ai/llmstxt.mdx‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,10 @@ Le fichier `llms-full.txt` regroupe l'intégralité de votre site de documentati
120120

121121
Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de votre projet. Affichez votre `llms-full.txt` en ajoutant `/llms-full.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms-full.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.
122122

123+
<Note>
124+
Le paramètre [Don't index project](/fr/optimize/seo#disable-indexing-for-the-entire-project) renvoie `404` pour `llms.txt`, mais n'affecte pas `llms-full.txt`.
125+
</Note>
126+
123127
<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Ouvrir le llms-full.txt de ce site</PreviewButton>
124128

125129
<div id="custom-files">
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: "llms.txt renvoie 404 mais llms-full.txt fonctionne"
3+
description: "Diagnostiquez pourquoi le llms.txt de votre site renvoie une erreur 404 alors que llms-full.txt se charge, souvent dû au paramètre Don't index project."
4+
keywords: ["llms.txt 404", "llms.txt not found", "llms-full.txt works", "no llms.txt", "don't index project", "noindex"]
5+
---
6+
7+
Mintlify héberge automatiquement un fichier [`llms.txt`](/fr/ai/llmstxt) à la racine de chaque site de documentation. Si `https://yourdocs.com/llms.txt` renvoie `404` alors que `https://yourdocs.com/llms-full.txt` se charge normalement, la cause la plus probable est le paramètre **Don't index project**.
8+
9+
<div id="check-the-dont-index-project-setting">
10+
## Vérifier le paramètre Don't index project
11+
</div>
12+
13+
Lorsque vous activez **Don't index project** sur la page [Add-ons](https://app.mintlify.com/settings/deployment/addons) de votre tableau de bord, Mintlify renvoie `404` pour `llms.txt` et `/.well-known/llms.txt`. Ce paramètre ne bloque pas `llms-full.txt`, qui reste disponible. Cette différence donne l'impression que l'absence de `llms.txt` est un bug de déploiement, alors qu'il s'agit d'un comportement configuré.
14+
15+
L'export Markdown de chaque page (l'URL `.md`) conserve également son pointeur vers `/llms.txt` tant que le paramètre est activé, même si cette URL renvoie `404`.
16+
17+
Pour rétablir `llms.txt` :
18+
19+
1. Ouvrez la page [Add-ons](https://app.mintlify.com/settings/deployment/addons) de votre tableau de bord.
20+
2. Désactivez **Don't index project**.
21+
3. Attendez la fin du redéploiement. Activer ou désactiver l'indexation redéploie votre site, et le changement prend effet une fois le redéploiement terminé.
22+
23+
Consultez [Désactiver l'indexation pour l'ensemble du projet](/fr/optimize/seo#disable-indexing-for-the-entire-project) pour découvrir tout ce que ce paramètre contrôle par ailleurs.
24+
25+
<div id="other-causes">
26+
## Autres causes
27+
</div>
28+
29+
Si **Don't index project** est désactivé et que `llms.txt` renvoie toujours `404` :
30+
31+
- **Authentification** : sur les sites entièrement authentifiés, `llms.txt` et `llms-full.txt` nécessitent tous deux une authentification. Les requêtes non authentifiées échouent pour les deux fichiers, pas seulement pour `llms.txt`. Consultez [llms.txt](/fr/ai/llmstxt) pour savoir comment l'authentification affecte chaque fichier.
32+
- **Routage du reverse proxy** : si vous servez votre documentation via un reverse proxy avec une liste d'autorisation de chemins, vérifiez que le proxy transfère `/llms.txt` et `/.well-known/llms.txt`. Consultez [Reverse proxy](/fr/deploy/reverse-proxy#routing-configuration).
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: "La recherche du site ne renvoie aucun résultat"
3+
description: "Diagnostiquez pourquoi la recherche intégrée de votre site ne renvoie aucun résultat, souvent à cause de hidden: true sur une version dans docs.json."
4+
keywords: ["search returns no results", "empty search", "search broken", "hidden version", "search index empty", "site search"]
5+
---
6+
7+
Si la recherche intégrée de votre site de documentation Mintlify ne renvoie aucun résultat, quelle que soit la requête, y compris les titres exacts de pages, vos pages sont probablement exclues de l'index de recherche par un paramètre `hidden` dans votre `docs.json`.
8+
9+
<div id="check-for-hidden-true-on-a-version-or-other-top-level-navigation-element">
10+
## Vérifier la présence de `hidden: true` sur une version ou un autre élément de navigation de premier niveau
11+
</div>
12+
13+
Définir `hidden: true` sur une version, une ancre, un menu déroulant, une langue ou un produit dans votre `docs.json` exclut chaque page qu'il contient de l'index de recherche. Si cet élément contient toutes vos pages, par exemple votre seule version, l'index de recherche devient vide et chaque recherche ne renvoie rien. Le site lui-même continue de fonctionner, car les pages masquées restent accessibles par URL directe.
14+
15+
```json Example: this hides every page from search
16+
"navigation": {
17+
"versions": [
18+
{
19+
"version": "v1",
20+
"hidden": true,
21+
"groups": [...]
22+
}
23+
]
24+
}
25+
```
26+
27+
Pour corriger le problème, choisissez l'une des options suivantes :
28+
29+
- Retirez `hidden: true` de la version ou de l'autre élément.
30+
- Gardez l'élément masqué dans la navigation, mais réintégrez ses pages dans la recherche et l'indexation en définissant `seo.indexing: "all"` dans votre `docs.json` :
31+
32+
```json
33+
"seo": {
34+
"indexing": "all"
35+
}
36+
```
37+
38+
Contrairement aux onglets et aux groupes, les versions et les autres éléments de navigation de premier niveau ne prennent pas en charge l'option `searchable: true`. Consultez [Pages masquées](/fr/organize/hidden-pages#search-seo-and-ai-indexing) pour le comportement complet de visibilité et d'indexation de chaque emplacement de `hidden`.
39+
40+
La recherche se réindexe lorsque votre site est reconstruit ; poussez donc la modification de `docs.json` et attendez la fin du déploiement avant de tester à nouveau.
41+
42+
<div id="other-causes">
43+
## Autres causes
44+
</div>
45+
46+
- **Onglets ou groupes masqués** : `hidden: true` sur un onglet ou un groupe exclut également ses pages de la recherche. Pour les onglets et les groupes, vous pouvez ajouter `searchable: true` en plus de `hidden: true` pour garder les pages descendantes accessibles à la recherche. Consultez [Inclure les pages situées sous des onglets ou groupes masqués spécifiques](/fr/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups).
47+
- **Pages absentes de la navigation** : les pages qui ne figurent pas dans la navigation de votre `docs.json` sont exclues de la recherche par défaut.
48+
- **Frontmatter de la page** : `hidden: true`, `noindex: true` ou `searchable: false` dans le frontmatter d'une page excluent chacun cette page de la recherche du site.

0 commit comments

Comments
 (0)