{% extends 'base.html' %}
{% block content %}
{% include 'github_ribbon.html' %}
<div class="row">
    <h1>About <a href="/">searx</a></h1>

    <p>Searx is a <a href="https://en.wikipedia.org/wiki/Metasearch_engine">metasearch engine</a> inspired by the <a href="http://seeks-project.info/">seeks-project</a>.
    <br />It tries to provide basic privacy by mixing your queries with those from others while avoiding storing search data. For all browsers (except chrom*) queries are made using a POST request. Thus they don't show up in our logs, nor in your url history. For Chrom* users there is an exception, searx is used from the search bar, it issues GET requests.
    <br />You can add it to your browsers search bar and even make it your default search engine.
    </p>
    <h2>What makes searx different</h2>
    <ul>
        <li>No ads - searx is Free Software (free-as-in-freedom), funded by your donations</li>
        <li>Privacy - tries to minimalize the digital footprint of the searches</li>
        <li>Optionally self hosted - see the <a href="#faq">FAQ</a></li>
        <li>Easy to add new engines/categories</li>
    </ul>

<h2>Engines</h2>

{% for (categ,search_engines) in categs %}
    <h3>{{ categ.capitalize() }}</h3>
    <ul>
        {% for search_engine in search_engines %}
            {% if not search_engine.private %}
                <li>{{ search_engine.name }}</li>
            {% endif %}
        {% endfor %}
    </ul>
{% endfor %}
<p>Please add more engines to this list, pull requests are welcome!</p>

<h2><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Running public instances</a></h2>

<h2 id="faq">FAQ</h2>
<h3>Trust</h3>
<p>It's ok if you don't trust us regarding the logs, <a href="https://github.com/asciimoo/searx">take the code</a> and run it yourself! decentralize!</p>
<h3>How to add to firefox?</h3>
<p><a href="#" onclick="window.external.AddSearchProvider(window.location.protocol + '//' + window.location.host + '/opensearch.xml')">Install</a> searx as a search engine on any version of Firefox! (javascript required)</p>
<h2 id="dev_faq">Developer FAQ</h2>
<h3>New engines?</h3>
<ul>
    <li>Edit your engines.cfg, see <a href="https://raw.github.com/asciimoo/searx/master/engines.cfg_sample">sample config</a></li>
    <li>Create your custom engine module, check the <a href="https://github.com/asciimoo/searx/blob/master/examples/basic_engine.py">example engine</a></li>
</ul>
<p>Don't forget to restart searx after config edit!</p>
<h3>WSGI support?</h3>
<p><a href="https://about.okhin.fr/posts/Searx/">Okhin wrote</a> a great and detailed article about the setup.</p>
<h3>How to debug engines?</h3>
<p><a href="/stats">Stats page</a> contains some useful data about the used engines.</p>
</div>
{% endblock %}