searxng/docs/user/search_syntax.rst
Markus Heiser e32979aa3e [docs] update_external_bangs.py - implement script to document bangs
Function 'write_external_bang_doc(..)' generates documentation of the external
bangs in folder 'docs/admin/external_bang'.  Ducumentation will be update when
external bangs are updated::

    ./manage pyenv.cmd searx_extra/update/update_external_bangs.py

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2021-06-17 13:51:26 +02:00

74 lines
1.9 KiB
ReStructuredText

.. _search-syntax:
=============
Search syntax
=============
Searx allows you to modify the default categories, engines and search language
via the search query.
Prefix ``!``
to set category or :ref:`engine <configured engines>`
Prefix: ``!!``
to take you to search results on other sites (also know as :ref:`bang <external bang>`)
Prefix: ``:``
to set language
Prefix: ``?``
to add :ref:`engines <configured engines>` and categories to the
currently selected categories
Abbrevations of the engines and languages are also accepted. Engine/category
modifiers are chainable and inclusive (e.g. with :search:`!it !ddg !wp qwer
<?q=%21it%20%21ddg%20%21wp%20qwer>` search in IT category **and** duckduckgo
**and** wikipedia for ``qwer``).
See the :search:`/preferences page <preferences>` for the list of engines,
categories and languages.
Examples
========
*Bang* take you to search results on Wikipedia:
- :search:`!!w gallileo <?q=%21%21w%20gallileo>`
Search in wikipedia for ``qwer``:
- :search:`!wp qwer <?q=%21wp%20qwer>` or
- :search:`!wikipedia qwer :search:<?q=%21wikipedia%20qwer>`
Image search:
- :search:`!images Cthulhu <?q=%21images%20Cthulhu>`
Custom language in wikipedia:
- :search:`:hu !wp hackerspace <?q=%3Ahu%20%21wp%20hackerspace>`
Multilingual Search
===================
Searx does not support true multilingual search.
You have to use the language prefix in your search query when searching in a different language.
But there is a workaround:
By adding a new search engine with a different language, Searx will search in your default and other language.
Example configuration in settings.yml for a German and English speaker:
.. code-block:: yaml
search:
language : "de"
...
engines:
- name : google english
engine : google
language : english
...
When searching, the default google engine will return German results and "google english" will return English results.