From b6f0ec324dee7bf3ab23b13473160ddd4b3b5207 Mon Sep 17 00:00:00 2001 From: German <28149841+germa89@users.noreply.github.com> Date: Fri, 9 May 2025 14:58:03 +0200 Subject: [PATCH 1/6] style: update custom.css to remove background styles and add navbar element styles --- doc/source/_static/custom.css | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/doc/source/_static/custom.css b/doc/source/_static/custom.css index 4e58170ec53..3ac9e2282d3 100644 --- a/doc/source/_static/custom.css +++ b/doc/source/_static/custom.css @@ -20,14 +20,14 @@ box-shadow: 0 0rem 0rem 0 rgb(255,172,0); /* var(--pst-color-shadow); */ } +/* Navbar elements */ +.bd-navbar-elements { + text-align: center; +} + /* 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 } @@ -36,10 +36,6 @@ html[data-theme="light"] { /* 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 From 2271d0fb0ca1a1790f18b72d6eb0453800c1b7b8 Mon Sep 17 00:00:00 2001 From: German <28149841+germa89@users.noreply.github.com> Date: Mon, 12 May 2025 11:25:33 +0200 Subject: [PATCH 2/6] style: update conf.py to modify sidebar and navbar configurations --- doc/source/conf.py | 19 +++++++++++++++---- doc/source/index.rst | 8 -------- 2 files changed, 15 insertions(+), 12 deletions(-) diff --git a/doc/source/conf.py b/doc/source/conf.py index 23ab6e8e5cb..16db872df23 100755 --- a/doc/source/conf.py +++ b/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 --------------------------------------------- diff --git a/doc/source/index.rst b/doc/source/index.rst index cd367c6728b..3913f2ff68f 100644 --- a/doc/source/index.rst +++ b/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...** From 0e41cfd813be2c66bbc287489b52566110db380c Mon Sep 17 00:00:00 2001 From: German <28149841+germa89@users.noreply.github.com> Date: Mon, 12 May 2025 11:25:42 +0200 Subject: [PATCH 3/6] style: refactor custom.css to improve navbar shadow handling and content centering --- doc/source/_static/custom.css | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/doc/source/_static/custom.css b/doc/source/_static/custom.css index 3ac9e2282d3..0f54aca9b79 100644 --- a/doc/source/_static/custom.css +++ b/doc/source/_static/custom.css @@ -25,19 +25,23 @@ text-align: center; } +/* Centering the page content */ +.bd-main .bd-content { + 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 */ - .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 */ - .sd-shadow-sm { - box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important - } } From 9f5d729223575afaa87134c1d83150d0ee004230 Mon Sep 17 00:00:00 2001 From: pyansys-ci-bot <92810346+pyansys-ci-bot@users.noreply.github.com> Date: Mon, 12 May 2025 09:36:46 +0000 Subject: [PATCH 4/6] chore: adding changelog file 3918.fixed.md [dependabot-skip] --- doc/changelog.d/3918.fixed.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 doc/changelog.d/3918.fixed.md diff --git a/doc/changelog.d/3918.fixed.md b/doc/changelog.d/3918.fixed.md new file mode 100644 index 00000000000..d7ca047b175 --- /dev/null +++ b/doc/changelog.d/3918.fixed.md @@ -0,0 +1 @@ +fix: documentation html looks \ No newline at end of file From 963ff977adac24a3861c0244a60f49291c04cc69 Mon Sep 17 00:00:00 2001 From: German <28149841+germa89@users.noreply.github.com> Date: Mon, 12 May 2025 14:25:29 +0200 Subject: [PATCH 5/6] style: update custom.css and index.rst for navbar background and section header formatting --- doc/source/_static/custom.css | 6 +++++- doc/source/user_guide/index.rst | 3 ++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/doc/source/_static/custom.css b/doc/source/_static/custom.css index 0f54aca9b79..157b94b142d 100644 --- a/doc/source/_static/custom.css +++ b/doc/source/_static/custom.css @@ -27,12 +27,16 @@ /* Centering the page content */ .bd-main .bd-content { + display: flex; justify-content: center; } +#pst-back-to-top { + background: +} /* Removing navbar shadow */ .sd-shadow-sm { - box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important + box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important; } /* anything related to the light theme */ diff --git a/doc/source/user_guide/index.rst b/doc/source/user_guide/index.rst index c750478f745..c1b1957190f 100644 --- a/doc/source/user_guide/index.rst +++ b/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 ` in a Pythonic manner. This is to simplify calling Ansys, especially when inputs are variables within From 675985492285f472fea86f9a34a4be806190e440 Mon Sep 17 00:00:00 2001 From: German <28149841+germa89@users.noreply.github.com> Date: Mon, 12 May 2025 14:42:34 +0200 Subject: [PATCH 6/6] style: remove background style for back-to-top button in custom.css since it does not affect. Waiting for ansys-sphinx-theme release --- doc/source/_static/custom.css | 3 --- 1 file changed, 3 deletions(-) diff --git a/doc/source/_static/custom.css b/doc/source/_static/custom.css index 157b94b142d..39e7f448d65 100644 --- a/doc/source/_static/custom.css +++ b/doc/source/_static/custom.css @@ -31,9 +31,6 @@ justify-content: center; } -#pst-back-to-top { - background: -} /* Removing navbar shadow */ .sd-shadow-sm { box-shadow: 0 0rem 0rem rgba(250, 250, 250, 0.6) !important;