Pagine nascoste

Alcune pagine non devono comparire nella barra laterale pubblica: bozze, manuali interni, guide obsolete a cui però devi ancora fare riferimento. Le pagine nascoste restano raggiungibili tramite URL diretto, ma scompaiono dalla navigazione, dalla ricerca, dalla tua sitemap e dal contesto AI fornito agli LLM.

Nascondere una singola pagina

Aggiungi hidden: true al frontmatter della pagina:

---
title: Internal handbook
hidden: true
---

La pagina viene comunque renderizzata al suo URL. Jamdesk:

La rimuove dalla barra laterale
Aggiunge <meta name="robots" content="noindex, follow"> così i motori di ricerca la ignorano
La esclude da sitemap.xml, llms.txt, llms-full.txt e dalla ricerca interna al sito

Nascondere un intero gruppo o una scheda

Imposta "hidden": true su un gruppo o un tab in docs.json:

{
  "navigation": {
    "tabs": [
      {
        "tab": "Public",
        "groups": [{ "group": "Guides", "pages": ["intro", "quickstart"] }]
      },
      {
        "tab": "Internal",
        "hidden": true,
        "groups": [{ "group": "Runbooks", "pages": ["oncall", "postmortems"] }]
      }
    ]
  }
}

Ogni pagina sotto il nodo nascosto eredita la regola. Lo stesso flag funziona su tabs, groups, anchors, dropdowns, products, languages e versions.

Mantenere le pagine nascoste nella ricerca

Aggiungi "searchable": true per mantenere un tab o un gruppo nascosto indicizzato per la ricerca nel sito, le risposte AI e la sitemap:

{
  "tab": "Internal",
  "hidden": true,
  "searchable": true,
  "groups": [{ "group": "Runbooks", "pages": ["oncall"] }]
}

Il frontmatter hidden: true su una pagina figlia ha comunque la precedenza. searchable riapre solo i discendenti che non hanno già scelto di escludersi.

Escludere una pagina solo dalla ricerca

Aggiungi search: false al frontmatter di una pagina che deve restare nella barra laterale e indicizzabile, ma non deve comparire nella ricerca del sito né nelle risposte AI:

---
title: Legacy v1 endpoints
search: false
---

La pagina mantiene il suo posto nella navigazione, nella sitemap, in llms.txt e nel feed RSS. I motori di ricerca la indicizzano ancora. Esce invece dalle superfici di consultazione: ricerca nel sito, risposte della chat AI e server MCP.

search: false ha il compito opposto a hidden: true. hidden rimuove una pagina dalla navigazione e dalle superfici di indicizzazione. search: false lascia tutto il resto invariato e impedisce solo che la pagina venga recuperata. Non confonderlo con searchable a livello di navigazione, che riporta le pagine nascoste dentro la ricerca.

Quanto di una pagina viene indicizzato

La ricerca non indicizza una pagina come un blocco unico, ma sezione per sezione. Ogni titolo diventa una voce di ricerca separata. Cercando "Rate limits" si arriva direttamente a quel titolo e non all'inizio di una pagina lunga.

Si applicano automaticamente due limiti:

Limite	Valore	Cosa succede oltre il limite
Voci per pagina	50	Le sezioni vengono indicizzate nell'ordine della pagina. Quelle dopo la cinquantesima restano escluse dalla ricerca.
Testo per sezione	Primi 300 caratteri	Il testo più in profondità in una sezione non viene trovato.

La pagina stessa occupa uno dei 50 slot, quindi vengono indicizzate 49 sezioni.

Il limite esiste perché la ricerca confronta ogni voce con il resto dell'indice. Una pagina che genera centinaia di voci esclude le altre dai risultati. Un changelog generato può riempire metà dell'indice e spingere le pagine pertinenti fuori dalla prima schermata.

Una pagina oltre il limite viene comunque renderizzata per intero. Solo le sezioni successive smettono di essere trovabili, e nulla nella pagina lo segnala ai lettori.

Dividi una pagina con più di circa 50 titoli in più pagine. Questo migliora anche la navigazione. Per una pagina generata automaticamente che nessuno cerca a mano, aggiungi invece search: false per escludere l'intera pagina dall'indice.

Inserisci un termine dove la ricerca gli attribuisce più peso: il titolo della pagina (peso massimo), poi un titolo di sezione, poi la descrizione. Il testo del corpo ha il peso minore, e solo i suoi primi 300 caratteri per sezione vengono considerati.

seo.metatags.keywords non alimenta la ricerca del sito. Emette un tag HTML <meta name="keywords">, che Google ha dichiarato di ignorare ai fini del ranking. Non puoi associare termini di ricerca aggiuntivi a una pagina. Inserisci le parole che vuoi trovate nel titolo, in un titolo di sezione o nella descrizione.

Controlli a livello di progetto

Questi flag si trovano sotto seo in docs.json:

Flag	Predefinito	Effetto
`seo.indexing`	`"navigable"`	Negli artefatti compaiono solo le pagine elencate nella navigazione. Imposta `"all"` per includere ogni file MDX del repository.
`seo.indexHiddenPages`	`false`	Imposta `true` per includere le pagine `hidden: true` in sitemap, llms.txt e ricerca, e per eliminare il tag noindex automatico.

Esempio:

{
  "seo": {
    "indexing": "all"
  }
}

Riferimento rapido

Scenario	Frontmatter	docs.json	Visibile nella barra laterale	URL diretto	Nella sitemap
Pagina normale	-	elencata	Sì	Sì	Sì
Nascosta tramite frontmatter	`hidden: true`	elencata	No	Sì	No
Pagina non in navigazione (orfana)	-	omessa	No	Sì	No
Gruppo nascosto	-	`hidden: true` sul gruppo	No	Sì	No
Gruppo nascosto e ricercabile	-	`hidden: true, searchable: true`	No	Sì	Sì
Esclusa solo dalla ricerca	`search: false`	elencata	Sì	Sì	Sì
Il progetto indicizza tutto	-	qualsiasi	Come sopra	Sì	Sì

Quando usare ciascuna opzione

Bozze e anteprime: frontmatter hidden: true sulle singole pagine
Sezioni interne per un piccolo team: un gruppo o un tab nascosto
Documenti di conformità che devono essere pubblici ma non promossi: gruppo nascosto con searchable: true
Indicizzazione dell'intero repository solo per l'AI grounding: seo.indexing: "all"
Pagine superate che vuoi ancora linkabili e indicizzate ma non mostrate dalla ricerca né dall'AI: frontmatter search: false

Le pagine nascoste non sono un controllo degli accessi. Chiunque abbia l'URL può leggerle. Per il controllo degli accessi, vedi Protezione con password.