diff --git a/book/exercises/005a.md b/book/exercises/005a.md index 9e49aa2..684e4b4 100644 --- a/book/exercises/005a.md +++ b/book/exercises/005a.md @@ -7,19 +7,19 @@ You can find the link to reuse in one of two ways: * Use the [TeachBooks Recombiner](https://teachbooks.io/recombiner/) to select and copy the link. * If the page isn't listed in the Recombiner, find the link manually in the GitHub repository. -\::::::{topic} Exercise objective +::::::{topic} Exercise objective Can you include a page from someone else’s book into your own using `external:` in your `_toc.yml`? -\:::::: +:::::: -1. **Find the page you want to reuse:** +1. Find the page you want to reuse: - * **Option 1:** Open the [TeachBooks Recombiner](https://teachbooks.io/recombiner/), select the book and chapter(s) you want to reuse, and click **Show how do it yourself instructions**. Copy the `external:` link provided. - * **Option 2:** If the page isn’t in the Recombiner, find it manually: + * Option 1: Open the [TeachBooks Recombiner](https://teachbooks.io/recombiner/), select the book and chapter(s) you want to reuse, and click *Show how do it yourself instructions*. Copy the `external:` link provided. + * Option 2: If the page isn’t in the Recombiner, find it manually: * Go to the repository (e.g., [TeachBooks Manual on GitHub](https://github.com/TeachBooks/manual)). * Browse the files and find the `.md` page you want (e.g., `README.md`, `workflows/collaboration.md`). - * Copy the **raw link** in this format: + * Copy the raw link in this format: ```yaml - external: https://github.com/TeachBooks/manual/blob/v1.1.1/book/examples/book_structure.md @@ -29,7 +29,7 @@ Can you include a page from someone else’s book into your own using `external: 3. Save the changes, commit, and push them. -\::::::{admonition} Example: `_toc.yml` snippet +````{admonition} Example: `_toc.yml` snippet ```yaml format: jb-book @@ -41,7 +41,7 @@ chapters: - file: 003 ``` -\:::::: +```` 4. When you are ready, commit your changes to the repository by clicking on the green `Commit changes` button. @@ -53,12 +53,12 @@ chapters: -\::::::{admonition} Check your understanding -\:class: note +```{admonition} Check your understanding +:class: note Before moving on, make sure you understand: * What is the benefit of linking to an external page instead of copying it? * How does using the Recombiner simplify adding external content? * What can you do if a page isn’t in the Recombiner? - \:::::: +```