Use sphinxext-opengraph to generate OpenGraph metadata (#953)

Co-authored-by: Ezio Melotti <[email protected]>

Author: hugovk

_static/og-image.png

@@ -10,6 +10,7 @@
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
     'sphinx_copybutton',
+    'sphinxext.opengraph',
     'sphinxext.rediraffe',
 ]
 
@@ -105,6 +106,16 @@
 
 todo_include_todos = True
 
+# sphinxext-opengraph config
+ogp_site_url = "https://devguide.python.org/"
+ogp_site_name = "Python Developer's Guide"
+ogp_image = "_static/og-image.png"
+ogp_custom_meta_tags = [
+    '<meta property="og:image:width" content="1200">',
+    '<meta property="og:image:height" content="630">',
+    '<meta name="theme-color" content="#3776ab" />',
+]
+
 # Strip the dollar prompt when copying code
 # https://sphinx-copybutton.readthedocs.io/en/latest/use.html#strip-and-configure-input-prompts-for-code-cells
 copybutton_prompt_text = "$"

conf.py

@@ -2,4 +2,5 @@ Sphinx==5.3.0
 furo>=2022.6.4
 sphinx_copybutton>=0.3.3
 sphinx-lint==0.6.7
+sphinxext-opengraph>=0.7.1
 sphinxext-rediraffe