diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css new file mode 100644 index 00000000..38458950 --- /dev/null +++ b/docs/_static/css/custom.css @@ -0,0 +1,45 @@ +/* + This fixes the vertical position of list markers when the first + element in the
block + + Scrolling inside theblock is still working as expected +*/ +.rst-content pre.literal-block, +.rst-content div[class^='highlight'] pre { + overflow: visible; +} + + +/* + This fixes the bottom margin of paragraphs inside lists, where margins inside + a single list item would incorrectly be displayed larger than margins between + the list items. + + Upstream fix (not fixed on readthedocs.io yet): + https://github.com/readthedocs/sphinx_rtd_theme/commit/ac20ce75d426efeb40fe2af1f89ea9bad285a45b +*/ +.rst-content .section ol li > p, +.rst-content .section ol li > p:last-child, +.rst-content .section ul li > p, +.rst-content .section ul li > p:last-child { + margin-bottom: 12px; +} +.rst-content .section ol li > p:only-child, +.rst-content .section ol li > p:only-child:last-child, +.rst-content .section ul li > p:only-child, +.rst-content .section ul li > p:only-child:last-child { + margin-bottom: 0rem; +} + +/* + This fixes the bottom margin of nested lists + + Based on upstream fix (not on readthedocs.io yet): + https://github.com/readthedocs/sphinx_rtd_theme/commit/6f0de13baff93f25204aa2cdf0308aae47d71312 +*/ +.rst-content .section ul li > ul, +.rst-content .section ul li > ol, +.rst-content .section ol li > ul, +.rst-content .section ol li > ol { + margin-bottom: 12px; +} diff --git a/docs/conf.py b/docs/conf.py index e5a27f68..766a07cd 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -89,7 +89,7 @@ html_theme = 'sphinx_rtd_theme' # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". # -# html_static_path = ['_static'] +html_static_path = ['_static'] # Custom sidebar templates, must be a dictionary that maps document names # to template names. @@ -101,6 +101,10 @@ html_theme = 'sphinx_rtd_theme' # # html_sidebars = {} +# These paths are either relative to html_static_path +# or fully qualified paths (eg. https://...) +html_css_files = ['css/custom.css'] + # -- Options for HTMLHelp output ---------------------------------------------