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

Update 005a.md

Browse source
This commit is contained in:
Tom van Woudenberg 2025-06-18 13:23:29 +02:00 • committed by GitHub
parent ac4e319dd5
commit 45253e3c7e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

20
book/exercises/005a.md
View file

@ -25,34 +25,34 @@ Can you include a page from someone else’s book into your own using `external:
- external: https://github.com/TeachBooks/manual/blob/release/book/examples/book_structure.md - external: https://github.com/TeachBooks/manual/blob/release/book/examples/book_structure.md
``` ```
2. Add the `external:` link into the `parts:` or `chapters:` section of your `_toc.yml` file. 2. Add the `external:` link into `chapters:` section of your `_toc.yml` file.
3. Save the changes, commit, and push them. 3. Save the changes, commit, and push them.
````{admonition} Example ````{admonition} Example
`_toc.yml` snippet: `_toc.yml` snippet:
```yaml ```yaml
format: jb-book format: jb-book
root: intro root: intro
parts:
- caption: Contents
chapters: chapters:
- file: 001 - file: 001
- external: https://github.com/TeachBooks/manual/blob/release/book/examples/book_structure.md - external: https://github.com/TeachBooks/manual/blob/release/book/examples/book_structure.md
- 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.
5. Add a commit message. 5. Add a commit message.
6. To see your changes, go to {octicon}`play` `Actions` - The most recent workflow run `overview.md / the commit message of the commit you just made` - Wait for it to finish - In the summary, click on the link of your book shown in the table `Branches deployed` and under `Primary book at root` (getting bored of waiting? There'll be exercising on doing this locally which prevents you from waiting). 6. To see your changes, go to {octicon}`play` `Actions` - The most recent workflow run `the commit message of the commit you just made` - Wait for it to finish - In the summary, click on the link of your book shown in the table `Branches deployed` and under `Primary book at root` (getting bored of waiting? There'll be exercising on doing this locally which prevents you from waiting).
7. Do you see your change? If you don't see it click `CTRL`+`F5`/`Control`+`F5`to refresh the page. 7. Do you see your change? If you don't see it click `CTRL`+`F5`/`Control`+`F5`to refresh the page. Open the reused page. At the top, you should see an **attribution box**. This confirms the external content is working correctly and shows where it was sourced from.
8. When viewing your book online, open the reused page. At the top, you should see an **attribution box**. This confirms the external content is working correctly and shows where it was sourced from.
```{figure} https://github.com/TeachBooks/template_figures/blob/main/external_page_attribution.png?raw=true ```{figure} https://github.com/TeachBooks/template_figures/blob/main/external_page_attribution.png?raw=true
:name: external_page_attribution :name: external_page_attribution