diff --git a/book/syntax_exercises/009.md b/book/syntax_exercises/009.md new file mode 100644 index 0000000..9c12cc9 --- /dev/null +++ b/book/syntax_exercises/009.md @@ -0,0 +1,100 @@ +# Exercise 9: Cross-referencing content + +In this exercise, you will learn how to create references to other parts of your book, such as chapters, equations, tables, and figures. + +::::::{topic} Exercise objective +Can you create internal references to other sections, equations, tables, and figures? +:::::: + +```{tip} +Referencing elements properly ensures that readers can navigate your book more easily. More details can be found in the [JupyterBook documentation](https://jupyterbook.org/en/stable/content/references.html). +``` + +## 1. Referencing a Chapter or Section + +To create a reference to another chapter or section, use the following syntax: + +```md +[Text to display](path/to/file.md) +``` + +For example, if you want to link to Exercise 7, you can write: + +```md +[Go to Exercise 7](../exercises/007.md) +``` + + +## 2. Referencing an Equation + +To reference an equation, you need to define a label using `{eq}` and refer to it elsewhere in your text: + +```md +```{math} +:label: eq-example +E = mc^2 +``` +``` + +You can then reference this equation using: + +```md +Equation {eq}`eq-example` +``` + +## 3. Referencing a Table + +To reference a table, assign a label when defining it: + +```md +```{table} Example Table +:label: tab-example +| Column 1 | Column 2 | +|----------|----------| +| A | B | +``` +``` + +And refer to it using: + +```md +Table {numref}`tab-example` +``` + +## 4. Referencing a Figure + +To reference a figure, label it when inserting it: + +```md +```{figure} figures/example.png +--- +width: 80% +align: center +name: fig-example +--- +Example figure. +``` +``` + +And refer to it using: + +```md +Figure {numref}`fig-example` +``` + +## 5. Commit Your Changes + +1. Once you have added your references, commit your changes to the repository. +2. Click the green `Commit changes` button. +3. Add a commit message. +4. View your changes using the `Actions` tab and check if they appear correctly. + +```{admonition} Check your understanding +:class: note + +Before moving on to the next exercise, make sure you understand the following: +- How do you reference another chapter? +- How do you create a reference to an equation? +- How can you refer to a table or a figure in your book? + +``` \ No newline at end of file