Fixed buggy content tabs overflow scrolling + updated documentation

docs/insiders/changelog.md

@@ -6,264 +6,264 @@ template: overrides/main.html
 
 ## Material for MkDocs Insiders
 
-### 3.1.2 <small>_ October 6, 2021</small>
+### 3.1.2 <small>_ October 6, 2021</small> { id="3.1.2" }
 
 - Fixed incorrect path separators for social cards on Windows
 
-### 3.1.1 <small>_ September 26, 2021</small>
+### 3.1.1 <small>_ September 26, 2021</small> { id="3.1.1" }
 
 - Fixed ordering bug in search exclusion logic
 
-### 3.1.0 <small>_ September 26, 2021</small>
+### 3.1.0 <small>_ September 26, 2021</small> { id="3.1.0" }
 
 - Added support for excluding pages, sections, and elements from search
 - Fixed #2803: Code block annotations not visible when printing
 
-### 3.0.1 <small>_ September 19, 2021</small>
+### 3.0.1 <small>_ September 19, 2021</small> { id="3.0.1" }
 
 - Added support for using literal `h1-6` tags for search plugin
 - Fixed search plugin breaking on void elements without slashes
 - Fixed search plugin filtering link contents from headlines
 - Fixed search plugin handling of multiple `h1` headlines
 - Fixed search plugin handling of missing `h1` headlines
 
-### 3.0.0 <small>_ September 13, 2021</small>
+### 3.0.0 <small>_ September 13, 2021</small> { id="3.0.0" }
 
 - Rewrite of MkDocs' search plugin
 - Added support for rich search previews
 - Added support for tokenizer with lookahead
 - Improved search indexing performance (twice as fast)
 - Improved search highlighting
 
-### 2.13.3 <small>_ September 1, 2021</small>
+### 2.13.3 <small>_ September 1, 2021</small> { id="2.13.3" }
 
 - Added support for disabling social card generation
 
-### 2.13.2 <small>_ August 25, 2021</small>
+### 2.13.2 <small>_ August 25, 2021</small> { id="2.13.2" }
 
 - Fixed #2965: Social plugin error when primary color is not defined
 
-### 2.13.1 <small>_ August 21, 2021</small>
+### 2.13.1 <small>_ August 21, 2021</small> { id="2.13.1" }
 
 - Fixed #2948: Social cards are not cached
 - Fixed #2953: Mermaid.js diagrams can't be centered anymore
 
-### 2.13.0 <small>_ August 7, 2021</small>
+### 2.13.0 <small>_ August 7, 2021</small> { id="2.13.0" }
 
 - Added support for custom colors in social cards
 
-### 2.12.2 <small>_ August 4, 2021</small>
+### 2.12.2 <small>_ August 4, 2021</small> { id="2.12.2" }
 
 - Fixed #2891: Division by zero error in social plugin
 
-### 2.12.1 <small>_ July 26, 2021</small>
+### 2.12.1 <small>_ July 26, 2021</small> { id="2.12.1" }
 
 - Fixed error in social plugin when `site_description` was not set
 - Fixed error in social plugin for non-ASCII characters
 
-### 2.12.0 <small>_ July 25, 2021</small>
+### 2.12.0 <small>_ July 25, 2021</small> { id="2.12.0" }
 
 - Added support for social cards
 
-### 2.11.1 <small>_ July 20, 2021</small>
+### 2.11.1 <small>_ July 20, 2021</small> { id="2.11.1" }
 
 - Fixed order of tags index, now sorted alphabetically
 
-### 2.11.0 <small>_ July 18, 2021</small>
+### 2.11.0 <small>_ July 18, 2021</small> { id="2.11.0" }
 
 - Improved Mermaid.js intergration, now stable
 - Added support for sequence diagrams
 - Added support for entity relationship diagrams
 - Added support for cookie consent configuration
 - Added feature flag to always enable annotations
 
-### 2.10.0 <small>_ July 10, 2021</small>
+### 2.10.0 <small>_ July 10, 2021</small> { id="2.10.0" }
 
 - Added support for cookie consent
 - Fixed #2807: Back-to-top button not hidden when using sticky tabs
 
-### 2.9.2 <small>_ May 30, 2021</small>
+### 2.9.2 <small>_ May 30, 2021</small> { id="2.9.2" }
 
 - Moved tags to partial for easier customization
 - Added support for hiding tags on any page
 
-### 2.9.1 <small>_ May 24, 2021</small>
+### 2.9.1 <small>_ May 24, 2021</small> { id="2.9.1" }
 
 - Added missing guard for linking of content tabs
 
-### 2.9.0 <small>_ May 23, 2021</small>
+### 2.9.0 <small>_ May 23, 2021</small> { id="2.9.0" }
 
 - Added support for linking of content tabs
 
-### 2.8.0 <small>_ May 12, 2021</small>
+### 2.8.0 <small>_ May 12, 2021</small> { id="2.8.0" }
 
 - Added support for boosting pages in search
 
-### 2.7.2 <small>_ May 8, 2021</small>
+### 2.7.2 <small>_ May 8, 2021</small> { id="2.7.2" }
 
 - Fixed #2638: Warnings shown when using `tags` plugin without directory URLs
 
-### 2.7.1 <small>_ May 3, 2021</small>
+### 2.7.1 <small>_ May 3, 2021</small> { id="2.7.1" }
 
 - Fixed `git-revision-date-localized` plugin integration (2.7.0 regression)
 
-### 2.7.0 <small>_ May 1, 2021</small>
+### 2.7.0 <small>_ May 1, 2021</small> { id="2.7.0" }
 
 - Added support for tags (with search integration)
 
-### 2.6.0 <small>_ April 11, 2021</small>
+### 2.6.0 <small>_ April 11, 2021</small> { id="2.6.0" }
 
 - Stay on page when switching versions
 
-### 2.5.0 <small>_ March 28, 2021</small>
+### 2.5.0 <small>_ March 28, 2021</small> { id="2.5.0" }
 
 - Added support for version warning
 
-### 2.4.0 <small>_ March 20, 2021</small>
+### 2.4.0 <small>_ March 20, 2021</small> { id="2.4.0" }
 
 - Added support for custom admonition icons
 - Fixed #2444: Code block annotations with extra comments have wrong index
 
-### 2.3.1 <small>_ March 14, 2021</small>
+### 2.3.1 <small>_ March 14, 2021</small> { id="2.3.1" }
 
 - Fixed anchor offset for permalinks when using sticky navigation tabs
 
-### 2.3.0 <small>_ March 13, 2021</small>
+### 2.3.0 <small>_ March 13, 2021</small> { id="2.3.0" }
 
 - Added support for back-to-top button
 
-### 2.2.1 <small>_ March 4, 2021</small>
+### 2.2.1 <small>_ March 4, 2021</small> { id="2.2.1" }
 
 - Fixed #2382: Repository stats failing when no release tag is present
 
-### 2.2.0 <small>_ February 28, 2021</small>
+### 2.2.0 <small>_ February 28, 2021</small> { id="2.2.0" }
 
 - Added support for code block annotations
 
-### 2.1.0 <small>_ February 26, 2021</small>
+### 2.1.0 <small>_ February 26, 2021</small> { id="2.1.0" }
 
 - Added support for anchor tracking
 
-### 2.0.0 <small>_ February 24, 2021</small>
+### 2.0.0 <small>_ February 24, 2021</small> { id="2.0.0" }
 
 - Migrated Insiders to the new architecture
 - Swapped color palette toggle configuration
 
-### 1.17.0 <small>_ January 31, 2021</small>
+### 1.17.0 <small>_ January 31, 2021</small> { id="1.17.0" }
 
 - Added support for section index pages
 
-### 1.16.1 <small>_ January 26, 2021</small>
+### 1.16.1 <small>_ January 26, 2021</small> { id="1.16.1" }
 
 - Fixed #2249: Instant loading + sticky tabs result in invalid links
 - Fixed #2248: Search highlighting URL parameter always added
 - Fixed #2235: Version selector doesn't select current version for aliases
 
-### 1.16.0 <small>_ January 7, 2021</small>
+### 1.16.0 <small>_ January 7, 2021</small> { id="1.16.0" }
 
 - Added latest release to repository info (GitHub)
 - Slight facelift of repository info (lighter fonts, spacing and icons)
 
-### 1.15.0 <small>_ January 2, 2021</small>
+### 1.15.0 <small>_ January 2, 2021</small> { id="1.15.0" }
 
 - Added support for native Mermaid.js integration
 
-### 1.14.0 <small>_ December 30, 2020</small>
+### 1.14.0 <small>_ December 30, 2020</small> { id="1.14.0" }
 
 - Added support for sharing searches
 
-### 1.13.2 <small>_ December 22, 2020</small>
+### 1.13.2 <small>_ December 22, 2020</small> { id="1.13.2" }
 
 - Fixed version selector + sticky tabs navigation rendering issues
 - Fixed version selector wrapping
 
-### 1.13.1 <small>_ December 20, 2020</small>
+### 1.13.1 <small>_ December 20, 2020</small> { id="1.13.1" }
 
 - Removed horizontal scrollbars on language and version selector
 - Fixed type conversion in JavaScript config
 
-### 1.13.0 <small>_ December 13, 2020</small>
+### 1.13.0 <small>_ December 13, 2020</small> { id="1.13.0" }
 
 - Refactored navigation tabs to simplify grouping behavior
 - Added support for sticky navigation tabs
 - Added support for arbitrary links in navigation tabs
 - Fixed #2098: Subsequent active subsection not highlighted correctly
 
-### 1.12.1 <small>_ December 8, 2020</small>
+### 1.12.1 <small>_ December 8, 2020</small> { id="1.12.1" }
 
 - Fixed empty language selector being shown
 
-### 1.12.0 <small>_ December 6, 2020</small>
+### 1.12.0 <small>_ December 6, 2020</small> { id="1.12.0" }
 
 - Added support for adding a language selector
 
-### 1.11.2 <small>_ November 29, 2020</small>
+### 1.11.2 <small>_ November 29, 2020</small> { id="1.11.2" }
 
 - Fixed #2068: Search highlight interprets code blocks as JavaScript
 
-### 1.11.1 <small>_ November 29, 2020</small>
+### 1.11.1 <small>_ November 29, 2020</small> { id="1.11.1" }
 
 - Refactored styling to be more stable and easier to adjust
 - Fixed some styling regressions from latest features
 
-### 1.11.0 <small>_ November 22, 2020</small>
+### 1.11.0 <small>_ November 22, 2020</small> { id="1.11.0" }
 
 - Added support for rendering admonitions as inline blocks
 
-### 1.10.0 <small>_ November 15, 2020</small>
+### 1.10.0 <small>_ November 15, 2020</small> { id="1.10.0" }
 
 - Added support for integrating table of contents into navigation
 
-### 1.9.0 <small>_ November 7, 2020</small>
+### 1.9.0 <small>_ November 7, 2020</small> { id="1.9.0" }
 
 - Added support for hiding navigation and table of contents on any page
 - Removed autohiding table of contents when empty
 
-### 1.8.0 <small>_ November 1, 2020</small>
+### 1.8.0 <small>_ November 1, 2020</small> { id="1.8.0" }
 
 - Added support for navigation sections
 - Fixed appearance of inactive search suggestions
 
-### 1.7.0 <small>_ October 25, 2020</small>
+### 1.7.0 <small>_ October 25, 2020</small> { id="1.7.0" }
 
 - Added support for deploying multiple versions
 - Fixed alignment of sidebar when content area is too small
 
-### 1.6.0 <small>_ October 11, 2020</small>
+### 1.6.0 <small>_ October 11, 2020</small> { id="1.6.0" }
 
 - Added support for search suggestions to save keystrokes
 - Added support for removing __Made with Material for MkDocs__ from footer
 - Fixed #1915: search should go to first result by pressing ++enter++
 
-### 1.5.1 <small>_ September 21, 2020</small>
+### 1.5.1 <small>_ September 21, 2020</small> { id="1.5.1" }
 
 - Fixed content area stretching to whole width for long code blocks
 
-### 1.5.0 <small>_ September 19, 2020</small>
+### 1.5.0 <small>_ September 19, 2020</small> { id="1.5.0" }
 
 - Added support for autohiding table of contents when empty
 
-### 1.4.1 <small>_ September 6, 2020</small>
+### 1.4.1 <small>_ September 6, 2020</small> { id="1.4.1" }
 
 - Improved typeahead and search result relevance and scoring
 
-### 1.4.0 <small>_ August 30, 2020</small>
+### 1.4.0 <small>_ August 30, 2020</small> { id="1.4.0" }
 
 - Added support for autohiding header on scroll
 
-### 1.3.0 <small>_ August 26, 2020</small>
+### 1.3.0 <small>_ August 26, 2020</small> { id="1.3.0" }
 
 - Added support for user-selectable color palettes
 
-### 1.2.0 <small>_ August 11, 2020</small>
+### 1.2.0 <small>_ August 11, 2020</small> { id="1.2.0" }
 
 - Added feature to expand navigation by default
 
-### 1.1.0 <small>_ August 3, 2020</small>
+### 1.1.0 <small>_ August 3, 2020</small> { id="1.1.0" }
 
 - Added highlighting of search results
 
-### 1.0.0 <small>_ July 14, 2020</small>
+### 1.0.0 <small>_ July 14, 2020</small> { id="1.0.0" }
 
 - Added grouping of search results
 - Added missing query terms to search result

docs/setup/setting-up-site-search.md

@@ -115,8 +115,9 @@ The following configuration options are supported:
 
 `prebuild_index`{ #search-prebuild-index }
 
-:   :octicons-milestone-24: Default: `false` · :octicons-archive-24: Deprecated
-    · :octicons-trash-24: 8.0.0 – MkDocs can generate a [prebuilt index] of all pages during
+:   [:octicons-tag-24: 7.2.0][prebuilt index support] · :octicons-archive-24:
+    Deprecated · :octicons-trash-24: 8.0.0 · :octicons-milestone-24: Default:
+    `false` – MkDocs can generate a [prebuilt index] of all pages during
     build time, which provides performance improvements at the cost of more
     bandwidth, as it reduces the build time of the search index:
 
@@ -145,6 +146,7 @@ them at your own risk.
   [lunr's default tokenizer]: https://github.com/olivernn/lunr.js/blob/aa5a878f62a6bba1e8e5b95714899e17e8150b38/lunr.js#L413-L456
   [site language]: changing-the-language.md#site-language
   [tokenizer lookahead]: #tokenizer-lookahead
+  [prebuilt index support]: https://github.com/squidfunk/mkdocs-material/releases/tag/5.0.0
   [prebuilt index]: https://www.mkdocs.org/user-guide/configuration/#prebuild_index
   [50% smaller]: ../blog/2021/search-better-faster-smaller.md#benchmarks