[PATCH 0/8] Add support for documentation tags

[Antonin Godard <antonin.godard@bootlin.com>]

This series aims at making discovering documentation easier for users.
The Yocto Project documentation is a long-lasting repository and
nowadays has *lots* of documentation:

❯ cat -p $(find . -name "*.rst" | grep -v migration-guides) | wc -l
61530

Looking for documentation has always been a trouble of mine, so this
series adds support for tags. Tags are keywords that show at the bottom
of pages and that group different sections of the documentation by a
common category.

For example, all sstate related pages are grouped under the 'sstate'
tag. Users wanting to learn about its concept or how to use it can know
where to go from the 'sstate' tag page.

A tag overview page is also create and lists all known documentation tags.

A series will be sent to OE-Core to add sphinx-tags to the buildtools
tarball used on the Autobuilder for the docs build.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Antonin Godard (8):
      Pipfile: update dependencies for sphinx-tags
      tools/host_packages_scripts/pip3_docs.sh: update for sphinx-tags
      conf.py: enable the sphinx-tags extension
      sphinx-static/theme_overrides.css: customize tags appearance
      Makefile: use splithtml tag for html target
      docs-wide: tag sections
      index.rst: link to the tags overview page for splithtml
      standards.md: add note about document tags

 documentation/.gitignore                           |  1 +
 documentation/Makefile                             |  6 +++++-
 documentation/Pipfile                              |  2 ++
 documentation/conf.py                              |  8 ++++++++
 .../contributor-guide/identify-component.rst       |  4 ++++
 .../contributor-guide/recipe-style-guide.rst       |  4 ++++
 documentation/contributor-guide/report-defect.rst  |  4 ++++
 documentation/contributor-guide/submit-changes.rst |  4 ++++
 documentation/conventions.rst                      |  4 ++++
 documentation/dev-manual/bblock.rst                |  3 +++
 documentation/dev-manual/bmaptool.rst              |  4 ++++
 documentation/dev-manual/build-quality.rst         |  3 +++
 documentation/dev-manual/building.rst              |  3 +++
 documentation/dev-manual/creating-fragments.rst    |  4 ++++
 documentation/dev-manual/custom-distribution.rst   |  4 ++++
 .../custom-template-configuration-directory.rst    |  3 +++
 documentation/dev-manual/customizing-images.rst    |  3 +++
 documentation/dev-manual/debugging.rst             |  3 +++
 documentation/dev-manual/development-shell.rst     |  3 +++
 documentation/dev-manual/device-manager.rst        |  3 +++
 documentation/dev-manual/devtool.rst               |  4 ++++
 documentation/dev-manual/disk-space.rst            |  4 ++++
 .../dev-manual/efficiently-fetching-sources.rst    |  3 +++
 documentation/dev-manual/error-reporting-tool.rst  |  3 +++
 documentation/dev-manual/external-scm.rst          |  3 +++
 documentation/dev-manual/external-toolchain.rst    |  4 ++++
 documentation/dev-manual/gobject-introspection.rst |  3 +++
 documentation/dev-manual/hashequivserver.rst       |  4 ++++
 documentation/dev-manual/init-manager.rst          |  4 ++++
 documentation/dev-manual/layers.rst                |  3 +++
 documentation/dev-manual/libraries.rst             |  3 +++
 documentation/dev-manual/licenses.rst              |  3 +++
 documentation/dev-manual/limiting-resources.rst    |  4 ++++
 documentation/dev-manual/multiconfig.rst           |  4 ++++
 documentation/dev-manual/new-machine.rst           |  3 +++
 documentation/dev-manual/new-recipe.rst            |  3 +++
 documentation/dev-manual/packages.rst              |  3 +++
 documentation/dev-manual/poky-manual-setup.rst     |  4 ++++
 documentation/dev-manual/prebuilt-libraries.rst    |  3 +++
 .../dev-manual/python-development-shell.rst        |  3 +++
 documentation/dev-manual/qemu.rst                  |  4 ++++
 documentation/dev-manual/quilt.rst                 |  3 +++
 documentation/dev-manual/sbom.rst                  |  4 ++++
 documentation/dev-manual/speeding-up-build.rst     |  3 +++
 documentation/dev-manual/sstate-mirrors-setup.rst  |  4 ++++
 documentation/dev-manual/start.rst                 |  4 ++++
 documentation/dev-manual/temporary-source-code.rst |  4 ++++
 documentation/dev-manual/upgrading-recipes.rst     |  3 +++
 documentation/dev-manual/wayland.rst               |  3 +++
 documentation/dev-manual/wic.rst                   |  3 +++
 documentation/dev-manual/x32-psabi.rst             |  3 +++
 documentation/index.rst                            | 11 +++++++++++
 documentation/kernel-dev/index.rst                 |  4 ++++
 documentation/overview-manual/concepts.rst         |  4 ++++
 .../overview-manual/development-environment.rst    |  4 ++++
 documentation/overview-manual/yp-intro.rst         |  4 ++++
 documentation/profile-manual/index.rst             |  4 ++++
 documentation/ref-manual/devtool-reference.rst     |  4 ++++
 documentation/ref-manual/fragments.rst             |  4 ++++
 documentation/ref-manual/kickstart.rst             |  4 ++++
 documentation/ref-manual/release-process.rst       |  4 ++++
 documentation/sdk-manual/index.rst                 |  4 ++++
 .../security-manual/build-process-security.rst     |  4 ++++
 documentation/security-manual/read-only-rootfs.rst |  3 +++
 documentation/security-manual/securing-images.rst  |  3 +++
 documentation/security-manual/sstate-signing.rst   |  4 ++++
 documentation/security-manual/vulnerabilities.rst  |  3 +++
 documentation/security-reference/index.rst         |  4 ++++
 documentation/sphinx-static/theme_overrides.css    | 23 ++++++++++++++++++++++
 documentation/standards.md                         | 15 ++++++++++++++
 documentation/test-manual/ptest.rst                |  4 ++++
 documentation/test-manual/reproducible-builds.rst  |  4 ++++
 documentation/test-manual/runtime-testing.rst      |  3 +++
 documentation/test-manual/test-process.rst         |  4 ++++
 documentation/toaster-manual/index.rst             |  4 ++++
 .../tools/host_packages_scripts/pip3_docs.sh       |  2 +-
 76 files changed, 308 insertions(+), 2 deletions(-)
---
base-commit: 7b54854d12f3f2c909727702d39066a3d22a4a40
change-id: 20261021-tags-3b858a172be2