Publicar o site do projeto

mapa publicar gera um site estático com o painel do projeto: as mesmas vistas, lendo os mesmos dados, mas sem a API local. Ele funciona em qualquer servidor de arquivos, como o GitHub Pages, sem Python nem Ollama do outro lado.

Gerar

uv run mapa publicar

O site fica em saida/site/ (ou onde --destino indicar: uma pasta vazia, uma que ainda não existe ou um site publicado antes; a publicação troca todo o conteúdo do destino e, por isso, recusa uma pasta com outros arquivos ou a própria pasta do projeto). A saída diz quantos documentos entraram e quantos resumos foram publicados ou retirados. Antes de publicar, confira no navegador:

python -m http.server -d saida/site

e abra http://localhost:8000.

O que muda em relação ao painel local

• Só leitura. Sem API, não há como rodar etapas, editar o projeto nem codificar a amostra. A vista Projeto vira a página Metodologia, com o que o manifesto registra: fontes, recorte, modelos e licenças; a versão exata de cada modelo, o hash do codebook, as sementes e as durações ficam num bloco recolhido, "Para reproduzir".
• Para quem lê. O site mostra o resultado, e não o bastidor da execução. A Validação abre no par principal (o modelo contra a referência), com os outros pares e os detalhes técnicos (a comparação entre modelos, os estágios do júri e a auditoria) em blocos recolhidos; o cartão do documento não mostra os votos de cada modelo do júri; e uma vista sem dados diz que não faz parte da publicação, sem mandar rodar comandos. No painel local, tudo continua à mostra.
• Resumos só com licença aberta. O resumo de um artigo só vai para o site se a licença for Creative Commons (a mais restritiva entre a do OpenAlex e a da revista; veja Privacidade e licenças). Os outros aparecem com título, autores, revista, DOI e a licença, sem o resumo; os trechos que a classificação citou deles também saem, e os valores ficam. Com --sem-resumos, nenhum resumo vai.
• Só o que está em dia. Uma etapa desatualizada (as entradas mudaram depois dela) fica fora do site, e o mapa publicar avisa. Nas redes, a vista Redes some do site publicado: quem visita não recebe instruções de linha de comando. Rode mapa redes e publique de novo para incluí-las.
• Nada pessoal. O site não tem e-mails nem ORCIDs (uma varredura final confere cada arquivo e interrompe a publicação se achar um) nem as codificações de pessoas da validação: só as métricas agregadas e, das divergências, as de codificadores de referência.

Veja Privacidade e licenças.

No GitHub Pages

O site é uma pasta com um index.html e os dados ao lado, e funciona na raiz de um domínio ou numa subpasta (usuario.github.io/projeto/). Uma forma simples:

1. Crie um repositório (pode ser o do seu projeto) e copie o conteúdo de saida/site/ para uma pasta docs/.
2. Em Settings › Pages, escolha publicar a partir da pasta docs/ do ramo principal.
3. Em alguns minutos, o site está em https://<usuario>.github.io/<repositorio>/.

Para republicar depois de uma etapa nova, rode mapa publicar de novo e troque o conteúdo da pasta: ele é sempre gerado inteiro.

Os dados brutos não vão

Publique só a pasta do site. brutos/, dados/, o estado.sqlite e o .env ficam na sua máquina: o .gitignore que o mapa novo cria já os deixa de fora do git.