mkdocs-material/blog/2021/search-better-faster-smaller/

[giscus[bot]]

mkdocs-material/blog/2021/search-better-faster-smaller/

How we rebuilt client-side search, delivering a better user experience while making it faster and smaller at the same time

https://squidfunk.github.io/mkdocs-material/blog/2021/search-better-faster-smaller/

[squidfunk]

Comments are enabled again - we switched to giscus.app, a much better solution than Disqus, as it's ad-free and uses GitHub discussions as a backend.

[tahamaddam]

If I apply giscus site-wide, will it provide unique comment section on each page (like in Disqus)?

[squidfunk]

Yes.

[Andre601]

It primarely depends on what your configuration is for how it should "search" for discussions.
Best option would probably be URL, as that is the most guaranteed to be unique...

[tahamaddam]

It primarely depends on what your configuration is for how it should "search" for discussions.
Best option would probably be URL, as that is the most guaranteed to be unique...

Would you please explain this? I am using this article as a reference https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/

[Andre601]

From https://giscus.app

[ms2art]

I'm seeing repeated "Initializing search" messages in the search pop-up as I navigate to different pages in my documentation. Each time search initializes, there's about a 17 second wait before I can enter a search term. I'm using the navigation.instant feature, but it doesn't help. Is this an okay place to ask for help? In case I'm doing something weird in mkdocs.yml, here's what my file looks like, exclusive of the nav section, which lists about 7000 topics. Thanks for any insights.

site_name: 'My Documentation'
docs_dir: source/docs/documentation
site_dir: docs
use_directory_urls: false

theme:
name: material
features:
- navigation.instant

markdown_extensions:

• md_in_html

plugins:

• section-index
• search

[squidfunk]

Please create an new issue with a minimal reproducible example. I'll look into it then.