|
@@ -1,64 +1,64 @@
|
|
# Search syntax
|
|
# Search syntax
|
|
|
|
|
|
-SearXNG comes with a search syntax by with you can modify the categories,
|
|
|
|
-engines, languages and more. See the {{link('preferences', 'preferences')}} for
|
|
|
|
-the list of engines, categories and languages.
|
|
|
|
|
|
+SearXNG comes with a search syntax by which you can modify the categories,
|
|
|
|
+engines, languages, and more. See the {{link('preferences', 'preferences')}} for
|
|
|
|
+the list of engines, categories, and languages.
|
|
|
|
|
|
-## `!` select engine and category
|
|
|
|
|
|
+## `!` Select engine and category
|
|
|
|
|
|
-To set category and/or engine names use a `!` prefix. To give a few examples:
|
|
|
|
|
|
+To set category and/or engine names, use a `!` prefix. To give a few examples:
|
|
|
|
|
|
-- search in Wikipedia for **paris**
|
|
|
|
|
|
+- Search Wikipedia for **paris**:
|
|
|
|
|
|
- {{search('!wp paris')}}
|
|
- {{search('!wp paris')}}
|
|
- {{search('!wikipedia paris')}}
|
|
- {{search('!wikipedia paris')}}
|
|
|
|
|
|
-- search in category **map** for **paris**
|
|
|
|
|
|
+- Search in category **map** for **paris**:
|
|
|
|
|
|
- {{search('!map paris')}}
|
|
- {{search('!map paris')}}
|
|
|
|
|
|
-- image search
|
|
|
|
|
|
+- Image search
|
|
|
|
|
|
- {{search('!images Wau Holland')}}
|
|
- {{search('!images Wau Holland')}}
|
|
|
|
|
|
Abbreviations of the engines and languages are also accepted. Engine/category
|
|
Abbreviations of the engines and languages are also accepted. Engine/category
|
|
-modifiers are chain able and inclusive. E.g. with {{search('!map !ddg !wp
|
|
|
|
-paris')}} search in map category and DuckDuckGo and Wikipedia for **paris**.
|
|
|
|
|
|
+modifiers are chainable and inclusive. For example, {{search('!map !ddg !wp
|
|
|
|
+paris')}} searches in the map category and searches DuckDuckGo and Wikipedia for **paris**.
|
|
|
|
|
|
-## `:` select language
|
|
|
|
|
|
+## `:` Select language
|
|
|
|
|
|
-To select language filter use a `:` prefix. To give an example:
|
|
|
|
|
|
+To select a language filter use a `:` prefix. To give an example:
|
|
|
|
|
|
-- search Wikipedia by a custom language
|
|
|
|
|
|
+- Search Wikipedia with a custom language:
|
|
|
|
|
|
- {{search(':fr !wp Wau Holland')}}
|
|
- {{search(':fr !wp Wau Holland')}}
|
|
|
|
|
|
-## `!!<bang>` external bangs
|
|
|
|
|
|
+## `!!<bang>` External bangs
|
|
|
|
|
|
SearXNG supports the external bangs from [DuckDuckGo]. To directly jump to a
|
|
SearXNG supports the external bangs from [DuckDuckGo]. To directly jump to a
|
|
external search page use the `!!` prefix. To give an example:
|
|
external search page use the `!!` prefix. To give an example:
|
|
|
|
|
|
-- search Wikipedia by a custom language
|
|
|
|
|
|
+- Search Wikipedia with a custom language:
|
|
|
|
|
|
- {{search('!!wfr Wau Holland')}}
|
|
- {{search('!!wfr Wau Holland')}}
|
|
|
|
|
|
-Please note, your search will be performed directly in the external search
|
|
|
|
-engine, SearXNG cannot protect your privacy on this.
|
|
|
|
|
|
+Please note that your search will be performed directly in the external search
|
|
|
|
+engine. SearXNG cannot protect your privacy with this.
|
|
|
|
|
|
[DuckDuckGo]: https://duckduckgo.com/bang
|
|
[DuckDuckGo]: https://duckduckgo.com/bang
|
|
|
|
|
|
## `!!` automatic redirect
|
|
## `!!` automatic redirect
|
|
|
|
|
|
-When mentioning `!!` within the search query (separated by spaces), you will
|
|
|
|
|
|
+When including `!!` within your search query (separated by spaces), you will
|
|
automatically be redirected to the first result. This behavior is comparable to
|
|
automatically be redirected to the first result. This behavior is comparable to
|
|
the "Feeling Lucky" feature from DuckDuckGo. To give an example:
|
|
the "Feeling Lucky" feature from DuckDuckGo. To give an example:
|
|
|
|
|
|
-- search for a query and get redirected to the first result
|
|
|
|
|
|
+- Search for a query and get redirected to the first result
|
|
|
|
|
|
- {{search('!! Wau Holland')}}
|
|
- {{search('!! Wau Holland')}}
|
|
|
|
|
|
-Please keep in mind that the result you are being redirected to can't become
|
|
|
|
-verified for being trustworthy, SearXNG cannot protect your personal privacy
|
|
|
|
|
|
+Please keep in mind that the result you are being redirected to can't be
|
|
|
|
+verified for trustworthiness and SearXNG cannot protect your personal privacy
|
|
when using this feature. Use it at your own risk.
|
|
when using this feature. Use it at your own risk.
|
|
|
|
|
|
## Special Queries
|
|
## Special Queries
|
|
@@ -66,19 +66,19 @@ when using this feature. Use it at your own risk.
|
|
In the {{link('preferences', 'preferences')}} page you find keywords for
|
|
In the {{link('preferences', 'preferences')}} page you find keywords for
|
|
_special queries_. To give a few examples:
|
|
_special queries_. To give a few examples:
|
|
|
|
|
|
-- generate a random UUID
|
|
|
|
|
|
+- Generate a random UUID
|
|
|
|
|
|
- {{search('random uuid')}}
|
|
- {{search('random uuid')}}
|
|
|
|
|
|
-- find the average
|
|
|
|
|
|
+- Find the average
|
|
|
|
|
|
- {{search('avg 123 548 2.04 24.2')}}
|
|
- {{search('avg 123 548 2.04 24.2')}}
|
|
|
|
|
|
-- show _user agent_ of your browser (needs to be activated)
|
|
|
|
|
|
+- Show the _user agent_ of your browser (needs to be activated)
|
|
|
|
|
|
- {{search('user-agent')}}
|
|
- {{search('user-agent')}}
|
|
|
|
|
|
-- convert strings to different hash digests (needs to be activated)
|
|
|
|
|
|
+- Convert strings to different hash digests (needs to be activated)
|
|
|
|
|
|
- {{search('md5 lorem ipsum')}}
|
|
- {{search('md5 lorem ipsum')}}
|
|
- {{search('sha512 lorem ipsum')}}
|
|
- {{search('sha512 lorem ipsum')}}
|