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.1a36.tar.gz (5.9 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.1a36-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for sphinx_fonts-0.0.1a36.tar.gz
Algorithm Hash digest
SHA256 4936e03072fb1196d6d6106ecb363ad12e0235762f2a1a821f30c2266d5cba9b
MD5 764f2a0b71711dd1e32d3e4ca60f3251
BLAKE2b-256 d345ae1e3e319fd6771679f414aca2158b727d85df348af5fe7d9f063f6b82a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_fonts-0.0.1a36.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.1a36-py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_fonts-0.0.1a36-py3-none-any.whl
Algorithm Hash digest
SHA256 84c79b0d4cf815907af7dd279afee08771f2c7a535d5d347743ced419fb72a82
MD5 356788b3d49ceedc58be52b2270a6ff0
BLAKE2b-256 3a8259fc16e3b26cee3a6f722e6c2bffa297999ee78fea046fad5bfa4ddb04ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_fonts-0.0.1a36-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