From f11ad7136dbaf36b9959ebe5f7ce6b3fa8ce714c Mon Sep 17 00:00:00 2001
From: Andreas Motl <andreas.motl@panodata.org>
Date: Sun, 27 Oct 2024 16:23:46 +0100
Subject: [PATCH] Documentation: Add Sphinx extensions "copybutton" and
 "opengraph"

---
 docs/source/conf.py | 36 ++++++++++++++++++++++++++++++++++++
 setup.py            |  2 ++
 2 files changed, 38 insertions(+)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 7c4b1df..e61e75c 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -57,6 +57,8 @@ extensions = [
     "sphinx.ext.ifconfig",
     "sphinx.ext.viewcode",
     "sphinx.ext.githubpages",
+    "sphinx_copybutton",
+    "sphinxext.opengraph",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -226,3 +228,37 @@ intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
+
+# Configure OpenGraph extension
+#
+# When making changes, check them using the RTD PR preview URL on https://www.opengraph.xyz/.
+#
+# About text lengths
+#
+# Original documentation says:
+# - ogp_description_length
+#   Configure the amount of characters taken from a page. The default of 200 is probably good
+#   for most people. If something other than a number is used, it defaults back to 200.
+#   -- https://sphinxext-opengraph.readthedocs.io/en/latest/#options
+#
+# Other people say:
+# - og:title 40 chars
+# - og:description has 2 max lengths:
+#   When the link is used in a Post, it's 300 chars. When a link is used in a Comment, it's 110 chars.
+#   So you can either treat it as 110, or, write your Descriptions to 300 but make sure the first 110
+#   is the critical part and still makes sense when it gets cut off.
+#   -- https://stackoverflow.com/questions/8914476/facebook-open-graph-meta-tags-maximum-content-length
+ogp_site_url = "https://responder.kennethreitz.org/"
+ogp_description_length = 300
+ogp_site_name = "Responder Documentation"
+ogp_image = "https://responder.kennethreitz.org/_static/responder.png"
+ogp_image_alt = False
+ogp_use_first_image = False
+ogp_type = "website"
+ogp_enable_meta_description = True
+
+# Configure Sphinx-copybutton
+copybutton_remove_prompts = True
+copybutton_line_continuation_character = "\\"
+copybutton_prompt_text = r">>> |\.\.\. |\$ |sh\$ |PS> |cr> |mysql> |In \[\d*\]: | {2,5}\.\.\.: | {5,8}: "
+copybutton_prompt_is_regexp = True
diff --git a/setup.py b/setup.py
index 0f885e7..d9df305 100644
--- a/setup.py
+++ b/setup.py
@@ -124,6 +124,8 @@ setup(
         "docs": [
             "alabaster<1.1",
             "sphinx>=5,<9",
+            "sphinx-copybutton",
+            "sphinxext.opengraph",
         ],
         "graphql": ["graphene"],
         "release": ["build", "twine"],