From f49897c04d24ef2f14679b9fcf2fdaa4f5084740 Mon Sep 17 00:00:00 2001
From: YanNaingWinn <yann@oinsm.ch>
Date: Fri, 27 Mar 2026 23:31:30 +0700
Subject: [PATCH 1/3] Improve SEO: fix canonical URLs, og:image dimensions, add
 twitter:site, sitemap, and clean page titles

---
 docs/source/_templates/layout.html | 11 +++++++----
 docs/source/conf.py                |  4 +++-
 requirements.txt                   |  4 +++-
 3 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/docs/source/_templates/layout.html b/docs/source/_templates/layout.html
index ecd0fb0..b9dd837 100644
--- a/docs/source/_templates/layout.html
+++ b/docs/source/_templates/layout.html
@@ -4,20 +4,23 @@
 {% block extrahead %}
 {{ super() }}
 
-<link rel="canonical" href="https://docs.cryptnox.com/" />
+{% set canonical_url = pageurl | replace('index.html', '') if pageurl else 'https://docs.cryptnox.com/' %}
+
+<link rel="canonical" href="{{ canonical_url }}" />
 
 <!-- Open Graph -->
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://docs.cryptnox.com/" />
+<meta property="og:url" content="{{ canonical_url }}" />
 <meta property="og:title" content="{{ title|striptags }} | Cryptnox Docs" />
 <meta property="og:description" content="Access the official Cryptnox technical documentation. Explore setup guides, features, and integration details for secure and efficient solutions." />
 <meta property="og:image" content="https://docs.cryptnox.com/wp-content/uploads/2025/08/Technical-Documentation-1024x538.png" />
-<meta property="og:image:width" content="380" />
-<meta property="og:image:height" content="71" />
+<meta property="og:image:width" content="1024" />
+<meta property="og:image:height" content="538" />
 <meta property="og:site_name" content="Cryptnox Docs" />
 
 <!-- Twitter Card -->
 <meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:site" content="@CryptnoxTech" />
 <meta name="twitter:title" content="{{ title|striptags }} | Cryptnox Docs" />
 <meta name="twitter:description" content="Access the official Cryptnox technical documentation. Explore setup guides, features, and integration details for secure and efficient solutions." />
 <meta name="twitter:image" content="https://docs.cryptnox.com/wp-content/uploads/2025/08/Technical-Documentation-1024x538.png" />
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 3352edc..e4a4d17 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -9,7 +9,7 @@
 
 # -- General configuration ---------------------------------------------------
 
-extensions = []
+extensions = ['sphinx_multiversion', 'sphinx_sitemap']
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
@@ -19,6 +19,8 @@
 # -- SEO meta tags -----------------------------------------------------------
 
 html_baseurl = 'https://docs.cryptnox.com/'
+html_title = 'Cryptnox Docs'
+sitemap_url_scheme = "{link}"
 
 html_meta = {
     'description': 'Access the official Cryptnox technical documentation. Explore setup guides, features, and integration details for secure and efficient solutions.',
diff --git a/requirements.txt b/requirements.txt
index cbf1e36..fee24bf 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1,4 @@
-sphinx
+sphinx<8
 sphinx-rtd-theme
+sphinx-multiversion
+sphinx-sitemap

From e694f2de996bbe3939878c79cdc3344f2964f052 Mon Sep 17 00:00:00 2001
From: YanNaingWinn <yann@oinsm.ch>
Date: Thu, 18 Jun 2026 19:36:42 +0700
Subject: [PATCH 2/3] Updated sphinx version

---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index fee24bf..9287c58 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
-sphinx<8
+sphinx==9.1.0
 sphinx-rtd-theme
 sphinx-multiversion
 sphinx-sitemap

From 0edb8bc9f4a7fde845407e9ac7f9f0c5231ab78a Mon Sep 17 00:00:00 2001
From: YanNaingWinn <yann@oinsm.ch>
Date: Fri, 19 Jun 2026 15:07:17 +0700
Subject: [PATCH 3/3] Modified requirements.txt

---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 9287c58..7f6d908 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
-sphinx==9.1.0
+sphinx
 sphinx-rtd-theme
 sphinx-multiversion
 sphinx-sitemap