summaryrefslogtreecommitdiff
path: root/searx/engines/bing.py
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarit.de>2022-10-27 19:21:17 +0200
committerMarkus Heiser <markus.heiser@darmarit.de>2023-03-24 10:37:42 +0100
commite0a6ca96cc071c7b02fb024d34a8902e636d0653 (patch)
tree2f60f484fe864130b1a76082914d4dabfea6cd1c /searx/engines/bing.py
parent15eaf0f15fac1efa93dc5a3a85dd61c151b81298 (diff)
downloadsearxng-e0a6ca96cc071c7b02fb024d34a8902e636d0653.tar.gz
searxng-e0a6ca96cc071c7b02fb024d34a8902e636d0653.zip
[doc] add a description of bing engines (web, news, video, images)
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Diffstat (limited to 'searx/engines/bing.py')
-rw-r--r--searx/engines/bing.py27
1 files changed, 24 insertions, 3 deletions
diff --git a/searx/engines/bing.py b/searx/engines/bing.py
index 385c973cb..0f85c7036 100644
--- a/searx/engines/bing.py
+++ b/searx/engines/bing.py
@@ -1,10 +1,31 @@
# SPDX-License-Identifier: AGPL-3.0-or-later
# lint: pylint
-"""Bing (Web)
+"""This is the implementation of the Bing-WEB engine. Some of this
+implementations are shared by other engines:
-- https://github.com/searx/searx/issues/2019#issuecomment-648227442
-"""
+- :ref:`bing images engine`
+- :ref:`bing news engine`
+- :ref:`bing videos engine`
+
+On the `preference page`_ Bing offers a lot of languages an regions (see section
+'Search results languages' and 'Country/region'). However, the abundant choice
+does not correspond to reality, where Bing has a full-text indexer only for a
+limited number of languages. By example: you can select a language like Māori
+but you never get a result in this language.
+
+What comes a bit closer to the truth are the `search-APIs`_ but they don`t seem
+to be completely correct either (if you take a closer look you will find some
+inaccuracies there too):
+- :py:obj:`searx.engines.bing.bing_traits_url`
+- :py:obj:`searx.engines.bing_videos.bing_traits_url`
+- :py:obj:`searx.engines.bing_images.bing_traits_url`
+- :py:obj:`searx.engines.bing_news.bing_traits_url`
+
+.. _preference page: https://www.bing.com/account/general
+.. _search-APIs: https://learn.microsoft.com/en-us/bing/search-apis/
+
+"""
# pylint: disable=too-many-branches, invalid-name
from typing import TYPE_CHECKING