Does our "Get started" help you to, umm, get started?


#1

We’ve added a three step getting started guide on the Stencila home page https://stenci.la/ . It’s meant to be a simple-as-possible call to action for getting up and running with Stencila. Would love any suggestions: Did everything work for you? Does it need to be simpler? Does it need to be more detailed?


#2

I could not install the R packages. Got the following (using R 3.3.3 64bit on Windows7 Enterprise SP1):

(…)
package ‘httpuv’ successfully unpacked and MD5 sums checked
Warning: cannot remove prior installation of package ‘httpuv’
(…)
package ‘jsonlite’ successfully unpacked and MD5 sums checked
Warning: cannot remove prior installation of package ‘jsonlite’
(…)
ERROR: dependencies ‘httpuv’, ‘jsonlite’ are not available for package ‘stencila’

  • removing 'C:/Program Files/R/R-3.3.3/library/stencila’
    Installation failed: Command failed (1)

#3

Hi @Aran,

Thanks for trying out the R package. It’s seems that you have previous installations of some of the packages that stencila depends upon and you can’t delete them. That may be because you had another R session using them, or because you installed them as Admin.

Try deleting C:/Program Files/R/R-3.3.3/library/httpuv and C:/Program Files/R/R-3.3.3/library/jsonlite manually and then doing

devtools::install_github("stencila/r")
stencila:::install()

This post might help https://stackoverflow.com/a/26573219/4625911


#4

Yes, that has solved it, thanks!


#5

In a word, … no.

Or, at least, not entirely. The simple 3 step getting started guide is fine, as far as installing things go. I can’t see anywhere to go from the getting started guide that will actually tell me how to have R code embedded in a document. It doesn’t appear to be as simple as restarting Stencila. Is there a guide somewhere that I’m missing? If there is, is it linked from the getting started page at all? Even just a hello world somewhere would be useful.

Cheers
Ben.


#6

Hi Ben,

Thanks for trying out Stencila. Apologies for the lack of clarity in the docs.

The Stencila Desktop comes with two documents preinstalled. The second one “Stencila Documents” includes some instructions for how to embed code in external languages (see the section “Using other languages” > “R”).

If you have a Stencila host running in R, either via the Docker image, or via a local installation of the Stencila R package, then you can Insert > Cell from the menu. Then specify you want to embed R code using:

r()

…and in the lower part of the cell that then appears type your R code e.g.

hist(rnorm(1000), breaks=30, col=2)

If that’s not working, then there may be issues with the Desktop finding the Stencila Host running in R…I can help you debug that if that is the case…don’t hesitate to let me know.