search

oprypin / mkdocs-literate-nav

MkDocs plugin to specify the navigation in Markdown instead of YAML
https://oprypin.github.io/mkdocs-literate-nav
MIT License
76 stars 8 forks source link

Unrecognized relative link warning with nav cross links #32

Closed wtjones closed 5 months ago

wtjones commented 5 months ago

I have this in docs/SUMMARY.md:

* [Architecture](arch/)

The target folder contains a SUMMARY.md file per the nav cross-link feature. Everything works fine, however I get this message:

Doc file 'SUMMARY.md' contains an unrecognized relative link 'arch/', it was left as is. Did you mean 'arch/index.md'?

Mkdocs wants me to put arch/index.md for the sake of raw md navigation, but that trips up the plugin and will not render the nav. I can configure the warnings to be ignored, but was checking for a cleaner solution.

oprypin commented 5 months ago

See https://github.com/oprypin/mkdocs-literate-nav/issues/28#issuecomment-1848397051

Duplicate of #28