From 51f2dd1fc00b1dd72fc1ce456532e7c930035c29 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?iBug=20=E2=99=A6?= Date: Sat, 4 Apr 2020 04:41:47 +0800 Subject: [PATCH] Updated docs on navigation tabs (#1561) * Update docs on navigation tabs (as discussed in #1560) * Drop "less inconvenient" wording. --- docs/getting-started.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/getting-started.md b/docs/getting-started.md index 1a9d55d37..5a248e581 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -246,6 +246,14 @@ Note that all *top-level pages* (i.e. all top-level entries that directly refer to an `*.md` file) defined inside the `nav` entry of `mkdocs.yml` will be grouped under the first tab which will receive the title of the first page. +If you want to maintain absolute control over the navigation bar, you can opt +in to group all top-level pages under one entry (so all top-level entries have +subentries now). This way you can have nested navigation items in conjunction +with tabs, as nesting works as expected from the second level on when tabs are +enabled. Keep in mind that mobile navigation isn't affected by tabs, however, +which means that your top-level entries correspond to top-level mobile +navigation items. + ### Language > Default: `en`