Looping through and displaying other file's metadata

[SoumayaMauthoorMOJ]

Is it possible to reference the metadata in other files?

I have added an adr keyword to the front-matter of my Architecture Decision Record markdown files:

---
adr: 
    number: "0001"
    status: Draft
---

I have updated the content block in main.html so that this information is displayed before the title:

{% block content %}
  {% if page.meta and page.meta.adr %}
    <table>
      <tr>
        <th>Number</th>
        <th>{{page.meta.adr.number}}</th>
      </tr>
      <tr>
        <th>Status</th>
        <th>{{page.meta.adr.status}}</th>
      </tr>
    </table>
  {% endif %}
  {{ super() }}
{% endblock %}

I was wondering whether it was possible to loop through these files and render them on a designated file e.g.:

---
adr_root: true
---

{% block content %}
 {{ super() }}

{% if page.meta and page.meta.adr_root %}
    {%  for page in pages %}
      {% if page.meta and page.meta.adr %}
        * [{{page.title}}]
      {% endif %}
    {% endfor %}
{% endif %}

{% endblock %}

Or would I have to create my own plugin similar to the tag plugin

[squidfunk]

You should be able to access the metadata of all pages via the nav object, as this contains all pages,so something like this might work (but YMMV depending on what you want to achieve):

{% block content %}
  {% for nav_item in nav %}
    {{ nav_item.meta.adr_root }}
  {% endfor %}
{% endblock %}

Also, you would need to recursively loop through children. See the nav_item partial for guidance.

[vlebert]

hi @squidfunk
I do have the same need. What if my pages are not in the navigation ? Neither GPT or Claude or Codestral could help me :)

[kamilkrzyskow]

Have you tried using pages @vlebert?

• https://www.mkdocs.org/dev-guide/themes/#pages

Just be cautious to not override the page, as this is also a global context variable. Also better don't use post/posts, as blog posts from the plugin are set via those:

{% block content %}
  {% for loop_file in pages %}
    {{ loop_file.page.meta }}
  {% endfor %}
{% endblock %}

[vlebert]

Hi @kamilkrzyskow

When using pages, i can iterate on pages but properties such as title or meta are empty

Or maybe i am missing something...

[kamilkrzyskow]

Oh sorry @vlebert, I didn't read the fine print, which was the whole description...

A flat list of File objects for all pages in the project. This list can contain pages not included in the global navigation and may not match the order of pages within that navigation. The page object for each File can be accessed from file.page.

So those are Files not Pages, so to access the meta, you need to first access the page, I've edited the example above to use the file.page structure. If that still doesn't work, please provide a minimal example zip archive I could run and modify ✌️

[vlebert]

Thanks @kamilkrzyskow
I think my issue from the begining came from using a "page" variable name in my for loop :)