Make MkDocs' variables available inside blog templates

docs/template.md

@@ -85,3 +85,11 @@ These variables are available inside your template:
 - `show_total`: whether to show the total number of the blog
 
 You can refer to the original template for help.
+
+## Access to the Original MkDocs Template Variables
+
+Use `mkdocs_context` inside your template to access variables that are available inside MkDocs' templates. For example, to access `base_url`:
+
+```jinja
+<img href="{{ mkdocs_context.base_url }}/img/1.png" alt="">
+```

mkdocs_blogging_plugin/plugin.py

@@ -70,6 +70,7 @@ class BloggingPlugin(BasePlugin):
     tags = {}
     tags_page_html = None
     tags_index_url = ""
+    mkdocs_template_context = None
 
     util = Util()
 
@@ -163,6 +164,10 @@ def on_config(self, config):
         self.blog_pages = []
         self.tags = {}
 
+    def on_template_context(self, context, template_name, config):
+        self.mkdocs_template_context = context
+        return context
+
     def on_page_markdown(self, markdown, page, config, files):
         if "tags" in self.features and "tags" in page.meta:
             tags = page.meta["tags"]
@@ -257,7 +262,8 @@ def generate_html(self, pages) -> str:
             pages=blog_pages, page_size=self.size,
             paging=self.paging, is_revision=self.sort["by"] == "revision",
             show_total=self.show_total, theme_options=theme_options,
-            index_url=self.tags_index_url, show_tags="tags" in self.features
+            index_url=self.tags_index_url, show_tags="tags" in self.features,
+            mkdocs_context=self.mkdocs_template_context
         )
 
     def sorted_pages(self, pages):

setup.py

@@ -12,7 +12,7 @@
 
 setup(
     name="mkdocs-blogging-plugin",
-    version="1.2.1",
+    version="1.3.0",
     description="Mkdocs plugin that generates a blog index page sorted by creation date.",
     long_description=LONG_DESCRIPTION,
     long_description_content_type="text/markdown",