Disable search indexing for local documentation builds #6807

Closed
opened 2025-12-29 19:45:39 +01:00 by adam · 0 comments
Owner

Originally created by @jeremystretch on GitHub (Aug 12, 2022).

Originally assigned to: @jeremystretch on GitHub.

Change Type

Cleanup (formatting, typos, etc.)

Area

Other

Proposed Changes

I've noticed that when searching for NetBox documentation topics, search engines often return results pointing to the documentation hosted on our public demo instances in addition to the "correct" results on ReadTheDocs. This because the complete documentation is accessible locally on each NetBox deployment, and our public demo instance is open to the Internet.

We should be able to override the base HTML template used by mkdocs to render the documentation and inject a meta tag that instructs search engines not to index the page. However, as we obviously do want them to continue indexing ReadTheDocs, we'll need to introduce some variable to toggle this on and off.

Originally created by @jeremystretch on GitHub (Aug 12, 2022). Originally assigned to: @jeremystretch on GitHub. ### Change Type Cleanup (formatting, typos, etc.) ### Area Other ### Proposed Changes I've noticed that when searching for NetBox documentation topics, search engines often return results pointing to the documentation hosted on our public demo instances in addition to the "correct" results on ReadTheDocs. This because the complete documentation is accessible locally on each NetBox deployment, and our public demo instance is open to the Internet. We should be able to override the base HTML template used by mkdocs to render the documentation and inject a meta tag that instructs search engines not to index the page. However, as we obviously _do_ want them to continue indexing ReadTheDocs, we'll need to introduce some variable to toggle this on and off.
adam added the status: acceptedtype: documentation labels 2025-12-29 19:45:39 +01:00
adam closed this issue 2025-12-29 19:45:39 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#6807