Use the create-social-cards tag

Author: AA-Turner

Doc/conf.py

@@ -621,16 +621,19 @@
 # Options for sphinxext-opengraph
 # -------------------------------
 
-ogp_site_url = 'https://hugovk-cpython.readthedocs.io/en/ogp_social_cards/'
+ogp_site_url = 'https://docs.python.org/3/'
 ogp_site_name = 'Python documentation'
-# ogp_image = '_static/og-image.png'
-# ogp_custom_meta_tags = [
-#     '<meta property="og:image:width" content="200" />',
-#     '<meta property="og:image:height" content="200" />',
-#     '<meta name="theme-color" content="#3776ab" />',
-# ]
-
-ogp_social_cards = {
-    "image": "_static/og-image.png",
-    "line_color": "#3776ab",
+ogp_social_cards = {  # Used when matplotlib is installed
+    'image': '_static/og-image.png',
+    'line_color': '#3776ab',
 }
+ogp_custom_meta_tags = [
+    '<meta name="theme-color" content="#3776ab" />',
+]
+if 'create-social-cards' not in tags:  # noqa: F821
+    # Define a static preview image when not creating social cards
+    ogp_image = '_static/og-image.png'
+    ogp_custom_meta_tags += [
+        '<meta property="og:image:width" content="200" />',
+        '<meta property="og:image:height" content="200" />',
+    ]

Doc/requirements.txt

@@ -19,5 +19,3 @@ sphinx-notfound-page~=1.0.0
 python-docs-theme>=2023.3.1,!=2023.7
 
 -c constraints.txt
-
-matplotlib