Publicações

Este guia explica como cadastrar e manter publicações seguindo os campos validados da coleção.

As publicações ficam em src/content/publicacoes/.

Nome do arquivo

Use o padrão: YYYY-MM-DD-{slug}.mdx

O idioma vai no frontmatter (lang), não no nome do arquivo.

Exemplos:

• 2026-04-15-gestao-de-dados.mdx
• 2026-04-15-introducao-ao-r.mdx

Estrutura de arquivos

As publicações podem ser salvas diretamente em src/content/publicacoes/.

Use o campo lang no frontmatter para definir o idioma (pt, en, es).

Frontmatter

Exemplo mínimo (só frontmatter)

---
title: 'Título da publicação'
date: 2024-02-15
authors: ['Autor 1', 'Autor 2']
summary: 'Resumo breve do trabalho.'
type: 'material-didatico'
lang: 'pt'
---

Exemplo completo (frontmatter + corpo)

---
title: 'Introdução ao R para Ciências Sociais'
date: 2026-03-10
authors: ['Ana Silva', 'Bruno Costa']
summary: 'Material didático para primeiros passos com R aplicado a dados sociais.'
tags: ['R', 'Estatística', 'Dados']
type: 'material-didatico'
lang: 'pt'
image: '/imagens/publicacoes/2026-03-10-intro-r.jpg'
featured: true
pdf_url: '/arquivos/intro-r-ciencias-sociais.pdf'
---

Este material foi desenvolvido para auxiliar estudantes de ciências
sociais que estão tendo o primeiro contato com a linguagem R.

## Conteúdo abordado

1. Instalação do R e RStudio
2. Importação de dados (CSV, Excel)
3. Manipulação com **dplyr**
4. Visualização com **ggplot2**

## Pré-requisitos

- Computador com acesso à internet
- Nenhum conhecimento prévio de programação é necessário

## Como usar este material

Baixe o PDF pelo link acima ou siga os capítulos diretamente nesta
página. Cada seção inclui exercícios práticos com dados reais.

> O material é atualizado semestralmente pela equipe do CPPS.

Tipos aceitos (importante)

O campo type é estrito. Use apenas um destes valores:

• material-didatico: apostilas, guias de estudo e materiais de apoio.
• tutorial: conteúdos práticos passo a passo.

Como manter os tipos ao longo do tempo

Para facilitar manutenção, os tipos válidos ficam centralizados em:

• src/config/publicationTypes.ts

Fluxo recomendado quando quiser adicionar, renomear ou remover tipos:

1. Atualize a lista PUBLICATION_TYPES em src/config/publicationTypes.ts.
2. Ajuste os rótulos exibidos na interface (PT/EN/ES) em:
   • src/i18n/locales/pt.json → publicacoes.types
   • src/i18n/locales/en.json → publicacoes.types
   • src/i18n/locales/es.json → publicacoes.types
3. Rode o build (npm run build) para validar conteúdo e filtros.

Como adicionar nova publicação

1. Crie um arquivo .md ou .mdx em src/content/publicacoes/ (ex: src/content/publicacoes/meu-artigo.md).
2. Preencha o frontmatter seguindo o modelo acima.
3. Escreva o texto em Markdown abaixo do frontmatter.

Tabela de campos

• authors deve ser uma lista de nomes entre colchetes.
• Se não houver image, o card é exibido sem foto.
• Use featured: true apenas em publicações que devem ganhar destaque.

Como adicionar imagens

As imagens das publicações ficam em public/imagens/publicacoes/ (crie a pasta se ainda não existir). Use nomes em minúsculas e com hífens.

Para adicionar uma imagem pelo GitHub:

1. Acesse public/imagens/publicacoes/ no repositório (ou crie a pasta fazendo upload).
2. Clique em “Add file” → “Upload files”.
3. Faça o commit no seu branch.

No frontmatter, referencie assim:

image: '/imagens/publicacoes/2026-04-20-gestao-dados.jpg'