/ceg_rdm_handbook

Research data and software management practices relevant to TU Delft's Civil Engineering & Geosciences faculty

Primary LanguageJupyter NotebookOtherNOASSERTION

Your first TeachBook using the GitHub template

The template allows you to start your own Jupyter Book and hosting that book online without knowledge on Git, the Jupyter book package, python or anaconda. It doesn't elaborate on the collaborative functionalities of Git or how to edit the book.

  1. To get started making your Jupyter Book with our functionalities, use the template book as template:

use-template

  1. Fill in a repository name, this name will be used in the future url of your book:

create_new_repository

  1. Set source for GitHub pages to under Settings - Pages - Build and deployment - Source - GitHub Actions. As long as you don't do this your book is not published online:

Activate pages

  1. Make a edit to the book by editing one of the files in the book/ subdirectory (available under Code) or by running the workflow from Actions - All workflows - call-deploy-book - Run workflow - Run workflow. Wait a few minutes for the website to be deployed, if you're curious, you can see the progress and result under Actions - All workflows - call-deploy-book -<the most recent workflow run> (The first commit might have failed because github pages wasn't activated at the time of Initial commit):

Action

  1. When the workflow has finished, visit your build book at https://<username or organiszation_name>.github.io/<repository_name> (case sensitive). For our example it is https://dummydocent.github.io/test_book_from_template/ for the shown repository. These links are visible in the action as well, as shown in the figure above or in the GitHub repository website which you set in step 3.

Additional tip: Set the repository website as your GitHub Pages website under Code- About - - Website - Use your GitHub Pages Website

github_pages_as_website