Páginas ocultas

Algumas páginas não pertencem à barra lateral pública: rascunhos, manuais internos e guias obsoletos aos quais você ainda precisa vincular. As páginas ocultas continuam acessíveis por URL direta, mas desaparecem da navegação, da busca, do sitemap e do contexto de IA fornecido aos LLMs.

Ocultar uma única página

Adicione hidden: true ao frontmatter da página:

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

A página é renderizada normalmente quando alguém acessa sua URL, mas o Jamdesk:

• Remove-a da barra lateral
• Adiciona <meta name="robots" content="noindex, follow"> para que os mecanismos de busca a ignorem
• Exclui-a de sitemap.xml, llms.txt, llms-full.txt e da busca no site

Ocultar um grupo ou uma aba inteira

Defina "hidden": true em um grupo ou uma aba no docs.json:

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

Todas as páginas no nó oculto herdam essa regra. O mesmo sinalizador funciona em tabs, groups, anchors, dropdowns, products, languages e versions.

Manter páginas ocultas na busca

Se quiser remover uma aba ou um grupo oculto da barra lateral, mas ainda indexá-lo para a busca no site, as respostas de IA e o sitemap, adicione "searchable": true:

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

O hidden: true do frontmatter em uma página filha ainda tem precedência. searchable apenas reabre descendentes que não optaram por sair da busca.

Manter uma página fora da busca בלבד

Às vezes, uma página deve continuar na barra lateral e permanecer indexável, mas deixar de aparecer quando alguém faz uma busca ou uma pergunta. Adicione search: false ao frontmatter:

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

A página mantém seu lugar na navegação, no sitemap, em llms.txt e no feed RSS, e os mecanismos de busca continuam indexando-a. O que ela deixa são as superfícies de consulta: a busca no site, as respostas do chat de IA e o servidor MCP.

Quanto de uma página é indexado

A busca não indexa uma página como um bloco único. Ela a indexa seção por seção — cada título se torna sua própria entrada de busca, portanto, quem busca por "Rate limits" chega a esse título em vez do início de uma página longa.

Duas limitações se aplicam, e ambas são automáticas:

A própria página ocupa uma das 50 posições, portanto 49 seções são indexadas.

O limite existe porque a busca compara o peso de cada entrada com o restante do seu índice. Uma página que emite centenas de entradas expulsa as outras dos resultados — um changelog gerado pode, sozinho, representar metade de um índice e tirar páginas realmente relevantes da primeira tela.

Para colocar um termo onde a busca possa atribuir a ele o peso adequado, use o título da página (maior peso), depois um título de seção e, por fim, a descrição. O texto do corpo tem o menor peso, e apenas seus primeiros 300 caracteres por seção são considerados.

Controles para todo o projeto

Ambos os sinalizadores ficam em seo no docs.json:

Exemplo:

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

Referência rápida

Quando usar cada opção

• Rascunhos e prévias: hidden: true no frontmatter de páginas individuais
• Seções internas para uma equipe pequena: um grupo ou uma aba ocultos
• Documentos de conformidade que devem ser públicos, mas não promovidos: grupo oculto com searchable: true
• Indexação do repositório inteiro apenas para fundamentação de IA: seo.indexing: "all"
• Páginas substituídas que você ainda quer disponibilizar por link e indexar, mas não exibir na busca ou na IA: search: false no frontmatter

Páginas ocultas não são um mecanismo de controle de acesso. Qualquer pessoa que tenha a URL pode lê-las. Para obter um controle de acesso real, consulte Proteção por senha.