Hi Why making it complicated? Every version can get renedered independently, copies in /v$version folder and the versions.json index computed there or maintained with release process and some JS in the layout to list versions?
Romain Manni-Bucau @rmannibucau <https://x.com/rmannibucau> | .NET Blog <https://dotnetbirdie.github.io/> | Blog <https://rmannibucau.github.io/> | Old Blog <http://rmannibucau.wordpress.com> | Github <https://github.com/rmannibucau> | LinkedIn <https://www.linkedin.com/in/rmannibucau> | Book <https://www.packtpub.com/en-us/product/java-ee-8-high-performance-9781788473064> Javaccino founder (Java/.NET service - contact via linkedin) Le jeu. 14 mai 2026, 19:43, Max Konstantinov <[email protected]> a écrit : > I was considering mkdocs-exclude-search option but was unsure about using > such a niche custom library, whether it's abandoned, and if it won't break > in the future with updates to mkdocs or mkdocs-material. Given that the > same results could be build on the top of standard mkdocs-material > functionality. > > On Thu, May 14, 2026 at 9:59 AM Kevin Liu <[email protected]> wrote: > >> mkdocs-exclude-search (https://github.com/chrieke/mkdocs-exclude-search) >> seems promising >> >> We can try something like this to exclude all the versioned paths: >> ``` >> plugins: >> - search >> - exclude-search: >> exclude: >> - "*/[0-9]*/**" >> ``` >> >> Note that nightly and latest are symlinks. >> >> >> >> >> On Thu, May 14, 2026 at 9:54 AM Kevin Liu <[email protected]> wrote: >> >>> +1 to only indexing the latest/nightly >>> mkdoc is using the `search` plugin [1]. And like you mentioned, we can >>> use its `exclude ` property to configure exclusion paths. >>> >>> >>> > Is there a way we can add a Version dropdown to the search? "Latests, >>> 1.11, etc ...." >>> >>> I've looked into this before, the best solution I found is to migrate >>> over to `mike` (see the tracking issue >>> https://github.com/apache/iceberg/issues/14521) It's a lot of work >>> though and I didn't want to risk breaking the site. >>> >>> Best, >>> Kevin Liu >>> >>> >>> [1] >>> https://github.com/apache/iceberg/blob/87a7e4b13470b238e86872e5b194b80c3a89a80f/site/mkdocs.yml#L51 >>> [2] >>> https://squidfunk.github.io/mkdocs-material/plugins/search/#meta.search.exclude >>> >>> >>> >>> On Thu, May 14, 2026 at 9:33 AM Max Konstantinov < >>> [email protected]> wrote: >>> >>>> That was my first idea too. I did some research and it seems it will be >>>> more complicated to implement and might require an overhaul of the site >>>> build process or/and site structure. Let me look into that again and get >>>> back with an overview of potential changes. >>>> >>>> On Thu, May 14, 2026 at 9:13 AM Russell Spitzer < >>>> [email protected]> wrote: >>>> >>>>> Is there a way we can add a Version dropdown to the search? "Latests, >>>>> 1.11, etc ...." >>>>> >>>>> On Thu, May 14, 2026 at 10:26 AM Max Konstantinov < >>>>> [email protected]> wrote: >>>>> >>>>>> I looked into options for resolving that and the easiest solution I >>>>>> found is to exclude all md files from search for all Icerbrg >>>>>> documentation >>>>>> versions, except for the just one, nightly probably being the best >>>>>> candidate as it is a defult landing version of documentation. That can be >>>>>> achieved by adding a mkdocs-material's YAML frontmatter property to md >>>>>> files during the site build process: >>>>>> >>>>>> --- >>>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-2>search: >>>>>> >>>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-3> >>>>>> exclude: true >>>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-4>--- >>>>>> >>>>>> >>>>>> >>>>>> On Thu, May 14, 2026 at 1:39 AM Robin Moffatt via dev < >>>>>> [email protected]> wrote: >>>>>> >>>>>>> I agree, the current behaviour is not ideal for the end-user. The >>>>>>> results don't indicate the version either so you end up with literal >>>>>>> duplicates: >>>>>>> [image: CleanShot 2026-05-14 at [email protected]] >>>>>>> >>>>>>> On Thu, 14 May 2026 at 07:17, Max Konstantinov < >>>>>>> [email protected]> wrote: >>>>>>> >>>>>>>> Hi all, >>>>>>>> >>>>>>>> >>>>>>>> Problem statement >>>>>>>> If you open https://iceberg.apache.org/ >>>>>>>> <https://urldefense.com/v3/__https://iceberg.apache.org/__;!!Ayb5sqE7!oRqHG1ZbjiQCzTf4geY7acwJ5T348ItdBhCxA93gVPFAC7C6I6nQHtkpxvkEN1zEBSfkq7BdqNaJnYBf6wfaUGD1HAZo$> >>>>>>>> and >>>>>>>> use a search bar to look for anything, ex: "rewrite", you get >>>>>>>> duplicated >>>>>>>> results because results(ex: rewrite_table_path) are found multiple >>>>>>>> times, >>>>>>>> once for each version of Iceberg documentation(1.4 to 1.10), all these >>>>>>>> versions are present on the website under the previous section in the >>>>>>>> navigation tab and all of them are indexed. >>>>>>>> >>>>>>>> Question >>>>>>>> Is that a bug and does it need to be addressed? I have a suggestion >>>>>>>> on how to approach this. >>>>>>>> >>>>>>>> Notes >>>>>>>> Iceberg's site build uses mkdocs and mkdocs-material which in turn >>>>>>>> utilize lunrjs for search. >>>>>>>> >>>>>>>> >>>>>>>> Max. >>>>>>>> >>>>>>> >>>>>>> >>>>>>>
