Wednesday, November 9, 2022

Pandoc: corrigindo problemas em citações com estilo ABNT

Quem já usou pandoc com o filtro citeproc para produzir trabalho acadêmico seguindo as regras da ABNT se deparou com um problema: as citações textuais (com os nomes dos autores fora dos parênteses) ficam com a mesma formatação das citações entre parênteses, com os nomes dos autores em letras maiúsculas e separados por ponto-e-vírgula. Ou seja, o que deveria ser

Segundo Fulano, Sicrano e Beltrano (2020), ...

aparece como

Segundo FULANO; SICRANO; BELTRANO (2020), ...

Isso ocorre porque a versão atual da CSL (Citation Style Language) não faz distinção entre citações no texto e entre parênteses e as normas da ABNT determinam formatações distintas nos dois casos. O problema já é conhecido e uma próxima versão da CSL deverá trazer uma solução definitiva. Por enquanto, uma forma de corrigir o problema é aplicar o filtro abntfix.py após o citeproc. Exemplos:

pandoc documento.md --citeproc -F abntfix.py -o documento.pdf
quarto render documento.qmd pandoc-args -F abntfix.py

Note que, se o diretório em que se encontra o abntfix.py não estiver incluído na variável de ambiente PATH, será preciso especificar o caminho completo do filtro. O abntfix.py é parte do plugin zotcite para Vim/Neovim, mas pode ser usado juntamente com qualquer editor de texto ou diretamente na linha de comando de um terminal.

O problema solucionado pelo abntfix.py não é exclusivo do pandoc. O uso do Zotero com LibreOffice ou Microsoft Word também depende de arquivos CSL e enfrenta o mesmo inconveniente, mas, nesse caso, não conheço solução diferente da edição manual das citações após sua inserção automática pelo Zotero.

Tuesday, November 8, 2022

Usando Quarto para produção de trabalhos acadêmicos

Esta postagem não é uma sugestão de que um quarto seja um lugar melhor para produção de trabalhos acadêmicos do que outras partes da casa. Quarto a que me refiro é uma extensão da linguagem Markdown que, assim como RMarkdown, permite combinar código R com Markdown, mas com alguns comandos adicionais que facilitam o uso de referências cruzadas e a produção de templates mais complexos. A edição de documentos Quarto pode ser feita com o RStudio, com o Nvim-R e Zotcite ou com outros editores de texto, sendo possível extrair dados do Zotero para citações e referências bibliográficas.

Para saber mais sobre como editar documentos Quarto no Neovim, usando os plugins Nvim-R e Zotcite, assista minha à apresentação na VII Semana de Metodologia e Produção Científica da Universidade Federal do Ceará:

Software R na produção de trabalhos acadêmicos

Na ocasião, apresentei um template para a produção de trabalhos acadêmicos que replica a formatação do template LaTeX da Universidade Federal do Ceará:

trabalho_ufc.zip

“Antes só do que mal acompanhada”: defasagem escolar de beneficiários do Bolsa Família com idade entre 12 e 18 anos

Jakson Alves de Aquino Domingos Sávio Abreu Introdução Durante a realização do EPDS na UFC no período de 2016 a 2017, planejamos uma pes...