From d7f519ca10ffc6e01cc7a9faa4ac5d17894961cf Mon Sep 17 00:00:00 2001 From: Carl Boettiger Date: Tue, 28 Nov 2023 23:50:12 +0000 Subject: [PATCH] :pen: --- _quarto.yml | 15 +++++++++------ contents/computing-environment.qmd | 19 ++++++++++++++++++- 2 files changed, 27 insertions(+), 7 deletions(-) diff --git a/_quarto.yml b/_quarto.yml index e90cf19..db5c0f9 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -9,12 +9,9 @@ execute: freeze: auto website: - page-footer: - right: - - icon: github - href: https://github.com/boettiger-lab/nasa-topst-env-justice - - icon: globe-americas - href: https://carlboettiger.info + repo-url: https://github.com/boettiger-lab/nasa-topst-env-justice + repo-actions: [edit, issue] + page-navigation: true sidebar: style: "docked" search: true @@ -48,5 +45,11 @@ website: contents: - text: Portable Environments href: contents/computing-environment.qmd + page-footer: + right: + - icon: github + href: https://github.com/boettiger-lab/nasa-topst-env-justice + - icon: globe-americas + href: https://carlboettiger.info diff --git a/contents/computing-environment.qmd b/contents/computing-environment.qmd index 96957c9..ba96b12 100644 --- a/contents/computing-environment.qmd +++ b/contents/computing-environment.qmd @@ -23,6 +23,23 @@ It should be as easy as possible to grab the whole onion and take it where you w be that a local VSCode editor on your laptop, or an RStudio Server instance running up on Microsoft Azure cloud. + +## Notebooks on GitHub + +Each of the recipes on this site correspond to a Quarto or Jupyter notebook in a +GitHub repository (see `contents/` directory or footer links). Such notebooks form the +basis of technical documentation and publishing to a wide array of formats. +A `_quarto.yml` configuration file in the repository root determines the [website layout](https://quarto.org/docs/websites/). +Notebooks can be run interactively in any appropriate environment +(RStudio, JupyterLab, VSCode, etc, see below for free online platforms). +Type `quarto render` from the bash command line or use `quarto::quarto_preview()` +from the R console to preview the entire site. + +## A Portable compute environment + + + + ## On the cloud: Gitpod or Codespaces [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/boettiger-lab/nasa-topst-env-justice) @@ -42,7 +59,7 @@ Additionally, this also provides access to an RStudio environment on an embedded who prefer that editor to VSCode. Once the Codespace has fully completed loading, it will include a link in a second welcome message in the Terminal to access RStudio like so: - + The RStudio link can also always be accessed from the Ports tab under the port labeled "Rstudio" (8787). (Gitpod will show a pop-up message to open this port instead.)