Bad macro response. title=[blank] only in the root folder

[angeld-jr2]

• I made a test playground:

test/
test/docs
test/docs/index.md
test/docs/outside_root
test/docs/outside_root/index.md
test/docs/outside_root/one.md
test/docs/outside_root/two.md
test/docs/outside2_root
test/docs/outside2_root/index.md
test/docs/outside2_root/one.md
test/docs/outside2_root/two.md
test/docs/one.md
test/docs/two.md
test/mkdocs.yml

• All .md files contain are the same. Only filename change:

# Welcome to MkDocs

{{ navigation.pages }}

For full documentation visit [mkdocs.org](https://www.mkdocs.org).

• mkdoks.yml only contains site_name and macros plugin:

site_name: My Docs

plugins:
  - macros:

• In al pages in root folder some of return page title of {{ navigation.pages }} macro are in blank

[Page(title='Welcome to MkDocs', url='/'), Page(title=[blank], url='/one/'), Page(title=[blank], url='/two/'), Page(title=[blank], url='/outside2_root/'), Page(title=[blank], url='/outside2_root/one/'), Page(title=[blank], url='/outside2_root/two/'), Page(title=[blank], url='/outside_root/'), Page(title=[blank], url='/outside_root/one/'), Page(title=[blank], url='/outside_root/two/')]

• In all pages in other folder outside of root folder return page title of {{ navigation.pages }} macro are OK for all folders excpect the current folder :

[Page(title='Welcome to MkDocs', url='/'), Page(title='Welcome to MkDocs', url='/one/'), Page(title='Welcome to MkDocs', url='/two/'), Page(title='Welcome to MkDocs', url='/outside2_root/'), Page(title='Welcome to MkDocs', url='/outside2_root/one/'), Page(title='Welcome to MkDocs', url='/outside2_root/two/'), Page(title='Welcome to MkDocs', url='/outside_root/'), Page(title=[blank], url='/outside_root/one/'), Page(title=[blank], url='/outside_root/two/')]

Why are tittles in "blank"?

Is a bug?

Another discussion has similar problem. Why does navigation.pages not return full page objects? #198, but the response "forward to mkdocs team" It's not a good answer until we rule out the possibility that it's the macros plugin malfunctioning.

[fralau]

The subject of navigation comes back often (see #198, #267).

The key fact to know about MkDocs-Macros is that, by design choice, the environment variables are copied at the time of the on_config event.

mkdocs-macros-plugin/mkdocs_macros/plugin.py

Line 742 in 86e31f7

def on_config(self, config):

You get the config with what's in there at the time of the on_page event.

The program does a shallow copy, so you might have a mix of states.

from copy import copy

However the navigation and files variables are defined at the time of the on_nav:

mkdocs-macros-plugin/mkdocs_macros/plugin.py

Line 896 in 86e31f7

def on_nav(self, nav, config, files):

In truth, MkDocs-Macros was not developed with the purpose of exposing that kind of information and it was an added as a bonus. It does not manipulate those objects, so it exposes what they contain without further promises or guarantees.

[angeld-jr2]

Thanks. #267 is a very good response, problem of the chicken and the egg