I understand that the uppermost index.md will be the opening page of the hosted site. That file has a title "Introduction" which, upon rendering on Github Pages, will create an "Introduction" chapter on the top toolbar with only one page, the identically named Introduction page being in it.
I would like to specify more introduction-related pages instead of having to condense everything into this global index.md. I tried adding getting-started.md and contact-us.md files on the top level (just within the docs folder, i.e., on the same level as the main index.md) but that created two additional chapters on the toolbar: Getting Started and Contact Us. That is not what I had in mind; I would like to use the aforementioned "Introduction" chapter and add more pages to it.
I'm aware I can just reorganize my folder structure like this:
However, in this case my original index.md is no longer on the top level and hence the site will not have an opening page as earlier. Can I point the opening page to be the docs/Introduction/index.md? If so, how?
I am using
mkdocs
(1.6.0) withmkdocs-material
(9.5.19).My documentation that I am building with mkdocs and hosting on Github Pages looks approximately like this:
I understand that the uppermost
index.md
will be the opening page of the hosted site. That file has a title "Introduction" which, upon rendering on Github Pages, will create an "Introduction" chapter on the top toolbar with only one page, the identically named Introduction page being in it.I would like to specify more introduction-related pages instead of having to condense everything into this global
index.md
. I tried addinggetting-started.md
andcontact-us.md
files on the top level (just within thedocs
folder, i.e., on the same level as the mainindex.md
) but that created two additional chapters on the toolbar: Getting Started and Contact Us. That is not what I had in mind; I would like to use the aforementioned "Introduction" chapter and add more pages to it.I'm aware I can just reorganize my folder structure like this:
However, in this case my original
index.md
is no longer on the top level and hence the site will not have an opening page as earlier. Can I point the opening page to be thedocs/Introduction/index.md
? If so, how?