lukasgeiter / mkdocs-awesome-pages-plugin

An MkDocs plugin that simplifies configuring page titles and their order
MIT License
452 stars 35 forks source link

An absolute path to '/...' is included in the 'nav' configuration, which presumably points to an external #92

Closed viceice closed 7 months ago

viceice commented 7 months ago

We're getting this message when using this plugin:

An absolute path to '/...' is included in the 'nav' configuration, which presumably points to an external

We're not sure how to suppress that, because it will cause an error if we enable strict mkdocs checks.

lukasgeiter commented 7 months ago

Do you have an example that I could use to reproduce the issue?

viceice commented 7 months ago

only our repo / PR linked above, sorry.

viceice commented 7 months ago

will try to create a reproduction

kamilkrzyskow commented 7 months ago

@lukasgeiter This should do as a minimal reproduction, simple mkdocs new with all of the new validation features enabled. mkdocs-awesome-issue.zip I believe that validation of the nav comes before the plugin processes the ... in the mkdocs.yml nav

@viceice As for your case, have you tried removing the nav from the mkdocs.yml, do you really need that to insert the .pages navigation properly on the root level?

Most of the examples here https://github.com/lukasgeiter/mkdocs-awesome-pages-plugin#combine-custom-navigation--file-structure assume some deeper nesting than root, therefore I'm assuming it's not required.

viceice commented 7 months ago

@kamilkrzyskow will try

viceice commented 7 months ago

@kamilkrzyskow Thanks, removing nav from mkdoc.yml solved the error.