Explain how to add revision date to mkdocs default theme

Author: timvink

Diff for: README.md

@@ -58,6 +58,45 @@ In your markdown files you can use the `{{ git_revision_date_localized }}` tag a
 Last update: {{ git_revision_date_localized }}
 ```
 
+### Extending existing themes
+
+You can [customize an existing theme](https://www.mkdocs.org/user-guide/styling-your-docs/#customizing-a-theme) by overriding blocks or partials and using the `page.meta.git_revision_date_localized` tag.
+
+To add a revision date to the default `mkdocs` theme by adding a `overrides/partials` folder to your `docs` folder and updating your `mkdocs.yml` file:
+
+```yml
+theme:
+    name: mkdocs
+    custom_dir: docs/overrides
+```
+
+And then adding a new file `docs/overrides/content.html` with the following content:
+
+<details>
+  <summary>content.html</summary>
+  
+  ```html
+  <!-- Overwrites content.html base mkdocs theme, taken from 
+  https://github.com/mkdocs/mkdocs/blob/master/mkdocs/themes/mkdocs/content.html -->
+
+  {% if page.meta.source %}
+      <div class="source-links">
+      {% for filename in page.meta.source %}
+          <span class="label label-primary">{{ filename }}</span>
+      {% endfor %}
+      </div>
+  {% endif %}
+
+  {{ page.content }}
+
+  {% if page.meta.git_revision_date_localized %}
+      <small>Last update: {{ page.meta.git_revision_date_localized }}</small>
+  {% endif %}
+  ```
+</details>
+
+&nbsp;
+
 ### In custom themes
 
 When writing your own [custom themes](https://www.mkdocs.org/user-guide/custom-themes/) you can use the `page.meta.git_revision_date_localized` jinja tag:

Diff for: mkdocs_git_revision_date_localized_plugin/util.py

@@ -9,6 +9,7 @@
 
 logger = logging.getLogger("mkdocs.plugins")
 
+
 class Util:
     def __init__(self, path: str = ".", config={}):
 

Diff for: tests/fixtures/basic_project/docs/overrides/content.html

@@ -0,0 +1,16 @@
+<!-- Overwrites content.html base mkdocs theme, taken from 
+https://github.com/mkdocs/mkdocs/blob/master/mkdocs/themes/mkdocs/content.html -->
+
+{% if page.meta.source %}
+    <div class="source-links">
+    {% for filename in page.meta.source %}
+        <span class="label label-primary">{{ filename }}</span>
+    {% endfor %}
+    </div>
+{% endif %}
+
+{{ page.content }}
+
+{% if page.meta.git_revision_date_localized %}
+    <small>Last update: {{ page.meta.git_revision_date_localized }}</small>
+{% endif %}

Diff for: tests/fixtures/basic_project/mkdocs_with_override.yml

@@ -0,0 +1,10 @@
+site_name: test gitrevisiondatelocalized_plugin
+use_directory_urls: true
+
+theme:
+    name: mkdocs
+    custom_dir: docs/overrides
+
+plugins:
+    - search
+    - git-revision-date-localized