diff options
author | Markus Heiser <markus.heiser@darmarit.de> | 2022-10-27 19:21:17 +0200 |
---|---|---|
committer | Markus Heiser <markus.heiser@darmarit.de> | 2023-03-24 10:37:42 +0100 |
commit | e0a6ca96cc071c7b02fb024d34a8902e636d0653 (patch) | |
tree | 2f60f484fe864130b1a76082914d4dabfea6cd1c /searx/engines/bing.py | |
parent | 15eaf0f15fac1efa93dc5a3a85dd61c151b81298 (diff) | |
download | searxng-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.py | 27 |
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 |