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

Uploaded Python 3

File details

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

File metadata

  • Download URL: sphinx_fonts-0.0.1a34.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.1a34.tar.gz
Algorithm Hash digest
SHA256 bf8392cd057c430db3064a0dd6f43bfd0defe94a80fcd0c68993b04268201cb4
MD5 18c496df78f51473cc00e23ceb7a6628
BLAKE2b-256 c564654804528ef85604722dbb168de178fcae5daac8e85c86317dff5155422d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for sphinx_fonts-0.0.1a34-py3-none-any.whl
Algorithm Hash digest
SHA256 5057228567d03e554f47045cc32a178bd6bbeab9cd01e760bde8f2236843872e
MD5 334d6814e82000b0b03a43b0cfbd8d6b
BLAKE2b-256 0fbf713e7e8f1f79105045c30a864bceeef62b6ebf65b6551e531868f2403fa4

See more details on using hashes here.

Provenance

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