Skip to content

Tooltips

Tooltips show additional information when hovering over text.

Abbreviations

Define abbreviations that show full text on hover:

The HTML specification is maintained by the W3C.

*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium

The HTML specification is maintained by the W3C.

Footnotes

Add footnotes with references:

DocsForge is a self-contained documentation build system.[^1]

[^1]: All dependencies are vendored into the project repository.

DocsForge is a self-contained documentation build system.1

Content tooltips

Enable with content.tooltips feature:

theme:
  features:
    - content.tooltips

This adds hover tooltips for abbreviations and links throughout the site.

Use title attribute for link tooltips:

[DocsForge](https://github.com/QQSHI13/docsforge "Self-contained documentation builds")

Definition lists as tooltips

Definition terms can serve as glossary entries:

DocsForge
:   A self-contained documentation build system with vendored dependencies.
DocsForge
A self-contained documentation build system with vendored dependencies.

Automatic link conversion for GitHub references:

See issue #123 and PR #456 for details.

Enable with:

markdown_extensions:
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: QQSHI13
      repo: docsforge-docs

Next steps

  1. All dependencies are vendored into the project repository. ↩