Skip to contents

VS Code Tutorials

Package website: https://ppbds.github.io/vscode.tutorials/

About this package

vscode.tutorials is a collection of tutorials for working with VS Code. Covers scripts, Quarto documents, git, Github, and Quarto websites. Makes extensive use of the tools in the tutorial.helpers package.

Installation

Install the development version from GitHub with:

remotes::install_github("PPBDS/vscode.tutorials")

Tutorials

There are many tutorials in the package. The recommended way to launch them is with the R Tutorials extension for VS Code, which lists every installed tutorial and lets you start one with a click.

As a backup, you can launch a tutorial from the R console with learnr::run_tutorial(), providing the short name of the tutorial and the package name.

learnr::run_tutorial(name = "01-code",
                     package = "vscode.tutorials")

VS Code Tutorials

The core tutorials introduce students to the VS Code integrated development environment.

  • VS Code and Scripts (“01-code”). Introduce students to VS Code and to writing R code in simple scripts.

  • VS Code and Quarto (“02-quarto”). Demonstrate more tricks for working with R code using VS Code, and also explain Quarto documents.

  • Terminal (“03-terminal”). Teach the command line.

  • AI Introduction (“04-ai-1”). Meet the Gemini CLI agent and use it to create and render a Quarto analysis.

  • VS Code and GitHub Introduction (“05-github-1”). Explain the basics of Git and GitHub, mostly in the context of VS Code.

  • VS Code and GitHub Advanced (“06-github-2”). Provide more practice in working with Git/GitHub, including more details on the use of GitHub Pages.

  • AI and Git (“07-ai-2”). Return to the Gemini CLI, now using it to run and explain a full Git workflow.

  • Quarto Websites Introduction (“08-websites-1”). Demonstrate the basics of website construction using Quarto projects.

  • Quarto Websites Advanced (“09-websites-2”). Practice Quarto websites, building two sites and refactoring analysis code into scripts that save results as RDS and PNG files.

  • Infrastructure (“10-infrastructure”). Tour devcontainers and how they keep Codespaces consistent.

The R for Data Science and Analyzing US Census Data tutorials now live in the separate misc.tutorials package.