Generation/build date in the footer

[PlasmaHH]

Hi, after trying out the git-revision-date-localized plugin we found it to be a bit too slow for our needs ( well more like git at that point being too slow, either way the build takes 30 minutes instead of 3) we agreed that the most intresting information anyways is the build timestamp (to figure out if one should be able to see the latest push already).

The information needs to be in the footer.

So I tried finding something and googling for it seems to be rather hard... I know I could write a plugin myself that does nothing more than to provide a python datetime object for jinja this seems to be a bit excessive, especially since its nontrivial to provide it with my documentation.

So the question is, is there anywhere a date object or so that one could use? Or would it possible to just add one on the the jinja environment as a global? probably just a oneliner somewhere appropriate: jinja_env["date"] = datetime.now() or so....

[squidfunk]

I think build_date_utc and a partial override (footer?) should tick all boxes.

[PlasmaHH]

Ah of course, I must have somehow mixed that up with page.update_date, thanks a lot!

[PlasmaHH]

Ok, not sure if that is worth a topic elsewhere (in a jinja place maybe) but I guess others wonder too, does anyone happen to know a way to convert the timezone? astimezone() takes a tzinfo and all hits I could find for jinja implement their own filter for that...

[squidfunk]

You could register an additional filter in on_env by using the env variable, like we do it in the blog plugin (see below). Other than that, MkDocs doesn't directly allow to do that via configuration, you would either need to implement a hook or plugin.

mkdocs-material/src/plugins/blog/plugin.py

Lines 302 to 324 in 12a8e82

	# Filter for formatting dates related to posts
	def date_filter(date: datetime):
	return self._format_date_for_post(date, config)
	# Patch URL template filter to add support for paginated views, i.e.,
	# that paginated views never link to themselves but to the main view
	@pass_context
	def url_filter_with_pagination(context: Context, url: str | None):
	page = context["page"]
	# If the current page is a view, check if the URL links to the page
	# itself, and replace it with the URL of the main view
	if isinstance(page, View):
	view = self._resolve_original(page)
	if page.url == url:
	url = view.url
	# Forward to original template filter
	return url_filter(context, url)
	# Register custom template filters
	env.filters["date"] = date_filter
	env.filters["url"] = url_filter_with_pagination