From f5d17483f5c75f403e90e2894fa341b10adcc31c Mon Sep 17 00:00:00 2001 From: Katia Gatt Date: Mon, 11 Aug 2025 22:02:58 +0200 Subject: [PATCH] automatic indexing --- book/exercises/007.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/book/exercises/007.md b/book/exercises/007.md index d7b5256..d6c5d47 100644 --- a/book/exercises/007.md +++ b/book/exercises/007.md @@ -47,7 +47,16 @@ Can you install and use a new Sphinx extension like `Sphinx-Indexed-Definitions` This will appear as a hyperlink that takes the reader directly to the definition. -7. The same steps you followed here can be used to install any other extension of your choice. Simply add the extension to your `requirements.txt` (using either a GitHub link or PyPI package name), and list it under `extra_extensions` in `_config.yml`. Then use its features in your Markdown files according to the extension’s documentation. Check out the ever-growing list of TeachBooks extensions in the [TeachBooks manual](https://teachbooks.io/manual/features/overview.html)! + +7. The extension can also automatically index terms based on text formatting. In another `.md` file, try writing: + + ```md + This is a **strong term**, this is an *emphasised term*, and this is a `literal term`. + ``` + + When the book is built, these terms will be included in the generated index without needing to define them manually. You can view the index in the build output to confirm. + +8. The same steps you followed here can be used to install any other extension of your choice. Simply add the extension to your `requirements.txt` (using either a GitHub link or PyPI package name), and list it under `extra_extensions` in `_config.yml`. Then use its features in your Markdown files according to the extension’s documentation. Check out the ever-growing list of TeachBooks extensions in the [TeachBooks manual](https://teachbooks.io/manual/features/overview.html)! 8. When you are ready, commit your changes to the repository by clicking on the green `Commit changes` button.