https://github.com/mcanouil/quarto-codespaces
Quarto Codespaces / Dev Containers setup for quick online testing.
https://github.com/mcanouil/quarto-codespaces
codespaces devcontainer quarto quartopub
Last synced: 2 months ago
JSON representation
Quarto Codespaces / Dev Containers setup for quick online testing.
- Host: GitHub
- URL: https://github.com/mcanouil/quarto-codespaces
- Owner: mcanouil
- License: mit
- Created: 2023-10-06T20:23:06.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-29T11:26:52.000Z (4 months ago)
- Last Synced: 2025-06-29T12:29:11.393Z (4 months ago)
- Topics: codespaces, devcontainer, quarto, quartopub
- Language: Shell
- Homepage:
- Size: 167 KB
- Stars: 28
- Watchers: 1
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
- jimsghstars - mcanouil/quarto-codespaces - Quarto Codespaces setup for quick online testing. (Others)
README
# Quarto Codespaces
[](https://github.com/mcanouil/quarto-codespaces/actions/workflows/devcontainer.yml)
Setup to deploy [GitHub Codespaces](https://github.com/features/codespaces) (Codespaces) or [Development Containers](https://containers.dev/) (Dev Containers) with [Quarto](https://quarto.org/).
## Overview
This repository provides a setup to deploy Codespaces or Dev Containers with Quarto, supporting R, Python, and Julia environments.
It includes configuration files and scripts to initialise and manage these environments.
Using [`ghcr.io/mcanouil/quarto-codespaces:latest`](https://github.com/mcanouil/quarto-codespaces/pkgs/container/quarto-codespaces) as a base image for a quick deployment (Ubuntu 22.04 - Jammy Jellyfish):
[](https://codespaces.new/mcanouil/quarto-codespaces?quickstart=1&devcontainer_path=.devcontainer%2Fdevcontainer.json)
Using Codespaces default base image ([`ghcr.io/mcanouil/quarto-codespaces:release-universal`](https://github.com/mcanouil/quarto-codespaces/pkgs/container/quarto-codespaces)) to mitigate GitHub storage usage (Ubuntu 20.04 - Focal Fossa):
[](https://codespaces.new/mcanouil/quarto-codespaces?quickstart=1&devcontainer_path=.devcontainer%2Funiversal%2Fdevcontainer.json)
## Using as a Template
You can use this repository as a template for your own projects.
To do so, click the "Use this template" button on the GitHub repository page.
This will create a new repository with the same files and structure.
## Using with Codespaces
This repository is configured to work with GitHub Codespaces.
To use it, follow these steps:
1. Open the repository on GitHub.
2. Click the "Code" button and select "Open with Codespaces".
3. If you don't have a Codespace already, create a new one.
4. The Codespace will be set up automatically using the configuration provided in this repository.
## Dev Container Configuration
The Dev Container configuration is located in [`.github/.devcontainer/devcontainer.json`](.github/.devcontainer/devcontainer.json).
This file defines the development container settings, including the base image, user settings, and features to be installed.
### Key Features
- **Base Image**: The container uses the `buildpack-deps:jammy-curl` image as the base.
- **Remote User**: The default user is set to `vscode`.
- **Installed Features**:
- Common utilities with Zsh shell.
- [Git](https://git-scm.com/) for version control.
- [R](https://www.r-project.org/) with `renv` support and `rmarkdown`.
- [Python](https://www.python.org/) with shared libraries, `jupyter` and [`uv`](https://docs.astral.sh/uv/).
- [Julia](https://julialang.org/) with the latest release channel and `IJulia`.
- [TinyTeX](https://github.com/rstudio/tinytex) for LaTeX support.
- [Decktape](https://github.com/astefanutti/decktape) for PDF generation from HTML presentations.
- [Quarto CLI](https://quarto.org/) for scientific and technical publishing.
### Docker Image
The Dev Container configuration is used to build a Docker image that is available for use.
You can pull the latest image (using Quarto stable release) using the following command:
```sh
docker pull ghcr.io/mcanouil/quarto-codespaces:latest
```
Available tags: [`ghcr.io/mcanouil/quarto-codespaces`](https://github.com/mcanouil/quarto-codespaces/pkgs/container/quarto-codespaces)
## Initialisation Script
The initialisation script [init.sh](init.sh) is used to set up the R, Python, and Julia environments.
It supports initialising all environments or specific ones based on the provided options.
### Usage
```sh
./init-env.sh [--what/-w all|r|python|julia] [--force/-f] [--help/-h]
```
### Script Details
- **Options**:
- `--what/-w`: Specify which environment(s) to initialise (`all`, `r`, `python` (uv), `julia`).
- `--force/-f`: Force reinstallation of the specified environment(s).
- `--help/-h`: Display help message and exit.
- **Functionality**: The script installs necessary dependencies for R, Python, and Julia, inside environments.
- For R, it sets up `renv` and installs required packages.
- For Python, it sets up uv and installs required libraries.
- For Julia, it sets up an environment and installs required packages.
## Contributing
Contributions are welcome!
Please open an issue or submit a pull request for any improvements or bug fixes.
## License
This project is licensed under the MIT License.
See the [LICENSE](LICENSE) file for details.