-
-
Notifications
You must be signed in to change notification settings - Fork 8
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Will use first page as "index", even if it is not named index.md
or README.md
#6
Comments
The endorsed way to avoid pages being picked up for the index is specifying their title (not only file name) when writing the nav. In the example you can see that I chose to omit the title only for the index page. I thought that would be good enough, but perhaps not for everyone. Personally I use mkdocs-literate-nav with this (as described here) so it's impossible to omit titles. So perhaps I misjudged this. #5 would indeed be an alternative, as you noticed. |
@oprypin I was using mkdocs-literate-nav as well, but I didn't bother to fully specify every single sub element. I only specified some of the top level ones who's names I wanted to change. |
What if we are not using nav? I have alot of files so I just let MKDocs pickup on the directory structure. ex ) https://github.com/rkk1995/Notes/blob/mainline/mkdocs.yml Is tehre a way I can specify index pages for only some directories? |
+1 on that, I definitely prefer the behaviour presented in |
Currently, the first page will be set as the "index page", even if the name doesn't match
index.md
orREADME.md
.This is quite annoying, as it requires me to make an
index.md
page for every single folder to avoid ""losing"" pages.The text was updated successfully, but these errors were encountered: