manual_teachbooks/book/features/favourites.md

```{note}
{bdg-primary}`Sphinx Extension`

{bdg-link-light}`Included in TeachBooks Template <../external/template/README.html>`

```

```{tip}
This page is useful for user type 3-5.
```

```{seealso}

[{octicon}`mark-github` Repository](https://github.com/TeachBooks/TeachBooks-Favourites)

[{octicon}`pencil` Exercise](https://teachbooks.io/template/extension_exercises/017.html)

```

TeachBooks Favourites

TeachBooks Favourites is a Sphinx extension which collects all of TeachBooks' favourite features in one place (including tools originally by TeachBooks and from other sources). It is included by default in the TeachBooks Template or can be installed independently. The features included are:

• Sphinx-Thebe from TeachBooks
• Jupyterbook patches
• Download link replacer
• Sphinx image inverter
• Sphinx iframes
• Sphinx exercise (from Executable Books including TeachBooks contributions)
• Teachbooks Sphinx tippy
• Sphinx named colors
• Sphinx dropdown toggle
• Sphinx proof (from Executable Books including TeachBooks contributions)
• Sphinx code examples
• Sphinx accessibility
• Sphinx toggle button (from Executable Books including TeachBooks contributions)
• Notebook execution patterns
• Sphinx Launch Buttons
• Sphinx GitHub Alerts
• Sphinx Metadata Figure
• Sphinx last updated by git (from Matthias Geier, TeachBooks version of the original)
• Sphinx Gated Directives
• Teachbooks Zoomies
• TeachBooks Questions
• Sphinx Sticky Margin
• TeachBooks Fetch
• Sphinx to do (from core sphinx

The extension Open in new tab is nice, but is not compatible with all setups (dependency clash) so is not included in TeachBooks-Favourites.

All features which are part of TeachBooks Favourites are include the following label on their respective pages in this manual: {bdg-primary-line}Part of TeachBooks Favourites. If you'd like to use specific features, but not the entire TeachBooks Favourites, you can remove this extension and replace it with the individual extensions you want to use.

Installation

To install TeachBooks-Favourites, follow these steps:

Step 1: Install the Package

Install the teachbooks-favourites package using pip:

pip install git+https://github.com/TeachBooks/TeachBooks-Favourites

Step 2: Add to requirements.txt

Make sure that the package is included in your project's requirements.txt to track the dependency:

git+https://github.com/TeachBooks/TeachBooks-Favourites

Step 3: Enable in _config.yml

In your _config.yml file, add the extension to the list of Sphinx extra extensions (important: underscore, not dash this time):

sphinx: 
    extra_extensions:
        - teachbooks_favourites

Usage

For using the various package we refer to the different manuals linked above.

All extensions are loaded with their default settings.

Contribute

Do you think we missed an extension that should really be included? Let us know by either

• creating a fork of this repository and submitting a pull request, in which you added the extension to the files
  • README.md
  • pyproject.toml
  • src\teachbooks_favourites\__init__.py
• opening an issue.