From e5323b8aa285d61bf011bbe7ca8f02818f19ed79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?L=C3=A9on=20Tiek=C3=B6tter?= Date: Tue, 21 Jun 2022 14:48:46 +0200 Subject: [PATCH] [docs] corrections from @tiekoetter's review --- docs/admin/architecture.rst | 2 +- docs/admin/installation-apache.rst | 18 +++++++++--------- docs/admin/installation-docker.rst | 4 ++-- docs/admin/installation-nginx.rst | 12 ++++++------ docs/admin/installation-scripts.rst | 10 +++++----- docs/admin/installation-searxng.rst | 6 +++--- docs/admin/installation-uwsgi.rst | 12 ++++++------ docs/admin/installation.rst | 2 +- docs/admin/update-searxng.rst | 4 ++-- docs/utils/searxng.sh.rst | 2 +- 10 files changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/admin/architecture.rst b/docs/admin/architecture.rst index be99aa994..d0d40715d 100644 --- a/docs/admin/architecture.rst +++ b/docs/admin/architecture.rst @@ -19,7 +19,7 @@ SearXNG infrastructures. uWSGI Setup =========== -We start with a *reference* setup for public SearXNG instances which can build +We start with a *reference* setup for public SearXNG instances which can be build up and maintained by the scripts from our :ref:`toolboxing`. .. _arch public: diff --git a/docs/admin/installation-apache.rst b/docs/admin/installation-apache.rst index ca919812e..673a37ee4 100644 --- a/docs/admin/installation-apache.rst +++ b/docs/admin/installation-apache.rst @@ -40,8 +40,8 @@ Apache https://httpd.apache.org/docs/current/mod/mod_proxy.html -This section explains how to set up a SearXNG site using the HTTP server Apache_. -If you have used the :ref:`installation scripts` and do not have any preference +This section explains how to set up a SearXNG instance using the HTTP server Apache_. +If you did use the :ref:`installation scripts` and do not have any special preferences you can install the :ref:`SearXNG site ` using :ref:`searxng.sh `: @@ -99,8 +99,8 @@ Directives`_ documentation gives first orientation. There is also a list of sudo -H systemctl enable httpd sudo -H systemctl start httpd -Now at http://localhost you should see any kind of *Welcome* or *Test* page. -How this default intro site is configured, depends on the linux distribution +Now at http://localhost you should see some kind of *Welcome* or *Test* page. +How this default site is configured, depends on the linux distribution (compare `Apache directives`_). .. tabs:: @@ -322,11 +322,11 @@ mod_proxy_ module (:ref:`apache modules`). With ProxyPreserveHost_ the incoming ``Host`` header is passed to the proxied host. -Depending on what your SearXNG installation is listen, you need a http +Depending on what your SearXNG installation is listening on, you need a http mod_proxy_http_) or socket (mod_proxy_uwsgi_) communication to upstream. -The :ref:`installation scripts` installs by default the :ref:`reference setup -` and a :ref:`uwsgi setup` that listens on a socket. +The :ref:`installation scripts` installs the :ref:`reference setup +` and a :ref:`uwsgi setup` that listens on a socket by default. You can install and activate your own ``searxng.conf`` like shown in :ref:`apache sites`. @@ -383,6 +383,6 @@ one of the lines and `restart apache`_: SetEnvIf Request_URI "/searxng" dontlog # CustomLog /dev/null combined env=dontlog -The ``CustomLog`` directive disable logs of the entire (virtual) server, use it -when the URL of the service does not have a path component (``/searxng``), when +The ``CustomLog`` directive disables logs for the entire (virtual) server, use it +when the URL of the service does not have a path component (``/searxng``), so when SearXNG is located at root (``/``). diff --git a/docs/admin/installation-docker.rst b/docs/admin/installation-docker.rst index 7800472eb..1457d6a6b 100644 --- a/docs/admin/installation-docker.rst +++ b/docs/admin/installation-docker.rst @@ -51,8 +51,8 @@ of this container: Get Docker ========== -If you plan to build and maintain a docker image by your own, make sure you have -`Docker installed `_ and on Linux, don't +If you plan to build and maintain a docker image by yourself, make sure you have +`Docker installed `_. On Linux don't forget to add your user to the docker group (log out and log back in so that your group membership is re-evaluated): diff --git a/docs/admin/installation-nginx.rst b/docs/admin/installation-nginx.rst index 33b6df53a..8e5299588 100644 --- a/docs/admin/installation-nginx.rst +++ b/docs/admin/installation-nginx.rst @@ -19,8 +19,8 @@ NGINX .. _SCRIPT_NAME: https://werkzeug.palletsprojects.com/en/1.0.x/wsgi/#werkzeug.wsgi.get_script_name -This section explains how to set up a SearXNG site using the HTTP server nginx_. -If you have used the :ref:`installation scripts` and do not have any preference +This section explains how to set up a SearXNG instance using the HTTP server nginx_. +If you have used the :ref:`installation scripts` and do not have any special preferences you can install the :ref:`SearXNG site ` using :ref:`searxng.sh `: @@ -78,7 +78,7 @@ If nginx_ is not installed, install it now. Now at http://localhost you should see a *Welcome to nginx!* page, on Fedora you see a *Fedora Webserver - Test Page*. The test page comes from the default -`nginx server configuration`_. How this default intro site is configured, +`nginx server configuration`_. How this default site is configured, depends on the linux distribution: .. tabs:: @@ -134,7 +134,7 @@ site. If nginx_ is new to you, the `nginx beginners guide`_ is a good starting point and the `Getting Started wiki`_ is always a good resource *to keep in the pocket*. -Depending on what your SearXNG installation is listen, you need a http or socket +Depending on what your SearXNG installation is listening on, you need a http or socket communication to upstream. .. tabs:: @@ -151,8 +151,8 @@ communication to upstream. :start-after: START nginx http :end-before: END nginx http -The :ref:`installation scripts` installs by default the :ref:`reference setup -` and a :ref:`uwsgi setup` that listens on a socket. +The :ref:`installation scripts` installs the :ref:`reference setup +` and a :ref:`uwsgi setup` that listens on a socket by default. .. tabs:: diff --git a/docs/admin/installation-scripts.rst b/docs/admin/installation-scripts.rst index 0efeee2a8..e256a2461 100644 --- a/docs/admin/installation-scripts.rst +++ b/docs/admin/installation-scripts.rst @@ -4,12 +4,12 @@ Installation Script =================== -.. sidebar:: Update OS first! +.. sidebar:: Update the OS first! To avoid unwanted side effects, update your OS before installing SearXNG. The following will install a setup as shown in :ref:`the reference architecture -`. First you need to get a clone. The clone is only needed for +`. First you need to get a clone of the repository. The clone is only needed for the installation procedure and some maintenance tasks. .. sidebar:: further read @@ -41,9 +41,9 @@ including a :ref:`uWSGI setup ` as described in the For the installation procedure, use a *sudoer* login to run the scripts. If you install from ``root``, take into account that the scripts are creating a - ``searxng`` user. In the installation procedure this new created user do - need read access to the clone of searx, which is not the case if you clone - into a folder below ``/root``! + ``searxng`` user. In the installation procedure this new created user does + need read access to the cloned SearXNG repository, which is not the case if you clone + it into a folder below ``/root``! .. sidebar:: further read diff --git a/docs/admin/installation-searxng.rst b/docs/admin/installation-searxng.rst index db760bc39..9152784fc 100644 --- a/docs/admin/installation-searxng.rst +++ b/docs/admin/installation-searxng.rst @@ -52,8 +52,8 @@ In the same shell create *virtualenv*: :start-after: START create virtualenv :end-before: END create virtualenv -To install searx's dependencies, exit the SearXNG *bash* session you opened above -and restart a new. Before install, first check if your *virtualenv* was sourced +To install SearXNG's dependencies, exit the SearXNG *bash* session you opened above +and start a new one. Before installing, check if your *virtualenv* was sourced from the login (*~/.profile*): .. kernel-include:: $DOCS_BUILD/includes/searxng.rst @@ -127,6 +127,6 @@ configuration file. :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 +debug option in ``settings.yml``. You can now exit SearXNG user bash session (enter exit command twice). At this point SearXNG is not demonized; uwsgi allows this. diff --git a/docs/admin/installation-uwsgi.rst b/docs/admin/installation-uwsgi.rst index eea52ab3e..a6ea85608 100644 --- a/docs/admin/installation-uwsgi.rst +++ b/docs/admin/installation-uwsgi.rst @@ -80,7 +80,7 @@ Distributors The `uWSGI Emperor`_ mode and `systemd unit template`_ is what the distributors mostly offer their users, even if they differ in the way they implement both -modes and their defaults. Another point they might differ is the packaging of +modes and their defaults. Another point they might differ in is the packaging of plugins (if so, compare :ref:`install packages`) and what the default python interpreter is (python2 vs. python3). @@ -98,8 +98,8 @@ Debian's uWSGI layout https://salsa.debian.org/uwsgi-team/uwsgi/-/raw/debian/latest/debian/uwsgi.README.Debian Be aware, Debian's uWSGI layout is quite different from the standard uWSGI -configuration. Your are familiar with :ref:`Debian's Apache layout`? .. they do -similar for the uWSGI infrastructure. The folders are:: +configuration. Your are familiar with :ref:`Debian's Apache layout`? .. they do a +similar thing for the uWSGI infrastructure. The folders are:: /etc/uwsgi/apps-available/ /etc/uwsgi/apps-enabled/ @@ -108,7 +108,7 @@ The `uwsgi ini file`_ is enabled by a symbolic link:: ln -s /etc/uwsgi/apps-available/searxng.ini /etc/uwsgi/apps-enabled/ -More details you will find in the uwsgi.README.Debian_ +More details can be found in the uwsgi.README.Debian_ (``/usr/share/doc/uwsgi/README.Debian.gz``). Some commands you should know on Debian: @@ -235,8 +235,8 @@ major release is from Dec. 2013, since the there had been only bugfix releases **In Tyrant mode, there is no way to get additional groups, and the uWSGI process misses additional permissions that may be needed.** -By example, on Fedora (RHEL): If you try to install a redis DB with socket -communication and you want to connect from the SearXNG uWSGI, you will see a +For example on Fedora (RHEL): If you try to install a redis DB with socket +communication and you want to connect to it from the SearXNG uWSGI, you will see a *Permission denied* in the log of your instance:: ERROR:searx.shared.redis: [searxng (993)] can't connect redis DB ... diff --git a/docs/admin/installation.rst b/docs/admin/installation.rst index 8b2b4b3e5..cae51be63 100644 --- a/docs/admin/installation.rst +++ b/docs/admin/installation.rst @@ -10,7 +10,7 @@ Installation - :ref:`installation scripts` - :ref:`installation basic` -The :ref:`installation basic` is a excellent illustration of *how a SearXNG +The :ref:`installation basic` is an excellent illustration of *how a SearXNG instance is build up* (see :ref:`architecture uWSGI`). If you do not have any special preferences, its recommend to use the :ref:`installation docker` or the :ref:`installation scripts`. diff --git a/docs/admin/update-searxng.rst b/docs/admin/update-searxng.rst index 4eba7633c..15735b0ba 100644 --- a/docs/admin/update-searxng.rst +++ b/docs/admin/update-searxng.rst @@ -18,7 +18,7 @@ How to update ============= How to update depends on the :ref:`installation` method. If you have used the -:ref:`installation scripts`, use ``update`` command from the :ref:`searxng.sh` +:ref:`installation scripts`, use the ``update`` command from the :ref:`searxng.sh` script. .. code:: sh @@ -31,7 +31,7 @@ How to inspect & debug ====================== How to debug depends on the :ref:`installation` method. If you have used the -:ref:`installation scripts`, use ``inspect`` command from the :ref:`searxng.sh` +:ref:`installation scripts`, use the ``inspect`` command from the :ref:`searxng.sh` script. .. code:: sh diff --git a/docs/utils/searxng.sh.rst b/docs/utils/searxng.sh.rst index 0558f22a8..f6578f7b1 100644 --- a/docs/utils/searxng.sh.rst +++ b/docs/utils/searxng.sh.rst @@ -12,7 +12,7 @@ - :ref:`installation nginx` - :ref:`installation apache` -To simplify installation and maintenance of a SearXNG instance you can use the +To simplify the installation and maintenance of a SearXNG instance you can use the script :origin:`utils/searxng.sh`. Install