mirror of https://github.com/searxng/searxng.git
[doc] remove obsolete build docs
This commit is contained in:
parent
1e4f0bedc5
commit
0c84996a32
117
README.rst
117
README.rst
|
@ -7,31 +7,16 @@ engine <https://en.wikipedia.org/wiki/Metasearch_engine>`__.
|
||||||
List of `running
|
List of `running
|
||||||
instances <https://github.com/asciimoo/searx/wiki/Searx-instances>`__.
|
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|
|
|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
|
Installation
|
||||||
~~~~~~~~~~~~
|
~~~~~~~~~~~~
|
||||||
|
|
||||||
- clone source:
|
- clone source:
|
||||||
``git clone git@github.com:asciimoo/searx.git && cd searx``
|
``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
|
- edit your
|
||||||
`settings.yml <https://github.com/asciimoo/searx/blob/master/settings.yml>`__
|
`settings.yml <https://github.com/asciimoo/searx/blob/master/settings.yml>`__
|
||||||
(set your ``secret_key``!)
|
(set your ``secret_key``!)
|
||||||
|
@ -40,104 +25,6 @@ Installation
|
||||||
For all the details, follow this `step by step
|
For all the details, follow this `step by step
|
||||||
installation <https://github.com/asciimoo/searx/wiki/Installation>`__
|
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
|
Bugs
|
||||||
~~~~
|
~~~~
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue