diff --git a/book/Introduction/Authors.md b/book/Introduction/Authors.md index d1153c0..c209741 100644 --- a/book/Introduction/Authors.md +++ b/book/Introduction/Authors.md @@ -2,7 +2,7 @@ ```{figure} ../Pedagogy/Figures/team.jpg --- -width:70% +width: 70% --- Part of the team discussing one of the potential demonstrations of the third edition of Show*de*Fysica. ``` diff --git a/book/Introduction/tableOC.md b/book/Introduction/tableOC.md index b058272..da82ccf 100644 --- a/book/Introduction/tableOC.md +++ b/book/Introduction/tableOC.md @@ -9,7 +9,7 @@ align: right **Introduction** 1. [About this book](../Introduction/About.ipynb) 2. [Preface](../Introduction/Foreword.md) -3. [Preface from the editor](../introduction/Preface2.md) +3. [Preface from the editor](../Introduction/Preface2.md) 4. [About the authors](../Introduction/Authors.md) 5. [NVON](../Introduction/NVON.md) 6. [Python](../Introduction/Python%20summary.ipynb) diff --git a/book/Pedagogy/Argumentation.ipynb b/book/Pedagogy/Argumentation.ipynb index 31e25e1..015cacf 100644 --- a/book/Pedagogy/Argumentation.ipynb +++ b/book/Pedagogy/Argumentation.ipynb @@ -17,7 +17,7 @@ "\n", "```{figure} Figures/sdf.jpg\n", "---\n", - "width=70%\n", + "width: 70%\n", "---\n", "The [signing rod](../demos/demo81/demo81.ipynb), how many measurements do we need before we have a 'convincing' value for Young's modulus for a specific material?\n", "```\n", diff --git a/book/Pedagogy/Introduction.md b/book/Pedagogy/Introduction.md index 88be65f..942d587 100644 --- a/book/Pedagogy/Introduction.md +++ b/book/Pedagogy/Introduction.md @@ -58,7 +58,7 @@ width: 75% [Determination of $g$](../demos/demo73/demo73.ipynb) revolves around the question how you can determine the acceleration due to gravity as precise as possible. ``` -Our [demonstrations on teaching scientific inquiry](../demos/Inquirydemos.md) cover this learning objective. These demonstrations aim at teaching students to become aware of the decisions they have to make when conceiving a scientific investigation. They are meant to teach students to thoroughly consider various options and determine, also in regard of the practical limitations, what decision is 'best' from a scientific perspective. [Argumentation](./Argumentation.md) plays a major role in this. +Our [demonstrations on teaching scientific inquiry](../demos/Inquirydemos.md) cover this learning objective. These demonstrations aim at teaching students to become aware of the decisions they have to make when conceiving a scientific investigation. They are meant to teach students to thoroughly consider various options and determine, also in regard of the practical limitations, what decision is 'best' from a scientific perspective. [Argumentation](./Argumentation.ipynb) plays a major role in this. Teaching students how to investigate their world independently in a scientific way includes addressing questions such as: 1. What does it mean when some claim is said to be *"scientifically proven"*? @@ -92,7 +92,7 @@ In physics research, all of these questions matter but in demonstrations this is Questions like question 1. encourage [thinking-back-and-forth between theory and practice](../Pedagogy/BackAndForthThinking.md). In demonstrations of this kind something often happens that your audience doesn't expect and that raises questions. This will allow you to illustrate how in physical research you are constantly testing theory and practice against each other. Students experience this with the support of the teacher in the demonstrations. -Questions like question 2. focus on [argumentation](../Pedagogy/Argumentation.md). When doing scientific inquiry students often seem satisfied with any answer they can find, without spending further effort in finding the most *convincing* answer available. In science only that optimally convincing answer would be good enough. +Questions like question 2. focus on [argumentation](../Pedagogy/Argumentation.ipynb). When doing scientific inquiry students often seem satisfied with any answer they can find, without spending further effort in finding the most *convincing* answer available. In science only that optimally convincing answer would be good enough. But what do we find convincing in science, and why? Demonstrations can develop scientific understandings of this kind in students. Questions such as question 3. deal with the [nature of science](../Pedagogy/Nos.md). In successful research the researcher is looking for something that was not yet known. diff --git a/book/_config.yml b/book/_config.yml index 1640892..b7c2685 100644 --- a/book/_config.yml +++ b/book/_config.yml @@ -43,15 +43,19 @@ sphinx: use_thebe_lite: true exclude_patterns: ["**/**"] html_theme_options: - repository_url: https://github.com/TeachBooks/Showing-Physics #"https://gitlab.tudelft.nl/fpols/showing-physics" # Online location of your book + repository_url: https://github.com/TeachBooks/Showing-Physics #"https://gitlab.tudelft.nl/fpols/showing-physics" # Online location of your book # path_to_book: # Optional path to your book, relative to the repository root # branch: # Which branch of the repository should be used when creating links (optional) use_repository_button: true use_issues_button: true - use_multitoc_numbering: true + # use_multitoc_numbering: true launch_buttons: thebe: true + html: + use_multitoc_numbering: true nb_render_text: ["remove-input", "hide-input"] # to hide or remove input cells with tags + suppress_warnings: ['ref.duplicate'] # suppress warnings for duplicate labels + extra_extensions: - sphinx_exercise #- extensions.fa_extension # for fontawesome icons needed when converting to pdf diff --git a/book/demos/demo43/demo43.md b/book/demos/demo43/demo43.md index 9f3ab67..62d92ce 100644 --- a/book/demos/demo43/demo43.md +++ b/book/demos/demo43/demo43.md @@ -17,6 +17,7 @@