O que é quarto para paper duck
É um fluxo de trabalho em que você usa o Quarto para transformar rascunhos de papers científicos em documentos publicáveis, com verificação automática de formato, referências e consistência visual. O nome "paper duck" veio de uma prática informal do meu grupo de pesquisa: cada autor deixa seu rascunho em uma pasta compartilhada, o pipeline roda e gera um relatório tipo "o que está errado", similar ao rubber duck debugging mas voltado para submissão. A estrutura funciona bem quando você tem múltiplos autores, múltiplos formatos de revista e prazos apertados. Eu montei o meu em quatro arquivos principais: o documento mestre, o YAML de configuração, um script R para validar referências e um Makefile que orquestra tudo. O resultado costuma reduzir o tempo de formatação final de cerca de duas horas para uns quinze minutos, dependendo da complexidade das referências.
Como configurar quarto para paper duck na prática
Comece instalando o Quarto pelo site oficial ou pelo gerenciador de pacotes que você já usa. Depois, crie um diretório com a seguinte estrutura básica: um arquivo .qmd principal, uma pasta references com seu banco bibliográfico em formato .bib, uma pasta figures com todas as imagens, um arquivo output.yml para múltiplos formatos de revista e um script de validação. Não tente fazer tudo em um único arquivo .qmd. Isso dá dor de cabeça na manutenção. No arquivo YAML do documento, defina o formato padrão, o driver de referência e o estilo de citação. Se você trabalha com várias revistas, use um arquivo output.yml separadamente. Cada entrada nesse arquivo deve ter um formato específico, como nature, sciadv, ou ieee. O Quarto lê essas configurações sem precisão cirúrgica, então erros de digitação aqui causam falhas silenciosas. Fique atento a isso.
Um detalhe que quase ninguém menciona: o motor de geração de PDF não é o mesmo que o motor de HTML. O PDF usa LaTeX por baixo, e se o seu arquivo .bib tiver campos incompletos, o LaTeX pode falhar sem aviso claro. Eu perdi três horas num projeto assim porque um artigo tinha o ano como "n.d." em vez de "no date". O Quarto não reclama, mas o LaTeX entra em modo de erro e para a compilação.
O fluxo completo de validação
Depois que o documento está configurado, o próximo passo é validar as referências. Eu uso um script R simples que lê o .bib, cruza com as citações no .qmd e gera um relatório de inconsistências. O script checa campos obrigatórios, duplicatas e formatação de DOI. Leva cerca de dois minutos rodar em um projeto médio de cem referências. Para figuras, a recomendação é usar sempre SVG quando possível. Tabelas geradas com as funções do Quarto funcionam bem, mas se você precisar de uma tabela mais complexa, exporte como imagem de alta resolução. Tabelas HTML em PDF costumam quebrar o layout dependendo da revista. Já vi gente resolver isso com knitr::include_graphics(), mas isso depende do motor de compilação e do formato de saída escolhido.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Se você trabalha com revisões, mantenha dois rascunhos: um com todas as alterações e outro limpo. O quarto para paper duck facilita isso porque o controle de versão é nativo. Eu costumo guardar uma branch por versão de submissão, e o pipeline gera dois PDFs diferentes para comparação. Isso economiza muito tempo quando o revisor pede alterações específicas.
Erros comuns e soluções diretas
Um problema frequente é a falha na compilação de PDF quando há caracteres especiais nas referências. Campos como "doi" ou "url" podem conter % ou & e quebrar o LaTeX. A solução é rodar uma limpeza no arquivo .bib antes de compilar. Eu uso um script que troca caracteres problemáticos por entidades LaTeX correspondentes. Outro erro comum é confundir o estilo de citação com o estilo de referência. O Quarto trata os dois de formas diferentes. Você pode definir style: nature no YAML e ter citeproc processando as citações, mas o estilo de lista de referências pode não seguir exatamente o da revista. Sempre verifique exemplos reais do journal antes de confiar na formatação automática.
Quanto ao papel de validação automática, há situações em que ele não ajuda muito. Se o seu documento depende de layouts customizados, como colunas duplas ou notas de rodapé especiais, o Quarto pode não reproduzir exatamente o esperado. Nesses casos, o caminho mais seguro é exportar para LaTeX e ajustar manualmente, ou usar temas personalizados que já existem na comunidade.
Download e disponibilidade
O Quarto é um projeto open-source disponível em quarto.pub. O repositório oficial está no GitHub, e existem templates prontos para artigos científicos. A configuração básica é gratuita e não exige licença. Para quem quer um ponto de partida rápido, o template scientific-article do repositório oficial serve como base sólida. A partir dali, você adapta para o seu fluxo de paper duck. Se você prefere começar com algo já pronto, existem repositórios com configurações para revistas específicas. A desvantagem é que elas nem sempre são atualizadas para a última versão do Quarto. Sempre verifique a compatibilidade antes de usar templates prontos em produção.
Limitações e quando não usar
O quarto para paper duck não é ideal para documentos que dependem fortemente de elementos visuais não padrão, como infográficos complexos ou diagramas interativos. Se o seu paper precisa de animações ou gráficos que mudam conforme o formato, o workflow tradicional com LaTeX pode ser mais adequado. Também não recomendo para grupos que trabalham exclusivamente com Word. A curva de aprendizado compensa em projetos de médio e grande porte, mas em trabalhos únicos e pequenos, o tempo gasto na configuração pode não valer a pena. Outro ponto importante: o Quarto não resolve problemas de conteúdo. Ele melhora a formatação e a validação, mas se o artigo tem erros de lógica, dados inconsistentes ou Referências mal formatadas, o pipeline vai apenas sinalizar os problemas, não corrigi-los. O trabalho editorial continua sendo humano.
