search_syntax.rst 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. .. _search-syntax:
  2. =============
  3. Search syntax
  4. =============
  5. Searx allows you to modify the default categories, engines and search language
  6. via the search query.
  7. Prefix ``!``
  8. to set Category/engine
  9. Prefix: ``:``
  10. to set language
  11. Prefix: ``?``
  12. to add engines and categories to the currently selected categories
  13. Abbreviations of the engines and languages are also accepted. Engine/category
  14. modifiers are chainable and inclusive (e.g. with :search:`!it !ddg !wp qwer
  15. <?q=%21it%20%21ddg%20%21wp%20qwer>` search in IT category **and** duckduckgo
  16. **and** wikipedia for ``qwer``).
  17. See the :search:`/preferences page <preferences>` for the list of engines,
  18. categories and languages.
  19. Examples
  20. ========
  21. Search in wikipedia for ``qwer``:
  22. - :search:`!wp qwer <?q=%21wp%20qwer>` or
  23. - :search:`!wikipedia qwer :search:<?q=%21wikipedia%20qwer>`
  24. Image search:
  25. - :search:`!images Cthulhu <?q=%21images%20Cthulhu>`
  26. Custom language in wikipedia:
  27. - :search:`:hu !wp hackerspace <?q=%3Ahu%20%21wp%20hackerspace>`
  28. Multilingual Search
  29. ===================
  30. Searx does not support true multilingual search.
  31. You have to use the language prefix in your search query when searching in a different language.
  32. But there is a workaround:
  33. By adding a new search engine with a different language, Searx will search in your default and other language.
  34. Example configuration in settings.yml for a German and English speaker:
  35. .. code-block:: yaml
  36. search:
  37. language : "de"
  38. ...
  39. engines:
  40. - name : google english
  41. engine : google
  42. language : english
  43. ...
  44. When searching, the default google engine will return German results and "google english" will return English results.