Add new variables for site revision date, see #19

Author: timvink

docs/howto/override-a-theme.md

@@ -120,4 +120,13 @@ And if you've enable creation date in the config:
 - `page.meta.git_creation_date_localized_raw_datetime`
 - `page.meta.git_creation_date_localized_raw_iso_date`
 - `page.meta.git_creation_date_localized_raw_iso_datetime`
-- `page.meta.git_creation_date_localized_raw_timeago`
+- `page.meta.git_creation_date_localized_raw_timeago`
+
+And finally there are variants that contain the latest revision date of your entire site. This is the last commit on any file in the `docs/` directory, which is added to the meta information of every page.
+
+- `page.meta.git_site_revision_date_localized`
+- `page.meta.git_site_revision_date_localized_raw_datetime`
+- `page.meta.git_site_revision_date_localized_raw_iso_date`
+- `page.meta.git_site_revision_date_localized_raw_date`
+- `page.meta.git_site_revision_date_localized_raw_iso_datetime`
+- `page.meta.git_site_revision_date_localized_raw_timeago`

mkdocs_git_revision_date_localized_plugin/css/timeago.css

@@ -1,6 +1,9 @@
 /* 
- * timeago output is dynamic, which breaks when you print a page.
- * This ensures fallback to type "iso_date" when printing.
+ timeago output is dynamic, which breaks when you print a page.
+
+ This CSS is only included when type: timeago 
+ and ensures fallback to type "iso_date" when printing.
+ 
  */
 
 .git-revision-date-localized-plugin-iso_date { display: none }

mkdocs_git_revision_date_localized_plugin/plugin.py

@@ -61,6 +61,11 @@ def on_config(self, config: config_options.Config, **kwargs) -> Dict[str, Any]:
 
         self.util = Util(config=self.config)
 
+        # Save last commit timestamp for entire site
+        self.last_site_revision_timestamp = self.util.get_git_commit_timestamp(
+            config.get('docs_dir')
+        )
+
         # Get locale settings - might be added in future mkdocs versions
         # see: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/issues/24
         mkdocs_locale = config.get("locale", None)
@@ -222,6 +227,17 @@ def on_page_markdown(
             flags=re.IGNORECASE,
         )
 
+        # Finally,
+        # Also add site last updated information, for developers
+        site_dates = self.util.get_date_formats_for_timestamp(self.last_site_revision_timestamp)
+        site_date = site_dates[self.config["type"]]
+        if self.config["type"] == "timeago":
+            site_date += site_dates["iso_date"]
+        page.meta["git_site_revision_date_localized"] = site_date
+        site_dates_raw = self.util.get_date_formats_for_timestamp(self.last_site_revision_timestamp, add_spans=False)
+        for date_type, date_string in site_dates_raw.items():
+            page.meta["git_site_revision_date_localized_raw_%s" % date_type] = date_string
+
         return markdown
 
     def on_post_build(self, config: Dict[str, Any], **kwargs) -> None:

mkdocs_git_revision_date_localized_plugin/util.py

@@ -104,6 +104,7 @@ def get_git_commit_timestamp(
             # https://git-scm.com/docs/git-log#Documentation/git-log.txt---diff-filterACDMRTUXB82308203
             realpath = os.path.realpath(path)
             git = self._get_repo(realpath)
+
             if is_first_commit:
                 # diff_filter="A" will select the commit that created the file
                 commit_timestamp = git.log(
@@ -115,6 +116,7 @@ def get_git_commit_timestamp(
                 if commit_timestamp != "":
                     commit_timestamp = commit_timestamp.split()[-1]
             else:
+                # Latest commit touching a specific file
                 commit_timestamp = git.log(
                     realpath, date="short", format="%at", n=1
                 )

tests/fixtures/basic_project/docs/overrides_material_theme/partials/source-date.html renamed to tests/fixtures/basic_project/docs/overrides_material_theme/partials/source-file.html

@@ -37,5 +37,10 @@
     {% elif page.meta.revision_date %}
       {{ label }}: {{ page.meta.revision_date }}
     {% endif %}
+
+    {% if page.meta.git_site_revision_date_localized %}
+    <br />Site last updated: {{ page.meta.git_site_revision_date_localized }}
+    {% endif %}
+    
   </small>
 </div>