Fix pymdownx.extra config (#214)

Author: PeaWarrior

README.md

@@ -149,6 +149,9 @@ We only use `material-mkdocs` as base styles because Backstage also uses the `Ma
 
 ## Changelog
 
+### 1.4.2
+ - Fixes an issue where individual extension configurations were being ignored if the extension was included within `pymdownx.extra`. See [#147](https://github.com/backstage/mkdocs-techdocs-core/issues/147)
+
 ### 1.4.1
  - Introduced mkdocs-redirects plugin (v`1.2.1`). 
 

setup.py

@@ -28,15 +28,15 @@
 
 setup(
     name="mkdocs-techdocs-core",
-    version="1.4.1",
+    version="1.4.2",
     description="The core MkDocs plugin used by Backstage's TechDocs as a wrapper around "
     "multiple MkDocs plugins and Python Markdown extensions",
     long_description=long_description,
     long_description_content_type="text/markdown",
     keywords="mkdocs",
     url="https://github.com/backstage/mkdocs-techdocs-core",
     author="TechDocs Core",
-    author_email="pulp-fiction@spotify.com",
+    author_email="protean@spotify.com",
     license="Apache-2.0",
     python_requires=">=3.7",
     install_requires=required,

src/core.py

@@ -23,6 +23,7 @@
 from material.plugins.search.plugin import SearchPlugin as MaterialSearchPlugin
 from mkdocs_monorepo_plugin.plugin import MonorepoPlugin
 from pymdownx.emoji import to_svg
+from pymdownx.extra import extra_extensions
 
 log = logging.getLogger(__name__)
 
@@ -114,7 +115,6 @@ def on_config(self, config):
         config["markdown_extensions"].append("pymdownx.mark")
         config["markdown_extensions"].append("pymdownx.smartsymbols")
         config["markdown_extensions"].append("pymdownx.snippets")
-        config["markdown_extensions"].append("pymdownx.superfences")
         config["markdown_extensions"].append("pymdownx.highlight")
         config["mdx_configs"]["pymdownx.highlight"] = {
             "linenums": True,
@@ -134,6 +134,17 @@ def on_config(self, config):
         }
         config["markdown_extensions"].append("pymdownx.tilde")
 
+        # merge individual extension configs under the pymdownx.extra extension namespace if individual extension is supplied by pymdownx.extra
+        # https://facelessuser.github.io/pymdown-extensions/extensions/extra/
+        if "pymdownx.extra" not in config["mdx_configs"]:
+            config["mdx_configs"]["pymdownx.extra"] = {}
+        for extension in extra_extensions:
+            if extension in config["mdx_configs"]:
+                config["mdx_configs"]["pymdownx.extra"][extension] = config[
+                    "mdx_configs"
+                ][extension]
+                del config["mdx_configs"][extension]
+
         config["markdown_extensions"].append("markdown_inline_graphviz")
         config["markdown_extensions"].append("plantuml_markdown")
         config["markdown_extensions"].append("mdx_truly_sane_lists")