Getting started with Stencila


#1

Stencila Desktop

The Stencila Desktop is the main application that you’ll use to read and write Stencila Documents. It’s available as a binary executable for Windows, Mac, and Linux

Windows

Download the .exe file for the latest Stencila Desktop release then just double click on the .exe.

Mac

Download the .dmg file for the latest Stencila Desktop release then,

  • double click the .dmg to make its content available (name will show up in the Finder sidebar)
  • drag the application from the .dmg window into /Applications to install (may need an administrator password)
  • wait for the copy process to finish
  • eject the .dmg (by clicking the eject button in the Sidebar)

Linux

Download the AppImage file for the latest Stencila Desktop release then,

  • double click on it and click yes to “Make executable and run”.
  • or, at the command line,
$ chmod a+x stencila-desktop-*.AppImage
$ ./stencila-desktop-*.AppImage

AppImage is a format for distributing applications for Linux and, on most distributions, will not require the installation of any dependencies.

The Stencila Desktop will allow you to run code cells written either in Stencila’s internal language Mini, or in Javascript. If you also want to execute cells in R, SWL or Python, read on…

Stencila Docker images

If you have Docker installed our stencila/alpha Docker image is the easiest way to get started with execution contexts for Python, SQL, R and Node.js.

docker run -p 2100:2000 stencila/alpha

However if you do not have Docker installed, you can install the language specific packages directly, in R or Python.

Stencila R Package

The R package provides an execution context for R. It isn’t on CRAN yet, but you can install it using the devtools package from our Github repo:

devtools::install_github("stencila/r")

Then install the package’s manifest so that it can be found by the Stencila Desktop and Stencila packages for other languages,

stencila:::install()

Stencila Python package

The Python package provides execution context’s for Python and SQL. It isn’t on PyPI yet, but you can install using pip from our Github repo:

pip install --user https://github.com/stencila/py/archive/master.zip

Then install the package’s manifest so that it can be found by the Stencila Desktop and Stencila packages for other languages,

import stencila
stencila.install()