Moved over exercises properly

This commit is contained in:
Tom van Woudenberg 2024-12-19 09:22:45 +01:00
parent ef8bd3535c
commit 08fd386338
4 changed files with 1045 additions and 1 deletions

View file

@ -15,6 +15,7 @@ parts:
- file: exercises/004.md
- file: exercises/005.md
- file: exercises/006.md
- file: exercises/summary
- file: references.md
- file: changelog.md
- file: credits.md

View file

@ -1,3 +1,19 @@
# Exercises
Want to get started making books? Follow these exercises!
Getting used to the syntax of writing in a Jupyter Book can be a bit daunting at the start, not to mention becoming familiar with the various tools and workflows required. To help make the learning curve somewhat easier to travel, a number of exercises have been prepared for you as part. The exercises are designed such that no prior experience with any tools or programming is required, as long as you have read the preceding introductory pages.
```{exercise}
Work through the exercises attached to this page (you can find them in the left sidebar).
```
```{tip}
Maybe you're already comfortable with Git, GitHub and the concept of using software to parse text-based files and create marked-up documents. In that case, can you answer the following questions (referring to the exercises):
1. Can you add some content to the intro page?
2. Can you add the file named `file_to_be_added_to_toc.md` to the book website?
3. Can you edit the repository url defined in the `_config.yml`, change the title shown below the logo and change the author as shown in the footer?
4. Can you make a new branch of your book with an additional file `file_on_new_version.md` and view it online?
5. Can you merge your branch into `main` with a pull request?
6. Can you fork someone else's repo, and suggest a change in a pull request?
If something is not clear, dive into to the relevant exercise page.
```

21
book/exercises/summary.md Normal file
View file

@ -0,0 +1,21 @@
# Summary of Workshop: All Exercises
With the exercises, you did all the steps of our TeachBooks workflow!
```{figure} ../figures/TeachBooks_flowchart.svg
---
width: 500px
align: center
---
```
Here is how the exercises relate to the workflow.
| Step No. | Name | Exercise | Description |
| :---: | :---: | :---: | :---: |
| 1 | Get and idea | 4 | Create an issue |
| 2 | Create _your_ version of the book | 4 | Create a branch |
| 3 | Edit the book | 1, 2, 3| Editing `.md`-files, the `_toc.yml` and the `_config.yml` |
| 4 | Check changes online | 1, 2, 3 | Workflows and Actions Summary |
| 5 | Repeat edit and checking | 1, 2, 3, 4, 5 | Keep on doing all the steps until it's ready|
| 6 | Submit for review | 5, 6 | Open and merge a Pull Request, from a branch or forks |

File diff suppressed because it is too large Load diff

After

Width:  |  Height:  |  Size: 79 KiB