Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

sphinx-fonts

Sphinx extension for self-hosted fonts via Fontsource CDN.

Downloads font files at build time, caches them locally (~/.cache/sphinx-fonts), and injects @font-face declarations via Jinja2 template context.

Install

$ pip install sphinx-fonts

Usage

In your docs/conf.py:

extensions = ["sphinx_fonts"]

sphinx_fonts = [
    {
        "family": "IBM Plex Sans",
        "package": "@fontsource/ibm-plex-sans",
        "version": "5.2.8",
        "weights": [400, 500, 600, 700],
        "styles": ["normal", "italic"],
        "subset": "latin",
    },
]

sphinx_font_css_variables = {
    "--font-stack": '"IBM Plex Sans", sans-serif',
}

Requires a page.html template override that reads the font_faces and font_preload_hrefs context variables. See the gp-sphinx docs for a complete template example.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_fonts-0.0.1a32.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sphinx_fonts-0.0.1a32-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_fonts-0.0.1a32.tar.gz.

File metadata

  • Download URL: sphinx_fonts-0.0.1a32.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for sphinx_fonts-0.0.1a32.tar.gz
Algorithm Hash digest
SHA256 c7bfa095ea63489ce7c5c980aa0caa737ca1a17fbbb394c6572ee8d4278aebd3
MD5 30910783e5c42decd3f845d7a177d306
BLAKE2b-256 8798564c7286058a70cac4920232a3e12810b0f7c7c12cc0af721de7a4ec7dde

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_fonts-0.0.1a32.tar.gz:

Publisher: release.yml on git-pull/gp-sphinx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sphinx_fonts-0.0.1a32-py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_fonts-0.0.1a32-py3-none-any.whl
Algorithm Hash digest
SHA256 2a147d87b79986292d36957f4135da280432f2e03c70e4a160065c9e7bc0a7eb
MD5 10d76f2cb5ad68b6409e6e50d997339c
BLAKE2b-256 e1c5917086ef201db6b21d8743236cb7ac549fd27846bdd7d70773d87800ae75

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_fonts-0.0.1a32-py3-none-any.whl:

Publisher: release.yml on git-pull/gp-sphinx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page