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

Extração de coordenadas de documentos oficiais para adicionar dados ao OpenStreetMap

Alguns documentos oficiais incluem as coordenadas dos pontos que definem os limites da área sendo demarcada. É o caso de muitos decretos de ...