summaryrefslogtreecommitdiff
path: root/README.rst
diff options
context:
space:
mode:
authorAdam Tauber <asciimoo@gmail.com>2016-01-02 16:18:43 +0100
committerAdam Tauber <asciimoo@gmail.com>2016-01-10 19:23:10 +0100
commit0c84996a32710c6de4e00a0e19ed13194d8831f5 (patch)
tree73f3bdee6c63e7af37aae58c99436eaf4da3d17e /README.rst
parent1e4f0bedc5ed70359c6a75ae93bf51eba8e7145e (diff)
[doc] remove obsolete build docs
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst117
1 files changed, 2 insertions, 115 deletions
diff --git a/README.rst b/README.rst
index cf1263c0..c0993157 100644
--- a/README.rst
+++ b/README.rst
@@ -7,31 +7,16 @@ engine <https://en.wikipedia.org/wiki/Metasearch_engine>`__.
List of `running
instances <https://github.com/asciimoo/searx/wiki/Searx-instances>`__.
-See the `wiki <https://github.com/asciimoo/searx/wiki>`__ for more information.
+See the `documentation <https://asciimoo.github.io/searx>`__ and the `wiki <https://github.com/asciimoo/searx/wiki>`__ for more information.
|Flattr searx|
-Features
-~~~~~~~~
-
-- Tracking free
-- Supports multiple output formats
-
- - json ``curl https://searx.me/?format=json&q=[query]``
- - csv ``curl https://searx.me/?format=csv&q=[query]``
- - opensearch/rss ``curl https://searx.me/?format=rss&q=[query]``
-- Opensearch support (you can set as default search engine)
-- Configurable search engines/categories
-- Different search languages
-- Duckduckgo like !bang functionality with engine shortcuts
-- Parallel queries - relatively fast
-
Installation
~~~~~~~~~~~~
- clone source:
``git clone git@github.com:asciimoo/searx.git && cd searx``
-- install dependencies: ``pip install -r requirements.txt``
+- install dependencies: ``./manage.sh update_packages``
- edit your
`settings.yml <https://github.com/asciimoo/searx/blob/master/settings.yml>`__
(set your ``secret_key``!)
@@ -40,104 +25,6 @@ Installation
For all the details, follow this `step by step
installation <https://github.com/asciimoo/searx/wiki/Installation>`__
-Alternative (Recommended) Installation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-- clone source:
- ``git clone git@github.com:asciimoo/searx.git && cd searx``
-- build in current folder: ``make minimal``
-- run ``bin/searx-run`` to start the application
-
-Development
-~~~~~~~~~~~
-
-Just run ``make``. Versions of dependencies are pinned down inside
-``versions.cfg`` to produce most stable build. Also remember, NO make
-command should be run as root, not even ``make production``
-
-Deployment
-~~~~~~~~~~
-
-- clone source:
- ``git clone git@github.com:asciimoo/searx.git && cd searx``
-- build in current folder: ``make production``
-- run ``bin/supervisord`` to start the application
-
-Upgrading
-~~~~~~~~~
-
-- inside previously cloned searx directory run: ``git stash`` to
- temporarily save any changes you have made
-- pull source: ``git pull origin master``
-- re-build in current folder: ``make production``
-- run ``bin/supervisorctl stop searx`` to stop searx, if it does not,
- then run ``fuser -k 8888/tcp``
-- run ``bin/supervisorctl reload`` to re-read supervisor config and
- start searx
-
-Command make
-~~~~~~~~~~~~
-
-``make``
-''''''''
-
-Builds development environment with testing support.
-
-``make tests``
-''''''''''''''
-
-Runs tests. You can write tests
-`here <https://github.com/asciimoo/searx/tree/master/searx/tests>`__ and
-remember 'untested code is broken code'.
-
-``make robot``
-''''''''''''''
-
-Runs robot (Selenium) tests, you must have ``firefox`` installed because
-this functional tests actually run the browser and perform operations on
-it. Also searx is executed with
-`settings\_robot <https://github.com/asciimoo/searx/blob/master/searx/settings_robot.yml>`__.
-
-``make flake8``
-'''''''''''''''
-
-'pep8 is a tool to check your Python code against some of the style
-conventions in `PEP 8 <http://www.python.org/dev/peps/pep-0008/>`__.'
-
-``make coverage``
-'''''''''''''''''
-
-Checks coverage of tests, after running this, execute this:
-``firefox ./coverage/index.html``
-
-``make production``
-'''''''''''''''''''
-
-Used to make co-called production environment - without tests (you
-should ran tests before deploying searx on the server). This installs
-supervisord, so if searx crashes, it will try to pick itself up again.
-And crontab entry is added to start supervisord at server boot.
-
-``make minimal``
-''''''''''''''''
-
-Minimal build - without test frameworks, the quickest build option.
-
-``make clean``
-''''''''''''''
-
-Deletes several folders and files (see ``Makefile`` for more), so that
-next time you run any other ``make`` command it will rebuild everithing.
-
-TODO
-~~~~
-
-- Moar engines
-- Better ui
-- Browser integration
-- Documentation
-- Tests
-
Bugs
~~~~