mkdocs-toggle-sidebar-plugin 0.0.3__tar.gz → 0.0.4__tar.gz

{mkdocs-toggle-sidebar-plugin-0.0.3/src/mkdocs_toggle_sidebar_plugin.egg-info → mkdocs_toggle_sidebar_plugin-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mkdocs-toggle-sidebar-plugin
-Version: 0.0.3
+Version: 0.0.4
 Summary: Add keybindings to toggle the table of contents and menu sidebars on some MkDocs themes
 Home-page: https://github.com/six-two/mkdocs-toggle-sidebar-plugin
 Author: six-two
@@ -61,13 +61,42 @@ Key   | Action
 `m` | toggle navigation **m**enu
 `t` | toggle **T**OC
 
+For some themes like `readthedocs` navigation and TOC are combined.
+In this case the state of TOC is ignored, and only calls for navigation (or all) are interpreted.
+
+### Toggle button
+
+When you set the `toggle_button` option to `navigation`, `toc` or `all`, it will add a button that looks like a hamburger menu (three horizontal bars) on a theme-dependent location.
+It is usually in the nav or the top bar.
+Clicking the button will toggle the navigation, table of contents, or both (depending on the supplied value).
+By leaving the field empty or setting it to `none`, no button is added.
+
+### Exported API functions
+
+This plugin exposes some JavaScript functions, that can show, hide or toggle the visibility of the sidebars.
+You can see how they are called in `docs/javascript-functions.md` and how they are defined in `src/mkdocs_toggle_sidebar_plugin/toggle-sidebar.js`.
+
+In short there are:
+
+- `MkdocsToggleSidebarPlugin.setNavigationVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setTocVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setAllVisibility: (showNavigation: bool, showTOC: bool)`
+- `MkdocsToggleSidebarPlugin.toggleNavigationVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleTocVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleAllVisibility()`
+
+The names and parameters should be self-explanatory.
+
 ## Theme support
 
+Below shows the latest themes that I have tested.
+They are not updated that often, and the plugin should generally work for other of theme versions too.
+
 Theme            | Theme version | Plugin version | Status
 ---              | ---           | ---            | ---
-mkdocs-material  | 9.1.21        | 0.0.1          | works
-mkdocs (default) | 1.5.2         | 0.0.2          | works
-readthedocs      | 1.5.2         | 0.0.2          | works
+mkdocs-material  | 9.5.34        | 0.0.4          | works
+mkdocs (default) | 1.6.1         | 0.0.4          | works
+readthedocs      | 1.6.1         | 0.0.4          | works
 
 Just open a issue / PR if you use a strange theme or the info above is not up to date anymore.
 
@@ -85,6 +114,12 @@ Test mkdocs theme:
 
 ## Notable changes
 
+### Version 0.0.4
+
+- Export API via `MkdocsToggleSidebarPlugin` object.
+    This lets you create custom buttons or key bindings to hide, show or toggle the side bars.
+- Added `toggle_button` option and implemented it for Material theme
+
 ### Version 0.0.3
 
 - Changed internal API:

{mkdocs-toggle-sidebar-plugin-0.0.3 → mkdocs_toggle_sidebar_plugin-0.0.4}/README.md

@@ -42,13 +42,42 @@ Key   | Action
 `m` | toggle navigation **m**enu
 `t` | toggle **T**OC
 
+For some themes like `readthedocs` navigation and TOC are combined.
+In this case the state of TOC is ignored, and only calls for navigation (or all) are interpreted.
+
+### Toggle button
+
+When you set the `toggle_button` option to `navigation`, `toc` or `all`, it will add a button that looks like a hamburger menu (three horizontal bars) on a theme-dependent location.
+It is usually in the nav or the top bar.
+Clicking the button will toggle the navigation, table of contents, or both (depending on the supplied value).
+By leaving the field empty or setting it to `none`, no button is added.
+
+### Exported API functions
+
+This plugin exposes some JavaScript functions, that can show, hide or toggle the visibility of the sidebars.
+You can see how they are called in `docs/javascript-functions.md` and how they are defined in `src/mkdocs_toggle_sidebar_plugin/toggle-sidebar.js`.
+
+In short there are:
+
+- `MkdocsToggleSidebarPlugin.setNavigationVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setTocVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setAllVisibility: (showNavigation: bool, showTOC: bool)`
+- `MkdocsToggleSidebarPlugin.toggleNavigationVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleTocVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleAllVisibility()`
+
+The names and parameters should be self-explanatory.
+
 ## Theme support
 
+Below shows the latest themes that I have tested.
+They are not updated that often, and the plugin should generally work for other of theme versions too.
+
 Theme            | Theme version | Plugin version | Status
 ---              | ---           | ---            | ---
-mkdocs-material  | 9.1.21        | 0.0.1          | works
-mkdocs (default) | 1.5.2         | 0.0.2          | works
-readthedocs      | 1.5.2         | 0.0.2          | works
+mkdocs-material  | 9.5.34        | 0.0.4          | works
+mkdocs (default) | 1.6.1         | 0.0.4          | works
+readthedocs      | 1.6.1         | 0.0.4          | works
 
 Just open a issue / PR if you use a strange theme or the info above is not up to date anymore.
 
@@ -66,6 +95,12 @@ Test mkdocs theme:
 
 ## Notable changes
 
+### Version 0.0.4
+
+- Export API via `MkdocsToggleSidebarPlugin` object.
+    This lets you create custom buttons or key bindings to hide, show or toggle the side bars.
+- Added `toggle_button` option and implemented it for Material theme
+
 ### Version 0.0.3
 
 - Changed internal API:

{mkdocs-toggle-sidebar-plugin-0.0.3 → mkdocs_toggle_sidebar_plugin-0.0.4}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = mkdocs-toggle-sidebar-plugin
-version = 0.0.3
+version = 0.0.4
 author = six-two
 author_email = pip@six-two.dev
 description = Add keybindings to toggle the table of contents and menu sidebars on some MkDocs themes

{mkdocs-toggle-sidebar-plugin-0.0.3 → mkdocs_toggle_sidebar_plugin-0.0.4}/src/mkdocs_toggle_sidebar_plugin/__init__.py

@@ -1,18 +1,21 @@
 import os
 import logging
 # pip dependency
-from mkdocs.plugins import BasePlugin
+from mkdocs.plugins import BasePlugin, get_plugin_logger
 from mkdocs.config.defaults import MkDocsConfig
 from mkdocs.config.base import Config
 from mkdocs.config.config_options import Type, ExtraScriptValue
+from mkdocs.exceptions import PluginError
 
-LOGGER = logging.getLogger("mkdocs.plugins.toggle-sidebar")
+LOGGER = get_plugin_logger(__name__)
 SCRIPT_DIR = os.path.dirname(__file__)
+ALLOWED_TOGGLE_BUTTON_VALUES = ["none", "navigation", "toc", "all"]
 
 class PluginConfig(Config):
     enabled = Type(bool, default=True)
     show_toc_by_default = Type(bool, default=True)
     show_navigation_by_default = Type(bool, default=True)
+    toggle_button = Type(str, default="none")
     async_ = Type(bool, default=True)
     javascript = Type(str, default="assets/javascripts/toggle-sidebar.js")
 
@@ -39,6 +42,9 @@ class Plugin(BasePlugin[PluginConfig]):
                 custom_script.async_ = True
             
             config.extra_javascript.append(custom_script)
+        
+        if self.config.toggle_button not in ALLOWED_TOGGLE_BUTTON_VALUES:
+            raise PluginError(f"Unexpected value for 'toggle_button': '{self.config.toggle_button}'. Allowed values are {', '.join(ALLOWED_TOGGLE_BUTTON_VALUES)}")
         return config
 
 
@@ -61,6 +67,7 @@ class Plugin(BasePlugin[PluginConfig]):
                 data = data.replace("THEME_DEPENDENT_FUNCTION_DEFINITION_PLACEHOLDER", self.theme_function_definitions)
                 data = data.replace("TOC_DEFAULT_PLACEHOLDER", "true" if self.config.show_toc_by_default else "false")
                 data = data.replace("NAVIGATION_DEFAULT_PLACEHOLDER", "true" if self.config.show_toc_by_default else "false")
+                data = data.replace("TOGGLE_BUTTON_PLACEHOLDER", self.config.toggle_button)
                 with open(target_path, "w") as f:
                     f.write(data)
 

mkdocs_toggle_sidebar_plugin-0.0.4/src/mkdocs_toggle_sidebar_plugin/material.js

@@ -0,0 +1,61 @@
+const setCombinedVisibility = (showNavigation, showTOC) => {
+    let style = `
+.mkdocs-toggle-sidebar-button {
+    cursor: pointer;
+    margin-right: 5px;
+    margin-left: 1rem;
+}
+
+/*
+Hide the button when on mobile (and menu us shown as hamburger menu anyways).
+The exact max-width is taken from the styling of the 'body > header > nav > a' element
+*/
+
+@media screen and (max-width: 76.1875em) {
+    .mkdocs-toggle-sidebar-button {
+        display: none;
+    }
+}
+`;
+    if (!showTOC) {
+        style += `
+div.md-sidebar.md-sidebar--secondary {
+    display: none;
+}
+`;
+    }
+
+    if (!showNavigation) {
+        style += `
+div.md-sidebar.md-sidebar--primary {
+    display: none;
+}
+`
+    }
+
+    return style;
+}
+
+const addToggleButton = (toggleNavigation, toggleTOC) => {
+    const toggleBtn = createDefaultToggleButton(toggleNavigation, toggleTOC);
+    toggleBtn.classList.add("md-icon");
+  
+    const titleElement = document.querySelector(".md-header__title");
+    if (titleElement) {
+        titleElement.parentNode.insertBefore(toggleBtn, titleElement.nextSibling);  
+    } else {
+        console.warn(TOGGLE_BUTTON_REFERENCE_ELEMENT_NOT_FOUND_WARNING);
+    }
+}
+
+const registerKeyboardEventHandler = () => {
+    // Custom key handlers: SEE https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/?h=key+bind#docsjavascriptsshortcutsjs
+    keyboard$.subscribe(key => {
+        if (key.mode === "global") {
+            if (coreEventListenerLogic(key.type)) {
+                // event handled, stop propagation
+                key.claim();
+            }
+        }
+    });
+}

mkdocs_toggle_sidebar_plugin-0.0.4/src/mkdocs_toggle_sidebar_plugin/mkdocs.js

@@ -0,0 +1,69 @@
+const setCombinedVisibility = (showNavigation, showTOC) => {
+    let style = `
+.mkdocs-toggle-sidebar-container {
+    margin: auto 0;
+}
+
+.mkdocs-toggle-sidebar-button {
+    cursor: pointer;
+    width: 1.5em;
+    padding-bottom: 2px;
+}
+
+.mkdocs-toggle-sidebar-button svg {
+    fill: white;
+}
+`;
+
+    if (!showTOC) {
+        style += `
+div.col-md-3 {
+    display: none;
+}
+
+div.col-md-9 {
+    max-width: 100%;
+    flex-basis: 100%;
+}
+`;
+    }
+
+    if (!showNavigation) {
+        style += `
+ul.navbar-nav:nth-child(1) {
+    display: none;
+}
+`
+    }
+
+    return style;
+}
+
+const addToggleButton = (toggleNavigation, toggleTOC) => {
+    const toggleBtn = createDefaultToggleButton(toggleNavigation, toggleTOC);
+    const li = document.createElement("li");
+    li.className = "nav-item mkdocs-toggle-sidebar-container";
+    li.append(toggleBtn);
+  
+    let titleElement = document.querySelector("#navbar-collapse > ul.nav.navbar-nav.ms-md-auto");
+    if (!titleElement) {
+        // This worked in older versions, but not anymore. Since the default check failed, maybe we are in an old version?
+        titleElement = document.querySelector("#navbar-collapse > ul.nav.navbar-nav.ml-auto");
+    }
+    if (titleElement) {
+        titleElement.insertBefore(li, titleElement.firstChild);
+    } else {
+        console.warn(TOGGLE_BUTTON_REFERENCE_ELEMENT_NOT_FOUND_WARNING);
+    }
+}
+
+const registerKeyboardEventHandler = () => {
+    // Native HTML key event handling
+    document.addEventListener("keydown", (event => {
+        if (coreEventListenerLogic(event.key)) {
+            // event handled, stop propagation
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    }));
+}

mkdocs_toggle_sidebar_plugin-0.0.4/src/mkdocs_toggle_sidebar_plugin/readthedocs.js

@@ -0,0 +1,67 @@
+const setCombinedVisibility = (showNavigation, showTOC) => {
+    // Navigation and TOC are merged so we just pick one of the values and trust them
+    // @TODO: add support for combined bars in toggle-sidebar.js?
+    let style = `
+.mkdocs-toggle-sidebar-button {
+    cursor: pointer;
+    width: 1em;
+    fill: darkgray;
+    display: flex;
+    margin-right: 5px;
+}
+
+/* Hide toggle button in mobile view */
+@media screen and (max-width: 768px) {
+    .wy-breadcrumbs > li.mkdocs-toggle-sidebar-container {
+        display: none;
+    }
+}
+`;
+    if (!showNavigation) {
+        // We can not hide the contents in mobile view, since then the hamburger menu would be empty
+        style += `
+@media screen and (min-width: 768px) {
+    section.wy-nav-content-wrap {
+        margin-left: 0px;
+    }
+
+    nav.wy-nav-side, div.rst-versions {
+        display: none;
+    }
+
+    div.wy-nav-content {
+        max-width: 1100px;
+    }
+}
+`;
+    }
+
+    return style;
+    
+}
+
+const addToggleButton = (toggleNavigation, toggleTOC) => {
+    const toggleBtn = createDefaultToggleButton(toggleNavigation, toggleTOC);
+    toggleBtn.title = "Toggle Navigation"; // There is only one real sidebar, so we use this name for consistency
+    const li = document.createElement("li");
+    li.className = "mkdocs-toggle-sidebar-container";
+    li.append(toggleBtn);
+
+    const titleElement = document.querySelector("ul.wy-breadcrumbs");
+    if (titleElement) {
+        titleElement.insertBefore(li, titleElement.firstChild);  
+    } else {
+        console.warn(TOGGLE_BUTTON_REFERENCE_ELEMENT_NOT_FOUND_WARNING);
+    }
+}
+
+const registerKeyboardEventHandler = () => {
+    // Native HTML key event handling
+    document.addEventListener("keydown", (event => {
+        if (coreEventListenerLogic(event.key)) {
+            // event handled, stop propagation
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    }));
+}

{mkdocs-toggle-sidebar-plugin-0.0.3 → mkdocs_toggle_sidebar_plugin-0.0.4}/src/mkdocs_toggle_sidebar_plugin/toggle-sidebar.js

@@ -2,6 +2,7 @@
     const customDynamicStyle = document.createElement("style");
     document.head.appendChild(customDynamicStyle);
 
+    const TOGGLE_BUTTON_REFERENCE_ELEMENT_NOT_FOUND_WARNING = "[mkdocs-toggle-sidebar-plugin] Reference element for inserting 'toggle_button' not found. This version of the plugin may not be compatible with this version of the theme. Try updating both to the latest version. If that fails, you can open an GitHub issue.";
 
     const loadBool = (name, default_value) => {
         const value = localStorage.getItem(`TOGGLE_SIDEBAR_${name}`);
@@ -32,6 +33,10 @@
             saveBool("TOC", newTOC);
         }
         
+        _setVisibility(newNavigation, newTOC);
+    }
+
+    const _setVisibility = (newNavigation, newTOC) => {
         console.debug(`Setting new visibility: navigation=${newNavigation}, TOC=${newTOC}`);
         // combine this into one operation, so that it is more efficient (for toggling both) and easier to code with dynamic CSS generation
         customDynamicStyle.innerHTML = setCombinedVisibility(newNavigation, newTOC);
@@ -63,7 +68,55 @@
     window.addEventListener("load", () => {
         console.log("The mkdocs-toggle-sidebar-plugin is installed. It adds the following key bindings:\n T -> toggle table of contents sidebar\n M -> toggle navigation menu sidebar\n B -> toggle both sidebars (TOC and navigation)");
 
+        const toggle_button = "TOGGLE_BUTTON_PLACEHOLDER";
+        if (toggle_button == "none") {
+            // do nothing
+        } else if (toggle_button == "navigation") {
+            addToggleButton(true, false);
+        } else if (toggle_button == "toc") {
+            addToggleButton(false, true);
+        } else if (toggle_button == "all") {
+            addToggleButton(true, true);
+        } else {
+            console.error(`[mkdocs-toggle-sidebar-plugin] Unknown value for toggle_button: '${toggleButtonType}'`);
+        }
+
         registerKeyboardEventHandler();
         customDynamicStyle.innerHTML = setCombinedVisibility(loadNavigationState(), loadTocState());
     });
+
+    const createDefaultToggleButton = (toggleNavigation, toggleTOC) => {
+        const toggleBtn = document.createElement("div");
+        toggleBtn.className = "mkdocs-toggle-sidebar-button";
+        toggleBtn.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"></path></svg>`;
+        if (toggleNavigation && toggleTOC) {
+            toggleBtn.title = "Toggle Navigation and Table of Contents";
+        } else if (toggleNavigation) {
+            toggleBtn.title = "Toggle Navigation";
+        } else if (toggleTOC) {
+            toggleBtn.title = "Toggle Table of Contents";
+        }
+        toggleBtn.addEventListener("click", () => toggleVisibility(toggleNavigation, toggleTOC));
+        return toggleBtn;
+    };
+
+    // Export functions that the user can call to modify the state
+    window.MkdocsToggleSidebarPlugin = {
+        setNavigationVisibility: (show) => {
+            saveBool("NAVIGATION", show);
+            _setVisibility(show, loadTocState());
+        },
+        setTocVisibility: (show) => {
+            saveBool("TOC", show);
+            _setVisibility(loadNavigationState(), show);
+        },
+        setAllVisibility: (showNavigation, showTOC) => {
+            saveBool("NAVIGATION", showNavigation);
+            saveBool("TOC", showTOC);
+            _setVisibility(showNavigation, showTOC);
+        },
+        toggleNavigationVisibility: () => toggleVisibility(true, false),
+        toggleTocVisibility: () => toggleVisibility(false, true),
+        toggleAllVisibility: () => toggleVisibility(true, true)
+    };
 }());

{mkdocs-toggle-sidebar-plugin-0.0.3 → mkdocs_toggle_sidebar_plugin-0.0.4/src/mkdocs_toggle_sidebar_plugin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mkdocs-toggle-sidebar-plugin
-Version: 0.0.3
+Version: 0.0.4
 Summary: Add keybindings to toggle the table of contents and menu sidebars on some MkDocs themes
 Home-page: https://github.com/six-two/mkdocs-toggle-sidebar-plugin
 Author: six-two
@@ -61,13 +61,42 @@ Key   | Action
 `m` | toggle navigation **m**enu
 `t` | toggle **T**OC
 
+For some themes like `readthedocs` navigation and TOC are combined.
+In this case the state of TOC is ignored, and only calls for navigation (or all) are interpreted.
+
+### Toggle button
+
+When you set the `toggle_button` option to `navigation`, `toc` or `all`, it will add a button that looks like a hamburger menu (three horizontal bars) on a theme-dependent location.
+It is usually in the nav or the top bar.
+Clicking the button will toggle the navigation, table of contents, or both (depending on the supplied value).
+By leaving the field empty or setting it to `none`, no button is added.
+
+### Exported API functions
+
+This plugin exposes some JavaScript functions, that can show, hide or toggle the visibility of the sidebars.
+You can see how they are called in `docs/javascript-functions.md` and how they are defined in `src/mkdocs_toggle_sidebar_plugin/toggle-sidebar.js`.
+
+In short there are:
+
+- `MkdocsToggleSidebarPlugin.setNavigationVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setTocVisibility(show: bool)`
+- `MkdocsToggleSidebarPlugin.setAllVisibility: (showNavigation: bool, showTOC: bool)`
+- `MkdocsToggleSidebarPlugin.toggleNavigationVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleTocVisibility()`
+- `MkdocsToggleSidebarPlugin.toggleAllVisibility()`
+
+The names and parameters should be self-explanatory.
+
 ## Theme support
 
+Below shows the latest themes that I have tested.
+They are not updated that often, and the plugin should generally work for other of theme versions too.
+
 Theme            | Theme version | Plugin version | Status
 ---              | ---           | ---            | ---
-mkdocs-material  | 9.1.21        | 0.0.1          | works
-mkdocs (default) | 1.5.2         | 0.0.2          | works
-readthedocs      | 1.5.2         | 0.0.2          | works
+mkdocs-material  | 9.5.34        | 0.0.4          | works
+mkdocs (default) | 1.6.1         | 0.0.4          | works
+readthedocs      | 1.6.1         | 0.0.4          | works
 
 Just open a issue / PR if you use a strange theme or the info above is not up to date anymore.
 
@@ -85,6 +114,12 @@ Test mkdocs theme:
 
 ## Notable changes
 
+### Version 0.0.4
+
+- Export API via `MkdocsToggleSidebarPlugin` object.
+    This lets you create custom buttons or key bindings to hide, show or toggle the side bars.
+- Added `toggle_button` option and implemented it for Material theme
+
 ### Version 0.0.3
 
 - Changed internal API:

mkdocs-toggle-sidebar-plugin-0.0.3/src/mkdocs_toggle_sidebar_plugin/material.js

@@ -1,32 +0,0 @@
-const setCombinedVisibility = (showNavigation, showTOC) => {
-    let style = "";
-    if (!showTOC) {
-        style += `
-div.md-sidebar.md-sidebar--secondary {
-    display: none;
-}
-`;
-    }
-
-    if (!showNavigation) {
-        style += `
-div.md-sidebar.md-sidebar--primary {
-    display: none;
-}
-`
-    }
-
-    return style;
-}
-
-const registerKeyboardEventHandler = () => {
-    // Custom key handlers: SEE https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/?h=key+bind#docsjavascriptsshortcutsjs
-    keyboard$.subscribe(key => {
-        if (key.mode === "global") {
-            if (coreEventListenerLogic(key.type)) {
-                // event handled, stop propagation
-                key.claim();
-            }
-        }
-    });
-}

mkdocs-toggle-sidebar-plugin-0.0.3/src/mkdocs_toggle_sidebar_plugin/mkdocs.js

@@ -1,36 +0,0 @@
-const setCombinedVisibility = (showNavigation, showTOC) => {
-    let style = "";
-    if (!showTOC) {
-        style += `
-div.col-md-3 {
-    display: none;
-}
-
-div.col-md-9 {
-    max-width: 100%;
-    flex-basis: 100%;
-}
-`;
-    }
-
-    if (!showNavigation) {
-        style += `
-ul.navbar-nav:nth-child(1) {
-    display: none;
-}
-`
-    }
-
-    return style;
-}
-
-const registerKeyboardEventHandler = () => {
-    // Native HTML key event handling
-    document.addEventListener("keydown", (event => {
-        if (coreEventListenerLogic(event.key)) {
-            // event handled, stop propagation
-            event.preventDefault();
-            event.stopPropagation();
-        }
-    }));
-}

mkdocs-toggle-sidebar-plugin-0.0.3/src/mkdocs_toggle_sidebar_plugin/readthedocs.js

@@ -1,33 +0,0 @@
-const setCombinedVisibility = (showNavigation, showTOC) => {
-    // Navigation and TOC are merged so we just pick one of the values and trust them
-    // @TODO: add support for combined bars in toggle-sidebar.js?
-    if (showNavigation) {
-        return "";
-    } else {
-        return `
-section.wy-nav-content-wrap {
-    margin-left: 0px;
-}
-
-nav.wy-nav-side, div.rst-versions {
-    display: none;
-}
-
-div.wy-nav-content {
-    max-width: 1100px;
-}
-`;
-    }
-    
-}
-
-const registerKeyboardEventHandler = () => {
-    // Native HTML key event handling
-    document.addEventListener("keydown", (event => {
-        if (coreEventListenerLogic(event.key)) {
-            // event handled, stop propagation
-            event.preventDefault();
-            event.stopPropagation();
-        }
-    }));
-}