Merge branch '6-dev' into upgrade-guide

Author: stevepiercy

docs/_static/patch_scrollToActive.js

@@ -0,0 +1,41 @@
+/**
+ * Patch of scrollToActive of sphinxbook theme
+ * Scroll to active navigation item
+ */
+
+/**
+ * A helper function to load scripts when the DOM is loaded.
+ * This waits for everything to be on the page first before running, since
+ * some functionality doesn't behave properly until everything is ready.
+ */
+ var sbRunWhenDOMLoaded = (cb) => {
+  if (document.readyState != "loading") {
+    cb();
+  } else if (document.addEventListener) {
+    document.addEventListener("DOMContentLoaded", cb);
+  } else {
+    document.attachEvent("onreadystatechange", function () {
+      if (document.readyState == "complete") cb();
+    });
+  }
+};
+
+/**
+ * Sidebar scroll on load.
+ *
+ * Detect the active page in the sidebar, and scroll so that it is centered on
+ * the screen.
+ */
+
+var scrollToActive = () => {
+  let navbar_scrollable = $("#site-navigation").children()[0];
+  let active_navigation_item = $("#site-navigation .active").last();
+  if (active_navigation_item) {
+    if (active_navigation_item.offset().top > $(window).height() * 0.5) {
+      navbar_scrollable.scrollTop = active_navigation_item.offset().top - $(window).height() * 0.2;
+    }
+  }
+};
+
+
+sbRunWhenDOMLoaded(scrollToActive);

docs/conf.py

@@ -129,6 +129,10 @@
     "plone.restapi/src",
 ]
 
+html_js_files = [
+    "patch_scrollToActive.js",
+]
+
 html_extra_path = [
     "robots.txt",
 ]
@@ -293,11 +297,13 @@ def source_replace(app, docname, source):
         result = result.replace(key, app.config.source_replacements[key])
     source[0] = result
 
+
 # Dict of replacements.
 source_replacements = {
     "{PLONE_BACKEND_VERSION}": "6.0.0b2",
 }
 
+
 def setup(app):
-   app.add_config_value('source_replacements', {}, True)
-   app.connect('source-read', source_replace)
+    app.add_config_value("source_replacements", {}, True)
+    app.connect("source-read", source_replace)