diff --git a/book/_toc.yml b/book/_toc.yml index f04c1ac..e7c607d 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -22,8 +22,9 @@ parts: - caption: Cookbook chapters: - file: cookbook/recipes.md + - file: cookbook/grasple.md - file: cookbook/jupyterlite/jupyterlite sections: - file: cookbook/jupyterlite/configuration - file: cookbook/jupyterlite/including-jupyterlite - + - file: cookbook/h5p.md diff --git a/book/cookbook/grasple.md b/book/cookbook/grasple.md new file mode 100644 index 0000000..19d27ae --- /dev/null +++ b/book/cookbook/grasple.md @@ -0,0 +1,55 @@ +# Embedding Grasple question + +[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 + +``` + +The embed link is created for an exercise under 'More'- 'Embed Exercise' + +This iframe can be embedded into your Jupyter book. Remark: it doesn't display locally in VScode or in the build file, only on the hosted version. The code shown above gives: + + +More information on Grasple and the support of TU Delft can be found on: [Teaching Support - Educational Tools - Grasple](https://www.tudelft.nl/en/teaching-support/educational-tools/grasple) + +## Replace iframe by QR code for printed version +Dani Balague Guardia created an [extension](https://github.com/dbalague/sphinx-grasple) which allows you to easily add Grasple question with some formatting and, more importantly, the creation of QR codes in the PDF version of the page. This leads to the source link of the iframe. + +The grasple exercise as shown above can now be added as follows in your markdown file: +```markdown +::::{grasple} +:url: https://embed.grasple.com/exercises/767782d5-023a-4b49-a1f3-874fca626c8e?id=79907 +:label: grasple_exercise_1 +:dropdown: +:description: Example of exercise which goes along + +:::: +``` + +This leads to the following html in the Jupyter book. Remark: again, the iframe doesn't locally in VScode or in the build file, only on the hosted version. +
+ +

Grasple Exercise 1

+
+
+
+

Example of exercise which goes along

+

+
+
+
+
+ +In the PDF this leads to: +```{figure} ../images/Grasple_pdf.png +``` + + +The extension requires an extension of the `config.yml` file: +```markdown + extra_extensions: + - sphinx_grasple + - sphinx.ext.imgconverter +``` + +The extension should be installed both locally and on the server. \ No newline at end of file diff --git a/book/cookbook/h5p.md b/book/cookbook/h5p.md new file mode 100644 index 0000000..234252e --- /dev/null +++ b/book/cookbook/h5p.md @@ -0,0 +1,31 @@ +# adding interactive h5p elements + +## 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: + +```html + +``` + +A full list of all available interactive elements is available on the website of [H5p](https://h5p.org/content-types-and-applications), these include among others: +- Multiple choice questions +- Fill in the blanks +- Drag and drop +- Interactive video +- Image hotspot + +More information on H5p: [Teaching Support - Educational Tools - H5P](https://www.tudelft.nl/teaching-support/educational-tools/h5p) + +## Example +Truss structures are modelled as rigid bars (so elements which cannot deform) connected by hinges (so elements can rotate with respect to one each other). In our model, hinges are indicate with a circle, and bars with a line. For example, the structure you've seen in the second example (with two diagonal bars removed) is modelled as follows: + +```{figure} ../images/Truss1.svg +:name: truss structure + +Bars and hinges in truss structure +``` + +Now that you've been introduced to truss structures, answer the following question: + + + \ No newline at end of file diff --git a/book/images/Grasple_pdf.png b/book/images/Grasple_pdf.png new file mode 100644 index 0000000..6679548 Binary files /dev/null and b/book/images/Grasple_pdf.png differ diff --git a/book/images/Truss1.svg b/book/images/Truss1.svg new file mode 100644 index 0000000..e9b2179 --- /dev/null +++ b/book/images/Truss1.svg @@ -0,0 +1,135 @@ + + + + + + + + + + Pagina-1 + + + Vakwerk, 1 pt.16 + + + + Vakwerk, 1 pt.17 + + + + Vakwerk, 1 pt.18 + + + + Vakwerk, 1 pt.19 + + + + Vakwerk, 1 pt.20 + + + + Vakwerk, 1 pt.14 + + + + Vakwerk, 1 pt.15 + + + + Vakwerk, 1 pt.12 + + + + Vakwerk, 1 pt.13 + + + + Vakwerk, 1 pt + + + + Vakwerk, 1 pt.2 + + + + Scharnier + + + + Scharnier.4 + + + + Scharnier.5 + + + + Scharnier.6 + + + + Scharnier.7 + + + + Scharnier.8 + + + + Scharnier.9 + + + + Scharnier.10 + + + + Blad.21 + + + + Blad.22 + + + + Blad.23 + + + + Blad.24 + + + + Blad.25 + hinges + + + + hinges + + Blad.26 + bars + + + + bars + +