Partials override to move "Last Updated" to top of page?

[aforsythe]

Sorry for the basic question. I'm just banging my head against the wall trying to figure out what I'm doing wrong.

I'm using git-revision-date-localized and I would like to move the "Last Updated" notification to the top of the page (preferable under the title, but I haven't gotten that far yet.

I've added a custom_dir: mkdocs/overrides to my mkdocs.yml

I've created a overrides/partials/main.html

The contents are

{% extends "base.html" %} 
{% block content %}
{{ page.meta.revision_date }}
{{ super() }}
{% endblock content %}

This seems to have no effect.

Thanks for any help in advance.

[squidfunk]

From the information you gave us, it looks like you put main.html in the wrong place. It should be:

.
├─ overrides/
│  └─ main.html
└─ mkdocs.yml

[aforsythe]

I've moved main.html to overrides rather than partials, but still no luck.

My structure looks like this now.

├─latex/
├─other stuff/
├─mkdocs/
│  └─ docs/
│  └─ overrides/
│          └─ main.html
└─ mkdocs.yml
└─ Dockerfile

I tired moving overrides up to to the root next to the mkdocs.yml and adjusted my custom_dir: accordingly, but no luck that way either.

[aforsythe]

Here's the relevant sections of the mkdocs.yml

site_dir: /site
docs_dir: mkdocs/docs
...
theme:
  name: 'material'
  custom_dir: mkdocs/overrides

[squidfunk]

If you can provide a minimal reproduction, we can look into it. We need something we can run.

[aforsythe]

Thanks .. here's a minimal reproduction.

exmaple.zip

[squidfunk]

Thanks for providing the reproduction. You're deviating from the recommended file structure, as you're putting stuff into a subfolder. I've tested, and it does not work with other themes than Material for MkDocs as well, so it's a general MkDocs problem. Your options:

• Use the recommended file structure
• Raise a question (or issue) to the maintainers of MkDocs. You might have hit a bug, but I'm not sure.

[aforsythe]

Thanks but modifying the structure to the recommended file structure doesn't seem to fix it.

Further, modifying main.html shows that the override is being picked up even with the subdirectory structure.

modified main.html

{% extends "base.html" %} 
{% block htmltitle %}
  <title>Lorem ipsum dolor sit amet</title>
{% endblock %}
{% block content %}
{{ page.meta.revision_date }}
{{ super() }}
{% endblock content %}

Here's a version with the modified file structure showing that the page revision date isn't being moved to the top even when following the recommended file structure.
exmaple_revised_structure.zip

Could this be an issue with git-revision-date-localized?

[aforsythe]

Well this is slightly embarrassing.

Turns out I was using the wrong variable name for git-revision-date-localized. Should be page.meta.git_revision_date_localized instead of page.meta.revision_date.

I'm still trying to figure out how to disable the default placement of "Last updated" when using the variable and how I can place the variable below the page title, but that seems like a question for @timvink.

By the way, this works with the subdirectory structure I was originally using.

[timvink]

Hi there! I didn't read your full thread, but see the documentation of the git-revision-date-localized plugin on overriding themes: https://timvink.github.io/mkdocs-git-revision-date-localized-plugin/howto/override-a-theme/

The highlighted bit is what inserts "Last updated" (based on the locale used):