Merge branch 'master' of https://github.com/littlevgl/lvgl

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*/
 }
 
 

docs/_templates/layout.html

@@ -0,0 +1,31 @@
+{% extends "!layout.html" %}
+
+{%- block extrahead %}
+{{ super() }}
+<!-- Global site tag (gtag.js) - Google Analytics -->
+<script async src="https://www.googletagmanager.com/gtag/js?id=UA-78811084-3"></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+	gtag('config', 'UA-78811084-3', { 'anonymize_ip': true });
+</script>
+{% endblock %}
+
+{% block footer %}
+{{ super() }}
+<div class="footer">This page uses <a href="https://analytics.google.com/">
+Google Analytics</a> to collect statistics. You can disable it by blocking
+the JavaScript coming from www.google-analytics.com.
+<script type="text/javascript">
+  (function() {
+    var ga = document.createElement('script');
+    ga.src = ('https:' == document.location.protocol ?
+              'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+    ga.setAttribute('async', 'true');
+    document.documentElement.firstChild.appendChild(ga);
+  })();
+</script>
+</div>
+{% endblock %}

docs/_templates/page.html

@@ -0,0 +1,45 @@
+{% extends "!page.html" %}
+
+{% block footer %}
+
+ <script type="text/javascript">
+    $(document).ready(function() {
+        $(".toggle > *").hide();
+        $(".toggle .header").show();
+        $(".toggle .header").click(function() {
+            $(this).parent().children().not(".header").toggle(400);
+            $(this).parent().children(".header").toggleClass("open");
+        })
+    });
+</script>
+
+<script type="text/javascript">
+function add_version_selector()
+{
+    return fetch("https://raw.githubusercontent.com/lvgl/docs_compiled/gh-pages/versionlist.txt")
+        .then(res => res.text())
+        .then(text => {
+            const versions = text.split("\n").filter(version => version.trim().length > 0);
+            p = document.getElementById("rtd-search-form").parentElement;
+            p.innerHTML = `
+            <select name="versions" id="versions" onchange="ver_sel()" style="border-radius:5px; margin-bottom:15px">
+            ${versions.map(version => `<option value="${version}">${version}</option>`)}
+            </select>` + p.innerHTML;
+        });
+}
+
+function ver_sel()
+{
+  var x = document.getElementById("versions").value;
+  window.location.href = window.location.protocol + "//" + window.location.host + "/" + x + "/";
+}
+
+document.addEventListener('DOMContentLoaded', (event) => {
+    add_version_selector().then(() => {
+        var value = window.location.pathname.split('/')[1];
+        document.getElementById("versions").value = value;
+    });
+    
+})
+</script>
+{% endblock %}

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")

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')

docs/requirements.txt

@@ -0,0 +1,34 @@
+alabaster==0.7.12
+Babel==2.9.1
+breathe==4.30.0
+certifi==2020.12.5
+chardet==4.0.0
+commonmark==0.9.1
+docutils==0.16
+idna==2.10
+imagesize==1.2.0
+importlib-metadata==4.0.1
+Jinja2==2.11.3
+Markdown==3.3.4
+MarkupSafe==1.1.1
+packaging==20.9
+Pygments==2.9.0
+pyparsing==2.4.7
+pytz==2021.1
+recommonmark==0.6.0
+requests==2.25.1
+six==1.16.0
+snowballstemmer==2.1.0
+Sphinx==4.0.1
+sphinx-markdown-tables==0.0.15
+sphinx-rtd-theme==0.5.2
+sphinx-sitemap==2.2.0
+sphinxcontrib-applehelp==1.0.2
+sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-htmlhelp==1.0.3
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-serializinghtml==1.1.4
+typing-extensions==3.10.0.0
+urllib3==1.26.4
+zipp==3.4.1