Merge pull request #6 from haplo/toc

Basic style for markdown-generated Table of Contents

docs/toc.md

@@ -0,0 +1,33 @@
+# Table of contents documentation
+
+## Markdown
+
+Markdown has a [toc extension](https://python-markdown.github.io/extensions/toc/) that can be enabled and used directly.
+Once enabled just add `[TOC]` in the markdown document where you want the table of contents to appear.
+
+Configure the `toc` extension through `MARKDOWN` setting in `pelicanconf.py`:
+
+``` python
+MARKDOWN = {
+    "extension_configs": {
+        "markdown.extensions.toc": {
+            "title": "Table of Contents"
+        },
+    },
+}
+```
+
+Refer to [Markdown's toc extension documentation](https://python-markdown.github.io/extensions/toc/) for full settings.
+
+If you use the [i18n_subsites plugin](https://github.com/getpelican/pelican-plugins/tree/master/i18n_subsites) you can override the table of contents" title:
+
+``` python
+import copy
+
+I18N_SUBSITES = {
+    "es": {
+        "MARKDOWN": copy.deepcopy(MARKDOWN),  # copy to override later
+    }
+}
+I18N_SUBSITES["es"]["MARKDOWN"]["extension_configs"]["markdown.extensions.toc"]["title"] = "Índice de contenidos"
+```

static/dark-theme/dark-theme.min.js

@@ -1 +1 @@
-function ThemeManager(e){var t=e.defaultTheme,r="true"===e.enableAutoDetectTheme.toLowerCase(),a=window.matchMedia("light"===t?"(prefers-color-scheme: dark)":"(prefers-color-scheme: dark), (prefers-color-scheme: no-preference)");function d(e,t){var r=document.getElementById(e);r.disabled=!t,r.media=""}function m(){var e=localStorage.getItem("themeOverride");"light"!==e&&"dark"!==e&&(e="browser"===e||r?a.matches?"dark":"light":t),d("dark-theme-style","dark"===e),d("pygments-dark-theme","dark"===e),d("pygments-light-theme","light"===e),"dark"===e?(document.body.classList.add("dark-theme"),document.body.classList.remove("light-theme")):(document.body.classList.add("light-theme"),document.body.classList.remove("dark-theme"))}this.switch=function(e){localStorage.setItem("themeOverride",e),m()};var o=localStorage.getItem("themeOverride");"light"!==o&&"dark"!==o||m(),a.addListener(m)}window.theme=new ThemeManager(document.getElementById("dark-theme-script").dataset);
+function ThemeManager(e){var t=e.defaultTheme,r="true"===e.enableAutoDetectTheme.toLowerCase(),a=window.matchMedia("light"===t?"(prefers-color-scheme: dark)":"(prefers-color-scheme: dark), (prefers-color-scheme: no-preference)");function d(e,t){e=document.getElementById(e);e.disabled=!t,e.media=""}function m(){var e=localStorage.getItem("themeOverride");d("dark-theme-style","dark"===(e="light"!==e&&"dark"!==e?"browser"===e||r?a.matches?"dark":"light":t:e)),d("pygments-dark-theme","dark"===e),d("pygments-light-theme","light"===e),"dark"===e?(document.body.classList.add("dark-theme"),document.body.classList.remove("light-theme")):(document.body.classList.add("light-theme"),document.body.classList.remove("dark-theme"))}this.switch=function(e){localStorage.setItem("themeOverride",e),m()};e=localStorage.getItem("themeOverride");"light"!==e&&"dark"!==e||m(),a.addListener(m)}window.theme=new ThemeManager(document.getElementById("dark-theme-script").dataset);

static/stylesheet/style.less

@@ -276,6 +276,28 @@ main {
     section#isso-thread .auth-section .input-wrapper {
       margin-right: 5px;
     }
+
+    // Table of Contents Markdown extension:
+    // https://python-markdown.github.io/extensions/toc/
+    .toc {
+      border: 1px solid @light-orange;
+      margin-top: 2em;
+      padding: 1em;
+
+      .toctitle {
+        font-size: 1.3em
+      }
+
+      ul {
+        list-style: none;
+        margin-bottom: 0;
+        padding: 0;
+
+        li {
+          padding: 0.3em 0 0.3em 0;
+        }
+      }
+    }
   }
 
   footer {