on gh-pages help sign in
searx/user/search_syntax.html
167 lines 7.8 kB history raw
2<!DOCTYPE html>
4<html>
5 <head>
6 <meta charset="utf-8" />
7 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
8 <meta name="viewport" content="width=device-width, initial-scale=1">
9 <title>Search syntax &#8212; Searx Documentation (Searx-1.0.0.tex)</title>
10 <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
11 <link rel="stylesheet" type="text/css" href="../_static/searx.css" />
12 <link rel="stylesheet" type="text/css" href="../_static/tabs.css" />
13 <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
14 <script src="../_static/jquery.js"></script>
15 <script src="../_static/underscore.js"></script>
16 <script src="../_static/doctools.js"></script>
17 <link rel="index" title="Index" href="../genindex.html" />
18 <link rel="search" title="Search" href="../search.html" />
19 <link rel="next" title="Why use a private instance?" href="own-instance.html" />
20 <link rel="prev" title="User documentation" href="index.html" />
21 </head><body>
22 <div class="related" role="navigation" aria-label="related navigation">
23 <h3>Navigation</h3>
24 <ul>
25 <li class="right" style="margin-right: 10px">
26 <a href="../genindex.html" title="General Index"
27 accesskey="I">index</a></li>
28 <li class="right" >
29 <a href="../py-modindex.html" title="Python Module Index"
30 >modules</a> |</li>
31 <li class="right" >
32 <a href="own-instance.html" title="Why use a private instance?"
33 accesskey="N">next</a> |</li>
34 <li class="right" >
35 <a href="index.html" title="User documentation"
36 accesskey="P">previous</a> |</li>
37 <li class="nav-item nav-item-0"><a href="../index.html">Searx Documentation (Searx-1.0.0.tex)</a> &#187;</li>
38 <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">User documentation</a> &#187;</li>
39 <li class="nav-item nav-item-this"><a href="">Search syntax</a></li>
40 </ul>
41 </div>
43 <div class="document">
44 <div class="documentwrapper">
45 <div class="bodywrapper">
46 <div class="body" role="main">
48 <div class="section" id="search-syntax">
49<span id="id1"></span><h1>Search syntax<a class="headerlink" href="#search-syntax" title="Permalink to this headline">¶</a></h1>
50<p>Searx allows you to modify the default categories, engines and search language
51via the search query.</p>
52<dl class="simple">
53<dt>Prefix <code class="docutils literal notranslate"><span class="pre">!</span></code></dt><dd><p>to set Category/engine</p>
54</dd>
55<dt>Prefix: <code class="docutils literal notranslate"><span class="pre">:</span></code></dt><dd><p>to set language</p>
56</dd>
57<dt>Prefix: <code class="docutils literal notranslate"><span class="pre">?</span></code></dt><dd><p>to add engines and categories to the currently selected categories</p>
58</dd>
59</dl>
60<p>Abbrevations of the engines and languages are also accepted. Engine/category
61modifiers are chainable and inclusive (e.g. with <a class="reference external" href="/?q=%21it%20%21ddg%20%21wp%20qwer">!it !ddg !wp qwer</a> search in IT category <strong>and</strong> duckduckgo
62<strong>and</strong> wikipedia for <code class="docutils literal notranslate"><span class="pre">qwer</span></code>).</p>
63<p>See the <a class="reference external" href="/preferences">/preferences page</a> for the list of engines,
64categories and languages.</p>
65<div class="section" id="examples">
66<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
67<p>Search in wikipedia for <code class="docutils literal notranslate"><span class="pre">qwer</span></code>:</p>
68<ul class="simple">
69<li><p><a class="reference external" href="/?q=%21wp%20qwer">!wp qwer</a> or</p></li>
70<li><p><a class="reference external" href="/?q=%21wikipedia%20qwer">!wikipedia qwer :search:</a></p></li>
71</ul>
72<p>Image search:</p>
73<ul class="simple">
74<li><p><a class="reference external" href="/?q=%21images%20Cthulhu">!images Cthulhu</a></p></li>
75</ul>
76<p>Custom language in wikipedia:</p>
77<ul class="simple">
78<li><p><a class="reference external" href="/?q=%3Ahu%20%21wp%20hackerspace">:hu !wp hackerspace</a></p></li>
79</ul>
80</div>
81<div class="section" id="multilingual-search">
82<h2>Multilingual Search<a class="headerlink" href="#multilingual-search" title="Permalink to this headline">¶</a></h2>
83<p>Searx does not support true multilingual search.
84You have to use the language prefix in your search query when searching in a different language.</p>
85<p>But there is a workaround:
86By adding a new search engine with a different language, Searx will search in your default and other language.</p>
87<dl>
88<dt>Example configuration in settings.yml for a German and English speaker:</dt><dd><div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">search</span><span class="p">:</span>
89 <span class="nt">language </span><span class="p">:</span> <span class="s">&quot;de&quot;</span>
90 <span class="l l-Scalar l-Scalar-Plain">...</span>
92<span class="nt">engines</span><span class="p">:</span>
93 <span class="p p-Indicator">-</span> <span class="nt">name </span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">google english</span>
94 <span class="nt">engine </span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">google</span>
95 <span class="nt">language </span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">english</span>
96 <span class="l l-Scalar l-Scalar-Plain">...</span>
97</pre></div>
98</div>
99</dd>
100</dl>
101<p>When searching, the default google engine will return German results and “google english” will return English results.</p>
102</div>
103</div>
106 <div class="clearer"></div>
107 </div>
108 </div>
109 </div>
110 <span id="sidebar-top"></span>
111 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
112 <div class="sphinxsidebarwrapper">
115 <p class="logo"><a href="../index.html">
116 <img class="logo" src="../_static/searx_logo_small.png" alt="Logo"/>
117 </a></p>
120 <h3>Project Links</h3>
121 <ul>
122 <li><a href="blog/index.html">Blog</a>
124 <li><a href="https://github.com/searx/searx">Source</a>
126 <li><a href="https://github.com/searx/searx/wiki">Wiki</a>
128 <li><a href="https://searx.space">Public instances</a>
130 <li><a href="https://twitter.com/Searx_engine">Twitter</a>
132 <li><a href="https://github.com/searx/searx/issues">Issue Tracker</a>
133 </ul><h3>Navigation</h3>
134<ul>
135 <li><a href="../index.html">Overview</a>
136 <ul>
137 <li><a href="index.html">User documentation</a>
138 <ul>
139 <li>Previous: <a href="index.html" title="previous chapter">User documentation</a>
140 <li>Next: <a href="own-instance.html" title="next chapter">Why use a private instance?</a></ul>
141 </li>
142 </ul>
143 </li>
144</ul>
145<div id="searchbox" style="display: none" role="search">
146 <h3 id="searchlabel">Quick search</h3>
147 <div class="searchformwrapper">
148 <form class="search" action="../search.html" method="get">
149 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
150 <input type="submit" value="Go" />
151 </form>
152 </div>
153</div>
154<script>$('#searchbox').show(0);</script>
155 </div>
156 </div>
157 <div class="clearer"></div>
158 </div>
160 <div class="footer" role="contentinfo">
161 &#169; Copyright 2015-2021, Adam Tauber, Noémi Ványi.
162 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.3.2.
163 </div>
164 <script src="../_static/version_warning_offset.js"></script>
166 </body>
167</html>