Merge branch 'github-workflow' into 'isabel_new_branch_cookbook_stuff'

Added GitHub forking tutorial

See merge request interactivetextbooks-citg/jupyter-book-manual!41

book/_toc.yml

@@ -21,6 +21,7 @@ parts:
           sections: 
           - file: workflows/git-merge-conflict
       - file: workflows/gitlab
+      - file: workflows/github
   - caption: Features
     chapters:
     - file: basic-features/overview

book/workflows/github.md

@@ -0,0 +1,34 @@
+# GitHub template
+
+To get started making your Jupyter Book with our functionalities, fork our template book https://github.com/TeachBooks/template :
+
+![alt text](../images/image.png)
+
+Fill in a repository name, this name will be used in the future url of your book:
+
+![alt text](../images/image-1.png)
+
+Set up the build of your website using GitHub pages by selecting under `Settings` - `Pages` - `Build and deployment` - `Source` - `GitHub Actions`:
+
+![alt text](../images/image-2.png)
+
+Enable the predefined workflow to publish your book under `Actions` - `I understand my workflows, go ahead an enable them`:
+
+![alt text](../images/image-3.png)
+
+Edit a file under `Code` - `book` - A file of your choice - `Edit in place`, in the example below `book/intro.md` is edited:
+
+![alt text](../images/image-5.png)
+
+Make your edit and `Commit changes` to `main` branch:
+
+![alt text](../images/image-6.png)
+![alt text](../images/image-7.png)
+
+Wait a few minutes for the website to be deployed, if you're curious, have a look at the progress under `Actions` - `All wokflows`:
+
+![alt text](../images/image-8.png)
+
+When the workflow has finished, visit your build book at https://<username>.github.io/<repository_name> (case sensitive). For our example it is: https://dummystudent-Tom.github.io/My_own_book:
+
+![alt text](../images/image-9.png)

book/workflows/overview.md

@@ -2,4 +2,6 @@
 
 ```{warning} Under Construction!
 
-This page will provide a workflow how to collaborate in Git and GitLab for different uses types. Every team might have a different workflow but this workflow is shown as an example and is used in the MUDE course in CEG.
+This page will provide a workflow how to collaborate in Git and GitLab for different uses types. Every team might have a different workflow but this workflow is shown as an example and is used in the MUDE course in CEG.
+
+An alternative is to use Github and Github pages to publish your book.