Skip to content

Commit d1fbb05

Browse files
committed
add GitHub codespaces instrucitons to web page
1 parent c83aa86 commit d1fbb05

1 file changed

Lines changed: 22 additions & 3 deletions

File tree

web/docs/index.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -209,10 +209,29 @@ cd content/notebooks
209209
jupyter notebook
210210
```
211211

212-
## Run notebook in the cloud
212+
## Running this workshop via online services
213213

214-
If you somehow were not able to install Docker:
215-
there is a Cloud version of the Jupyter-Notebook-part of the workshop,
214+
If you somehow were not able to install Docker, or had trouble starting the workshop, the following option exist for running on the cloud:
215+
216+
### GitHub Codespaces
217+
218+
To run this workshop via GitHub Codespaces, please complete the following steps:
219+
220+
- Navigate to https://github.com/geopython/geopython-workshop
221+
- click the 'Codespaces' tab
222+
- click 'Create codespace on master'
223+
- click on the new codespace (new tab/window opens), note that this will take some time to initialize
224+
- once a terminal prompt is available (the `TERMINAL` tab), type the following command: `jupyter server list`
225+
- copy the value of the `TOKEN_VALUE` where `http://0.0.0.0:8888/?token=TOKEN_VALUE :: /jupyter/content/notebooks`
226+
- click the `PORTS` tab, however over the line of port 8888 (in the `DEBUG CONSOLE` column), and click on the globe icon (new tab/window opens)
227+
- in the new tab/window, paste the `TOKEN_VALUE`, and click 'Log in'
228+
- the workshop notebooks should now be fully available for interactive learning!
229+
230+
Note that a GitHub account is required.
231+
232+
### Binder
233+
234+
There is a Cloud version of the Jupyter-Notebook-part of the workshop,
216235
available via [Jupyter Binder](https://jupyter.org/binder).
217236

218237
With some limits (e.g. no local geo-services, no data publication), you can follow most of the workshop using a remote Docker instance within your browser via `Jupyter Binder`. Click on the button below

0 commit comments

Comments
 (0)