-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ef8bd35
commit 08fd386
Showing
4 changed files
with
1,045 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 | |
Oops, something went wrong.