diff --git a/docs/_static/css/import-all-salt-docs.css b/docs/_static/css/import-all-salt-docs.css
index 7a644b6..bd6a385 100644
--- a/docs/_static/css/import-all-salt-docs.css
+++ b/docs/_static/css/import-all-salt-docs.css
@@ -1 +1,29 @@
@import url("https://saltstack.gitlab.io/open/docs/docs-hub/_static/css/all-salt-docs.css");
+
+/* Custom Sidebar Title Styling */
+h3.salt-nav-title {
+ font-size: 1.125rem !important; /* Adjusts size to match saltproject.io */
+ font-weight: 600 !important; /* Gives it a slightly bold, clean weight */
+ margin-bottom: 1rem;
+ padding-left: 0;
+}
+
+h3.salt-nav-title a {
+ color: #333333 !important; /* Dark gray text matching the main site */
+ text-decoration: none !important; /* Removes the underline */
+ box-shadow: none !important; /* Removes any border-bottom shadows applied by the theme */
+}
+
+h3.salt-nav-title a:hover {
+ color: #00e1cc !important; /* Salt Project's signature teal on hover */
+ text-decoration: none !important;
+}
+
+/* Custom Sidebar Title Styling - Dark Mode Override */
+html[data-theme="dark"] h3.salt-nav-title a {
+ color: #f8f9fa !important; /* Light text for dark mode visibility */
+}
+
+html[data-theme="dark"] h3.salt-nav-title a:hover {
+ color: #00e1cc !important; /* Keeps the teal hover in dark mode */
+}
diff --git a/docs/_templates/globaltoc.html b/docs/_templates/globaltoc.html
index 1b136d2..2b35ee9 100644
--- a/docs/_templates/globaltoc.html
+++ b/docs/_templates/globaltoc.html
@@ -1,4 +1,6 @@
-
+
{{ toctree(includehidden=True, collapse=False, maxdepth=2) }}
diff --git a/docs/_templates/header-links.html b/docs/_templates/header-links.html
index 83c56c2..f1e7d2e 100644
--- a/docs/_templates/header-links.html
+++ b/docs/_templates/header-links.html
@@ -65,6 +65,7 @@
navbarCenter.innerHTML = "";
const links = [
+ { name: "Home", url: "https://saltproject.io/" },
{ name: "Install Guide", url: "https://docs.saltproject.io/salt/install-guide/en/latest/" },
{ name: "User Guide", url: "https://docs.saltproject.io/salt/user-guide/en/latest/", active: true },
{ name: "Reference Docs", url: "https://docs.saltproject.io/en/latest/contents.html" }
diff --git a/docs/conf.py b/docs/conf.py
index 295a9c0..4a8a3fe 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -135,16 +135,35 @@ def setup(app):
"genindex.html",
]
-html_logo = None
+html_logo = "_static/img/SaltProject_altlogo_teal.png"
html_theme_options = {
"logo": {
- "image_light": "_static/img/SaltProject_altlogo_teal.png",
- "image_dark": "_static/img/SaltProject_altlogo_teal.png",
+ "link": "https://saltproject.io",
},
"navbar_start": ["navbar-logo"],
"navbar_center": ["navbar-nav", "header-links"],
"navbar_end": ["theme-switcher", "navbar-icon-links"],
"navigation_depth": 4,
+ "icon_links": [
+ {
+ "name": "GitHub",
+ "url": "https://github.com/saltstack/salt-user-guide",
+ "icon": "fa-brands fa-github",
+ "type": "fontawesome",
+ },
+ {
+ "name": "Discord",
+ "url": "https://discord.gg/J7b7EscrAs",
+ "icon": "fa-brands fa-discord",
+ "type": "fontawesome",
+ },
+ {
+ "name": "RSS Feed",
+ "url": "https://saltproject.io/community/rss-feeds/",
+ "icon": "fa-solid fa-rss",
+ "type": "fontawesome",
+ },
+ ],
}
html_sidebars = {"**": ["globaltoc.html"]}
@@ -158,7 +177,7 @@ def setup(app):
# or fully qualified paths (eg. https://example.com)
html_css_files = [
'css/import-all-salt-docs.css',
- 'css/local-testing.css'
+ 'css/local-testing.css',
]
# The name of an image file (within the static path) to use as favicon of the
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 628bbcc..1e3d26d 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,5 @@
Sphinx-Substitution-Extensions>=2022.2.16
-pydata-sphinx-theme
+pydata-sphinx-theme==0.20.0
sphinx-copybutton>=0.5.1
sphinx-design>=0.3.0
sphinx-inline-tabs>=2022.1.2b11