Add some page.meta tags with raw date strings

Author: timvink

docs/howto/override-a-theme.md

@@ -87,3 +87,21 @@ When writing your own [custom themes](https://www.mkdocs.org/user-guide/custom-t
   Last update: {{ page.meta.git_revision_date_localized }}
 {% endif %}
 ```
+
+As a developer you might want access to more raw date formats that also do not have the `<span>` elements. You can also use:
+
+- `page.meta.git_revision_date_localized`
+- `page.meta.git_revision_date_localized_raw_date`
+- `page.meta.git_revision_date_localized_raw_datetime`
+- `page.meta.git_revision_date_localized_raw_iso_date`
+- `page.meta.git_revision_date_localized_raw_iso_datetime`
+- `page.meta.git_revision_date_localized_raw_timeago`
+
+And if you've enable creation date in the config:
+
+- `page.meta.git_creation_date_localized`
+- `page.meta.git_creation_date_localized_raw_date`
+- `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`

mkdocs_git_revision_date_localized_plugin/plugin.py

@@ -204,6 +204,31 @@ def on_page_markdown(
                 flags=re.IGNORECASE,
             )
 
+        # Developers might want access to the raw date strings
+        # Let's expose them also
+        revision_dates = self.util._date_formats(
+            unix_timestamp=self.util.get_git_commit_timestamp(
+                path=page.file.abs_src_path,
+                is_first_commit=False,
+            ),
+            time_zone=self.config.get("time_zone"),
+            locale=self.config.get("locale")
+        )
+        for date_type, date_string in revision_dates.items():
+            page.meta["git_revision_date_localized_raw_%s" % date_type] = date_string
+
+        if self.config.get("enable_creation_date"):
+            creation_dates = self.util._date_formats(
+                unix_timestamp=self.util.get_git_commit_timestamp(
+                    path=page.file.abs_src_path,
+                    is_first_commit=False,
+                ),
+                time_zone=self.config.get("time_zone"),
+                locale=self.config.get("locale")
+            )
+            for date_type, date_string in creation_dates.items():
+                page.meta["git_creation_date_localized_raw_%s" % date_type] = date_string
+
         return markdown
 
     def on_post_build(self, config: Dict[str, Any], **kwargs) -> None:

setup.py

@@ -12,7 +12,7 @@
 
 setup(
     name="mkdocs-git-revision-date-localized-plugin",
-    version="0.10.0",
+    version="0.10.1",
     description="Mkdocs plugin that enables displaying the localized date of the last git modification of a markdown file.",
     long_description=LONG_DESCRIPTION,
     long_description_content_type="text/markdown",