diff --git a/book/features/HTML_javascript.md b/book/features/HTML_javascript.md index d62ed0e..633fcc4 100644 --- a/book/features/HTML_javascript.md +++ b/book/features/HTML_javascript.md @@ -1,5 +1,10 @@ # Interactive HTML/JavaScript elements +```{admonition} User types +:class: tip +This section is useful for user type 5. +``` + In this section, we will discuss how to [create](creating_basic_HTML_elements.md) and [embed](adding_HTML_elements.md) interactive HTML/Javascript elements created in HTML/JavaScript in a TeachBook. These HTML/Javascript element work very fluently and don't require a python kernel running in the background. This could be for example interactive 3d figures: diff --git a/book/features/custom_download.md b/book/features/custom_download.md index b683409..4ee96cd 100644 --- a/book/features/custom_download.md +++ b/book/features/custom_download.md @@ -2,7 +2,7 @@ ```{admonition} User types :class: tip -This section is useful for user type 4-6. +This section is useful for user type 4-5. ``` You can control the download option of the book in two ways: diff --git a/book/features/custom_toc.md b/book/features/custom_toc.md index c968c10..fe178c0 100644 --- a/book/features/custom_toc.md +++ b/book/features/custom_toc.md @@ -2,7 +2,7 @@ ```{admonition} User types :class: tip -This section is useful for user type 3-6. +This section is useful for user type 3-5. ``` A new feature is added to enable testing of all interactive features on the web server (i.e., in the draft book) while preventing students from seeing it. Pages in the draft book (`main` branch) can be manually stripped out of the table of contents when a merge request from `main` to `publish` is made using a tag `REMOVE-FROM-PUBLISH`. Pages marked with this feature are still visible in the draft book and books build from source on personal computers. The tag is applied as follows: diff --git a/book/features/grasple.md b/book/features/grasple.md index 6cb2359..038f7d3 100644 --- a/book/features/grasple.md +++ b/book/features/grasple.md @@ -1,5 +1,10 @@ # Grasple questions +```{admonition} User types +:class: tip +This section is useful for user type 3-5. +``` + [Grasple](https://app.grasple.com/) gives you an embed code for each exercise which looks like this, which can be added cirectly to your markdown-file. ```html diff --git a/book/features/h5p.md b/book/features/h5p.md index 8ae0bfd..463dcab 100644 --- a/book/features/h5p.md +++ b/book/features/h5p.md @@ -1,5 +1,10 @@ # Adding interactive h5p elements +```{admonition} User types +:class: tip +This section is useful for user type 3-5. +``` + ## Instruction H5p elements are interactive HTML-blocks which can be imbeded in a Jupyter Book using an iframe. H5p element can be created in the [TU Delft portal on the H5p website](https://tudelft.h5p.com/content) (sign in via Brightspace to H5p required first). The iframe code can be copied at Edit - Publish - Public - Embed code. This html code can be directly added to your markdown file: diff --git a/book/installation-and-setup/user_types.md b/book/installation-and-setup/user_types.md index 4b9b0c4..5d6f09c 100644 --- a/book/installation-and-setup/user_types.md +++ b/book/installation-and-setup/user_types.md @@ -20,7 +20,7 @@ Different types of users will interact with the website or the Jupyter Books dif 4. **Colleague making text adjustments to multiple files at the same time locally**.
User 4 is a hybrid between type 3 and 5. Basically this user is making changes by editing the .md files locally using, for example, VS Code. Therefore, this user requires a little bit more knowledge on git (think of pulling and pushing changes) but their main focus remains to make adjustments to the content of the book by editing .md files whereas user type 4 has more knowledge to make changes to python files the book as well. This user can build the book online. -5. **Colleague making text and python adjustments to multiple files at the same time locally**.
+5. **Colleague making text and code (especially Python) adjustments to multiple files at the same time locally**.
Example Image This user has more knowledge in GitLab/GitHub than the previous user and can basically take care of branching and merging by themselves. They know how to work with software for editing .md and .ipynb files. They can use the draft book online to view their changed in the book, or build the book locally.