How to set up automatic obsolescence warnings?

[SWHL]

I want to set automatic outdated warnings for some documents. For example, if an article was last updated a year ago, it will automatically add the document written a long time ago at the beginning of the document, which may contain outdated information.

I tried to add logic in overrides/main.html, as follows:

{% block content %}

{{ super() }}

{% if page and page.meta.date %}
{% set doc_date = page.meta.date %}
{% set today = "" | as_datetime("%Y-%m-%d") %}
{% set diff_days = (today | date("%s") - doc_date | date("%s")) // 86400 %}

{% if diff_days > 365 %}
<div class="md-typeset">
    <div class="md-admonition warning outdated-warning">
        <p class="md-admonition__title">
            ⚠️  Document Outdated Reminder
        </p>
        <p>
             This document was last updated<strong>{doc_date}</strong>({diff_days}} days ago),
            May contain outdated information, please refer to the latest documentation for use.
        </p>
    </div>
</div>
{% endif %}
{% endif %}
{% endblock %}

Meanwhile, I add plugin config in the mkdocs.yml:

plugins:
  - meta

But it didn't take effect. Hope someone who knows can give me some guidance， thanks.

[alexvoss]

I assume you have set the custom_dir setting in your configuration?

The overrides file should be called main.html (not .exe, though perhaps that was just a typo?) and should contain {% extends "base.html" %} at the beginning, see the documentation on block overrides.

I am not sure what you are using the Meta Plugin in this? Do you mean to apply the same revision date to a bunch of files? I would have expected there to be a date in the front matter of each page. If you want to get the date from Git you can explore the git-revision-date-localized-plugin.

Finally, AFAIK you cannot execute arbitrary Python code in a Jinja template but are limited to the functions defined in Jinja because of sandboxing. The best approach IMHO would be to calculate the flag whether a page if outdated or not in a MkDocs hook, then use it in the template.

[SWHL]

Thanks, I will try to implement this in the hook.

[SWHL]

I've already implemented it here and wrote a small demo, hoping it can help other friends.

Demo: https://github.com/SWHL/DemoMkdocsExpirationRemider