Skip to content

Commit

Permalink
fix(docs): fixed sphinx autoapi issue in docs build
Browse files Browse the repository at this point in the history
fix(docs): upgraded sphinx book theme (and dependencies in general)

still some display issues though...

Signed-off-by: Markus Braun <markus.braun@em.ag>
  • Loading branch information
mb-emag committed Oct 12, 2023
1 parent 4adb2e6 commit 5eb94c6
Show file tree
Hide file tree
Showing 4 changed files with 425 additions and 280 deletions.
2 changes: 1 addition & 1 deletion conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
github_repository = "any"
# -- Sphinx extensions -------------------------------------------------------
extensions = [
"sphinxcontrib.needs",
"sphinx_needs",
"sphinxcontrib.plantuml",
"sphinx.ext.mathjax",
"sphinx.ext.ifconfig",
Expand Down
49 changes: 37 additions & 12 deletions docs/_static/sphinx-book-theme-custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -9,21 +9,51 @@
=====================================================================================
*/

@media (min-width: 1200px) {

.container,
.container-lg,
.container-md,
.container-sm,
.container-xl {
/* make sphinx book scale over the complete width:*/
@media(min-width: 960px) {
.bd-page-width {
max-width: 100% !important;
width: 100%
}
}

@media (min-width: 992px) {
.bd-sidebar-primary {
flex-basis: 20%;
max-width: 25em;
}
}

body div.bd-container {
justify-content: left;
}

div.bd-article-container {
max-width: 100% !important;
}

.bd-main .bd-content .bd-article-container {
max-width: 100%;
/* default is 60em */
}

.bd-page-width {
max-width: 100%;
/* default is 88rem */
}

/* color fixes to have sidebar in white smoke */

.bd-sidebar {
background: whitesmoke;
}

body {
background-color: white;
}

/* other styling stuff */

.copyright {
font-size: small;
font-weight: 300;
Expand All @@ -49,11 +79,6 @@ p.rubric {
border-bottom: none !important;
}

/* navigation bar color override */
.bd-sidebar#site-navigation {
background: whitesmoke;
}

#search-input {
border-radius: .3em
}
Loading

0 comments on commit 5eb94c6

Please sign in to comment.