From 2cc24068597830c778b339f096e757678337d22b Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Thu, 18 Nov 2021 17:27:49 +0100 Subject: [PATCH 1/4] [mod] doc - in sidebar, add links to the reST sources Offer links to the reST sources (aka) html_show_sourcelink [1]. Links to the reST source are sometimes very helpful, especially in our resT-Primer [2] :) [1] https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_show_sourcelink [2] https://searxng.github.io/searxng/dev/reST.html Related-to: https://github.com/pallets/pallets-sphinx-themes/issues/32 Signed-off-by: Markus Heiser --- docs/conf.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index eb3598908..47cdaa3f1 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -130,13 +130,13 @@ if CONTACT_URL: html_context["project_links"].append(ProjectLink("Contact", CONTACT_URL)) html_sidebars = { - "**": ["project.html", "relations.html", "searchbox.html"], + "**": ["project.html", "relations.html", "searchbox.html", "sourcelink.html"], } singlehtml_sidebars = {"index": ["project.html", "localtoc.html"]} html_static_path = ["static"] html_logo = "static/img/searx_logo_small.png" html_title = "SearXNG Documentation ({})".format(VERSION_STRING) -html_show_sourcelink = False +html_show_sourcelink = True # LaTeX ---------------------------------------------------------------- From 3e5057405abe3499e6127fdb73564e89755ba1c8 Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Thu, 18 Nov 2021 17:29:25 +0100 Subject: [PATCH 2/4] [mod] doc - html_logo = themes/simple/src/svg/searxng-wordmark.svg Signed-off-by: Markus Heiser --- docs/conf.py | 3 +-- docs/static/img/searx_logo_small.png | Bin 6472 -> 0 bytes 2 files changed, 1 insertion(+), 2 deletions(-) delete mode 100644 docs/static/img/searx_logo_small.png diff --git a/docs/conf.py b/docs/conf.py index 47cdaa3f1..f892336f8 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -133,8 +133,7 @@ html_sidebars = { "**": ["project.html", "relations.html", "searchbox.html", "sourcelink.html"], } singlehtml_sidebars = {"index": ["project.html", "localtoc.html"]} -html_static_path = ["static"] -html_logo = "static/img/searx_logo_small.png" +html_logo = "../searx/static/themes/simple/src/svg/searxng-wordmark.svg" html_title = "SearXNG Documentation ({})".format(VERSION_STRING) html_show_sourcelink = True diff --git a/docs/static/img/searx_logo_small.png b/docs/static/img/searx_logo_small.png deleted file mode 100644 index 083932686b19d396dbbb6312cb46d73adbf48aa3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6472 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 i;3Z7A&!_Qqvi=_*y?ARXUj97*0000 Date: Thu, 18 Nov 2021 17:33:48 +0100 Subject: [PATCH 3/4] [brand] SearXNG - docs html_theme = "searxng" Signed-off-by: Markus Heiser --- .../{searx/static/searx.css => searxng/static/searxng.css} | 0 docs/_themes/{searx => searxng}/theme.conf | 2 +- docs/conf.py | 2 +- 3 files changed, 2 insertions(+), 2 deletions(-) rename docs/_themes/{searx/static/searx.css => searxng/static/searxng.css} (100%) rename docs/_themes/{searx => searxng}/theme.conf (65%) diff --git a/docs/_themes/searx/static/searx.css b/docs/_themes/searxng/static/searxng.css similarity index 100% rename from docs/_themes/searx/static/searx.css rename to docs/_themes/searxng/static/searxng.css diff --git a/docs/_themes/searx/theme.conf b/docs/_themes/searxng/theme.conf similarity index 65% rename from docs/_themes/searx/theme.conf rename to docs/_themes/searxng/theme.conf index 2d5f72e7d..802ffff4e 100644 --- a/docs/_themes/searx/theme.conf +++ b/docs/_themes/searxng/theme.conf @@ -1,6 +1,6 @@ [theme] inherit = pocoo -stylesheet = searx.css +stylesheet = searxng.css [options] touch_icon = diff --git a/docs/conf.py b/docs/conf.py index f892336f8..5bc83ebe6 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -108,7 +108,7 @@ issues_github_path = "searxng/searxng" sys.path.append(os.path.abspath('_themes')) sys.path.insert(0, os.path.abspath("../utils/")) html_theme_path = ['_themes'] -html_theme = "searx" +html_theme = "searxng" # sphinx.ext.imgmath setup html_math_renderer = 'imgmath' From 1dae0c0be09d5c9e287bdea6aa5bf7ec4f4782ec Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Thu, 18 Nov 2021 18:27:26 +0100 Subject: [PATCH 4/4] [brand] SearXNG - docs rename links and fix documentation Signed-off-by: Markus Heiser --- docs/admin/architecture.rst | 12 ++++----- docs/admin/engines/settings.rst | 4 +-- docs/admin/engines/sql-engines.rst | 4 +-- docs/admin/filtron.rst | 8 +++--- docs/admin/index.rst | 4 +-- docs/admin/installation-apache.rst | 24 ++++++++--------- docs/admin/installation-docker.rst | 4 +-- docs/admin/installation-nginx.rst | 18 ++++++------- ...ion-searx.rst => installation-searxng.rst} | 16 ++++++------ docs/admin/installation-uwsgi.rst | 26 +++++++++---------- docs/admin/installation.rst | 10 +++---- docs/admin/morty.rst | 8 +++--- .../{update-searx.rst => update-searxng.rst} | 4 +-- docs/build-templates/searx.rst | 14 +++++----- docs/dev/lxcdev.rst | 10 +++---- docs/dev/quickstart.rst | 2 +- docs/dev/search_api.rst | 4 +-- docs/index.rst | 11 ++++---- docs/utils/filtron.sh.rst | 2 +- docs/utils/morty.sh.rst | 4 +-- docs/utils/searx.sh.rst | 2 +- utils/brand.env | 4 +-- utils/lib_install.sh | 4 +-- utils/searx.sh | 14 +++++----- .../etc/uwsgi/apps-archlinux/searxng.ini | 2 +- .../uwsgi/apps-archlinux/searxng.ini:socket | 2 +- .../etc/uwsgi/apps-available/searxng.ini | 2 +- .../uwsgi/apps-available/searxng.ini:socket | 2 +- 28 files changed, 111 insertions(+), 110 deletions(-) rename docs/admin/{installation-searx.rst => installation-searxng.rst} (89%) rename docs/admin/{update-searx.rst => update-searxng.rst} (96%) diff --git a/docs/admin/architecture.rst b/docs/admin/architecture.rst index 45d952282..db99c9f55 100644 --- a/docs/admin/architecture.rst +++ b/docs/admin/architecture.rst @@ -6,12 +6,12 @@ Architecture .. sidebar:: Further reading - - Reverse Proxy: :ref:`Apache ` & :ref:`nginx ` - - Filtron: :ref:`searx filtron` - - Morty: :ref:`searx morty` - - uWSGI: :ref:`searx uwsgi` - - Searx: :ref:`installation basic` + - Reverse Proxy: :ref:`Apache ` & :ref:`nginx ` + - Filtron: :ref:`searxng filtron` + - Morty: :ref:`searxng morty` + - uWSGI: :ref:`searxng uwsgi` + - SearXNG: :ref:`installation basic` Herein you will find some hints and suggestions about typical architectures of SearXNG infrastructures. diff --git a/docs/admin/engines/settings.rst b/docs/admin/engines/settings.rst index c67b45669..b04de7cb3 100644 --- a/docs/admin/engines/settings.rst +++ b/docs/admin/engines/settings.rst @@ -94,7 +94,7 @@ Global Settings port: 8888 bind_address: "127.0.0.1" # address to listen on secret_key: "ultrasecretkey" # change this! - image_proxy: false # proxying image results through searx + image_proxy: false # proxying image results through SearXNG default_locale: "" # default interface locale default_theme: oscar # ui theme default_http_headers: @@ -293,7 +293,7 @@ engine is shown. Most of the options have a default value or even are optional. ``timeout`` : optional Timeout of the search with the current search engine. **Be careful, it will - modify the global timeout of searx.** + modify the global timeout of SearXNG.** ``api_key`` : optional In a few cases, using an API needs the use of a secret key. How to obtain them diff --git a/docs/admin/engines/sql-engines.rst b/docs/admin/engines/sql-engines.rst index 713ef9a40..9d24913a9 100644 --- a/docs/admin/engines/sql-engines.rst +++ b/docs/admin/engines/sql-engines.rst @@ -127,7 +127,7 @@ find an example configuration below: - name: my_database engine: postgresql database: my_database - username: searx + username: searxng password: password query_str: 'SELECT * from my_table WHERE my_column = %(query)s' @@ -155,7 +155,7 @@ example configuration for quering a MySQL server: - name: my_database engine: mysql_server database: my_database - username: searx + username: searxng password: password limit: 5 query_str: 'SELECT * from my_table WHERE my_column=%(query)s' diff --git a/docs/admin/filtron.rst b/docs/admin/filtron.rst index dd3cfc675..1c32c1b37 100644 --- a/docs/admin/filtron.rst +++ b/docs/admin/filtron.rst @@ -1,5 +1,5 @@ -.. _searx filtron: +.. _searxng filtron: ========================== How to protect an instance @@ -8,7 +8,7 @@ How to protect an instance .. sidebar:: further reading - :ref:`filtron.sh` - - :ref:`nginx searx site` + - :ref:`nginx searxng site` .. contents:: Contents @@ -19,7 +19,7 @@ How to protect an instance .. _filtron: https://github.com/asciimoo/filtron SearXNG depends on external search services. To avoid the abuse of these services -it is advised to limit the number of requests processed by searx. +it is advised to limit the number of requests processed by SearXNG. An application firewall, filtron_ solves exactly this problem. Filtron is just a middleware between your web server (nginx, apache, ...) and searx, we describe @@ -188,4 +188,4 @@ Use it along with ``nginx`` with the following example configuration. Requests are coming from port 4004 going through filtron and then forwarded to port 8888 where a SearXNG is being run. For a complete setup see: :ref:`nginx -searx site`. +searxng site`. diff --git a/docs/admin/index.rst b/docs/admin/index.rst index 3139db99c..940707d8f 100644 --- a/docs/admin/index.rst +++ b/docs/admin/index.rst @@ -7,12 +7,12 @@ Administrator documentation :caption: Contents installation - installation-searx + installation-searxng installation-uwsgi installation-nginx installation-apache installation-docker - update-searx + update-searxng engines/index api architecture diff --git a/docs/admin/installation-apache.rst b/docs/admin/installation-apache.rst index c15e3f5a0..b60e20ad1 100644 --- a/docs/admin/installation-apache.rst +++ b/docs/admin/installation-apache.rst @@ -47,13 +47,13 @@ Install with apache ---- -**Install** :ref:`apache searx site` using :ref:`filtron.sh ` +**Install** :ref:`apache searxng site` using :ref:`filtron.sh ` .. code:: bash $ sudo -H ./utils/filtron.sh apache install -**Install** :ref:`apache searx site` using :ref:`morty.sh ` +**Install** :ref:`apache searxng site` using :ref:`morty.sh ` .. code:: bash @@ -163,7 +163,7 @@ How this default intro site is configured, depends on the linux distribution less /etc/httpd/conf.d/welcome.conf -.. _apache searx site: +.. _apache searxng site: Apache Reverse Proxy ==================== @@ -192,14 +192,14 @@ except in :ref:`The Debian Layout`. sudo -H a2enmod proxy sudo -H a2enmod proxy_http - In :ref:`The Debian Layout` you create a ``searx.conf`` with the + In :ref:`The Debian Layout` you create a ``searxng.conf`` with the ```` directive and save this file in the *sites available* folder at ``/etc/apache2/sites-available``. To enable the - ``searx.conf`` use :man:`a2ensite`: + ``searxng.conf`` use :man:`a2ensite`: .. code:: sh - sudo -H a2ensite searx.conf + sudo -H a2ensite searxng.conf .. group-tab:: Arch Linux @@ -230,7 +230,7 @@ except in :ref:`The Debian Layout`. With ProxyPreserveHost_ the incoming Host HTTP request header is passed to the proxied host. -.. _apache searx via filtron plus morty: +.. _apache searxng via filtron plus morty: .. tabs:: @@ -262,7 +262,7 @@ proxied host. - 2. Configure reverse proxy for :ref:`morty `, listening on + 2. Configure reverse proxy for :ref:`morty `, listening on *localhost 3000* .. code:: apache @@ -286,7 +286,7 @@ proxied host. - For a fully result proxification add :ref:`morty's ` **public + For a fully result proxification add :ref:`morty's ` **public URL** to your :origin:`searx/settings.yml`: .. code:: yaml @@ -302,10 +302,10 @@ proxied host. uWSGI support ============= -Be warned, with this setup, your instance isn't :ref:`protected `, nevertheless it is good enough for intranet usage. In modern Linux distributions, the `mod_proxy_uwsgi`_ is compiled into the *normal* apache -package and you need to install only the :ref:`uWSGI ` package: +package and you need to install only the :ref:`uWSGI ` package: .. tabs:: @@ -337,7 +337,7 @@ For socket communication, you have to activate ``socket = /run/uwsgi/app/searx/socket`` and comment out the ``http = 127.0.0.1:8888`` configuration in your :ref:`uwsgi ini file `. If not already exists, create a folder for the unix sockets, which can be used by the -searx account (see :ref:`create searx user`): +SearXNG account (see :ref:`create searxng user`): .. code:: bash diff --git a/docs/admin/installation-docker.rst b/docs/admin/installation-docker.rst index ecf9c833f..cd91af382 100644 --- a/docs/admin/installation-docker.rst +++ b/docs/admin/installation-docker.rst @@ -25,8 +25,8 @@ Docker installation If you intend to create a public instance using Docker, use our well maintained searxng-docker_ image which includes - - :ref:`protection ` `[filtron]`_, - - a :ref:`result proxy ` `[morty]`_ and + - :ref:`protection ` `[filtron]`_, + - a :ref:`result proxy ` `[morty]`_ and - a HTTPS reverse proxy `[caddy]`_. Make sure you have `installed Docker `_ and diff --git a/docs/admin/installation-nginx.rst b/docs/admin/installation-nginx.rst index 1d982bc8f..fdbcdf032 100644 --- a/docs/admin/installation-nginx.rst +++ b/docs/admin/installation-nginx.rst @@ -34,13 +34,13 @@ Install with nginx ---- -**Install** :ref:`nginx searx site` using :ref:`filtron.sh ` +**Install** :ref:`nginx searxng site` using :ref:`filtron.sh ` .. code:: bash $ sudo -H ./utils/filtron.sh nginx install -**Install** :ref:`nginx searx site` using :ref:`morty.sh ` +**Install** :ref:`nginx searxng site` using :ref:`morty.sh ` .. code:: bash @@ -126,7 +126,7 @@ depends on the linux distribution: include /etc/nginx/conf.d/*.conf; -.. _nginx searx site: +.. _nginx searxng site: A nginx SearXNG site ==================== @@ -163,7 +163,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. Create configuration at ``/etc/nginx/conf.d/searxng`` and place a symlink to sites-enabled: -.. _nginx searx via filtron plus morty: +.. _nginx searxng via filtron plus morty: .. tabs:: @@ -195,7 +195,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. } - 2. Configure reverse proxy for :ref:`morty `, listening on + 2. Configure reverse proxy for :ref:`morty `, listening on *localhost 3000*: .. code:: nginx @@ -212,7 +212,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. proxy_set_header X-Scheme $scheme; } - For a fully result proxification add :ref:`morty's ` **public + For a fully result proxification add :ref:`morty's ` **public URL** to your :origin:`searx/settings.yml`: .. code:: yaml @@ -228,7 +228,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. .. group-tab:: proxy or uWSGI - Be warned, with this setup, your instance isn't :ref:`protected `. Nevertheless it is good enough for intranet usage and it is a excellent example of; *how different services can be set up*. The next example shows a reverse proxy configuration wrapping the :ref:`searx-uWSGI @@ -281,7 +281,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. } If not already exists, create a folder for the unix sockets, which can be - used by the searx account: + used by the SearXNG account: .. code:: bash @@ -290,7 +290,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*. .. group-tab:: \.\. at subdir URL - Be warned, with these setups, your instance isn't :ref:`protected `. The examples are just here to demonstrate how to export the SearXNG application from a subdirectory URL ``https://example.org/searx/``. diff --git a/docs/admin/installation-searx.rst b/docs/admin/installation-searxng.rst similarity index 89% rename from docs/admin/installation-searx.rst rename to docs/admin/installation-searxng.rst index 3aa655e85..b14139310 100644 --- a/docs/admin/installation-searx.rst +++ b/docs/admin/installation-searxng.rst @@ -23,9 +23,9 @@ Install packages .. hint:: - This installs also the packages needed by :ref:`searx uwsgi` + This installs also the packages needed by :ref:`searxng uwsgi` -.. _create searx user: +.. _create searxng user: Create user =========== @@ -42,8 +42,8 @@ Install SearXNG & dependencies Start a interactive shell from new created user and clone searx: .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START clone searx - :end-before: END clone searx + :start-after: START clone searxng + :end-before: END clone searxng In the same shell create *virtualenv*: @@ -87,8 +87,8 @@ For a *minimal setup*, configure like shown below – replace ``searx@$(uname ``/etc/searxng/settings.yml`` to your needs. .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx config - :end-before: END searx config + :start-after: START searxng config + :end-before: END searxng config .. tabs:: @@ -111,8 +111,8 @@ SearXNG looks at the exported environment ``$SEARXNG_SETTINGS_PATH`` for a configuration file. .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START check searx installation - :end-before: END check searx installation + :start-after: START check searxng installation + :end-before: END check searxng installation If everything works fine, hit ``[CTRL-C]`` to stop the *webapp* and disable the debug option in ``settings.yml``. You can now exit SearXNG user bash (enter exit diff --git a/docs/admin/installation-uwsgi.rst b/docs/admin/installation-uwsgi.rst index 1fb24ca8f..1021283f9 100644 --- a/docs/admin/installation-uwsgi.rst +++ b/docs/admin/installation-uwsgi.rst @@ -1,4 +1,4 @@ -.. _searx uwsgi: +.. _searxng uwsgi: ===== uwsgi @@ -105,24 +105,24 @@ restart the uwsgi application. .. group-tab:: Ubuntu / debian .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-description ubuntu-20.04 - :end-before: END searx uwsgi-description ubuntu-20.04 + :start-after: START searxng uwsgi-description ubuntu-20.04 + :end-before: END searxng uwsgi-description ubuntu-20.04 .. hotfix: a bug group-tab need this comment .. group-tab:: Arch Linux .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-description arch - :end-before: END searx uwsgi-description arch + :start-after: START searxng uwsgi-description arch + :end-before: END searxng uwsgi-description arch .. hotfix: a bug group-tab need this comment .. group-tab:: Fedora / RHEL .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-description fedora - :end-before: END searx uwsgi-description fedora + :start-after: START searxng uwsgi-description fedora + :end-before: END searxng uwsgi-description fedora .. tabs:: @@ -130,21 +130,21 @@ restart the uwsgi application. .. group-tab:: Ubuntu / debian .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-appini ubuntu-20.04 - :end-before: END searx uwsgi-appini ubuntu-20.04 + :start-after: START searxng uwsgi-appini ubuntu-20.04 + :end-before: END searxng uwsgi-appini ubuntu-20.04 .. hotfix: a bug group-tab need this comment .. group-tab:: Arch Linux .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-appini arch - :end-before: END searx uwsgi-appini arch + :start-after: START searxng uwsgi-appini arch + :end-before: END searxng uwsgi-appini arch .. hotfix: a bug group-tab need this comment .. group-tab:: Fedora / RHEL .. kernel-include:: $DOCS_BUILD/includes/searx.rst - :start-after: START searx uwsgi-appini fedora - :end-before: END searx uwsgi-appini fedora + :start-after: START searxng uwsgi-appini fedora + :end-before: END searxng uwsgi-appini fedora diff --git a/docs/admin/installation.rst b/docs/admin/installation.rst index 59f142aff..ccb5314c1 100644 --- a/docs/admin/installation.rst +++ b/docs/admin/installation.rst @@ -27,7 +27,7 @@ Installation scripts .. sidebar:: Update OS first! - To avoid unwanted side effects, update your OS before installing searx. + To avoid unwanted side effects, update your OS before installing SearXNG. The following will install a setup as shown in :ref:`architecture`. First you need to get a clone. The clone is only needed for the installation procedure @@ -42,14 +42,14 @@ the case if you clone into a folder below ``/root``. .. code:: bash $ cd ~/Downloads - $ git clone https://github.com/searxng/searxng.git searx - $ cd searx + $ git clone https://github.com/searxng/searxng.git searxng + $ cd searxng .. sidebar:: further read - :ref:`toolboxing` - - :ref:`update searx` - - :ref:`inspect searx` + - :ref:`update searxng` + - :ref:`inspect searxng` **Install** :ref:`SearXNG service ` diff --git a/docs/admin/morty.rst b/docs/admin/morty.rst index d19a91361..b6bd2ea56 100644 --- a/docs/admin/morty.rst +++ b/docs/admin/morty.rst @@ -1,5 +1,5 @@ -.. _searx morty: +.. _searxng morty: ========================= How to setup result proxy @@ -15,7 +15,7 @@ How to setup result proxy By default SearXNG can only act as an image proxy for result images, but it is possible to proxify all the result URLs with an external service, morty_. -To use this feature, morty has to be installed and activated in searx's +To use this feature, morty has to be installed and activated in SearXNG's ``settings.yml``. Add the following snippet to your ``settings.yml`` and restart searx: @@ -30,8 +30,8 @@ instances without a HTTP proxy. If your morty service is public, the url is the address of the reverse proxy (e.g ``https://example.org/morty``). For more information about *result proxy* have a look at *"SearXNG via filtron -plus morty"* in the :ref:`nginx ` and -:ref:`apache ` sections. +plus morty"* in the :ref:`nginx ` and +:ref:`apache ` sections. ``url`` Is the address of the running morty service. diff --git a/docs/admin/update-searx.rst b/docs/admin/update-searxng.rst similarity index 96% rename from docs/admin/update-searx.rst rename to docs/admin/update-searxng.rst index ea58a9954..4c541bf57 100644 --- a/docs/admin/update-searx.rst +++ b/docs/admin/update-searxng.rst @@ -1,4 +1,4 @@ -.. _update searx: +.. _update searxng: ============= How to update @@ -25,7 +25,7 @@ How to update depends on the :ref:`installation` method. If you have used the $ sudo -H ./utils/morty.sh update morty -.. _inspect searx: +.. _inspect searxng: ====================== How to inspect & debug diff --git a/docs/build-templates/searx.rst b/docs/build-templates/searx.rst index bea7fa5e0..626cce6bd 100644 --- a/docs/build-templates/searx.rst +++ b/docs/build-templates/searx.rst @@ -72,7 +72,7 @@ ${fedora_build} .. END create user -.. START clone searx +.. START clone searxng .. tabs:: @@ -83,7 +83,7 @@ ${fedora_build} $ sudo -H -u ${SERVICE_USER} -i (${SERVICE_USER})$ git clone \"$GIT_URL\" \"$SEARX_SRC\" -.. END clone searx +.. END clone searxng .. START create virtualenv @@ -118,14 +118,14 @@ ${fedora_build} pip install -U wheel pip install -U pyyaml - # jump to searx's working tree and install SearXNG into virtualenv + # jump to SearXNG's working tree and install SearXNG into virtualenv (${SERVICE_USER})$ cd \"$SEARX_SRC\" (${SERVICE_USER})$ pip install -e . .. END manage.sh update_packages -.. START searx config +.. START searxng config .. tabs:: @@ -153,9 +153,9 @@ ${fedora_build} $ sudo -H sed -i -e \"s/ultrasecretkey/\$(openssl rand -hex 16)/g\" \"$SEARXNG_SETTINGS_PATH\" -.. END searx config +.. END searxng config -.. START check searx installation +.. START check searxng installation .. tabs:: @@ -206,4 +206,4 @@ container or in a script, test with curl: HTTP/1.0 200 OK ... -.. END check searx installation +.. END check searxng installation diff --git a/docs/dev/lxcdev.rst b/docs/dev/lxcdev.rst index e13667c0b..597f99925 100644 --- a/docs/dev/lxcdev.rst +++ b/docs/dev/lxcdev.rst @@ -88,8 +88,8 @@ fork: .. code:: sh $ cd ~/Downloads - $ git clone https://github.com/searxng/searxng.git searx - $ cd searx + $ git clone https://github.com/searxng/searxng.git searxng + $ cd searxng The :ref:`lxc-searx.env` consists of several images, see ``export LXC_SUITE=(...`` near by :origin:`utils/lxc-searx.env#L19`. For this blog post @@ -180,7 +180,7 @@ searx-archlinux``: $ sudo -H ./utils/lxc.sh cmd searx-archlinux bash INFO: [searx-archlinux] bash [root@searx-archlinux searx]# pwd - /share/searx + /share/searxng The prompt ``[root@searx-archlinux ...]`` signals, that you are the root user in the searx-container. To debug the running SearXNG instance use: @@ -213,7 +213,7 @@ To debug services from filtron and morty analogous use: Another point we have to notice is that each service (:ref:`SearXNG `, :ref:`filtron ` and :ref:`morty `) runs under dedicated -system user account with the same name (compare :ref:`create searx user`). To +system user account with the same name (compare :ref:`create searxng user`). To get a shell from theses accounts, simply call one of the scripts: .. tabs:: @@ -267,7 +267,7 @@ suite. For this, we have to keep an eye on the :ref:`installation basic`: - SearXNG software in: ``/usr/local/searx/searx-src`` With the use of the :ref:`searx.sh` the SearXNG service was installed as -:ref:`uWSGI application `. To maintain this service, we can use +:ref:`uWSGI application `. To maintain this service, we can use ``systemctl`` (compare :ref:`service architectures on distributions `). diff --git a/docs/dev/quickstart.rst b/docs/dev/quickstart.rst index 7e4ce8b68..d2b666c09 100644 --- a/docs/dev/quickstart.rst +++ b/docs/dev/quickstart.rst @@ -12,7 +12,7 @@ you simply by using :ref:`make `. .. code:: sh - git clone https://github.com/searxng/searxng.git searx + git clone https://github.com/searxng/searxng.git searxng Here is how a minimal workflow looks like: diff --git a/docs/dev/search_api.rst b/docs/dev/search_api.rst index 552b0ff84..ce7237677 100644 --- a/docs/dev/search_api.rst +++ b/docs/dev/search_api.rst @@ -25,7 +25,7 @@ Parameters ``q`` : required The search query. This string is passed to external search services. Thus, SearXNG supports syntax of each search service. For example, ``site:github.com - searx`` is a valid query for Google. However, if simply the query above is + SearXNG`` is a valid query for Google. However, if simply the query above is passed to any search engine which does not filter its results based on this syntax, you might not get the results you wanted. @@ -62,7 +62,7 @@ Parameters ``image_proxy`` : default ``False`` [ ``True``, ``False`` ] - Proxy image results through searx. + Proxy image results through SearXNG. ``autocomplete`` : default *empty* [ ``google``, ``dbpedia``, ``duckduckgo``, ``startpage``, ``wikipedia`` ] diff --git a/docs/index.rst b/docs/index.rst index 20b1848ca..7100d4ed1 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,11 +2,7 @@ Welcome to SearXNG ================== - *Search without being tracked.* - -.. hint:: - - This is not searx, but searxng. + *Search without being tracked.* SearXNG is a free internet metasearch engine which aggregates results from more than 70 search services. Users are neither tracked nor profiled. Additionally, @@ -25,6 +21,11 @@ If you don't trust anyone, you can set up your own, see :ref:`installation`. - Cookies are not used by default - Secure, encrypted connections (HTTPS/SSL) +.. sidebar:: info + + SearXNG development has been started in the middle of 2021 as a fork of the + searx project. + .. toctree:: :maxdepth: 2 :caption: Contents diff --git a/docs/utils/filtron.sh.rst b/docs/utils/filtron.sh.rst index 86e3fa88a..f4a85282a 100644 --- a/docs/utils/filtron.sh.rst +++ b/docs/utils/filtron.sh.rst @@ -7,7 +7,7 @@ .. sidebar:: further reading - - :ref:`searx filtron` + - :ref:`searxng filtron` - :ref:`architecture` - :ref:`installation` (:ref:`nginx ` & :ref:`apache `) diff --git a/docs/utils/morty.sh.rst b/docs/utils/morty.sh.rst index f2e02baab..99103b1cb 100644 --- a/docs/utils/morty.sh.rst +++ b/docs/utils/morty.sh.rst @@ -14,7 +14,7 @@ - :ref:`architecture` - :ref:`installation` (:ref:`nginx ` & :ref:`apache `) - - :ref:`searx morty` + - :ref:`searxng morty` To simplify installation and maintenance of a morty_ instance you can use the script :origin:`utils/morty.sh`. In most cases you will install morty_ simply by @@ -37,7 +37,7 @@ into this user account: .. hint:: - To add morty to your SearXNG instance read chapter :ref:`searx morty`. + To add morty to your SearXNG instance read chapter :ref:`searxng morty`. Create user =========== diff --git a/docs/utils/searx.sh.rst b/docs/utils/searx.sh.rst index bcbe04a61..6d412d23d 100644 --- a/docs/utils/searx.sh.rst +++ b/docs/utils/searx.sh.rst @@ -24,7 +24,7 @@ In most cases you will install SearXNG simply by running the command: sudo -H ./utils/searx.sh install all -The script adds a ``${SERVICE_USER}`` (default:``searx``) and installs searx +The script adds a ``${SERVICE_USER}`` (default:``searx``) and installs SearXNG into this user account. The installation is described in chapter :ref:`installation basic`. diff --git a/utils/brand.env b/utils/brand.env index 31afce53c..7c38364d6 100644 --- a/utils/brand.env +++ b/utils/brand.env @@ -1,5 +1,5 @@ export SEARXNG_URL='' export SEARXNG_PORT='8888' export SEARXNG_BIND_ADDRESS='127.0.0.1' -export GIT_URL='https://github.com/searxng/searxng' -export GIT_BRANCH='master' +export GIT_URL='https://github.com/return42/searxng' +export GIT_BRANCH='doc-theme' diff --git a/utils/lib_install.sh b/utils/lib_install.sh index 4a251c096..e8e3297c5 100755 --- a/utils/lib_install.sh +++ b/utils/lib_install.sh @@ -121,10 +121,10 @@ install_log_searx_instance() { echo -e " SEARXNG_URL : ${_BBlue}${SEARXNG_URL:-none}${_creset}" if in_container; then - # searx is listening on 127.0.0.1 and not available from outside container + # SearXNG is listening on 127.0.0.1 and not available from outside container # in containers the service is listening on 0.0.0.0 (see lxc-searx.env) echo -e "---- container setup" - echo -e " ${_BBlack}HINT:${_creset} searx only listen on loopback device" \ + echo -e " ${_BBlack}HINT:${_creset} SearXNG only listen on loopback device" \ "${_BBlack}inside${_creset} the container." for ip in $(global_IPs) ; do if [[ $ip =~ .*:.* ]]; then diff --git a/utils/searx.sh b/utils/searx.sh index 54bddeda9..09af3819d 100755 --- a/utils/searx.sh +++ b/utils/searx.sh @@ -151,13 +151,13 @@ usage:: shell start interactive shell from user ${SERVICE_USER} install / remove - :all: complete (de-) installation of searx service + :all: complete (de-) installation of SearXNG service :user: add/remove service user '$SERVICE_USER' ($SERVICE_HOME) :dot-config: copy ./config.sh to ${SEARX_SRC} :searx-src: clone $GIT_URL :init-src: copy files (SEARX_SRC_INIT_FILES) to ${SEARX_SRC} :pyenv: create/remove virtualenv (python) in $SEARX_PYENV - :uwsgi: install searx uWSGI application + :uwsgi: install SearXNG uWSGI application :settings: reinstall settings from ${SEARXNG_SETTINGS_PATH} :packages: install needed packages from OS package manager :buildhost: install packages from OS package manager needed by buildhosts @@ -688,7 +688,7 @@ remove_settings() { } remove_searx() { - rst_title "Drop searx sources" section + rst_title "Drop SearXNG sources" section if ask_yn "Do you really want to drop SearXNG sources ($SEARX_SRC)?"; then rm -rf "$SEARX_SRC" else @@ -1035,7 +1035,7 @@ rst-doc() { [[ $DIST_VERS =~ $DIST_ID ]] && DIST_VERS= uWSGI_distro_setup - echo -e "\n.. START searx uwsgi-description $DIST_NAME" + echo -e "\n.. START searxng uwsgi-description $DIST_NAME" case $DIST_ID-$DIST_VERS in ubuntu-*|debian-*) cat <