Quarto:

Conhecendo a evolução do R Markdown

Beatriz Milz • Curso-R | IEE/USP

Maio de 2022 - VI SER International Seminar on Statistics with R


Código: github.com/beatrizmilz/2022-SER-quarto

Slides: beatrizmilz.github.io/2022-SER-quarto/

Licença: CC BY-SA

Beatriz Milz

Beatriz Milz

Curso-R

Logo da Curso-R

Filosofia de código aberto!

Livros

Lives

Material dos cursos

Blog

Cursos que a Curso-R oferece:

Use a barra de rolagem do navegador para ver tudo :D

Sobre essa apresentação

  • ❌ Tutorial sobre o Quarto

  • ✅ Minha experiência pessoal

  • ✅ Dicas sobre o que eu aprendi até então

No começo…

R Markdown

  • Pacote em R, para criar documentos reprodutíveis.

  • Muito usado na comunidade de R.

  • Criado e mantido pela RStudio.

R Markdown

  • Possui extensões que permitem produzir:
    • Sites
    • Blogs
    • Apresentações
    • Textos acadêmicos (artigos científicos, relatórios, teses, etc)
    • Livros: Ex: Análises ecológicas no R
    • Entre outros!

Eu 💜 R Markdown

No 3º R Day (setembro/2021), o Yihui Xie (criador do R Markdown) participou e disse:

” The future? We have learned a lot in the last 10 years from those packages in the R Markdown ecosystem. We are lauching a new, exciting and much bigger project. Stay tuned.”

Assista a apresentação no YouTube.

Stalkeando Acompanhando

Encontrei uma nova organização no GitHub: quarto-dev

Algumas pessoas da RStudio estavam envolvidas no projeto

Acompanhei e logo quis testar!

Pequeno parêntese: RStudio

  • Mais conhecida pela IDE RStudio

  • É uma companhia criada em 2009

  • Tem uma grande equipe de pessoas que trabalham no desenvolvimento de pacotes em R

  • Organizam a rstudio::conf (em 2020 com mais de 2200 participantes)

  • É muito próxima da comunidade e uma B Corporation

  • É a empresa privada mais importante no contexto da linguagem de programação R do mundo (minha opinião)

  • Saiba mais neste link!

O que é o Quarto?

  • Segundo a documentação oficial, o Quarto é um sistema de escrita técnica e científica, de código aberto, baseada no Pandoc.

  • O Pandoc é um sistema de conversão de documentos em vários formatos, e também é usado no R Markdown.

Quarto

Porque o Quarto existe?

  • O {rmarkdown} é um pacote em R. Para usá-lo, é necessário ter o R instalado (mesmo que o seu arquivo não tenha conteúdos em R).

  • O R Markdown é uma ferramenta muito boa para escrita técnica e científica reprodutível, possibilitando criar vários tipos de documentos. Porém, o seu uso acaba ficando limitado às pessoas que usam R.

  • O Quarto é um software novo, que não depende do R!

Quais são as similaridades?

  • A estrutura do arquivo é muito similar! Para muitos arquivos, há compatibilidade (bastando alterar a extensão de .Rmd para .qmd).

  • Podemos adicionar código em R, Python, Julia, etc etc.

  • Podemos criar diversos tipos de arquivos, como:

    • Páginas da internet (arquivos .html)
    • PDFs
    • Words
    • Apresentações
    • Documentos interativos
    • Livros
    • E mais está sendo produzido :)

Quais são as (principais) diferenças?

R Markdown

  • É um pacote em R.

  • Precisamos ter o R instalado para renderizar o arquivo R Markdown.

Quarto

  • É um outro software, precisa ser instalado.

  • Não precisamos do R para renderizar o arquivo.

R Markdown

  • .Rmd

Quarto

  • .qmd

R Markdown

  • Bootstrap: Por padrão, usa o v3.3.5.

  • Para usar versões recentes do bootstrap, é necessário usar o pacote bslib #1260

Quarto

R Markdown

  • Não tem suporte ao Observable JS.

Quarto

  • Tem suporte ao Observable JS.

Observable JS: Usado para criar visualizações de dados interativas.

Como começar a usar o quarto

Instalar o Quarto:


Print screen da página de instalação do Quarto

Como começar a usar o quarto


Print screen da página de instalação do Quarto

Quarto no RStudio

Print screen da IDE RStudio

Print screen da IDE RStudio

Print screen da IDE RStudio

Print screen da IDE RStudio

Quarto no RStudio Cloud

  • Similar ao RStudio: https://rstudio.cloud/

  • O quarto já vem instalado!

  • Não tem a opção (até agora) de usar o “New project”, apenas o “New file”.

  • Atenção aos pacotes que é importante instalar antes:

install.packages("jsonlite")
install.packages("rmarkdown")
install.packages("htmltools")

Print screen da IDE RStudio Cloud

Print screen da IDE RStudio Cloud

Quarto no terminal

Você também pode usar o terminal para utilizar o Quarto.

quarto help
  Usage:   quarto 
  Version: 0.9.243
                  

  Description:

    Quarto CLI

  Options:

    -h, --help     - Show this help.                            
    -V, --version  - Show the version number for this program.  

  Commands:

    render          [input] [args...]  - Render input file(s) to various document types.                                                
    serve           [input]            - Serve an interactive document.                                                                 
    create-project  [dir]              - Create a project for rendering multiple documents                                              
    preview         [file] [args...]   - Render and preview a Quarto document or website project. Automatically reloads the browser when
    convert         [input]            - Convert documents to alternate representations.                                                
    capabilities                       - Query for current capabilities (output formats, engines, kernels etc.)                         
    check           [target]           - Check and verify correct functioning of Quarto installation and computation engines.           
    inspect         [path]             - Inspect a Quarto project or input path. Inspecting a project returns its config and engines.   
    tools           [command] [tool]   - Manage the installation, update, and uninstallation of useful tools.                           
    help            [command]          - Show this help or the help of a sub-command.    
cd ~/Desktop
quarto create-project exemplo-quarto-project
Creating project at /Users/beatrizmilz/Desktop/exemplo-quarto-project:
  - Created _quarto.yml
  - Created exemplo-quarto-project.qmd
cd ~/Desktop/exemplo-quarto-project
quarto render
pandoc 
  to: html
  output-file: exemplo-quarto-project.html
  standalone: true
  section-divs: true
  html-math-method: mathjax
  wrap: none
  default-image-extension: png
  filters:
    - crossref
  
metadata
  document-css: false
  link-citations: true
  lang: en
  title: exemplo-quarto-project

Quarto no VS Code

Print screen da IDE VSCode

Vamos experimentar no RStudio Cloud!

https://rstudio.cloud/

Dicas para acompanhar as novidades

Futurologia

Materiais para ir mais longe

Obrigada!

Agradecimentos:

Contato:

Slides por Beatriz Milz, feitos com Quarto. Código disponível no GitHub.