Criar Arquivos

Criar Arquivos

Estrutura de arquivos e pastas

Caminho da pastaDescrição do conteúdo
src/content/atividades/Documentação de atividades e projetos do CPPS
src/content/atendimento/Materiais e informações sobre atendimento
src/content/editarSite/Guias e instruções para edição e manutenção do site

O conteúdo localizado nas pastas acima é baseado em coleções de conteúdo. Isso significa que a organização das pastas define a organização dessa parte do site.

  • Localização principal: src/content/atividades/

  • Pastas sugeridas:

    PastaDescrição
    /projetos/dados/Documentação técnica de datasets.
    /projetos/ensino/Trilhas, cursos e manuais de treinamento.
    /projetos/sistemas/Infraestrutura, servidores e desenvolvimento.

Gerenciando menus (sidebar)

O menu lateral de /atividades é gerado automaticamente pela estrutura dos arquivos em src/content/atividades/.

Como inserir uma página no menu

  1. Crie o arquivo .md ou .mdx no local correto da coleção.
  2. Defina title no frontmatter.
  3. Salve e rode o site.
AçãoComo fazerExemplo
Criar páginaNovo arquivo .mdprojeto-x.md
Criar submenuNova pasta + arquivos/dados/projeto-x/
Página inicialArquivo index.md na pasta/dados/index.md
Mudar ordemsidebar_order: N no toposidebar_order: 1
Mudar nomesidebar_label: "Nome"sidebar_label: "Docs"

Frontmatter: opções disponíveis

CampoObrigatórioTipoExemploEfeito no site
titleRecomendadostringtitle: "Guia de Atendimento"Título da página e fallback no menu
descriptionNãostringdescription: "Resumo da página"Subtítulo no topo da página
sidebar_labelNãostringsidebar_label: "Início"Nome exibido no menu lateral
sidebar_sectionNãostringsidebar_section: "Operação"Coloca a página em seção dinâmica da sidebar
sidebar_orderNãonumbersidebar_order: 10Ordena itens na mesma seção (menor vem antes)
authorsNãostring[]authors: ["Ana", "Bruno"]Metadado editorial (sem efeito visual automático)
tagsNãostring[]tags: ["guia", "edição"]Metadado editorial para classificação futura
statusNãostringstatus: "draft"Metadado de fluxo (draft, published, archived)
updated_atNãostringupdated_at: "2026-02-12"Data da última revisão editorial
  • Sem sidebar_section, a página fica na raiz da sidebar.
  • Não existe mais seção Geral ou Introdução automática.
  • Metadados editoriais são aceitos no frontmatter, mas só aparecem no site se alguma tela/consulta usar esses campos.

Exemplo mínimo

---
title: 'Minha nova página'
description: 'Resumo do conteúdo'
---

Exemplo completo

---
title: 'Guia de atendimento'
description: 'Passos para abrir e acompanhar chamados'
sidebar_label: 'Atendimento'
sidebar_section: 'Operação'
sidebar_order: 10
authors: ['Equipe CPPS', 'Colaborador X']
tags: ['guia', 'edição']
status: 'draft'
updated_at: '2026-02-12'
---

Como organizar submenus

Os grupos e subgrupos são montados a partir das pastas.

Exemplo:

  • src/content/atividades/projetos/dados/meu-projeto/index.md
  • src/content/atividades/projetos/dados/meu-projeto/equipe.md

Isso gera a navegação:

  • Projetos
    • Dados
      • Meu Projeto
        • Equipe
ℹ️ Informação

Navegação inteligente: o grupo da página atual abre automaticamente no menu.