TL;DR
Já vou avisando: a próxima seção é uma apologia ao Quarto e por que você deve abandonar o processador de texto do Bill Gates. Se não quiser ler essa groselha, pula direto para a parte em que eu ensino como usar o abnquarto
Groselhas preliminares
Por que Quarto
Escrever resenhas, artigos ou até mesmo sua tese no R pode parecer impossível, loucura ou falta do que fazer. Talvez esta última afirmação seja verdade, mas as duas primeiras, certamente não.
Comecei a escrever pela IDE do RStudio desde que comecei a aprender R pelo Codecademy… Mas quando fui tentar compilar um PDF, o bicho pegou: instalar um compilador , uma hora pra entender como muda as margens, três horas para descobrir como coloca recuo no primeiro parágrafo… a lista de perrengues é interminável, mas o meu objetivo aqui é encorajar as pessoas a usarem Quarto, e não o contrário!
Considerando essa curva de aprendizado, por que vale a pena aprender a escrever em Quarto? E porque não direto em no Overleaf ou outro editor? A minha resposta passa por quatro pontos: consistência, reprodução, treino e estética. Em primeiro lugar, a consistência de um editor WYSIWYM (what you see is what you mean), como Markdown ou , é incomparável com a de editores WYSIWYG (what you see is what you get). Isso acontece porque no segundo grupo de editores, da filosofia “clicar no botão”, você pode estar perdido, sair fuçando e por acaso dar certo… Mas depois, a chance de você não saber o que fez e ficar tudo desconfigurado é considerável. Já nos editores em que o resultado deve ser programado, o comando X sempre vai levar a Y; é mais fácil padronizar.
Mas então por que Quarto e não ? Aí entramos no segundo argumento, o da reprodução. Quando sua análise estatística já foi feita toda em R, fica muito fácil integrar os resultados com um relatório final, misturando tabelas e gráficos programados e texto. Sinceramente, eu acho um inferno transferir tabela e gráfico para o Word; e não importa o que eu faça, ainda não descobri um jeito de evitar perda de qualidade na hora de compilar para PDF. Uma tabela programada via kableExtra() vai te dar trabalho no começo, mas depois que sai, vale a pena. Outra situação em que vale a pena escrever em Quarto é exatamente esta: misturar código e texto, montar uma aula, um tutorial, fazer uma lista de econometria. Mas ainda assim… Por que Quarto Markdown e não RMarkdown? Ora, é muito simples. Por acaso fazia sentido ser alfabetizado com o acordo ortográfico antigo no ano em que o novo entrou em vigor? O Quarto é a evolução do RMarkdown. Tem muitas funcionalidades que não tinham no outro —eu pessoalmente gosto do YAML global, as configurações de chunk e os callouts. E se você ainda quiser usar um editor visual, they’ve got you covered! O quarto vem com um editor visual que é quase um word, para o desmame do mundo WYSIWYG doer menos.
Terceiro ponto: treine suas habilidades de programação. Aí é pra maluco mesmo, é pra quem gosta de encarar uma tela preta pra ver um monte de letra e número. Essa caixinha é legal demais, e se você gosta do quebra-cabeça, vai gostar de aprender Quarto. Em todos os casos, é um excelente treino de resolução de problemas! E talvez você acabe aprendendo um pouquinho de , html e css, se quiser customizar seu material…
O que me leva ao quarto motivo: é bonito demais! A vida é muito curta para coisas feias, e eu pessoalmente gosto muito do resultado de um arquivo compilado em Quarto, Rmarkdown, Xaringan, Revealjs ou Shiny. O céu é o limite! Quanto mais eu aprendo, mais eu gosto. E o importante é ser feliz!
Por que abnquarto
Se você já se convenceu a escrever em Quarto, talvez se depare com o mesmo desafio que eu: entrar na caixinha da ABNT. Tem regra de margem, regra de recuo, regra de fonte, disso, daquilo… É um parto e é muito chato, até no Word. Por isso, é bom ter algumas configurações predefinidas para o documento sair no formato exigido pelas nossas instituições patrícias. É um template bem simples, longe de ser um pacote completo, mas já é uma mão na roda!
Primeiros passos
Como baixar
Alternativa 1
Baixar tudo e inserir manualmente no seu computador: <> Code > Download ZIP
Alternativa 2
Basta clonar este repositório, copiando o link acima.
Pelo Terminal (do RStudio ou do seu computador):
git clone https://github.com/baarthur/abnquarto.git nome_da_pastaDica: Garanta que você está na pasta certa usando o comando
pwd(print work directory); caso contrário, digite cd e o caminho da pasta onde vai ficar o projeto.
Isso vai criar uma pasta no diretório que você excolheu com os arquivos necessários. Os mais importantes são _quarto.yml (definições globais de margens, recuos, bibliografia etc) e tudo na pasta src, onde há um template e os arquivos necessários na subpasta yaml.
Uso básico
- Edite o arquivo
_quarto.ymlseguindo as instruções do arquivo. - Use o template em
src(ou crie um arquivo do zero onde quiser) —veja aqui como fica o template.
Links úteis:
Citation
@online{bazolli alvarenga2023,
author = {Bazolli Alvarenga, Arthur},
title = {Abnquarto},
date = {2023-06-23},
url = {https://baarthur.github.io/posts/2023-06-20-abnquarto-v0/},
langid = {en}
}