admin2/template
1
0
Fork 0
mirror of https://github.com/TeachBooks/template.git synced 2026-11-13 06:35:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

display updates

Browse source
This commit is contained in:
katiagatt 2025-06-02 22:31:20 +02:00
parent e42fd30d76
commit 087f66fe61
1 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

22
book/exercises/005a.md
View file

@ -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. * 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. * 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`? 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 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 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)). * 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`). * 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 ```yaml
- external: https://github.com/TeachBooks/manual/blob/v1.1.1/book/examples/book_structure.md - 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. 3. Save the changes, commit, and push them.
\::::::{admonition} Example: `_toc.yml` snippet ````{admonition} Example: `_toc.yml` snippet
```yaml ```yaml
format: jb-book format: jb-book
@ -41,7 +41,7 @@ chapters:
- file: 003 - file: 003
``` ```
\:::::: ````
4. When you are ready, commit your changes to the repository by clicking on the green `Commit changes` button. 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 ```{admonition} Check your understanding
\:class: note :class: note
Before moving on, make sure you understand: Before moving on, make sure you understand:
* What is the benefit of linking to an external page instead of copying it? * What is the benefit of linking to an external page instead of copying it?
* How does using the Recombiner simplify adding external content? * How does using the Recombiner simplify adding external content?
* What can you do if a page isn’t in the Recombiner? * What can you do if a page isn’t in the Recombiner?
\:::::: ```