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 @@ -

{{ project|title }}

+

+ {{ project|title }} +

{{ 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