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

Uploaded Python 3

File details

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

File metadata

  • Download URL: sphinx_fonts-0.0.1a35.tar.gz
  • Upload date:
  • Size: 5.8 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.1a35.tar.gz
Algorithm Hash digest
SHA256 13a1c83a02c0f14547f0295d8d9d9f5728ba5fb19793b319dbadddace714ee4c
MD5 e56a5ed6eaa98e804dba1a84204d7e79
BLAKE2b-256 2ddbdb42563a8b22886241c00d319cb7c7297c074ce5d45ff4ed23f2fa4b001f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for sphinx_fonts-0.0.1a35-py3-none-any.whl
Algorithm Hash digest
SHA256 c1a78e43591937d32dab3e4335cfd810f1b3ccc656e2deb873b10d55b179f07d
MD5 50ad02a1aec0ced8a4bc727fa731ba4d
BLAKE2b-256 1373875faebf651c63eb29462ae181b70e164b707d53b245770ab8aa74c93ed2

See more details on using hashes here.

Provenance

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