diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css index 72e083dd4..a5e2c2532 100644 --- a/docs/_static/css/custom.css +++ b/docs/_static/css/custom.css @@ -51,6 +51,7 @@ code.sig-name } .wy-side-nav-search>div.version { color: #333; + display: none; /*replaced by dropdown*/ } diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html new file mode 100644 index 000000000..d3c25f081 --- /dev/null +++ b/docs/_templates/layout.html @@ -0,0 +1,31 @@ +{% extends "!layout.html" %} + +{%- block extrahead %} +{{ super() }} + + + +{% endblock %} + +{% block footer %} +{{ super() }} + +{% endblock %} diff --git a/docs/_templates/page.html b/docs/_templates/page.html new file mode 100644 index 000000000..713f58496 --- /dev/null +++ b/docs/_templates/page.html @@ -0,0 +1,45 @@ +{% extends "!page.html" %} + +{% block footer %} + + + + +{% endblock %} diff --git a/docs/build.py b/docs/build.py index 9b094bc3a..32e71c90a 100755 --- a/docs/build.py +++ b/docs/build.py @@ -37,9 +37,11 @@ os.system("sed -i \"s|html_baseurl = .*|" + base_html +"|\" conf.py") clean = 0 trans = 0 +skip_latex = False args = sys.argv[1:] if len(args) >= 1: if "clean" in args: clean = 1 + if "skip_latex" in args: skip_latex = True lang = "en" print("") @@ -55,14 +57,17 @@ print("Running doxygen") cmd("cd ../scripts && doxygen Doxyfile") # BUILD PDF -# Silly workarond to include the more or less correct PDF download link in the PDF -#cmd("cp -f " + lang +"/latex/LVGL.pdf LVGL.pdf | true") -cmd("sphinx-build -b latex . out_latex") +if not skip_latex: + # Silly workarond to include the more or less correct PDF download link in the PDF + #cmd("cp -f " + lang +"/latex/LVGL.pdf LVGL.pdf | true") + cmd("sphinx-build -b latex . out_latex") -# Generate PDF -cmd("cd out_latex && latexmk -pdf 'LVGL.tex'") -# Copy the result PDF to the main directory to make it avaiable for the HTML build -cmd("cd out_latex && cp -f LVGL.pdf ../LVGL.pdf") + # Generate PDF + cmd("cd out_latex && latexmk -pdf 'LVGL.tex'") + # Copy the result PDF to the main directory to make it avaiable for the HTML build + cmd("cd out_latex && cp -f LVGL.pdf ../LVGL.pdf") +else: + print("skipping latex build as requested") # BULD HTML cmd("sphinx-build -b html . ../out_html") diff --git a/docs/conf.py b/docs/conf.py index 345932b03..8a14efc7b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -232,5 +232,5 @@ def setup(app): 'enable_auto_toc_tree': 'True', }, True) app.add_transform(AutoStructify) - app.add_stylesheet('css/custom.css') - app.add_stylesheet('css/fontawesome.min.css') + app.add_css_file('css/custom.css') + app.add_css_file('css/fontawesome.min.css')