PowerDNS / pdns

PowerDNS Authoritative, PowerDNS Recursor, dnsdist
https://www.powerdns.com/
GNU General Public License v2.0
3.7k stars 908 forks source link

Doc site: sphinx tuning needed? #11049

Open franklouwers opened 2 years ago

franklouwers commented 2 years ago

Short description

The search engine on the auth/rec documentation site, might need some love and tuning. It doesn't return any hits when searching for the config parameters for instance.

Environment

Any web browser

Steps to reproduce

  1. On the auth doc site, search for any-to-tcp. https://doc.powerdns.com/authoritative/search.html?q=any-to-tcp&check_keywords=yes&area=default
  2. On the resolver doc site, search for client-tcp-timeout. https://doc.powerdns.com/recursor/search.html?q=client-tcp-timeout&check_keywords=yes&area=default

Expected behaviour

  1. Show https://doc.powerdns.com/authoritative/settings.html#any-to-tcp as the first result
  2. Show https://doc.powerdns.com/recursor/settings.html#client-tcp-timeout as the first result

Actual behaviour

  1. No results
  2. No results

Other information

update: seems to happen on parameters with dashes in them only.

omoerbeek commented 2 years ago

What seems to be happening is that search terms containing dashes get split up. If the words then are common, the settings results get buried. Is there a way to avoid the splitting on dashes?

pieterlexis commented 2 years ago

I think we might need to write some javascript: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_search_scorer