Gallery¶

Each example shows the rendered label, then the source that produced it.

Kinds¶

The Commission publishes three icons. With no argument, the directive uses basic.

AI
.. ai-label:: basic
AI-generated
.. ai-label:: generated
AI-modified
.. ai-label:: modified

Variants¶

Each icon comes in black, white, black-50 and white-50. The -50 variants are 50% transparent, and the white ones are for dark backgrounds. The dark panels below come from this site’s own CSS, added with :class:.

AI-generated
.. ai-label:: generated
   :variant: black
AI-generated
.. ai-label:: generated
   :variant: black-50
AI-generated
.. ai-label:: generated
   :variant: white
   :class: dark-panel
AI-generated
.. ai-label:: generated
   :variant: white-50
   :class: dark-panel

The default variant is auto, which shows black or white depending on the reader’s prefers-color-scheme. This site sets eu_ai_label_variant = "black" because its theme has no dark mode.

Text¶

For basic, the text goes before the icon, so it reads as a sentence ending in “AI”.

Summary generated withAI
.. ai-label:: basic
   :text: Summary generated with

For the other kinds, the text goes after the icon.

AI-modifiedIllustrations modified with AI
.. ai-label:: modified
   :text: Illustrations modified with AI

An empty :text: shows the icon on its own, even if eu_ai_label_texts sets text for that kind.

.. ai-label:: modified
   :text:

Alignment¶

AI-generated
.. ai-label:: generated
   :align: left
AI-generated
.. ai-label:: generated
   :align: center
AI-generated
.. ai-label:: generated
   :align: right

Inline role¶

The role puts a label in running text.

This sentence was AI-generated.

This sentence was :ai-label:`generated`.

Add a variant after the kind, and put text before it in angle brackets, as with links.

This paragraph was written withAI

:ai-label:`This paragraph was written with <basic black-50>`

sphinx-eu-ai-label

EU AI labelling icons for Sphinx

Navigation

  • Gallery
    • Kinds
    • Variants
    • Text
    • Alignment
    • Inline role
  • MyST Markdown
  • Configuration

Related Topics

  • Documentation overview
    • Previous: sphinx-eu-ai-label
    • Next: MyST Markdown
©2026, Kristian Glass. | Powered by Sphinx 9.1.0 & Alabaster 1.0.0 | Page source