mirror of
https://github.com/mkdocs/mkdocs.git
synced 2026-03-27 09:58:31 +07:00
873b970f7f
Fixes #588 and fixes #1374. # Some implementation notes: ## `include_homepage_in_sidebar` setting Note that the homepage is always linked from the site_name above the search box. Therefore it does not need to also be in the nav tree. In the upstream Sphinx theme, this is controlled when defining the toctree. However, Sphinx has a separate setting for identifying the "homepage". In MkDocs the homepage is identified as the first item in the `nav`. Therefore, without this setting you can't exclude the homepage from the sidebar like you can in Sphinx. With this setting we get feature parity. ## Nested sections This output is a little weird as the section title is a link that does nothing when you click it. You need to click the `+` to expand the submenu. But that is what the upstream theme requires to work.