XML JATS e SciELO: o que é e por que a sua revista precisa

Para quem lê, o artigo é o PDF. Para o SciELO, o artigo é o XML. É dele que saem os metadados enviados ao Crossref, ao Google Acadêmico e às bases que contam citações, e é ele que o SciELO guarda como a versão oficial do texto. Se a sua revista está no SciELO ou quer entrar, entender esse arquivo deixou de ser assunto só da equipe técnica.

O que é JATS

JATS (Journal Article Tag Suite) é a norma internacional que define como marcar um artigo científico em XML. Ela é mantida pela NISO, a organização norte-americana de padrões para informação, e saiu de um trabalho da Biblioteca Nacional de Medicina dos Estados Unidos. A versão mais recente, a 1.4, foi publicada em outubro de 2024 como ANSI/NISO Z39.96-2024.

Marcar um artigo em JATS é dizer à máquina o que é cada parte do texto. O título passa a ser um título; o nome de cada autor fica ligado à sua afiliação e ao seu ORCID; cada referência é dividida em autores, ano, título, periódico, volume e páginas; cada figura vem com legenda e arquivo de imagem. O PDF mostra tudo isso; o XML explica tudo isso.

Trecho de XML no padrão JATS com o título do artigo, uma autora ligada ao ORCID e à afiliação, e uma referência dividida em autor, ano, título, periódico, volume e páginas.
O PDF mostra; o XML explica o que é cada parte do texto.

O que é o SciELO PS

O SciELO Publishing Schema (SciELO PS, ou SPS) é o conjunto de regras que o SciELO aplica sobre o JATS. Ele escolhe quais elementos usar, define o que é obrigatório e fixa a forma de marcar casos comuns nas revistas da rede, como artigos em mais de um idioma. Um XML pode ser JATS válido e, mesmo assim, ser recusado por não seguir o SciELO PS.

Três camadas encaixadas: a norma JATS da NISO, as regras do SciELO PS aplicadas sobre ela e o XML de cada artigo da revista.
Um XML pode ser JATS válido e, mesmo assim, ser recusado por não seguir o SciELO PS.

O que os critérios do SciELO Brasil exigem

Os critérios de admissão e permanência da Coleção SciELO Brasil, na versão de setembro de 2024, tratam o XML como peça central. Entre outros pontos:

  • Todo documento publicado precisa poder ser estruturado em XML segundo o SciELO PS. Só são indexados os documentos que cumprem essa condição.
  • A marcação é responsabilidade da revista. Cabe ao periódico garantir a editoração e a marcação dos artigos aprovados.
  • O pacote vai completo. Para cada artigo, a revista envia o PDF, o XML e, se quiser, o ePUB, com as imagens em alta definição.
  • Artigo multilíngue, XML único. Quando o artigo sai em mais de um idioma, todas as versões precisam estar no mesmo arquivo XML.
  • O XML é a fonte original. O XML e as imagens são o que o SciELO guarda como referência e para preservação.
  • Metadados em inglês. Título, resumo e palavras-chave no idioma original e em inglês são obrigatórios, e os metadados são extraídos do próprio XML.
  • O DOI vai dentro do arquivo. Ele precisa constar no XML e no PDF, e o registro no Crossref deve trazer as referências citadas.
O pacote de cada artigo enviado ao SciELO: arquivo XML, PDF, imagens em alta definição e, se a revista quiser, ePUB.
Para cada artigo, a revista envia o pacote completo. O XML e as imagens são a versão de referência.

Por que isso importa além do SciELO

  • Citações que aparecem. Quando as referências estão bem marcadas, elas seguem para o Crossref e entram na contagem de citações das bases que usam esses dados. Uma referência mal marcada pode simplesmente não ser contada.
  • Autores encontráveis. Afiliação e ORCID marcados ligam o artigo ao pesquisador e à instituição nas bases bibliográficas.
  • Um arquivo, muitos formatos. Do mesmo XML saem a página HTML do artigo, o ePUB e os metadados para indexadores. A revista prepara uma vez.
  • Preservação. Um texto estruturado em padrão aberto continua legível quando o software que gerou o PDF já não existir.
Diagrama com o XML no centro e o que sai dele: página HTML do artigo, ePUB, metadados para o Crossref e indexadores, e arquivo de preservação.
A revista prepara o XML uma vez, e dele saem os outros formatos e os metadados.

Como a marcação é feita na prática

Cinco etapas da marcação XML: arquivo final aprovado, marcação, validação, montagem do pacote e depósito com conferência.
A marcação começa no texto final. Marcar antes da revisão obriga a refazer o trabalho.
  1. Arquivo final aprovado. O ponto de partida é o texto já revisado e diagramado. Marcar antes da revisão final obriga a refazer o trabalho.
  2. Marcação. Cada parte do artigo recebe o elemento correspondente: metadados de abertura, corpo do texto, tabelas, figuras, notas e referências.
  3. Validação. O pacote passa pelos validadores do SciELO, que apontam erros de estrutura e de estilo. Cada erro precisa ser entendido e corrigido, não apenas silenciado.
  4. Montagem do pacote. XML, PDF e imagens são reunidos e nomeados conforme o guia de entrega do SciELO.
  5. Depósito e conferência. Depois de publicado, vale abrir o artigo no site e conferir se referências, figuras e afiliações aparecem como deveriam.

Os erros que mais fazem um pacote voltar

  • Referências marcadas como texto corrido, sem separar autor, ano, título e periódico.
  • Afiliações incompletas: sem país, sem cidade ou com a instituição escrita de formas diferentes em cada artigo.
  • Nomes de arquivo de imagem que não batem com o que o XML chama.
  • Problemas de codificação de caracteres, que transformam acentos e símbolos em sinais estranhos.
  • Versões em outro idioma faltando no XML de um artigo multilíngue.
  • DOI ausente no XML, ou diferente do DOI registrado no Crossref.
Erros que fazem um pacote XML voltar e a forma correta: referência em texto corrido, afiliação incompleta, nome de imagem diferente, acentos corrompidos e DOI ausente.
Os erros que mais fazem um pacote voltar, e como eles deveriam estar.

Quer ajuda com isso?

A Agência Rivera produz, valida e corrige pacotes XML no padrão SciELO PS, de artigos avulsos a acervos inteiros, com relatório de validação em cada entrega. Se a sua revista tem pacotes recusados ou quer tirar a marcação da rotina da equipe editorial, veja como funciona em Produção XML, JATS e SciELO ou peça um orçamento.