searxng/docs/admin
Markus Heiser 5fca26f0b3 [mod] engines_languages.json: add new type engine_properties
This patch adds the boilerplate code, needed to fetch properties from engines.
In the past we only fetched *languages* but some engines need *regions* to
parameterize the engine request.

To fit into our *fetch language* procedures the boilerplate is implemented in
the `searxng_extra/update/update_languages.py` and the *engine_properties* are
stored along in the `searx/data/engines_languages.json`.

This implementation is downward compatible to the `_fetch_fetch_languages()`
infrastructure we have.  If there comes the day we have all
`_fetch_fetch_languages()` implementations moved to `_fetch_engine_properties()`
implementations, we can rename the files and scripts.

The new type `engine_properties` is a dictionary with keys `languages` and
`regions`.  The values are dictionaries to map from SearXNG's language & region
to option values the engine does use::

    engine_properties = {
        'type' : 'engine_properties',  # <-- !!!
        'regions': {
            # 'ca-ES' : <engine's region name>
        },
        'languages': {
            # 'ca' : <engine's language name>
        },
    }

Similar to the `supported_languages`, in the engine the properties are available
under the name `supported_properties`.

Initial we start with languages & regions, but in a wider sense the type is
named *engine properties*.  Engines can store in whatever options they need and
may be in the future there is a need to fetch additional or complete different
properties.

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2022-04-19 14:35:02 +02:00
..
engines [mod] engines_languages.json: add new type engine_properties 2022-04-19 14:35:02 +02:00
api.rst [brand] docs - normalize project name to SearXNG 2021-09-13 14:36:24 +02:00
arch_public.dot reference docs.searxng.org 2022-01-02 21:18:29 +01:00
architecture.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
buildhosts.rst [doc] modify docs to fit to the new build boilerplate 2021-04-23 11:26:22 +02:00
filtron.rst [doc] add some documentation about the limiter plugin (and redis) 2022-03-25 11:26:10 +01:00
index.rst [docs] Switch from searx to SearXNG 2022-01-17 10:05:13 +01:00
installation-apache.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
installation-docker.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
installation-nginx.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
installation-searxng.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
installation-switch2ng.rst [docs] fix some warnings from Sphinx-doc update 4.3.2 to 4.4.0 2022-01-21 09:35:00 +01:00
installation-uwsgi.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
installation.rst [docs] Switch from searx to SearXNG 2022-01-17 10:05:13 +01:00
morty.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00
plugins.rst [mod] documentation: change the jinja context doesn't depend on searx.webapp 2020-12-27 10:00:35 +01:00
update-searxng.rst [brand] SearXNG - docs rename links and fix documentation 2021-11-18 18:27:26 +01:00