Instalação dos mecanismos Quarto Live e WebAssembly

Introdução

A codificação interativa em R e Python é possível com Quarto Live, que aproveita motores com tecnologia WebAssembly, como webR e Pyodide. Neste guia, você aprenderá como instalar o Quarto Live e configurar esses motores para habilitar a programação prática em tempo real no seu navegador.

A codificação interativa oferece feedback imediato, visualizações dinâmicas e uma experiência de aprendizado envolvente, sem a necessidade de um servidor. Siga estas etapas para começar.

Etapa 1: Instalando o Quarto Live

Abra seu terminal dentro do diretório do projeto Quarto e execute o seguinte comando:

quarto add r-wasm/quarto-live

Este comando instala a extensão Quarto Live junto com todas as dependências necessárias para suportar a execução baseada em WebAssembly.

Etapa 2: Configurando seu documento

Para usar Quarto Live em seus documentos, atualize o front matter YAML do seu documento Quarto. Por exemplo:

---
format: live-html
engine: knitr
---

Se você estiver usando o mecanismo knitr para R, inclua o trecho de código de configuração para carregar o mecanismo WebAssembly:

---
format: live-html
engine: knitr
---

{{< include ./_extensions/r-wasm/live/_knitr.qmd >}}

Nota

Incluir _knitr.qmd não é estritamente necessário se você estiver usando o mecanismo de renderização jupyter. É um requisito temporário para o mecanismo knitr e será removido em uma versão futura do quarto-live.

Etapa 3: Verificando sua configuração

Crie um novo documento interativo com um bloco de código simples para verificar se a instalação funciona corretamente. Por exemplo, em uma célula de código R:

Bloco de código R

Bloco de código Python

Nota

A execução desses blocos de código deve exibir imediatamente a saída no seu navegador. Se você vir os resultados esperados, sua configuração está completa!

Dicas de solução de problemas

• Problemas de carregamento do mecanismo:
  Certifique-se de que sua conexão com a Internet esteja estável, pois os mecanismos WebAssembly são baixados em tempo de execução.

• Erros de comando:
  Verifique se você está executando o comando de instalação no diretório correto do projeto Quarto.

• Problemas de configuração:
  Verifique novamente o front matter YAML para erros de sintaxe ou campos ausentes.

Se você encontrar outros problemas, consulte o guia de solução de problemas para obter suporte adicional.

Conclusão

Seguindo essas etapas, você instalou com sucesso o Quarto Live e configurou os mecanismos WebAssembly para programação interativa em R e Python. Agora você está pronto para explorar blocos de código interativos, visualizações dinâmicas e exercícios de codificação envolventes.

Sinta-se à vontade para revisitar este guia conforme necessário e continuar explorando outros tópicos na pasta Introdução.

Leitura adicional

• Explicação sobre blocos de código interativos
  Aprenda a criar e executar blocos de código interativos usando os motores webr e pyodide.
  Leia mais

• Carregando e usando pacotes
  Descubra como instalar e carregar pacotes R e Python adicionais, tanto na inicialização do documento quanto de forma interativa.
  Leia mais

• Gerenciamento de ambientes de execução
  Entenda como compartilhar variáveis entre blocos de código ou isolar exercícios interativos gerenciando seus ambientes de execução.
  Leia mais

• Referência de opções de célula
  Para obter detalhes de configuração avançada, consulte o guia completo sobre opções de células interativas disponíveis no Quarto Live.
  Leia mais

• Solução de problemas em documentos interativos
  Se você encontrar problemas durante a instalação ou configuração, consulte nosso guia de solução de problemas comuns e soluções.
  Leia mais

Explore mais artigos

Nota

Aqui estão mais artigos da mesma categoria para ajudá-lo a se aprofundar no tópico.