Understanding theme extension

[DiabolusGX]

Problem statement:

• Override tabs, to hide some tabs from top nav bar (like "Getting Started").
• Override nav on a particular file (let's say "Overview") to show hidden tabs ("Getting Started") from the top nav.

I'm struggling with:

1. Identifier on the file such that I can skip that in tabs overrides partial and show the same file nav override.
2. Override nav only if Overview tab is active.

[DiabolusGX]

@squidfunk
As discussed on Gitter, you suggested to override the site_nav block and then set this template only for the page

• Should I use nav override partial or site_nav blocks for this?
• As per my understanding, using template meta data will use new template file instead of main.html but I just want to override nav, is there any alternative, this approach sounds much more demanding?

[squidfunk]

Should I use nav override partial or site_nav blocks for this?

Both are possible, it depends on where you need to inject your changes. Always try to use the block first, then partial.

As per my understanding, using template meta data will use new template file instead of main.html but I just want to override nav, is there any alternative, this approach sounds much more demanding?

This is how MkDocs theme extension works, so if you want to change the theme, this is the simplest and most economical way.

[DiabolusGX]

Hey, @squidfunk just wanted to know:

1. if I can find reference for site_nav block override somewhere? I'm not able to implement cleanly, do I need to write my own css?
2. is it possible to override site_nav on a specific tab? like only on Home/Index tab from top nav and keep default site_nav on About tab.

[squidfunk]

1. No, just follow the normal process when overriding blocks. site_nav is defined here.
2. Create an additional template, which you call something other than main.html, and set it for each page as a template.