Merge: resolve conflicts and ensure ogp_site_url set to live docs; keep sphinxext-opengraph in requirements

Author: Subham-KRLX

doc/requirements-docs.txt

@@ -7,4 +7,4 @@ sphinx-markdown-tables
 sphinx-notfound-page
 sphinx_rtd_theme
 sphinxext-opengraph
-matplotlib
+matplotlib

doc/source/conf.py

@@ -3,13 +3,15 @@
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
+
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = "64 Shades"
 copyright = "2025, 64 Shades"
 author = "64 Shades"
 
+
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
@@ -19,15 +21,16 @@
 ]  # type: ignore
 
 # Open Graph extension configuration
-ogp_site_url = "https://Subham-KRLX.github.io/"  # Replace with your actual docs URL
-
+# Point to the live documentation site so previews link to the published pages.
+ogp_site_url = "https://64-shades.github.io/"
 ogp_description_length = 200  # Optional, number of characters to use for descriptions
 ogp_type = "website"          # Optional, type of page (usually 'website' for docs)
 
 # NOTE: We keep templates_path to ensure our new template is found
 templates_path = ["_templates"]
 exclude_patterns = []  # type: ignore
 
+
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
@@ -36,6 +39,9 @@
 
 html_logo = "_static/images/logo.jpeg"
 
+# Favicon for the documentation site
+html_favicon = "_static/images/favicon.ico"
+
 # Add your custom CSS file (updated to use the new CSS variables)
 html_css_files = ["css/custom.css"]
 
@@ -62,3 +68,12 @@
     "github_type": "fork",  # Use 'watch' for the Star button
     # REMOVED: The extra_nav_links are now placed directly via the template file
 }
+
+# -- Open Graph / social metadata -----------------------------------------
+# Point to the live documentation site so previews link to the published pages.
+# Use the GitHub Pages URL for this repository's docs site.
+ogp_site_url = "https://64-shades.github.io/"
+# How many characters of the page body to use as the og:description (optional)
+ogp_description_length = 200
+# Default Open Graph object type
+ogp_type = "website"