Repository files navigation

This demo creates a prepared Dockerized environment for testing Stencila, Stencila VSCode and Stencila Cloud without any changes to your workstation's environment. Stencila can also run locally by simply installing theStencila VSCode extension in VSCode. The demo environment described below is an alternative available for those who do not want to install VSCode, but want to test out Stencila and Stencila Cloud.

Our free tier will let you experiment with Stencila and try out our walkthroughs, or test on your own documents.

You can launch the demo, in a data center near you, by clicking this button:

Expand to see Instructions

This repository has aDev Container defined in the.devcontainer directory of the repository. This defines a container that can run Stencila and the associated Stencila VSCode extension on your local machine in a containerized environment. To run locally (requires Docker).

1. Install VSCode or have it already installed
2. Install Docker or have it already installed
3. Install theDev Container Extension in VSCode
4. git clone https://github.com/stencila/demo-codespace
5. cd demo-codespace
6. code .
7. Chose "Reopen in Container from the pop-up in VSCode"

When the Codespace is open we recommend trying one of our interactive walkthroughs. PressF2 to bring up the Stencila command palette and select from one of the walkthroughs.

This Codespace includes Python and R with popular data science packages installed:

• Python:numpy,matplotlib,pandas,requests

• R:tidyverse

If you think we should add other languages or packagescreate an issue, or submit a PR with changes to theDockerfile.

You cancreate a fork of this repository and modify the following files to customize the environment:

• add language runtimes and packages to.devcontainer/Dockerfile

• add VSCode extensions to.devcontainer/devcontainer.json

We areplanning to make it easier to fork and customize this repository in the future.