diff --git a/book/_toc.yml b/book/_toc.yml index 9073c86..29d5ac6 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -22,7 +22,7 @@ parts: sections: - file: exercises/007.md - file: exercises/008.md - - file: exercises/type4.mb + - file: exercises/type4.md sections: - file: exercises/009.md - file: exercises/010.md diff --git a/book/exercises/008.md b/book/exercises/008.md index 7ce8c12..3068f1f 100644 --- a/book/exercises/008.md +++ b/book/exercises/008.md @@ -15,7 +15,6 @@ To help you illustrate your content, it can be sueful to add some type of visual 5. Copy this syntax and adjust the file name, width, alignment and caption. - ```{figure} figures/.PNG --- width: 80% @@ -42,7 +41,6 @@ Make sure the file extension of your figure is correct because markdown differen To link and display an online figure, you can use the `{figure}` directive, which also allows captions and references. - ```{figure} https://town-n-country-living.com/wp-content/uploads/2023/06/craftsman-exterior.jpg --- width: 80% @@ -51,7 +49,6 @@ To link and display an online figure, you can use the `{figure}` directive, whic --- ``` - ```` ````` diff --git a/book/exercises/009.md b/book/exercises/009.md index a49a9c9..9f389b4 100644 --- a/book/exercises/009.md +++ b/book/exercises/009.md @@ -1,10 +1,14 @@ # Exercise 9: Referencing using target headers -It can be really useful to refer to a specific section in your book while working in a different file. Referencing can be done using target headers. ()= +It can be really useful to refer to a specific section in your book while working in a different file. Referencing can be done using target headers such as: + +``` +(<title>)= +``` 1. Navigate to the file you want to work in (for example `book/some_content/overview.md`) and make sure you're in the correct branch. -2. Identify the section you want to reference and name it ebtween bracketsfor example exercise_1. +2. Identify the section you want to reference and name it between brackets for example `exercise_`1. ``` (exercise_1)= @@ -14,21 +18,21 @@ Let's start with the most basic edit: add some text to a file and see that the w ``` -3. Referncing +3. Referencing -There are three types of referencing +There are three types of referencing: -If you want to refernce in line you can use: +* If you want to refernce in line you can use: -My favourte exercise was {ref}`exercise_1`. +My favourite exercise was {ref}`exercise_1`. ``` My favourte exercise was {ref}`exercise_1`. ``` -You can specify the text of the target: +* You can also specify the in-line text of the target (aka what the link will say): -{ref}`MyST syntax lecture <exercise_1>` +{ref}`Best exercise <exercise_1>` -Another alternative is to use Markdown syntax: +* Another alternative is to use Markdown syntax: -[MyST syntax lecture](exercise_1) \ No newline at end of file +[Best exercose](exercise_1) \ No newline at end of file diff --git a/book/exercises/010.md b/book/exercises/010.md index 8c8990e..05bbfde 100644 --- a/book/exercises/010.md +++ b/book/exercises/010.md @@ -1,3 +1,6 @@ # Exercise 10: ... -ghkvkhg \ No newline at end of file +```{attention} + +Under Construction +``` \ No newline at end of file diff --git a/book/exercises/type3.md b/book/exercises/type3.md index 7c67e14..c221588 100644 --- a/book/exercises/type3.md +++ b/book/exercises/type3.md @@ -4,6 +4,5 @@ Now that you've made your own version of the book, it's time to add some content Exercises for user type 3 relate to: -- File Structure (Markdown) -- In-text referencing -- Adding a figure \ No newline at end of file +- [File structure (Markdown)](007.md) +- [Adding visual media](008.md) \ No newline at end of file diff --git a/book/exercises/type4.md b/book/exercises/type4.md index df8b1b4..9986582 100644 --- a/book/exercises/type4.md +++ b/book/exercises/type4.md @@ -1,3 +1,7 @@ # User type 4 -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 5 has more knowledge to make changes to python files the book as well. This user can build the book online and therefore does not need to have special software installed besides a text editor (e.g., Python is not required). Using this skills, this user type can take the role as editor, managing more than just book content. \ No newline at end of file +User 4 is a hybrid between type 3 and 5. As user type 4 you will mainly be making changes by editing the `.md` files locally using, for example, VS Code. + +Exercises for user type 4 relate to: + +- [Referencing](009.md)