diff --git a/docs/src/_templates/page.html b/docs/src/_templates/page.html deleted file mode 100644 index ea3fdc21d6..0000000000 --- a/docs/src/_templates/page.html +++ /dev/null @@ -1,149 +0,0 @@ -{% extends "!page.html" %} - -{# ------------------------------------------------------------------------ - # Including jquery.js here is needed for the Furo theme. RTD theme included it automatically. - # Note: having 'sphinxcontrib.jquery' in `conf.py` extensions list isn't working for this reason: - # it is including jQuery via `` - # at the VERY END of the HTML element, right before `` and so the jQuery code in the - # page will not execute becuase the `$` jQuery object has not been created yet! This is - # despite including 'sphinxcontrib.jquery' in `conf.py` extensions list DOES include - # `jquery.js` at the top of the page in simpler projects! Until it is sorted out why - # this is happening, we're having to include jQuery.js manually in the below code, - # and make it possible by storing the same `jquery.js` file that Sphinx RTD theme used - # in the `./docs/src/_static/` directory. - # - # One big difference that might be relevant: sphinx_rtd_theme simple projects include - # `jquery.js` at the top of each HTML page. With Furo theme, it is including it at the end. - # This might be relevant. - # - # We have to use an absolute path here because this code will be atop every page and the relative - # path varies since there is currently a 5-deep directory structure among the HTML pages. - # A `` URL could solve that. Getting it to use local (workstation) jsquery.js - # file could require some JavaScript emitting the correct `` and ` -{% endblock %} - - -{% block footer %} - -{# This "call" to super() here is needed because Furo theme has content in "block footer" which RTD - theme did not have. Without it, this "block footer" section wipes out Furo's parent versions. #} -{{ super() }} - - - - - -{% endblock %} diff --git a/docs/src/_templates/sidebar/search.html b/docs/src/_templates/sidebar/search.html new file mode 100644 index 0000000000..15cb217b99 --- /dev/null +++ b/docs/src/_templates/sidebar/search.html @@ -0,0 +1,6 @@ + + diff --git a/docs/src/_templates/sidebar/version-selector.html b/docs/src/_templates/sidebar/version-selector.html new file mode 100644 index 0000000000..59fdd59794 --- /dev/null +++ b/docs/src/_templates/sidebar/version-selector.html @@ -0,0 +1,4 @@ +
+ + +
diff --git a/docs/src/conf.py b/docs/src/conf.py index 5d57aeaa08..beb8b5f6fe 100755 --- a/docs/src/conf.py +++ b/docs/src/conf.py @@ -224,18 +224,22 @@ html_theme_options = { "source_repository": "https://github.com/lvgl/lvgl/", "source_branch": "master", "source_directory": "docs/src/", - "light_css_variables": { - "--font-stack": "\"Inter\", sans-serif", - "color-brand-primary": "#7C4DFF", - "color-brand-content": "#7C4DFF", - }, - "dark_css_variables": { - "color-brand-primary": "#7C4DFF", - "color-brand-content": "#7C4DFF", - }, # "announcement": "Semi-permanent announcement from conf.py.", } +html_sidebars = { + "**": [ + "sidebar/brand.html", + "sidebar/version-selector.html", + "sidebar/search.html", + "sidebar/scroll-start.html", + "sidebar/navigation.html", + "sidebar/ethical-ads.html", + "sidebar/scroll-end.html", + "sidebar/variant-selector.html" + ] +} + # For site map generation if "LVGL_URLPATH" not in os.environ: os.environ['LVGL_URLPATH'] = 'master'