Merge pull request #879 from kvch/gh-pages

[doc] bump version to 0.11 && rewrite Translation page
2025-02-23 07:07:42 +01:00 · 2017-03-19 00:16:47 +01:00 · 2017-03-19 00:16:47 +01:00 · 99ad8db26f
commit 99ad8db26f
parent f4b418175c e149103e11
19 changed files with 148 additions and 204 deletions
--- a/_sources/dev/translation.txt
+++ b/_sources/dev/translation.txt
@ -1,80 +1,61 @@
 Translation
 ===========

-run these commands in the root directory of searx
+Requirements
+------------

-Add new language
-~~~~~~~~~~~~~~~~
+ * Transifex account

-.. code:: shell
+ * Installed CLI tool of Transifex

-    pybabel init -i messages.pot -d searx/translations -l it
+Init Transifex project
+----------------------

-Update .po files
-~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    ./utils/update-translations.sh
-
-You may have errors here. In that case, edit the
-``update-translations.sh`` script to change ``pybabel`` to
-``pybabel-python2`` or ``pybabel2``
-
-After this step, you can modify the .po files.
-
-Compile translations
-~~~~~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    pybabel compile -d searx/translations
-
-Transifex stuff
-~~~~~~~~~~~~~~~
-
-Init Project
-^^^^^^^^^^^^
+After installing ``transifex`` using pip, run the following command to initialize the project.

 .. code:: shell

    tx init # Transifex instance: https://www.transifex.com/asciimoo/searx/

+
+After ``$HOME/.transifexrc`` is created, get a Transifex API key and insert it into the configuration file.
+
+Create a configuration file for ``tx`` named ``$HOME/.tx/config``.
+
+.. code:: shell
+
+    [main]
+    host = https://www.transifex.com
+    [searx.messagespo]
+    file_filter = searx/translations/<lang>/LC_MESSAGES/messages.po
+    source_file = messages.pot
+    source_lang = en
+    type = PO
+
+
+Then run ``tx set``:
+
+.. code:: shell
+
    tx set --auto-local -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \
    --source-lang en --type PO --source-file messages.pot --execute

-http://docs.transifex.com/client/init/

-http://docs.transifex.com/client/set/
+Update translations
+-------------------

-Get translations
-^^^^^^^^^^^^^^^^
+To retrieve the latest translations, pull it from Transifex.

 .. code:: shell

    tx pull -a

-http://docs.transifex.com/client/pull
-
-Upload source File
-^^^^^^^^^^^^^^^^^^
+Then check the new languages. If strings translated are not enough, delete those folders, because
+those should not be compiled. Call the command below to compile the ``.po`` files.

 .. code:: shell

-    tx push -s
+    pybabel compile -d searx/translations

-Upload all Translation
-^^^^^^^^^^^^^^^^^^^^^^

-.. code:: shell
-
-    tx push -s -t
-
-upload specifc Translation
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    tx push -t -l tr
-
-http://docs.transifex.com/client/push
+After the compilation is finished commit the ``.po`` and ``.mo`` files and create a PR.
--- a/admin/api.html
+++ b/admin/api.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Administration API &#8212; searx 0.10.0 documentation</title>
+    <title>Administration API &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="How to protect an instance" href="filtron.html" />
    <link rel="prev" title="Installation" href="../dev/install/installation.html" />
   
--- a/admin/filtron.html
+++ b/admin/filtron.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>How to protect an instance &#8212; searx 0.10.0 documentation</title>
+    <title>How to protect an instance &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Development Quickstart" href="../dev/quickstart.html" />
    <link rel="prev" title="Administration API" href="api.html" />
   
--- a/dev/contribution_guide.html
+++ b/dev/contribution_guide.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>How to contribute &#8212; searx 0.10.0 documentation</title>
+    <title>How to contribute &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Engine overview" href="engine_overview.html" />
    <link rel="prev" title="Development Quickstart" href="quickstart.html" />
   
--- a/dev/engine_overview.html
+++ b/dev/engine_overview.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Engine overview &#8212; searx 0.10.0 documentation</title>
+    <title>Engine overview &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Search API" href="search_api.html" />
    <link rel="prev" title="How to contribute" href="contribution_guide.html" />
   
--- a/dev/install/installation.html
+++ b/dev/install/installation.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Installation &#8212; searx 0.10.0 documentation</title>
+    <title>Installation &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../../genindex.html" />
    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../../index.html" />
    <link rel="next" title="Administration API" href="../../admin/api.html" />
    <link rel="prev" title="Why use a private instance?" href="../../user/own-instance.html" />
   
--- a/dev/plugins.html
+++ b/dev/plugins.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Plugins &#8212; searx 0.10.0 documentation</title>
+    <title>Plugins &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Translation" href="translation.html" />
    <link rel="prev" title="Search API" href="search_api.html" />
   
--- a/dev/quickstart.html
+++ b/dev/quickstart.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Development Quickstart &#8212; searx 0.10.0 documentation</title>
+    <title>Development Quickstart &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="How to contribute" href="contribution_guide.html" />
    <link rel="prev" title="How to protect an instance" href="../admin/filtron.html" />
   
--- a/dev/search_api.html
+++ b/dev/search_api.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Search API &#8212; searx 0.10.0 documentation</title>
+    <title>Search API &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Plugins" href="plugins.html" />
    <link rel="prev" title="Engine overview" href="engine_overview.html" />
   
--- a/dev/translation.html
+++ b/dev/translation.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Translation &#8212; searx 0.10.0 documentation</title>
+    <title>Translation &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="prev" title="Plugins" href="plugins.html" />
   
  
@ -42,68 +42,50 @@
            
  <div class="section" id="translation">
 <h1>Translation<a class="headerlink" href="#translation" title="Permalink to this headline">¶</a></h1>
-<p>run these commands in the root directory of searx</p>
-<div class="section" id="add-new-language">
-<h2>Add new language<a class="headerlink" href="#add-new-language" title="Permalink to this headline">¶</a></h2>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">pybabel</span> <span class="n">init</span> <span class="o">-</span><span class="n">i</span> <span class="n">messages</span><span class="o">.</span><span class="n">pot</span> <span class="o">-</span><span class="n">d</span> <span class="n">searx</span><span class="o">/</span><span class="n">translations</span> <span class="o">-</span><span class="n">l</span> <span class="n">it</span>
-</pre></div>
+<div class="section" id="requirements">
+<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline">¶</a></h2>
+<blockquote>
+<div><ul class="simple">
+<li>Transifex account</li>
+<li>Installed CLI tool of Transifex</li>
+</ul>
+</div></blockquote>
 </div>
-</div>
-<div class="section" id="update-po-files">
-<h2>Update .po files<a class="headerlink" href="#update-po-files" title="Permalink to this headline">¶</a></h2>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="o">./</span><span class="n">utils</span><span class="o">/</span><span class="n">update</span><span class="o">-</span><span class="n">translations</span><span class="o">.</span><span class="n">sh</span>
-</pre></div>
-</div>
-<p>You may have errors here. In that case, edit the
-<code class="docutils literal"><span class="pre">update-translations.sh</span></code> script to change <code class="docutils literal"><span class="pre">pybabel</span></code> to
-<code class="docutils literal"><span class="pre">pybabel-python2</span></code> or <code class="docutils literal"><span class="pre">pybabel2</span></code></p>
-<p>After this step, you can modify the .po files.</p>
-</div>
-<div class="section" id="compile-translations">
-<h2>Compile translations<a class="headerlink" href="#compile-translations" title="Permalink to this headline">¶</a></h2>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">pybabel</span> <span class="nb">compile</span> <span class="o">-</span><span class="n">d</span> <span class="n">searx</span><span class="o">/</span><span class="n">translations</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="transifex-stuff">
-<h2>Transifex stuff<a class="headerlink" href="#transifex-stuff" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="init-project">
-<h3>Init Project<a class="headerlink" href="#init-project" title="Permalink to this headline">¶</a></h3>
+<div class="section" id="init-transifex-project">
+<h2>Init Transifex project<a class="headerlink" href="#init-transifex-project" title="Permalink to this headline">¶</a></h2>
+<p>After installing <code class="docutils literal"><span class="pre">transifex</span></code> using pip, run the following command to initialize the project.</p>
 <div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="n">init</span> <span class="c1"># Transifex instance: https://www.transifex.com/asciimoo/searx/</span>
-
-<span class="n">tx</span> <span class="nb">set</span> <span class="o">--</span><span class="n">auto</span><span class="o">-</span><span class="n">local</span> <span class="o">-</span><span class="n">r</span> <span class="n">searx</span><span class="o">.</span><span class="n">messagespo</span> <span class="s1">&#39;searx/translations/&lt;lang&gt;/LC_MESSAGES/messages.po&#39;</span> \
+</pre></div>
+</div>
+<p>After <code class="docutils literal"><span class="pre">$HOME/.transifexrc</span></code> is created, get a Transifex API key and insert it into the configuration file.</p>
+<p>Create a configuration file for <code class="docutils literal"><span class="pre">tx</span></code> named <code class="docutils literal"><span class="pre">$HOME/.tx/config</span></code>.</p>
+<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">main</span><span class="p">]</span>
+<span class="n">host</span> <span class="o">=</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="o">.</span><span class="n">transifex</span><span class="o">.</span><span class="n">com</span>
+<span class="p">[</span><span class="n">searx</span><span class="o">.</span><span class="n">messagespo</span><span class="p">]</span>
+<span class="n">file_filter</span> <span class="o">=</span> <span class="n">searx</span><span class="o">/</span><span class="n">translations</span><span class="o">/&lt;</span><span class="n">lang</span><span class="o">&gt;/</span><span class="n">LC_MESSAGES</span><span class="o">/</span><span class="n">messages</span><span class="o">.</span><span class="n">po</span>
+<span class="n">source_file</span> <span class="o">=</span> <span class="n">messages</span><span class="o">.</span><span class="n">pot</span>
+<span class="n">source_lang</span> <span class="o">=</span> <span class="n">en</span>
+<span class="nb">type</span> <span class="o">=</span> <span class="n">PO</span>
+</pre></div>
+</div>
+<p>Then run <code class="docutils literal"><span class="pre">tx</span> <span class="pre">set</span></code>:</p>
+<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="nb">set</span> <span class="o">--</span><span class="n">auto</span><span class="o">-</span><span class="n">local</span> <span class="o">-</span><span class="n">r</span> <span class="n">searx</span><span class="o">.</span><span class="n">messagespo</span> <span class="s1">&#39;searx/translations/&lt;lang&gt;/LC_MESSAGES/messages.po&#39;</span> \
 <span class="o">--</span><span class="n">source</span><span class="o">-</span><span class="n">lang</span> <span class="n">en</span> <span class="o">--</span><span class="nb">type</span> <span class="n">PO</span> <span class="o">--</span><span class="n">source</span><span class="o">-</span><span class="n">file</span> <span class="n">messages</span><span class="o">.</span><span class="n">pot</span> <span class="o">--</span><span class="n">execute</span>
 </pre></div>
 </div>
-<p><a class="reference external" href="http://docs.transifex.com/client/init/">http://docs.transifex.com/client/init/</a></p>
-<p><a class="reference external" href="http://docs.transifex.com/client/set/">http://docs.transifex.com/client/set/</a></p>
 </div>
-<div class="section" id="get-translations">
-<h3>Get translations<a class="headerlink" href="#get-translations" title="Permalink to this headline">¶</a></h3>
+<div class="section" id="update-translations">
+<h2>Update translations<a class="headerlink" href="#update-translations" title="Permalink to this headline">¶</a></h2>
+<p>To retrieve the latest translations, pull it from Transifex.</p>
 <div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="n">pull</span> <span class="o">-</span><span class="n">a</span>
 </pre></div>
 </div>
-<p><a class="reference external" href="http://docs.transifex.com/client/pull">http://docs.transifex.com/client/pull</a></p>
-</div>
-<div class="section" id="upload-source-file">
-<h3>Upload source File<a class="headerlink" href="#upload-source-file" title="Permalink to this headline">¶</a></h3>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="n">push</span> <span class="o">-</span><span class="n">s</span>
+<p>Then check the new languages. If strings translated are not enough, delete those folders, because
+those should not be compiled. Call the command below to compile the <code class="docutils literal"><span class="pre">.po</span></code> files.</p>
+<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">pybabel</span> <span class="nb">compile</span> <span class="o">-</span><span class="n">d</span> <span class="n">searx</span><span class="o">/</span><span class="n">translations</span>
 </pre></div>
 </div>
-</div>
-<div class="section" id="upload-all-translation">
-<h3>Upload all Translation<a class="headerlink" href="#upload-all-translation" title="Permalink to this headline">¶</a></h3>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="n">push</span> <span class="o">-</span><span class="n">s</span> <span class="o">-</span><span class="n">t</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="upload-specifc-translation">
-<h2>upload specifc Translation<a class="headerlink" href="#upload-specifc-translation" title="Permalink to this headline">¶</a></h2>
-<div class="code shell highlight-default"><div class="highlight"><pre><span></span><span class="n">tx</span> <span class="n">push</span> <span class="o">-</span><span class="n">t</span> <span class="o">-</span><span class="n">l</span> <span class="n">tr</span>
-</pre></div>
-</div>
-<p><a class="reference external" href="http://docs.transifex.com/client/push">http://docs.transifex.com/client/push</a></p>
+<p>After the compilation is finished commit the <code class="docutils literal"><span class="pre">.po</span></code> and <code class="docutils literal"><span class="pre">.mo</span></code> files and create a PR.</p>
 </div>
 </div>

--- a/docs/conf.py
+++ b/docs/conf.py
@ -57,9 +57,9 @@ author = u'Adam Tauber'
 # built documents.
 #
 # The short X.Y version.
-version = '0.10.0'
+version = '0.11.0'
 # The full version, including alpha/beta/rc tags.
-release = '0.10.0'
+release = '0.11.0'

 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
--- a/docs/dev/translation.rst
+++ b/docs/dev/translation.rst
@ -1,80 +1,61 @@
 Translation
 ===========

-run these commands in the root directory of searx
+Requirements
+------------

-Add new language
-~~~~~~~~~~~~~~~~
+ * Transifex account

-.. code:: shell
+ * Installed CLI tool of Transifex

-    pybabel init -i messages.pot -d searx/translations -l it
+Init Transifex project
+----------------------

-Update .po files
-~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    ./utils/update-translations.sh
-
-You may have errors here. In that case, edit the
-``update-translations.sh`` script to change ``pybabel`` to
-``pybabel-python2`` or ``pybabel2``
-
-After this step, you can modify the .po files.
-
-Compile translations
-~~~~~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    pybabel compile -d searx/translations
-
-Transifex stuff
-~~~~~~~~~~~~~~~
-
-Init Project
-^^^^^^^^^^^^
+After installing ``transifex`` using pip, run the following command to initialize the project.

 .. code:: shell

    tx init # Transifex instance: https://www.transifex.com/asciimoo/searx/

+
+After ``$HOME/.transifexrc`` is created, get a Transifex API key and insert it into the configuration file.
+
+Create a configuration file for ``tx`` named ``$HOME/.tx/config``.
+
+.. code:: shell
+
+    [main]
+    host = https://www.transifex.com
+    [searx.messagespo]
+    file_filter = searx/translations/<lang>/LC_MESSAGES/messages.po
+    source_file = messages.pot
+    source_lang = en
+    type = PO
+
+
+Then run ``tx set``:
+
+.. code:: shell
+
    tx set --auto-local -r searx.messagespo 'searx/translations/<lang>/LC_MESSAGES/messages.po' \
    --source-lang en --type PO --source-file messages.pot --execute

-http://docs.transifex.com/client/init/

-http://docs.transifex.com/client/set/
+Update translations
+-------------------

-Get translations
-^^^^^^^^^^^^^^^^
+To retrieve the latest translations, pull it from Transifex.

 .. code:: shell

    tx pull -a

-http://docs.transifex.com/client/pull
-
-Upload source File
-^^^^^^^^^^^^^^^^^^
+Then check the new languages. If strings translated are not enough, delete those folders, because
+those should not be compiled. Call the command below to compile the ``.po`` files.

 .. code:: shell

-    tx push -s
+    pybabel compile -d searx/translations

-Upload all Translation
-^^^^^^^^^^^^^^^^^^^^^^

-.. code:: shell
-
-    tx push -s -t
-
-upload specifc Translation
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code:: shell
-
-    tx push -t -l tr
-
-http://docs.transifex.com/client/push
+After the compilation is finished commit the ``.po`` and ``.mo`` files and create a PR.
--- a/genindex.html
+++ b/genindex.html
@ -7,7 +7,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Index &#8212; searx 0.10.0 documentation</title>
+    <title>Index &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="_static/style.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@ -15,7 +15,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -26,7 +26,7 @@
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="index" title="Index" href="#" />
    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="index.html" />
   
  
  <link media="only screen and (max-device-width: 480px)" href="_static/small_flask.css" type= "text/css" rel="stylesheet" />
--- a/index.html
+++ b/index.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Welcome to searx &#8212; searx 0.10.0 documentation</title>
+    <title>Welcome to searx &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="_static/style.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="#" />
+    <link rel="top" title="searx 0.11.0 documentation" href="#" />
    <link rel="next" title="Search syntax" href="user/search_syntax.html" />
   
  
--- a/objects.inv
+++ b/objects.inv
@ -1,5 +1,5 @@
 # Sphinx inventory version 2
 # Project: searx
-# Version: 0.10.0
+# Version: 0.11.0
 # The remainder of this file is compressed using zlib.
 xÚuSÁnÃ ½ç+<2B>¶kWíºËTi“ÖÃ¤N›´cEÁKÑd@Òöï8¤<38>¤§„÷ìçgl(o„ZÓVëø×Œ¬	MàÃÑ5’lÂQXg¨Z‘Ín[aÄ<61><C384>Îxd–:˜þ¦OÄiÒí€9BÊ:ª L*.éä¼üÝý’ýšiåŒ8tÜ×<C39C>à0u²‘Yiˆz j¡`¯{0½€S)VÐ¨ôA’À¨Û“2}Ñt!¶ƒŠÛ	åZÙù¶T`LÚá!Æÿu‚ýz
ãÊ”+ƒY/ÐƒÔmÊ‘<C38A>‘‹"¨aÇ}±9ƒ"Ÿñ<ÅIÙåž'¦~]<5D><>[÷aÁº_ŠækPBq8ç	MWì«kØàqñ
’éÂ’„~Cp1ËÌÝÍizŸÙ<ÍÜµ—U"°ü»æ<C2BB>„Á'^xž<78>X6€¡ê,˜µ>©UzbÓþfäÐëñ(Bý=u0¾ÏgÔ&n/ÊÑóL0c3GUÿ>Ø˜¬
--- a/search.html
+++ b/search.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Search &#8212; searx 0.10.0 documentation</title>
+    <title>Search &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="_static/style.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -26,7 +26,7 @@
    <script type="text/javascript" src="_static/searchtools.js"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="#" />
-    <link rel="top" title="searx 0.10.0 documentation" href="index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="index.html" />
  <script type="text/javascript">
    jQuery(function() { Search.loadIndex("searchindex.js"); });
  </script>
--- a/searchindex.js
+++ b/searchindex.js
--- a/user/own-instance.html
+++ b/user/own-instance.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Why use a private instance? &#8212; searx 0.10.0 documentation</title>
+    <title>Why use a private instance? &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,7 +25,7 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
    <link rel="next" title="Installation" href="../dev/install/installation.html" />
    <link rel="prev" title="Search syntax" href="search_syntax.html" />
   
--- a/user/search_syntax.html
+++ b/user/search_syntax.html
@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
-    <title>Search syntax &#8212; searx 0.10.0 documentation</title>
+    <title>Search syntax &#8212; searx 0.11.0 documentation</title>
    
    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@ -14,7 +14,7 @@
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
-        VERSION:     '0.10.0',
+        VERSION:     '0.11.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
@ -25,8 +25,8 @@
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="searx 0.10.0 documentation" href="../index.html" />
-    <link rel="next" title="Installation" href="../dev/install/installation.html" />
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
+    <link rel="next" title="Why use a private instance?" href="own-instance.html" />
    <link rel="prev" title="Welcome to searx" href="../index.html" />