Having trouble using multiple .pages files in different directories about mkdocs-awesome-pages-plugin HOT 3 OPEN

You beautiful genius! Thank you, it works!

from mkdocs-awesome-pages-plugin.

Hi, in your design .pages file try:

nav:
    - index.md
    - Introduction: general
    - Book Design: book_design
    - Figure Design: figure_design

or if you're using the i18n plugin:

nav:
    - ... | index*.md
    - Introduction: general
    - Book Design: book_design
    - Figure Design: figure_design

I'm using the material theme with index pages and navigation tabs features on, together with the i18n plugin:
For the top level (root -> tab) I have to use the third method in the tab directories to directly set index at the top.
Apart of that in deeper directories I just use ... in the nav and it does include the index at the top.

It breaks at the navigation tab level since it's a feature of the material theme that could get the link before the ... is processed by the plugin 🤔, but I never investigated it 🤷.

EDIT: I removed the copy-paste typo example, which I later explain doesn't work 😅

from mkdocs-awesome-pages-plugin.

MkDocs always navigates to the first page of a section (folder). Therefore, as @kamilkrzyskow suggested, you need some sort of index page if you don't want users to go straight to the introduction.

@jeffjg I assume your question has been answered and this issue can be closed?

from mkdocs-awesome-pages-plugin.