[upd] pypi: Update docutils requirement from >=0.21.2 to >=0.22.4

Updates the requirements on [docutils](https://github.com/rtfd/recommonmark) to permit the latest version. - [Changelog](https://github.com/readthedocs/recommonmark/blob/master/CHANGELOG.md) - [Commits](https://github.com/rtfd/recommonmark/commits) --- updated-dependencies: - dependency-name: docutils dependency-version: 0.22.4 dependency-type: direct:development ... Signed-off-by: dependabot[bot] <support@github.com>
2026-05-07 18:03:51 +02:00 · 2026-04-29 05:33:43 +00:00
85 changed files with 1140 additions and 696 deletions
@@ -24,13 +24,13 @@
        "mathjs": "^15.2.0",
        "sharp": "~0.34.5",
        "sort-package-json": "^3.6.1",
-        "stylelint": "^17.9.1",
+        "stylelint": "^17.9.0",
        "stylelint-config-standard-less": "^4.1.0",
        "stylelint-prettier": "^5.0.3",
        "svgo": "^4.0.1",
        "typescript": "~6.0.3",
        "vite": "^8.0.10",
-        "vite-bundle-analyzer": "^1.3.8"
+        "vite-bundle-analyzer": "^1.3.7"
      }
    },
    "node_modules/@babel/code-frame": {
@@ -417,29 +417,6 @@
        "postcss-selector-parser": "^7.1.1"
      }
    },
-    "node_modules/@emnapi/core": {
-      "version": "1.10.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
-      "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "@emnapi/wasi-threads": "1.2.1",
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@emnapi/runtime": {
-      "version": "1.10.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
-      "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
    "node_modules/@emnapi/wasi-threads": {
      "version": "1.2.1",
      "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz",
@@ -4059,9 +4036,9 @@
      }
    },
    "node_modules/stylelint": {
-      "version": "17.9.1",
-      "resolved": "https://registry.npmjs.org/stylelint/-/stylelint-17.9.1.tgz",
-      "integrity": "sha512-THTmnAPJTrg/JhkTWZlSyrO+HUYMx6ELthIHeMyD2WOKqXIJUFQv2Yxn91bvUrZdbBJaW2dUuQdPST2wcQ6C3g==",
+      "version": "17.9.0",
+      "resolved": "https://registry.npmjs.org/stylelint/-/stylelint-17.9.0.tgz",
+      "integrity": "sha512-xO0jeY6z1/urFL5L/BZLmB1yYlbRiRMQnYH6ArZIDWJ+SZXGssOY7XoYb1JIv/L220+EBnwwJXJS4Mt/F96SvA==",
      "dev": true,
      "funding": [
        {
@@ -4623,9 +4600,9 @@
      }
    },
    "node_modules/vite-bundle-analyzer": {
-      "version": "1.3.8",
-      "resolved": "https://registry.npmjs.org/vite-bundle-analyzer/-/vite-bundle-analyzer-1.3.8.tgz",
-      "integrity": "sha512-IIk7WPhoYs7pyo75jwI+dFt7yykgjK7NY+dqnJtiZnyqP2k6NgPb3TY80FLFjtgnfk/o+OjI18+anKyeviCbRA==",
+      "version": "1.3.7",
+      "resolved": "https://registry.npmjs.org/vite-bundle-analyzer/-/vite-bundle-analyzer-1.3.7.tgz",
+      "integrity": "sha512-dYlW6iM0Gq7+uSEfXytDC+UjruUMgEKhXwQUbw4cJUgHA6FdEhpLgIrL5OZEyabrzVen0mZyfOSESyZ7nGyT8g==",
      "dev": true,
      "license": "MIT",
      "bin": {
@@ -38,12 +38,12 @@
    "mathjs": "^15.2.0",
    "sharp": "~0.34.5",
    "sort-package-json": "^3.6.1",
-    "stylelint": "^17.9.1",
+    "stylelint": "^17.9.0",
    "stylelint-config-standard-less": "^4.1.0",
    "stylelint-prettier": "^5.0.3",
    "svgo": "^4.0.1",
    "typescript": "~6.0.3",
    "vite": "^8.0.10",
-    "vite-bundle-analyzer": "^1.3.8"
+    "vite-bundle-analyzer": "^1.3.7"
  }
 }
@@ -1,57 +0,0 @@
-.content {
-  width: 52em;    /*  instead of 46em */
-}
-
-p code.literal {
-  text-wrap: nowrap;
-}
-
-aside.sidebar {
-  border-color: lightsteelblue;
-  border-radius: 3pt;
-}
-
-p.sidebar-title, .sidebar p {
-  margin: 6pt;
-}
-
-.sidebar li,
-.hlist li {
-  list-style-type: disclosure-closed;
-}
-
-.sphinxsidebar .current > a {
-  font-weight: bold;
-}
-
-/* admonitions with (rendered) reST markup examples (:class: rst-example)
- *
- * .. admonition:: title of the example
- *     :class: rst-example
- *     ....
-*/
-
-div.rst-example {
-  background-color: inherit;
-  margin: 0;
-  border-top: none;
-  border-right: 1px solid #ccc;
-  border-bottom: none;
-  border-left: none;
-  border-radius: none;
-  padding: 0;
-}
-
-div.rst-example > p.admonition-title {
-  font-family: Sans Serif;
-  font-style: italic;
-  font-size: 0.8em;
-  display: block;
-  border-bottom: 1px solid #ccc;
-  padding: 0.5em 1em;
-  text-align: right;
-}
-
-div.sphinx-tabs {
-    clear: both;
-}
@@ -0,0 +1,151 @@
+@import url("pocoo.css");
+
+a, a.reference, a.footnote-reference {
+  color: #004b6b;
+  border-color: #004b6b;
+}
+
+a:hover {
+  color: #6d4100;
+  border-color: #6d4100;
+}
+
+p.version-warning {
+  background-color: #004b6b;
+}
+
+aside.sidebar {
+  background-color: whitesmoke;
+  border-color: lightsteelblue;
+  border-radius: 3pt;
+}
+
+div.sphinxsidebar p.caption {
+  display: none;
+}
+
+p.sidebar-title, .sidebar p {
+  margin: 6pt;
+}
+
+.sidebar li,
+.hlist li {
+  list-style-type: disclosure-closed;
+}
+
+.sphinxsidebar .current > a {
+  font-weight: bold;
+}
+
+/* admonitions
+*/
+
+div.admonition, div.topic, nav.contents, div.toctree-wrapper {
+  background-color: #fafafa;
+  margin: 8px 0px;
+  padding: 1em;
+  border-radius: 3pt 0 0 3pt;
+  border-top: none;
+  border-right: none;
+  border-bottom: none;
+  border-left: 5pt solid #ccc;
+  list-style-type: disclosure-closed;
+}
+
+div.toctree-wrapper p.caption {
+  font-weight: normal;
+  font-size: 24px;
+  margin: 0 0 10px 0;
+  padding: 0;
+  line-height: 1;
+  display: inline;
+}
+
+p.admonition-title:after {
+  content: none;
+}
+
+.admonition.hint      { border-color: #416dc0b0; }
+.admonition.note      { border-color: #6c856cb0; }
+.admonition.tip       { border-color: #85c5c2b0; }
+.admonition.attention { border-color: #ecec97b0; }
+.admonition.caution   { border-color: #a6c677b0; }
+.admonition.danger    { border-color: #d46262b0; }
+.admonition.important { border-color: #dfa3a3b0; }
+.admonition.error     { border-color: red; }
+.admonition.warning   { border-color: darkred; }
+
+.admonition.admonition-generic-admonition-title {
+    border-color: #416dc0b0;
+}
+
+
+/* admonitions with (rendered) reST markup examples (:class: rst-example)
+ *
+ * .. admonition:: title of the example
+ *     :class: rst-example
+ *     ....
+*/
+
+div.rst-example {
+  background-color: inherit;
+  margin: 0;
+  border-top: none;
+  border-right: 1px solid #ccc;
+  border-bottom: none;
+  border-left: none;
+  border-radius: none;
+  padding: 0;
+}
+
+div.rst-example > p.admonition-title {
+  font-family: Sans Serif;
+  font-style: italic;
+  font-size: 0.8em;
+  display: block;
+  border-bottom: 1px solid #ccc;
+  padding: 0.5em 1em;
+  text-align: right;
+}
+
+/* code block in figures
+ */
+
+div.highlight pre {
+    text-align: left;
+}
+
+/* Table theme
+*/
+
+thead, tfoot {
+  background-color: #fff;
+}
+
+th:hover, td:hover {
+  background-color: #ffc;
+}
+
+thead th, tfoot th, tfoot td, tbody th {
+  background-color: #fffaef;
+}
+
+tbody tr:nth-child(odd) {
+  background-color: #fff;
+}
+
+tbody tr:nth-child(even) {
+  background-color: #fafafa;
+}
+
+caption {
+  font-family: Sans Serif;
+  padding: 0.5em;
+  margin: 0.5em 0 0.5em 0;
+  caption-side: top;
+  text-align: left;
+}
+
+div.sphinx-tabs {
+    clear: both;
+}
@@ -0,0 +1,7 @@
+[theme]
+inherit = pocoo
+stylesheet = searxng.css
+
+[options]
+touch_icon =
+globaltoc_maxdepth = 5
@@ -4,6 +4,11 @@
 Buildhosts
 ==========

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 To get best results from build, it's recommend to install additional packages on
 build hosts (see :ref:`searxng.sh`).

@@ -61,6 +61,11 @@ section might give you some guidance.
   - `Apache Fedora`_
   - `Apache directives`_

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+

 The Apache HTTP server
 ======================
@@ -41,6 +41,12 @@ section might give you some guidance.
   - `uWSGI support from nginx`_


+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 The nginx HTTP server
 =====================

@@ -4,6 +4,12 @@
 Step by step installation
 =========================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 In this section we show the setup of a SearXNG instance that will be installed
 by the :ref:`installation scripts`.

@@ -9,6 +9,12 @@ uWSGI
   - `systemd.unit`_
   - `uWSGI Emperor`_

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _systemd.unit: https://www.freedesktop.org/software/systemd/man/systemd.unit.html
 .. _One service per app in systemd:
    https://uwsgi-docs.readthedocs.io/en/latest/Systemd.html#one-service-per-app-in-systemd
@@ -8,6 +8,11 @@ Favicons

   Don't activate the favicons before reading the documentation.

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Activating the favicons in SearXNG is very easy, but this **generates a
 significantly higher load** in the client/server communication and increases
 resources needed on the server.
@@ -245,3 +250,4 @@ into the *proxy*:
 .. _data URL:
   https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
 .. _FQN: https://en.wikipedia.org/wiki/Fully_qualified_name
+
@@ -8,5 +8,10 @@ Limiter

   The limiter requires a :ref:`Valkey <settings valkey>` database.

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.limiter
   :members:
@@ -12,6 +12,11 @@ file.
   - :ref:`use_default_settings.yml`
   - :ref:`search API`

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _settings location:

 settings.yml location
@@ -102,18 +102,11 @@ The built-in plugins are all located in the namespace `searx.plugins`.
 external plugins
 ================

-SearXNG supports :ref:`external plugins <dev plugin>` / there is no need to
-install one, SearXNG runs out of the box.
-
-`Only show green hosted results`_:
-  SearXNG plugin to check if a domain is part of the Green WEB.
-
-`SearXNG BM25 Reranker`_:
-  SearXNG plugin that reranks search results using BM25 text relevance scoring
-  to improve search quality.
-
 .. _Only show green hosted results:
-    https://github.com/return42/tgwf-searx-plugins/
+   https://github.com/return42/tgwf-searx-plugins/

-.. _SearXNG BM25 Reranker:
-    https://github.com/Oaklight/searxng-bm25-reranker
+SearXNG supports *external plugins* / there is no need to install one, SearXNG
+runs out of the box.
+
+- `Only show green hosted results`_
+- ..
@@ -9,6 +9,11 @@ SearXNG maintenance
   - :ref:`toolboxing`
   - :ref:`uWSGI maintenance`

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _update searxng:

 How to update
@@ -1,7 +1,8 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later

-import os
+import  sys, os
 from pathlib import Path
+from pallets_sphinx_themes import ProjectLink

 from searx import get_setting
 from searx.version import VERSION_STRING, GIT_URL, GIT_BRANCH
@@ -97,6 +98,7 @@ extlinks['pull-searx'] = ('https://github.com/searx/searx/pull/%s', 'PR %s')
 extlinks['origin'] = (GIT_URL + '/blob/' + GIT_BRANCH + '/%s', 'git://%s')
 extlinks['patch'] = (GIT_URL + '/commit/%s', '#%s')
 extlinks['docs'] = (DOCS_URL + '/%s', 'docs: %s')
+extlinks['pypi'] = ('https://pypi.org/project/%s', 'PyPi: %s')
 extlinks['man'] = ('https://manpages.debian.org/jump?q=%s', '%s')
 #extlinks['role'] = (
 #    'https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-%s', '')
@@ -115,6 +117,7 @@ extensions = [
    'sphinx.ext.viewcode',
    "sphinx.ext.autodoc",
    "sphinx.ext.intersphinx",
+    "pallets_sphinx_themes",
    "sphinx_issues", # https://github.com/sloria/sphinx-issues/blob/master/README.rst
    "sphinx_jinja",  # https://github.com/tardyp/sphinx-jinja
    "sphinxcontrib.programoutput",  # https://github.com/NextThought/sphinxcontrib-programoutput
@@ -155,49 +158,15 @@ issues_github_path = "searxng/searxng"

 # HTML -----------------------------------------------------------------

-html_theme = "furo"
-html_theme_options = {
-    # link to project source at GitHub for editing and viewing docs code
-    "source_repository": "https://github.com/searxng/searxng/",
-    "source_branch": "master",
-    "source_directory": "docs/",
-
-    # Show link to repository & searx.space in footer
-    "footer_icons": [
-        {
-            "name": "GitHub",
-            "url": "https://github.com/searxng/searxng/",
-            "html": "&#x1F4BE;",
-        },
-        {
-            "name": "searx.space",
-            "url": "https://searx.space/",
-            "html": "&#x1F310;",
-        },
-    ],
-}
-
-html_sidebars = {
-    "**": [
-        "sidebar/scroll-start.html",
-        "sidebar/brand.html",
-        "sidebar/search.html",
-        "sidebar/navigation.html",
-        "sidebar/ethical-ads.html",
-        "sidebar/scroll-end.html",
-    ]
-}
-
-html_static_path = ['_static']
-
-html_css_files = [
-    'searxng.css',
-]
-
 # https://searxng.github.io/searxng --> '/searxng/'
 # https://docs.searxng.org --> '/'
 notfound_urls_prefix = '/'

+sys.path.append(os.path.abspath('_themes'))
+sys.path.insert(0, os.path.abspath("../"))
+html_theme_path = ['_themes']
+html_theme = "searxng"
+
 # sphinx.ext.imgmath setup
 html_math_renderer = 'imgmath'
 imgmath_image_format = 'svg'
@@ -205,10 +174,34 @@ imgmath_font_size = 14
 # sphinx.ext.imgmath setup END

 html_show_sphinx = False
+html_theme_options = {"index_sidebar_logo": True}
+html_context = {"project_links": [] }
+html_context["project_links"].append(ProjectLink("Source", GIT_URL + '/tree/' + GIT_BRANCH))
+
+if WIKI_URL:
+    html_context["project_links"].append(ProjectLink("Wiki", WIKI_URL))
+if PUBLIC_INSTANCES:
+    html_context["project_links"].append(ProjectLink("Public instances", PUBLIC_INSTANCES))
+if ISSUE_URL:
+    html_context["project_links"].append(ProjectLink("Issue Tracker", ISSUE_URL))
+if PRIVACYPOLICY_URL:
+    html_context["project_links"].append(ProjectLink("Privacy Policy", PRIVACYPOLICY_URL))
+if CONTACT_URL:
+    html_context["project_links"].append(ProjectLink("Contact", CONTACT_URL))
+
+html_sidebars = {
+    "**": [
+        "globaltoc.html",
+        "project.html",
+        "relations.html",
+        "searchbox.html",
+        "sourcelink.html"
+    ],
+}
+singlehtml_sidebars = {"index": ["project.html", "localtoc.html"]}
 html_logo = "../client/simple/src/brand/searxng-wordmark.svg"
 html_title = "SearXNG Documentation ({})".format(VERSION_STRING)
 html_show_sourcelink = True
-html_copy_source = True

 # LaTeX ----------------------------------------------------------------

@@ -4,6 +4,11 @@
 How to contribute
 =================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Prime directives: Privacy, Hackability
 ======================================

@@ -4,6 +4,11 @@
 Demo Offline Engine
 ===================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_offline
  :members:

@@ -4,6 +4,11 @@
 Demo Online Engine
 ==================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_online
  :members:

@@ -4,6 +4,11 @@
 Engine Overview
 ===============

+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 .. _metasearch-engine: https://en.wikipedia.org/wiki/Metasearch_engine

 .. sidebar:: Further reading ..
@@ -4,6 +4,12 @@
 Engine Implementations
 ======================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. toctree::
   :caption: Framework Components
   :maxdepth: 2
@@ -4,5 +4,10 @@
 JSON Engine
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.json_engine
  :members:
@@ -4,5 +4,10 @@
 MediaWiki Engine
 ================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.mediawiki
  :members:
@@ -9,6 +9,11 @@ Command Line Engines
   - :origin:`command.py <searx/engines/command.py>`
   - :ref:`offline engines`

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info

   Initial sponsored by `Search and Discovery Fund
@@ -6,16 +6,21 @@ NoSQL databases

 .. sidebar:: further read

-   - `NoSQL database <https://en.wikipedia.org/wiki/NoSQL>`_
+   - `NoSQL databases <https://en.wikipedia.org/wiki/NoSQL>`_
   - `valkey.io <https://valkey.io/>`_
   - `MongoDB <https://www.mongodb.com>`_

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info

   Initial sponsored by `Search and Discovery Fund
   <https://nlnet.nl/discovery>`_ of `NLnet Foundation <https://nlnet.nl/>`_.

-The following `NoSQL database`_ are supported:
+The following `NoSQL databases`_ are supported:

 - :ref:`engine valkey_server`
 - :ref:`engine mongodb`
@@ -52,7 +57,7 @@ instance.  To switch into the environment (:ref:`searxng-src`) you can use
 Configure the engines
 =====================

-`NoSQL database`_ are used for storing arbitrary data without first defining
+`NoSQL databases`_ are used for storing arbitrary data without first defining
 their structure.


@@ -70,13 +75,13 @@ Valkey Server
   - :origin:`valkey_server.py <searx/engines/valkey_server.py>`

 .. automodule:: searx.engines.valkey_server
-   :members:
+  :members:


 .. _engine mongodb:

-MongoDB / PyMongo
-----------------
+MongoDB
+-------

 .. _pymongo: https://github.com/mongodb/mongo-python-driver#installation

@@ -88,4 +93,4 @@ MongoDB / PyMongo


 .. automodule:: searx.engines.mongodb
-   :members:
+  :members:
@@ -7,6 +7,11 @@ Local Search APIs
   - `Comparison to alternatives
     <https://docs.meilisearch.com/learn/what_is_meilisearch/comparison_to_alternatives.html>`_

+.. contents::
+   :depth: 1
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info

   Initial sponsored by `Search and Discovery Fund
@@ -32,8 +37,8 @@ in section :ref:`private engines`.

 .. _engine meilisearch:

-MeiliSearch Engine
-==================
+MeiliSearch
+===========

 .. automodule:: searx.engines.meilisearch
  :members:
@@ -41,16 +46,17 @@ MeiliSearch Engine

 .. _engine elasticsearch:

-Elasticsearch Engine
-====================
+Elasticsearch
+=============

 .. automodule:: searx.engines.elasticsearch
  :members:

 .. _engine solr:

-Solr Engine
-===========
+Solr
+====

 .. automodule:: searx.engines.solr
  :members:
+
@@ -10,6 +10,11 @@ SQL Engines
   - `PostgreSQL <https://www.postgresql.org>`_
   - `MySQL <https://www.mysql.com>`_

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info

   Initial sponsored by `Search and Discovery Fund
@@ -4,5 +4,10 @@
 Adobe Stock
 ===========

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.adobe_stock
   :members:
@@ -4,5 +4,10 @@
 Alpine Linux Packages
 =====================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.alpinelinux
   :members:
@@ -4,5 +4,10 @@
 Anna's Archive
 ==============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.annas_archive
   :members:
@@ -4,6 +4,11 @@
 Arch Linux
 ==========

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.archlinux
  :members:

@@ -4,6 +4,12 @@
 Bing Engines
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _bing web engine:

 Bing WEB
@@ -4,5 +4,10 @@
 Bpb
 ===

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.bpb
  :members:
@@ -2,6 +2,11 @@
 Brave Engines
 =============

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Brave offers two different engines for SearXNG:

 1. The standard engine (``brave``) uses the web interface.
@@ -4,6 +4,11 @@
 BT4G
 ====

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.bt4g
  :members:

@@ -4,5 +4,10 @@
 CORE
 ====

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.core
   :members:
@@ -4,5 +4,10 @@
 Dailymotion
 ===========

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.dailymotion
  :members:
@@ -4,6 +4,11 @@
 DuckDuckGo Engines
 ==================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.duckduckgo
   :members:

@@ -4,6 +4,12 @@
 Google Engines
 ==============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _google API:

 Google API
@@ -4,5 +4,10 @@
 Lemmy
 =====

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.lemmy
   :members:
@@ -4,5 +4,10 @@
 Library of Congress
 ===================

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.loc
  :members:
@@ -4,5 +4,10 @@
 Mastodon
 ========

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.mastodon
  :members:
@@ -4,5 +4,10 @@
 Moviepilot
 ==========

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.moviepilot
   :members:
@@ -4,5 +4,10 @@
 Matrix Rooms Search (MRS)
 =========================

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.mrs
   :members:
@@ -4,6 +4,12 @@
 Mwmbl Engine
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _mwmbl web engine:

 Mwmbl WEB
@@ -4,5 +4,10 @@
 Odysee
 ======

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.odysee
  :members:
@@ -4,6 +4,12 @@
 Peertube Engines
 ================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _peertube video engine:

 Peertube Video
@@ -4,5 +4,10 @@
 Piped
 =====

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.piped
  :members:
@@ -4,5 +4,10 @@
 Presearch Engine
 ================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.presearch
   :members:
@@ -4,5 +4,10 @@
 Qwant
 =====

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.qwant
   :members:
@@ -4,5 +4,10 @@
 RadioBrowser
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.radio_browser
   :members:
@@ -4,5 +4,10 @@
 Recoll Engine
 =============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.recoll
   :members:
@@ -4,5 +4,10 @@
 Soundcloud
 ==========

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.soundcloud
   :members:
@@ -4,5 +4,10 @@
 Startpage Engines
 =================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.startpage
   :members:
@@ -4,5 +4,10 @@
 Tagesschau API
 ==============

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.tagesschau
  :members:
@@ -4,5 +4,10 @@
 Torznab WebAPI
 ==============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.torznab
   :members:
@@ -4,5 +4,10 @@
 Void Linux binary packages
 ==========================

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.voidlinux
  :members:
@@ -4,5 +4,10 @@
 Wallhaven
 =========

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.wallhaven
  :members:
@@ -4,6 +4,12 @@
 Wikimedia
 =========

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _wikipedia engine:

 Wikipedia
@@ -4,5 +4,10 @@
 Yacy
 ====

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.yacy
  :members:
@@ -4,5 +4,10 @@
 Yahoo Engine
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.yahoo
  :members:
@@ -4,5 +4,10 @@
 Z-Library
 =========

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.zlibrary
  :members:
@@ -4,6 +4,11 @@
 Tineye
 ======

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.tineye
  :members:

@@ -4,6 +4,11 @@
 XPath Engine
 ============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.xpath
  :members:

@@ -19,6 +19,11 @@ Makefiles, we recommend to read gnu-make_ introduction.
   To install developer requirements follow :ref:`buildhosts`.


+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 The usage is simple, just type ``make {target-name}`` to *build* a target.
 Calling the ``help`` target gives a first overview (``make help``):

@@ -36,6 +36,12 @@ docs.live <make docs.live>` to build HTML while editing.
   - SVG_, ImageMagick_
   - DOT_, `Graphviz's dot`_, Graphviz_

+
+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 Sphinx_ and reST_ have their place in the python ecosystem.  Over that reST is
 used in popular projects, e.g the Linux kernel documentation `[kernel doc]`_.

@@ -14,6 +14,11 @@ type of a result is defined by the :py:obj:`result_type.Result.template`.  To
 set another media-type as :ref:`template default`, the field ``template``
 in the result item must be set to the desired type.

+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+

 .. _result template macros:

@@ -7,6 +7,11 @@ Why use a private instance?
  \.\.\.is a common question among SearXNG users.  Before answering this
  question, see what options a SearXNG user has.

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Public instances are open to everyone who has access to their URL.  Usually, they
 are operated by unknown parties (from the users' point of view).  Private
 instances can be used by a select group of people, such as a SearXNG instance for a
@@ -4,6 +4,11 @@
 Bot Detection
 =============

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.botdetection
  :members:

@@ -4,6 +4,11 @@
 Favicons (source)
 =================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.favicons
   :members:

@@ -38,3 +43,6 @@ Favicons Cache

 .. automodule:: searx.favicons.cache
   :members:
+
+
+
@@ -4,6 +4,11 @@
 Locales
 =======

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.locales
   :members:

@@ -4,6 +4,12 @@
 Search processors
 =================

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 Abstract processor class
 ========================

@@ -22,6 +22,11 @@ Configured Engines
   called *tabs*), engines can be queried by their name or the categories they
   belong to, by using a :ref:`\!bing syntax <search-syntax>`.

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. jinja:: searx

   {% for category, engines in categories_as_tabs.items() %}
@@ -2,6 +2,11 @@
 User information
 ================

+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 .. toctree::
   :maxdepth: 2

@@ -15,6 +15,12 @@ script :origin:`utils/searxng.sh`.
   - :ref:`installation nginx`
   - :ref:`installation apache`

+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 Install
 =======

@@ -5,23 +5,21 @@ black==25.9.0
 pylint==4.0.5
 splinter==0.21.0
 selenium==4.43.0
-Sphinx==8.2.3;python_version <= "3.11"
-Sphinx==9.1.0; python_version > "3.11"
+Pallets-Sphinx-Themes==2.5.0
+Sphinx==8.2.3
 sphinx-issues==6.0.0
 sphinx-jinja==2.0.2
 sphinx-tabs==3.5.0
-furo==2025.12.19
 sphinxcontrib-programoutput==0.19
 sphinx-autobuild==2025.8.25
 sphinx-notfound-page==1.1.0
 myst-parser==5.0.0
-linuxdoc==20260504
+linuxdoc==20240924
 aiounittest==1.5.0
 yamllint==1.38.0
-wlc==2.0.0
+wlc==1.17.2
 coloredlogs==15.0.1
-docutils>=0.21.2;python_version <= "3.11"
-docutils>=0.22.4; python_version > "3.11"
+docutils>=0.22.4
 parameterized==0.9.0
 granian[reload]==2.7.4
 basedpyright==1.39.3
@@ -13,7 +13,7 @@ sniffio==1.3.1
 valkey==6.1.1
 markdown-it-py==4.0.0
 msgspec==0.21.1
-typer==0.25.1
+typer==0.25.0
 isodate==0.7.2
 whitenoise==6.12.0
 typing-extensions==4.15.0
@@ -39,12 +39,11 @@ def response(resp):

    for result in json_results:
        title_parts = [title['value'] for title in result['title']]
-        extract_parts = [extract['value'] for extract in result.get('extract', [])]
        results.append(
            {
                'url': result['url'],
                'title': ''.join(title_parts),
-                'content': ''.join(extract_parts),
+                'content': result['extract'][0]['value'],
            }
        )

@@ -345,10 +345,7 @@ def _get_news_result(result):

    publishedDate = None
    if result.get("date"):
-        try:
-            publishedDate = datetime.fromtimestamp(int(result["date"]) / 1000)
-        except (TypeError, ValueError):
-            pass
+        publishedDate = datetime.fromtimestamp(result["date"] / 1000)

    thumbnailUrl = None
    if result.get("thumbnailUrl"):
@@ -1,17 +1,10 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """Yep (general, images, news)"""

-import typing as t
-
+from datetime import datetime
 from urllib.parse import urlencode
-
-from searx.result_types import EngineResults
 from searx.utils import html_to_text

-if t.TYPE_CHECKING:
-    from searx.extended_types import SXNG_Response
-    from searx.search.processors import OnlineParams
-
 about = {
    'website': 'https://yep.com/',
    'official_api_documentation': 'https://docs.developer.yelp.com',
@@ -21,32 +14,69 @@ about = {
 }

 base_url = "https://api.yep.com"
+search_type = "web"  # 'web', 'images', 'news'

 safesearch = True
 safesearch_map = {0: 'off', 1: 'moderate', 2: 'strict'}

 enable_http2 = False

-results_per_page = 20

-
-def request(query: str, params: 'OnlineParams') -> None:
-    args = {'query': query, 'safeSearch': safesearch_map[params['safesearch']], 'limit': results_per_page}
+def request(query, params):
+    args = {
+        'client': 'web',
+        'no_correct': 'false',
+        'q': query,
+        'safeSearch': safesearch_map[params['safesearch']],
+        'type': search_type,
+    }
    params['url'] = f"{base_url}/fs/2/search?{urlencode(args)}"
    params['headers']['Referer'] = 'https://yep.com/'
    params['headers']['Origin'] = 'https://yep.com'
+    return params


-def response(resp: 'SXNG_Response') -> EngineResults:
-    res = EngineResults()
+def _web_result(result):
+    return {
+        'url': result['url'],
+        'title': result['title'],
+        'content': html_to_text(result['snippet']),
+    }
+
+
+def _images_result(result):
+    return {
+        'template': 'images.html',
+        'url': result['host_page'],
+        'title': result.get('title', ''),
+        'content': '',
+        'img_src': result['image_id'],
+        'thumbnail_src': result['src'],
+    }
+
+
+def _news_result(result):
+    return {
+        'url': result['url'],
+        'title': result['title'],
+        'content': html_to_text(result['snippet']),
+        'publishedDate': datetime.strptime(result['first_seen'][:19], '%Y-%m-%dT%H:%M:%S'),
+    }
+
+
+def response(resp):
+    results = []

    for result in resp.json()[1]['results']:
-        res.add(
-            res.types.MainResult(
-                url=result['url'],
-                title=result['title'],
-                content=html_to_text(result['snippet']),
-            )
-        )
+        if search_type == "web":
+            if result['type'] != 'Organic':
+                continue
+            results.append(_web_result(result))
+        elif search_type == "images":
+            results.append(_images_result(result))
+        elif search_type == "news":
+            results.append(_news_result(result))
+        else:
+            raise ValueError(f"Unsupported yep search type: {search_type}")

-    return res
+    return results
@@ -688,6 +688,22 @@ engines:
    engine: yep
    shortcut: yep
    categories: general
+    search_type: web
+    timeout: 15
+    disabled: true
+
+  - name: yep images
+    engine: yep
+    shortcut: yepi
+    categories: images
+    search_type: images
+    disabled: true
+
+  - name: yep news
+    engine: yep
+    shortcut: yepn
+    categories: news
+    search_type: news
    disabled: true

  - name: currency
@@ -1213,7 +1229,7 @@ engines:

  - name: karmasearch videos
    engine: karmasearch
-    categories: [videos, web]
+    categories: [general, web]
    search_type: videos
    shortcut: kav

@@ -67,13 +67,3 @@
         class="checkbox-onoff"{{- ' ' -}}
         {%- if checked -%} checked{%- endif -%}/>
 {%- endmacro -%}
-
-<!-- iframe that additionally sets some extra feature attrs for videos -->
-{%- macro iframe(iframe_src) -%}
-  <iframe data-src="{{iframe_src}}" frameborder="0" allowfullscreen
-    {% if result.parsed_url.hostname in ("www.youtube.com", ) -%}
-    allow="picture-in-picture" referrerpolicy="origin"
-    {%- endif -%}
-    >
-  </iframe>
-{%- endmacro -%}
@@ -1,4 +1,4 @@
-{% from 'simple/macros.html' import iframe, result_header, result_sub_header, result_sub_footer, result_footer with context %}
+{% from 'simple/macros.html' import result_header, result_sub_header, result_sub_footer, result_footer with context %}

 {{ result_header(result, favicons, image_proxify) -}}
 {{- result_sub_header(result) -}}
@@ -17,7 +17,7 @@
 {{- result_sub_footer(result) -}}
 {% if result.iframe_src -%}
 <div id="result-media-{{ index }}" class="embedded-content invisible">
-  {{ iframe(result.iframe_src) }}
+  <iframe data-src="{{result.iframe_src}}" frameborder="0" allowfullscreen></iframe>
 </div>
 {%- endif %}
 {% if result.audio_src -%}
@@ -1,4 +1,4 @@
-{% from 'simple/macros.html' import iframe, result_header, result_sub_header, result_sub_footer, result_footer with context %}
+{% from 'simple/macros.html' import result_header, result_sub_header, result_sub_footer, result_footer with context %}

 {{ result_header(result, favicons, image_proxify) }}
 {{ result_sub_header(result) }}
@@ -18,7 +18,11 @@
 {{- result_sub_footer(result) -}}
 {% if result.iframe_src -%}
 <div id="result-video-{{ index }}" class="embedded-video invisible">
-  {{ iframe(result.iframe_src) }}
+  <iframe data-src="{{result.iframe_src}}" frameborder="0" allowfullscreen
+    {% if result.parsed_url.hostname in ("www.youtube.com", ) -%}
+    allow="picture-in-picture" referrerpolicy="origin">
+    {%- endif -%}
+  </iframe>
 </div>
 {%- endif %}
 {{ result_footer(result) }}