fix: documentation html looks (#3918)

* style: update custom.css to remove background styles and add navbar element styles

* style: update conf.py to modify sidebar and navbar configurations

* style: refactor custom.css to improve navbar shadow handling and content centering

* chore: adding changelog file 3918.fixed.md [dependabot-skip]

* style: update custom.css and index.rst for navbar background and section header formatting

* style: remove background style for back-to-top button in custom.css since it does not affect. Waiting for ansys-sphinx-theme release

---------

Co-authored-by: pyansys-ci-bot <[email protected]>

Author: germa89

doc/changelog.d/3918.fixed.md

@@ -0,0 +1 @@
+fix: documentation html looks

doc/source/_static/custom.css

@@ -20,28 +20,29 @@
     box-shadow: 0 0rem 0rem 0 rgb(255,172,0); /* var(--pst-color-shadow); */
 }
 
+/* Navbar elements */
+.bd-navbar-elements {
+    text-align: center;
+}
+
+/* Centering the page content */
+.bd-main .bd-content {
+    display: flex;
+    justify-content: center;
+}
+
+/* Removing navbar shadow */
+.sd-shadow-sm {
+    box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important;
+    }
+
 /* anything related to the light theme */
 html[data-theme="light"] {
     /* whatever you want to change */
-    background: rgb(245, 245, 245);
-    --pst-color-on-background: rgb(35, 35, 35);
-    --pst-color-background: rgb(245, 245, 245);
-    --sd-color-card-border-hover: rgb(255,172,0);
-    
-    .sd-shadow-sm {
-        box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important
-    }
 }
 
 /* anything related to the dark theme */
 html[data-theme="dark"] {
     /* whatever you want to change */
-    background: rgb(35, 35, 35);
-    --pst-color-on-background: rgb(35, 35, 35);
-    --pst-color-background: rgb(35, 35, 35);
-    --sd-color-card-border-hover: rgb(255,172,0);
 
-    .sd-shadow-sm {
-        box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important
-    }
 }

doc/source/conf.py

@@ -316,8 +316,23 @@
         "json_url": f"https://{cname}/versions.json",
         "version_match": switcher_version,
     },
+    # Removing the secondary sidebar for the MAPDL commands
+    "secondary_sidebar_items": {
+        # "mapdl_commands/**/**": [],
+        # "mapdl_commands/index": [],
+        "**": [],  # "page-toc", "edit-this-page", "sourcelink"]
+    },
+    "navbar_persistent": [],
+    "primary_sidebar_end": ["edit-this-page", "sourcelink"],
+    "navbar_end": [
+        "search-button-field",
+        "version-switcher",
+        "theme-switcher",
+        "navbar-icon-links",
+    ],
 }
 
+
 BUILD_CHEATSHEET = os.environ.get("BUILD_CHEATSHEET", "false").lower() == "true"
 
 if BUILD_CHEATSHEET:
@@ -338,10 +353,6 @@
 }
 html_show_sourcelink = False
 
-html_sidebars = {
-    "mapdl_commands/**/**": [],
-    "mapdl_commands/index": [],
-}
 
 # -- Options for HTMLHelp output ---------------------------------------------
 

doc/source/index.rst

@@ -33,14 +33,6 @@
 
 .. vale off
 
-.. let's hide the `Edit on GitHub` link in this page...
-.. and the whole sidebar with it.
-.. hideobject::
-    :class: bd-sidebar-secondary bd-toc
-    :remove: true
-    :adjustmargin: true
-
-
 .. title is given using the 
 
 **What do you want to do? I want to...**

doc/source/user_guide/index.rst

@@ -129,7 +129,8 @@ various advanced methods to visualize, script, and interact with MAPDL, see
 
 
 Calling MAPDL Pythonically
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+==========================
+
 MAPDL functions can be called directly from an instance of
 :class:`Mapdl <ansys.mapdl.core.mapdl.MapdlBase>` in a Pythonic manner. This is
 to simplify calling Ansys, especially when inputs are variables within