admin2/template
1
0
Fork 0
mirror of https://github.com/TeachBooks/template.git synced 2026-11-12 22:25: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

22
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
```
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.
````{admonition} Example
`_toc.yml` snippet:
`_toc.yml` snippet:
```yaml
format: jb-book
root: intro
```yaml
format: jb-book
root: intro
chapters:
parts:
- caption: Contents
chapters:
- file: 001
- external: https://github.com/TeachBooks/manual/blob/release/book/examples/book_structure.md
- file: 003
```
```
````
4. When you are ready, commit your changes to the repository by clicking on the green `Commit changes` button.
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.
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.
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.
```{figure} https://github.com/TeachBooks/template_figures/blob/main/external_page_attribution.png?raw=true
:name: external_page_attribution