Do Zero ao site no ar com Quarto

Material de apoio - Playlist Café com R

Autor

Jennifer Luz Lopes | Café com R

Data de Publicação

8 de maio de 2026

1 O que é um portfólio?

  • Um portfólio é um espaço onde você organiza e apresenta seus projetos, análises e trabalhos de forma prática e profissional.

  • Enquanto o currículo descreve o que você sabe, o portfólio mostra como realmente você consegue construir.

1.1 Na área de dados, ele pode reunir:

  • análises;

  • gráficos;

  • dashboards;

  • relatórios;

  • projetos em R, Python e muito mais;

  • aplicações;

  • artigos e estudos técnicos.

Além de demonstrar conhecimento técnico, o portfólio ajuda a comunicar sua forma de pensar, resolver problemas e estruturar projetos.

2 Por que você precisa de um portfólio

  • Saber fazer é importante.

  • Conseguir mostrar o que você sabe fazer é o que torna esse conhecimento visível para oportunidades.

O portfólio funciona exatamente nesse ponto: ele transforma projetos, análises e resultados em evidências concretas do seu trabalho.

  • Mais do que uma vitrine, é uma forma objetiva de comunicar capacidade técnica, organização e experiência prática em áreas como dados, estatística, programação e pesquisa.

2.1 Para a academia

  • Pesquisadores desenvolvem análises, metodologias e resultados que frequentemente ficam restritos a artigos, apresentações e dissertações.

  • Um portfólio técnico amplia a visibilidade desse trabalho e cria uma ponte entre pesquisa, aplicação e comunicação científica.

    Além de centralizar projetos, scripts e relatórios, o portfólio fortalece princípios fundamentais da ciência moderna, como reprodutibilidade, transparência e compartilhamento do conhecimento.

  • É o espaço onde métodos, análises e resultados deixam de existir apenas no texto científico e passam a ser apresentados de forma acessível, organizada e reutilizável.

2.2 Para quem está em transição

  • Mudanças de área, cargo ou setor geralmente trazem o mesmo desafio: demonstrar competência em um contexto onde ainda não existe histórico profissional consolidado.

  • O portfólio ajuda a reduzir essa distância.

  • Ele permite mostrar projetos, estudos e soluções desenvolvidas na prática, mesmo antes da primeira oportunidade formal na nova área. Em vez de depender apenas de experiências anteriores, você passa a apresentar evidências do que já consegue construir, analisar e resolver.

  • Isso torna a transição mais estratégica, objetiva e visível.

3 Pré-requisitos para iniciarmos

3.1 1. Instalação do R no Windows

  • O R é a linguagem de programação base.

  • O Quarto executa o código R durante a renderização dos documentos.

  • Acesse o site oficial do CRAN: https://cran.r-project.org

    1. Clique em Mirrors → 0-Cloud → Download R for Windows → base → Download R-4.5.3 for Windows
    2. Salve o instalador em uma pasta de sua preferência
    3. Dê duplo clique no arquivo baixado para iniciar a instalação
    4. Mantenha as configurações padrão - clique em “Avançar” até concluir

3.2 2. RStudio ou Positron

Você precisa de um ambiente de desenvolvimento para escrever e renderizar os arquivos .qmd. As duas opções recomendadas são:

Ferramenta Quando usar
RStudio Recomendado para quem trabalha principalmente com R. Interface consolidada, integração nativa com Quarto.
Positron Nova IDE da Posit, multilinguagem (R e Python). Interface mais moderna. Boa opção para quem também usa Python.

RStudio: https://posit.co/download/rstudio-desktop

Positron: https://github.com/posit-dev/positron/releases

Nesta playlist

Os vídeos serão gravados no RStudio.

Se você usar o Positron, a lógica é a mesma apenas a interface visual difere.

3.3 Instalando o RStudio no Windows

  1. Acesse o site oficial da Posit: https://posit.co/download/rstudio-desktop/

Site da Posit para download do RStudio
  1. Clique em Install RStudio

Botão de instalação do RStudio no site da Posit
  1. Escolha a versão compatível com o seu sistema operacional (Windows 64-bit)

Escolha a versão correta para o seu sistema operacional
  1. Baixe o instalador e dê duplo clique para iniciar
  2. Mantenha as configurações padrão - clique em “Avançar” até concluir
  3. Após instalar, localize o ícone do RStudio e abra o programa

3.4 3. Quarto CLI

  • O Quarto CLI é o componente responsável pela renderização dos documentos.

  • Sem ele, o botão Render no RStudio não funciona.

  • Download: https://quarto.org/docs/get-started

  • Acesse o site, baixe o instalador para o seu sistema operacional e instale com as configurações padrão.

  • Assim, após a instalação o RStudio já identificará o Quarto.

Após a instalação, verifique no terminal do RStudio:

quarto --version

Se o número da versão aparecer, a instalação foi concluída corretamente.

Versão mínima recomendada

Quarto 1.4 ou superior. A versão mais recente disponível no site é sempre a mais estável.

Página de instalação do Quarto CLI.

4 Posit

  • A Posit é a empresa responsável pelo RStudio, pelo Quarto e por grande parte do ecossistema open source que usamos nesta playlist.

  • Conhecer o que ela representa ajuda a entender de onde vêm as ferramentas e para onde elas estão indo.

Acesse o site, clique na imagem.

4.0.1 Código aberto para um mundo melhor

“A Posit cria softwares excepcionais que ajudam indivíduos, equipes e organizações a compreender e tomar melhores decisões com base em dados. Acreditamos que as análises devem ser corretas, transparentes e reproduzíveis, e que as melhores análises exigem a colaboração entre humanos e IA. Nosso objetivo é ajudar a resolver os problemas mais importantes da nossa época com dados, e queremos auxiliar todos que trabalham nessas soluções, independentemente de seus recursos.”

5 Roteiro da playlist

Esta apostila acompanha os 12 vídeos da playlist “Do zero ao site no ar”. Abaixo está o mapa completo do que será construído em cada etapa.

Vídeo Título O que acontece
V01 Por que você precisa de um portfólio Contexto e motivação
V02 Instalando R, RStudio e Quarto Ambiente configurado e pronto
V03 O que é o Quarto e os tipos de output Entender a ferramenta antes de usar
V04 YAML: o cabeçalho que controla tudo Configurar o documento corretamente
V05 Chunks de código: opções essenciais Controlar como o código aparece no output
V06 Markdown e formatação Escrever o conteúdo do site
V07 Temas e personalização visual Dar identidade ao site
V08 Criando o site com Quarto Projeto criado, estrutura no lugar
V09 Posts e categorias Primeiro post publicado localmente
V10 Personalizando navegação e aparência site com identidade visual definida
V11 Publicando no Quarto Pub site no ar com URL pública
V12 Publicando no Netlify site com domínio personalizado
Produto final

Ao concluir a playlist, você terá um site técnico publicado, com pelo menos um post, acessível por URL pública e pronto para receber o primeiro projeto na segunda playlist.

6 O que é o Quarto

  • O Quarto é um sistema de publicação científica e técnica de código aberto mantido pela Posit.

  • Ele permite combinar texto, código e resultados em um único arquivo .qmd e gerar diferentes formatos de saída: documentos, apresentações, sites, blogs e livros.

É a evolução do R Markdown, com suporte a R, Python, Julia e Observable.

Página inicial do Quarto - quarto.org.

Acesse aqui: https://quarto.org

6.1 O que o Quarto gera?

Formato Uso
HTML Apostilas, relatórios online, portfólios
PDF Documentos formais e impressos
MS Word Compatibilidade com fluxos corporativos

Clique aqui para visualizar.
Formato Uso
Reveal.js Apresentações interativas em HTML
PowerPoint Compatibilidade com Office
Beamer Apresentações acadêmicas em LaTeX

Clique aqui para visualizar.
Formato Uso
Website Site com múltiplas páginas
Blog Posts organizados por data e categoria
Livro Conteúdo longo com capítulos

Clique aqui para visualizar.

6.2 Onde encontrar tudo no Quarto?

O site oficial tem três seções que você vai consultar ao longo da playlist:

  • Guide - documentação completa por tipo de output e funcionalidade.

Guia completo do Quarto

https://quarto.org/docs/guide/

  • Reference - referência técnica de todas as opções de YAML, chunks e projeto.

Referência técnica do Quarto

https://quarto.org/docs/reference/

  • Gallery - exemplos reais de sites, blogs, apresentações e livros construídos com Quarto.

Exemplos de websites construídos com Quarto

https://quarto.org/docs/gallery/#websites

7 O que você precisa saber antes de criar o site

Todo arquivo .qmd tem três componentes. Você não precisa dominar cada um agora, mas precisa reconhecê-los.

7.1 1. YAML

  • O YAML é o cabeçalho do documento.

  • Fica entre --- no início do arquivo e define o formato, o tema, o sumário e o comportamento do código.

---
title: "Meu site"
author: "Jennifer Lopes"
date: today
lang: pt
format:
  html:
    toc: true
    theme: cosmo
execute:
  warning: false
  message: false
---
Atenção

  • O YAML usa dois espaços por nível de indentação.

  • Nunca use tabulação. Erros de indentação impedem a renderização.

7.2 2. Chunks de código

  • Chunks são blocos onde o código é executado.

  • O resultado aparece automaticamente no documento renderizado.

  • As opções mais usadas:

Opção O que faz
echo: false Oculta o código, mostra o resultado
eval: false Mostra o código, não executa
include: false Executa mas não mostra nada no output
warning: false Oculta avisos
fig-cap: "texto" Adiciona legenda à figura

7.3 3. Markdown

  • O texto do documento é escrito em Markdown.

  • O essencial para o site:

Sintaxe Resultado
## Título Título de seção
**negrito** negrito
*itálico* itálico
[texto](url) link
![alt](img.png) imagem
  • Callouts para destacar informações:
::: {.callout-note}
Informação adicional.
:::

::: {.callout-warning}
Algo que merece atenção.
:::

::: {.callout-tip}
Recomendação prática.
:::

8 Criando o site

8.1 Novo projeto no RStudio

  • File > New Project > New Directory > Quarto website

  • O RStudio gera a estrutura inicial automaticamente:

meu-site/
├── _quarto.yml       ← configuração central do projeto
├── index.qmd         ← página inicial com listagem de posts
├── about.qmd         ← página sobre
├── posts/            ← pasta dos posts
│   ├── post-01/
│   │   └── index.qmd
│   └── post-02/
│       └── index.qmd
└── styles.css        ← estilo customizado

8.2 O arquivo _quarto.yml

  • O _quarto.yml é o centro de controle do site.

  • Tudo definido aqui se aplica a todas as páginas.

project:
  type: website

website:
  title: "Café com R"
  description: "Ciência de dados com R"
  navbar:
    right:
      - about.qmd
      - icon: github
        href: https://github.com/JenniferLopes
      - icon: linkedin
        href: https://linkedin.com/in/jennifer-luz-lopes
  page-footer:
    center: "Café com R - Jennifer Lopes"

format:
  html:
    theme: cosmo
    css: styles.css
    toc: true

8.3 Criando um post

  • Cada post é um arquivo index.qmd dentro de uma subpasta em posts/.

  • O YAML do post define os metadados que aparecem na listagem:

---
title: "Meu primeiro post"
author: "Jennifer Lopes"
date: "2026-04-23"
categories: [R, tutorial]
description: "Uma análise exploratória com dados reais."
image: capa.png
---

O conteúdo vem abaixo do YAML, escrito em Markdown com chunks de código quando necessário.

8.4 Listagem automática de posts

  • A página index.qmd usa o tipo listing para gerar o índice automaticamente a partir dos metadados de cada post:
---
title: "Blog"
listing:
  contents: posts
  sort: "date desc"
  type: default
  categories: true
---

O Quarto lê os metadados de cada post e monta a página. Nenhum código adicional é necessário.

8.5 Temas e personalização

Troca de tema em uma linha no _quarto.yml:

format:
  html:
    theme: flatly

  • Temas disponíveis: cosmo, flatly, darkly, lumen, journal, sandstone, minty, united, yeti, entre outros.

  • Para ir além dos temas prontos, edite o styles.css e referencie no YAML:

format:
  html:
    theme: cosmo
    css: styles.css

9 Publicando o blog

O Quarto oferece múltiplas plataformas. Nesta playlist serão usadas Quarto Pub e Netlify.

Plataforma Características
Quarto Pub Gratuito, publicação com um comando, sem configuração
Netlify Domínio customizado, mais controle, plano gratuito disponível

Opções para publicação.

9.1 Quarto Pub

  • Serviço de publicação gratuito da Posit, ideal para começar.

Quarto Pub.

https://quartopub.com

Publicar:

quarto publish quarto-pub

  • Na primeira execução, o terminal abre o navegador para autenticação.

  • Nas seguintes, basta rodar o comando novamente.

  • O site fica disponível em: usuario.quarto.pub/nome-do-projeto

9.2 Netlify

Plataforma de hospedagem web com plano gratuito.

Via terminal:

quarto publish netlify

Via upload manual:

  1. Renderizar o projeto: quarto render
  2. Criar conta em netlify.com
  3. Arrastar a pasta _site/ para o painel do Netlify
  4. O blog é publicado e uma URL gerada

O site fica disponível em: nome-escolhido.netlify.app

10 Referências

Recurso Link
Site do Quarto quarto.org
Guia completo quarto.org/docs/guide
Referência técnica quarto.org/docs/reference
Galeria quarto.org/docs/gallery
Temas HTML quarto.org/docs/output-formats/html-themes
Publicação no Quarto Pub quarto.org/docs/publishing
Publicação no Netlify https://www.netlify.com/

11 Acesse os materiais disponíveis

Blog Café com R GitHub YouTube