summaryrefslogtreecommitdiff
path: root/docs/user/search_syntax.rst
diff options
context:
space:
mode:
authorAdam Tauber <asciimoo@gmail.com>2019-12-16 11:41:49 +0000
committerGitHub <noreply@github.com>2019-12-16 11:41:49 +0000
commitfb6ff5afcb1ec5771bc149fee25d186198aa7607 (patch)
tree93d214f4039bea8aa42d8713bc3c2b35d38465ad /docs/user/search_syntax.rst
parent3f93fe04d8c43191cc3bff51c9add1c35728c789 (diff)
parent02d5173fb23dfcba02634e2765bf7fd91e3d0437 (diff)
Merge pull request #1767 from return42/docs
move reST source from gh-pages to master
Diffstat (limited to 'docs/user/search_syntax.rst')
-rw-r--r--docs/user/search_syntax.rst42
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/user/search_syntax.rst b/docs/user/search_syntax.rst
new file mode 100644
index 000000000..b738c7274
--- /dev/null
+++ b/docs/user/search_syntax.rst
@@ -0,0 +1,42 @@
+
+.. _search-syntax:
+
+=============
+Search syntax
+=============
+
+Searx allows you to modify the default categories, engines and search language
+via the search query.
+
+Prefix ``!``
+ to set Category/engine
+
+Prefix: ``:``
+ to set language
+
+Prefix: ``?``
+ to add 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
+========
+
+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>`