Skip to main content

MkDocs plugin for dynamic OpenGraph images via Allscreenshots API

Project description

mkdocs-allscreenshots-og-screenshot

MkDocs plugin that automatically generates dynamic OpenGraph images for every page using Allscreenshots.

Each page gets a unique og:image meta tag pointing to a live screenshot of that page.

Installation

pip install mkdocs-allscreenshots-og-screenshot

Or install locally:

pip install -e .

Usage

Add the plugin to your mkdocs.yml:

site_url: https://yourdomain.com

plugins:
  - search
  - allscreenshots-og-screenshot

This will add the following meta tag to each page:

<meta property="og:image" content="https://og.allscreenshots.com?url=https%3A%2F%2Fyourdomain.com%2Fyour-page%2F" />

Configuration

plugins:
  - allscreenshots-og-screenshot:
      screenshot_base_url: https://og.allscreenshots.com  # default
      site_url: https://yourdomain.com  # optional, falls back to site_url in mkdocs.yml
Option Default Description
screenshot_base_url https://og.allscreenshots.com Base URL for the screenshot API
site_url - Override the site URL (uses site_url from mkdocs.yml by default)

License

MIT

Project details


Download files

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

Source Distribution

mkdocs_allscreenshots_og_screenshot-0.1.1.tar.gz (2.3 kB view details)

Uploaded Source

Built Distribution

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

File details

Details for the file mkdocs_allscreenshots_og_screenshot-0.1.1.tar.gz.

File metadata

File hashes

Hashes for mkdocs_allscreenshots_og_screenshot-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b38000ae697eab07dcc90bfa1f6f3d8c957cd8075315fbd51e8729aaab328d81
MD5 729ea8b6017aaa4e19b51e1881f529cc
BLAKE2b-256 753ff4332040423e091bbafcc1e7c0a8cbde20e1c862b6d2ae751006bf603a7b

See more details on using hashes here.

File details

Details for the file mkdocs_allscreenshots_og_screenshot-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_allscreenshots_og_screenshot-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 57cf53e8a57f9f2a920297a3ce785ad0ea8ef27d8937c9d954b03112b6260903
MD5 aad0b7e2f203e253610206833a674dae
BLAKE2b-256 c7abbac753ae72cc7151d2050c981408e79452c4793f18da5b727d8f9e3341f3

See more details on using hashes here.

Supported by

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