Header content variables

Author: choldgraf

docs/conf.py

@@ -2,6 +2,7 @@
 import os
 from pathlib import Path
 from urllib import request
+from yaml import safe_load
 
 project = "Sphinx Book Theme"
 copyright = "2020"
@@ -103,6 +104,8 @@
     "repository_branch": "master",
 }
 
+header_config = safe_load(Path("./config-header.yml").read_text())
+
 html_theme_options = {
     "path_to_docs": "docs",
     "repository_url": "https://github.com/executablebooks/sphinx-book-theme",
@@ -126,55 +129,8 @@
         "⚠️The latest release refactored our HTML, "
         "so double-check your custom CSS rules!⚠️"
     ),
+    "header": header_config,
     # For testing
-    "header": {
-        "brand": {
-            "type": "image",
-            "src": "https://executablebooks.org/en/latest/_static/logo.svg",
-            "url": "https://sphinx-book-theme.readthedocs.io",
-        },
-        "start": [
-            {
-                "type": "text",
-                "content": "Jupyter Book",
-                "url": "https://jupyterbook.org",
-            },
-            {
-                "type": "dropdown",
-                "content": "EBP Projects",
-                "items": [
-                    {"content": "google", "url": "https://google.com"},
-                    {"content": "jupyter", "url": "https://jupyter.org"},
-                ],
-            },
-            {
-                "type": "dropdown",
-                "content": "MyST Markdown",
-                "items": [
-                    {"content": "google", "url": "https://google.com"},
-                    {"content": "jupyter", "url": "https://jupyter.org"},
-                ],
-            },
-        ],
-        "end": [
-            {"type": "button", "content": "end", "url": "https://google.com"},
-            {
-                "type": "icon-links",
-                "icons": [
-                    {
-                        "url": "https://twitter.com/executablebooks",
-                        "name": "Twitter",
-                        "icon": "fab fa-twitter-square",
-                    },
-                    {
-                        "url": "https://github.com/orgs/executablebooks/discussions",
-                        "name": "Forum",
-                        "icon": "fas fa-comments",
-                    },
-                ],
-            },
-        ],
-    }
     # "use_fullscreen_button": False,
     # "home_page_in_toc": True,
     # "single_page": True,

docs/config-header.yml

@@ -0,0 +1,40 @@
+brand:
+  type: image
+  src: https://executablebooks.org/en/latest/_static/logo.svg
+  url: https://sphinx-book-theme.readthedocs.io
+start:
+  - type: dropdown
+    content: Projects
+    items:
+    - content: Jupyter Book
+      url: https://jupyterbook.org
+    - content: MyST Markdown
+      url: https://myst-parser.readthedocs.io
+    - content: MyST-NB
+      url: https://myst-nb.readthedocs.io
+
+  - type: dropdown
+    content: Community
+    items:
+    - content: Community guide
+      url: https://executablebooks.org
+    - content: Forum
+      url: https://github.com/orgs/executablebooks/discussions
+    - content: Feature Voting
+      url: https://executablebooks.org/en/latest/feature-vote.html
+
+end:
+  - type: icon-links
+    icons:
+    - icon: fab fa-twitter-square
+      name: Twitter
+      url: https://twitter.com/executablebooks
+    - icon: fab fa-github-square
+      name: GitHub
+      url: https://github.com/executablebooks
+    - icon: fas fa-comments
+      name: Forum
+      url: https://github.com/orgs/executablebooks/discussions
+  - type: button
+    content: Book gallery
+    url: http://gallery.jupyterbook.org/