[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>

.dir-locals-template.el

@@ -0,0 +1,163 @@
+;;; .dir-locals.el
+;;
+;; Per-Directory Local Variables:
+;;   https://www.gnu.org/software/emacs/manual/html_node/emacs/Directory-Variables.html
+;;
+;; For full fledge developer tools install emacs packages:
+;;
+;;    M-x package-install ...
+;;
+;;     magit gitconfig
+;;     nvm lsp-mode lsp-pyright lsp-eslint
+;;     pyvenv pylint pip-requirements
+;;     jinja2-mode
+;;     json-mode
+;;     company company-jedi company-quickhelp company-shell
+;;     realgud
+;;     sphinx-doc markdown-mode graphviz-dot-mode
+;;     apache-mode nginx-mode
+;;
+;; To setup a developer environment, build target::
+;;
+;;     $ make node.env.dev pyenv.install
+;;
+;; Some buffer locals are referencing the project environment:
+;;
+;; - prj-root                                --> <repo>/
+;; - nvm-dir                                 --> <repo>/.nvm
+;; - python-environment-directory            --> <repo>/local
+;; - python-environment-default-root-name    --> py3
+;; - python-shell-virtualenv-root            --> <repo>/local/py3
+;;       When this variable is set with the path of the virtualenv to use,
+;;      `process-environment' and `exec-path' get proper values in order to run
+;;      shells inside the specified virtualenv, example::
+;;         (setq python-shell-virtualenv-root "/path/to/env/")
+;; - python-shell-interpreter                --> <repo>/local/py3/bin/python
+;;
+;; Python development:
+;;
+;; Jedi, flycheck & other python stuff should use the 'python-shell-interpreter'
+;; from the local py3 environment.
+;;
+
+((nil
+  . ((fill-column . 80)
+     (indent-tabs-mode . nil)
+     (eval . (progn
+
+               (add-to-list 'auto-mode-alist '("\\.html\\'" . jinja2-mode))
+
+               ;; project root folder is where the `.dir-locals.el' is located
+               (setq-local prj-root
+                           (locate-dominating-file  default-directory ".dir-locals.el"))
+
+               (setq-local python-environment-directory
+                           (expand-file-name "./local" prj-root))
+
+               ;; to get in use of NVM environment, install https://github.com/rejeep/nvm.el
+               (setq-local nvm-dir (expand-file-name "./.nvm" prj-root))
+
+               ;; use nodejs from the (local) NVM environment (see nvm-dir)
+               (nvm-use-for-buffer)
+               (ignore-errors (require 'lsp))
+               (setq-local lsp-server-install-dir (car (cdr nvm-current-version)))
+               (setq-local lsp-enable-file-watchers nil)
+
+               ;; use 'py3' environment as default
+               (setq-local python-environment-default-root-name
+                           "py3")
+
+               (setq-local python-shell-virtualenv-root
+                           (expand-file-name
+                            python-environment-default-root-name python-environment-directory))
+
+               (setq-local python-shell-interpreter
+                           (expand-file-name
+                            "bin/python" python-shell-virtualenv-root))))))
+ (makefile-gmake-mode
+  . ((indent-tabs-mode . t)))
+
+ (yaml-mode
+  . ((eval . (progn
+
+               ;; flycheck should use the local py3 environment
+               (setq-local flycheck-yaml-yamllint-executable
+                           (expand-file-name "bin/yamllint" python-shell-virtualenv-root))
+
+               (setq-local flycheck-yamllintrc
+                           (expand-file-name  ".yamllint.yml" prj-root))
+
+               (flycheck-checker . yaml-yamllint)))))
+
+ (json-mode
+  . ((eval . (progn
+               (setq-local js-indent-level 4)
+               (flycheck-checker . json-python-json)))))
+
+ (js-mode
+  . ((eval . (progn
+               (ignore-errors (require 'lsp-eslint))
+               (setq-local js-indent-level 2)
+               ;; flycheck should use the eslint checker from developer tools
+               (setq-local flycheck-javascript-eslint-executable
+                           (expand-file-name "node_modules/.bin/eslint" prj-root))
+               ;; (flycheck-mode)
+
+               (if (featurep 'lsp-eslint)
+                   (lsp))
+               ))))
+
+ (python-mode
+  . ((eval . (progn
+               (ignore-errors (require 'jedi-core))
+               (ignore-errors (require 'lsp-pyright))
+               (ignore-errors (sphinx-doc-mode))
+               (setq-local python-environment-virtualenv
+                           (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
+                                 ;;"--system-site-packages"
+                                 "--quiet"))
+
+               (setq-local pylint-command
+                           (expand-file-name "bin/pylint" python-shell-virtualenv-root))
+
+               (if (featurep 'lsp-pyright)
+                   (lsp))
+
+               ;; pylint will find the '.pylintrc' file next to the CWD
+               ;;   https://pylint.readthedocs.io/en/latest/user_guide/run.html#command-line-options
+               (setq-local flycheck-pylintrc
+                           ".pylintrc")
+
+               ;; flycheck & other python stuff should use the local py3 environment
+               (setq-local flycheck-python-pylint-executable
+                           python-shell-interpreter)
+
+               ;; use 'M-x jedi:show-setup-info' and 'M-x epc:controller' to inspect jedi server
+               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:environment-root -- You
+               ;; can specify a full path instead of a name (relative path). In that case,
+               ;; python-environment-directory is ignored and Python virtual environment
+               ;; is created at the specified path.
+               (setq-local jedi:environment-root
+                           python-shell-virtualenv-root)
+
+               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:server-command
+               (setq-local jedi:server-command
+                           (list python-shell-interpreter
+                                 jedi:server-script))
+
+               ;; jedi:environment-virtualenv --> see above 'python-environment-virtualenv'
+               ;; is set buffer local!  No need to setup jedi:environment-virtualenv:
+               ;;
+               ;;    Virtualenv command to use.  A list of string.  If it is nil,
+               ;;    python-environment-virtualenv is used instead.  You must set non-nil
+               ;;    value to jedi:environment-root in order to make this setting work.
+               ;;
+               ;;    https://tkf.github.io/emacs-jedi/latest/#jedi:environment-virtualenv
+               ;;
+               ;; (setq-local jedi:environment-virtualenv
+               ;;             (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
+               ;;                   "--python"
+               ;;                   "/usr/bin/python3.4"
+               ;;                   ))
+               ))))
+ )

.github/workflows/container.yml

@@ -78,7 +78,7 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
           fetch-depth: "0"
@@ -106,10 +106,10 @@ jobs:
 
       - if: ${{ matrix.emulation }}
         name: Setup QEMU
-        uses: docker/setup-qemu-action@06116385d9baf250c9f4dcb4858b16962ea869c3  # v4.1.0
+        uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
 
       - name: Login to GHCR
-        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee  # v4.2.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
@@ -141,16 +141,16 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - if: ${{ matrix.emulation }}
         name: Setup QEMU
-        uses: docker/setup-qemu-action@06116385d9baf250c9f4dcb4858b16962ea869c3  # v4.1.0
+        uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
 
       - name: Login to GHCR
-        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee  # v4.2.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
@@ -175,19 +175,19 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Login to GHCR
-        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee  # v4.2.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
           password: "${{ secrets.GITHUB_TOKEN }}"
 
       - name: Login to Docker Hub
-        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee  # v4.2.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "docker.io"
           username: "${{ secrets.DOCKER_USER }}"

.github/workflows/data-update.yml

@@ -46,7 +46,7 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 

.github/workflows/documentation.yml

@@ -37,7 +37,7 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
           fetch-depth: "0"
@@ -50,14 +50,11 @@ jobs:
             python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
-      - name: Setup dependencies
-        run: sudo ./utils/searxng.sh install buildhost
-
       - name: Setup venv
         run: make V=1 install
 
       - name: Build documentation
-        run: make V=1 docs.html
+        run: make V=1 docs.clean docs.html
 
       - if: github.ref_name == 'master'
         name: Release

.github/workflows/integration.yml

@@ -39,7 +39,7 @@ jobs:
           python-version: "${{ matrix.python-version }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
@@ -67,12 +67,12 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Setup Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e  # v6.4.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f  # v6.3.0
         with:
           node-version-file: "./.nvmrc"
 

.github/workflows/l10n.yml

@@ -40,7 +40,7 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"
@@ -88,7 +88,7 @@ jobs:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"

.github/workflows/security.yml

@@ -24,12 +24,12 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Sync GHCS from Docker Scout
-        uses: docker/scout-action@cd72f264beff1cd72735de31148b9d3244a0234a  # v1.21.0
+        uses: docker/scout-action@bacf462e8d090c09660de30a6ccc718035f961e3  # v1.20.4
         with:
           organization: "searxng"
           dockerhub-user: "${{ secrets.DOCKER_USER }}"
@@ -41,6 +41,6 @@ jobs:
           write-comment: "false"
 
       - name: Upload SARIFs
-        uses: github/codeql-action/upload-sarif@8aad20d150bbac5944a9f9d289da16a4b0d87c1e  # v4.36.2
+        uses: github/codeql-action/upload-sarif@95e58e9a2cdfd71adc6e0353d5c52f41a045d225  # v4.35.2
         with:
           sarif_file: "./scout.sarif"

.helix/languages.toml

@@ -1,11 +0,0 @@
-[[language]]
-name = "python"
-language-servers = ["basedpyright", "pylsp"]
-auto-format = true
-
-[language-server.pylsp.config.pylsp]
-plugins.pylint.enabled = true
-plugins.isort.enabled = true
-plugins.black.enabled = true
-plugins.black.skip_string_normalization = true
-plugins.black.line_length = 120

client/simple/package.json

@@ -29,21 +29,21 @@
     "swiped-events": "1.2.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.16",
-    "@types/node": "^25.9.3",
+    "@biomejs/biome": "2.4.12",
+    "@types/node": "^25.6.0",
     "browserslist": "^4.28.2",
     "browserslist-to-esbuild": "^2.1.1",
-    "edge.js": "^6.5.1",
+    "edge.js": "^6.5.0",
     "less": "^4.6.4",
     "mathjs": "^15.2.0",
-    "sharp": "~0.35.1",
+    "sharp": "~0.34.5",
     "sort-package-json": "^3.6.1",
-    "stylelint": "^17.13.0",
+    "stylelint": "^17.8.0",
     "stylelint-config-standard-less": "^4.1.0",
     "stylelint-prettier": "^5.0.3",
     "svgo": "^4.0.1",
     "typescript": "~6.0.3",
-    "vite": "^8.0.16",
-    "vite-bundle-analyzer": "^1.3.8"
+    "vite": "^8.0.8",
+    "vite-bundle-analyzer": "^1.3.7"
   }
 }

client/simple/src/js/toolkit.ts

@@ -5,6 +5,7 @@ import type { KeyBindingLayout } from "./main/keyboard.ts";
 // synced with searx/webapp.py get_client_settings
 type Settings = {
   plugins?: string[];
+  advanced_search?: boolean;
   autocomplete?: string;
   autocomplete_min?: number;
   doi_resolver?: string;

client/simple/src/less/style.less

@@ -7,6 +7,7 @@
 @import "mixins.less";
 @import "toolkit.less";
 @import "autocomplete.less";
+@import "detail.less";
 @import "animations.less";
 @import "embedded.less";
 @import "info.less";
@@ -1164,4 +1165,3 @@ pre code {
 @import "result_types/code.less";
 @import "result_types/paper.less";
 @import "result_types/file.less";
-@import "result_types/image.less";

docs/_static/searxng.css

@@ -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;
-}

docs/_themes/searxng/static/searxng.css

@@ -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;
+}

docs/_themes/searxng/theme.conf

@@ -0,0 +1,7 @@
+[theme]
+inherit = pocoo
+stylesheet = searxng.css
+
+[options]
+touch_icon =
+globaltoc_maxdepth = 5

docs/admin/buildhosts.rst

@@ -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`).
 

docs/admin/installation-apache.rst

@@ -61,6 +61,11 @@ section might give you some guidance.
    - `Apache Fedora`_
    - `Apache directives`_
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 
 The Apache HTTP server
 ======================

docs/admin/installation-nginx.rst

@@ -41,6 +41,12 @@ section might give you some guidance.
    - `uWSGI support from nginx`_
 
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 The nginx HTTP server
 =====================
 

docs/admin/installation-searxng.rst

@@ -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`.
 

docs/admin/installation-uwsgi.rst

@@ -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

docs/admin/searx.favicons.rst

@@ -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
+

docs/admin/searx.limiter.rst

@@ -8,5 +8,10 @@ Limiter
 
    The limiter requires a :ref:`Valkey <settings valkey>` database.
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.limiter
    :members:

docs/admin/settings/index.rst

@@ -19,7 +19,6 @@ Settings
    settings_search
    settings_server
    settings_ui
-   settings_preferences
    settings_redis
    settings_valkey
    settings_outgoing

docs/admin/settings/settings.rst

@@ -12,6 +12,11 @@ file.
    - :ref:`use_default_settings.yml`
    - :ref:`search API`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _settings location:
 
 settings.yml location

docs/admin/settings/settings_plugins.rst

@@ -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`_
+- ..

docs/admin/settings/settings_preferences.rst

@@ -1,8 +0,0 @@
-.. _settings preferences:
-
-================
-``preferences:``
-================
-
-.. autoclass:: searx._settings.SettingsPref
-   :members:

docs/admin/settings/settings_server.rst

@@ -47,7 +47,6 @@
   activated:
 
   - :py:obj:`searx.botdetection.link_token` in the :ref:`limiter`
-  - :ref:`image_proxy`
 
 .. _image_proxy:
 

docs/admin/update-searxng.rst

@@ -9,6 +9,11 @@ SearXNG maintenance
    - :ref:`toolboxing`
    - :ref:`uWSGI maintenance`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _update searxng:
 
 How to update

docs/build-templates/searxng.rst

@@ -169,7 +169,7 @@ ${fedora_build}
        $ sudo -H -u ${SERVICE_USER} -i
        (${SERVICE_USER})$ cd ${SEARXNG_SRC}
        (${SERVICE_USER})$ export SEARXNG_SETTINGS_PATH=\"${SEARXNG_SETTINGS_PATH}\"
-       (${SERVICE_USER})$ python -m searx.webapp
+       (${SERVICE_USER})$ python searx/webapp.py
 
        # disable debug
        $ sudo -H sed -i -e \"s/debug : True/debug : False/g\" \"$SEARXNG_SETTINGS_PATH\"

docs/conf.py

@@ -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": "💾",
-        },
-        {
-            "name": "searx.space",
-            "url": "https://searx.space/",
-            "html": "🌐",
-        },
-    ],
-}
-
-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 ----------------------------------------------------------------
 

docs/dev/contribution_guide.rst

@@ -4,6 +4,11 @@
 How to contribute
 =================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Prime directives: Privacy, Hackability
 ======================================
 

docs/dev/engines/demo/demo_offline.rst

@@ -4,6 +4,11 @@
 Demo Offline Engine
 ===================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_offline
   :members:
 

docs/dev/engines/demo/demo_online.rst

@@ -4,6 +4,11 @@
 Demo Online Engine
 ==================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_online
   :members:
 

docs/dev/engines/engine_overview.rst

@@ -4,6 +4,11 @@
 Engine Overview
 ===============
 
+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 .. _metasearch-engine: https://en.wikipedia.org/wiki/Metasearch_engine
 
 .. sidebar:: Further reading ..
@@ -107,7 +112,7 @@ module:
    ======================= =========== ===========================================
    base_url                string      base-url, can be overwritten to use same
                                        engine on other URL
-   page_size               int         maximum number of results per request
+   number_of_results       int         maximum number of results per request
    language                string      ISO code of language and country like en_US
    api_key                 string      api-key if required by engine
    ======================= =========== ===========================================

docs/dev/engines/index.rst

@@ -4,6 +4,12 @@
 Engine Implementations
 ======================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. toctree::
    :caption: Framework Components
    :maxdepth: 2

docs/dev/engines/json_engine.rst

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

docs/dev/engines/mediawiki.rst

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

docs/dev/engines/offline/command-line-engines.rst

@@ -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

docs/dev/engines/offline/nosql-engines.rst

@@ -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:

docs/dev/engines/offline/search-indexer-engines.rst

@@ -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:
+

docs/dev/engines/offline/sql-engines.rst

@@ -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

docs/dev/engines/online/500px.rst

@@ -1,8 +0,0 @@
-.. _500px engine:
-
-=====
-500px
-=====
-
-.. automodule:: searx.engines.500px
-   :members:

docs/dev/engines/online/adobe_stock.rst

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

docs/dev/engines/online/alpinelinux.rst

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

docs/dev/engines/online/annas_archive.rst

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

docs/dev/engines/online/archlinux.rst

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

docs/dev/engines/online/bing.rst

@@ -4,6 +4,12 @@
 Bing Engines
 ============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _bing web engine:
 
 Bing WEB

docs/dev/engines/online/bpb.rst

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

docs/dev/engines/online/brave.rst

@@ -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.

docs/dev/engines/online/bt4g.rst

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

docs/dev/engines/online/cara.rst

@@ -1,8 +0,0 @@
-.. _cara engine:
-
-===========
-Cara Images
-===========
-
-.. automodule:: searx.engines.cara
-   :members:

docs/dev/engines/online/core.rst

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

docs/dev/engines/online/dailymotion.rst

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

docs/dev/engines/online/duckduckgo.rst

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

docs/dev/engines/online/google.rst

@@ -4,6 +4,12 @@
 Google Engines
 ==============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _google API:
 
 Google API

docs/dev/engines/online/karmasearch.rst

@@ -0,0 +1,8 @@
+.. _karmasearch engine:
+
+===========
+Karmasearch
+===========
+
+.. automodule:: searx.engines.karmasearch
+   :members:

docs/dev/engines/online/lemmy.rst

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

docs/dev/engines/online/loc.rst

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

docs/dev/engines/online/mastodon.rst

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

docs/dev/engines/online/moviepilot.rst

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

docs/dev/engines/online/mrs.rst

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

docs/dev/engines/online/mwmbl.rst

@@ -4,6 +4,12 @@
 Mwmbl Engine
 ============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _mwmbl web engine:
 
 Mwmbl WEB

docs/dev/engines/online/odysee.rst

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

docs/dev/engines/online/peertube.rst

@@ -4,6 +4,12 @@
 Peertube Engines
 ================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _peertube video engine:
 
 Peertube Video

docs/dev/engines/online/piped.rst

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

docs/dev/engines/online/presearch.rst

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

docs/dev/engines/online/qwant.rst

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

docs/dev/engines/online/radio_browser.rst

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

docs/dev/engines/online/recoll.rst

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

docs/dev/engines/online/soundcloud.rst

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

docs/dev/engines/online/startpage.rst

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

docs/dev/engines/online/tagesschau.rst

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

docs/dev/engines/online/torznab.rst

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

docs/dev/engines/online/void.rst

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

docs/dev/engines/online/wallhaven.rst

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

docs/dev/engines/online/wikipedia.rst

@@ -4,6 +4,12 @@
 Wikimedia
 =========
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _wikipedia engine:
 
 Wikipedia

docs/dev/engines/online/yacy.rst

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

docs/dev/engines/online/yahoo.rst

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

docs/dev/engines/online/zlibrary.rst

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

docs/dev/engines/online_url_search/tineye.rst

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

docs/dev/engines/xpath.rst

@@ -4,6 +4,11 @@
 XPath Engine
 ============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.xpath
   :members:
 

docs/dev/makefile.rst

@@ -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``):
 

docs/dev/quickstart.rst

@@ -60,29 +60,11 @@ into the developer environment and start a python based HTTP server by::
 
     $ ./manage dev.env
     ...
-    (dev.env)$ SEARXNG_DEBUG=1 searxng-run
+    (dev.env)$ SEARXNG_DEBUG=1 python -m searx.webapp
 
 Since this is a pure Python solution, you can set breakpoints in your code with
 ``pdb.set_trace()`` and the debugger will wait for you in the terminal prompt.
 
-Any other script or command line provided by SearXNG can also be used in the
-same environment, here are a few examples::
-
-    # tools related to favicons
-    (dev.env)$ python -m searx.favicons
-
-    # tools related to DATA stored in searx/data
-    (dev.env)$ python -m searx.data --help
-
-    # tools related to engines
-    (dev.env)$ python -m searx.enginelib --help
-
-    # to test one of the update scripts
-    (dev.env)$ searxng_extra/update/update_engine_traits.py --help
-
-    # to test the update of the wikidata units
-    (dev.env)$ searxng_extra/update/update_wikidata_units.py
-
 
 .. sidebar:: further read
 

docs/dev/reST.rst

@@ -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]`_.
 

docs/dev/result_types/main/image.rst

@@ -1,7 +0,0 @@
-.. _result_types.image:
-
-=============
-Image Results
-=============
-
-.. automodule:: searx.result_types.image

docs/dev/result_types/main/mainresult.rst

@@ -1,8 +1,4 @@
 .. _result_types.mainresult:
 
-============
-Main Results
-============
-
 .. autoclass:: searx.result_types._base.MainResult
    :members:

docs/dev/result_types/main_result.rst

@@ -18,13 +18,13 @@ following types have been implemented so far ..
    main/code
    main/paper
    main/file
-   main/image
 
 The :ref:`LegacyResult <LegacyResult>` is used internally for the results that
 have not yet been typed.  The templates can be used as orientation until the
 final typing is complete.
 
 - :ref:`template default` / :py:obj:`Result`
+- :ref:`template images`
 - :ref:`template videos`
 - :ref:`template torrent`
 - :ref:`template map`

docs/dev/templates.rst

@@ -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:
 
@@ -129,6 +134,53 @@ audio_src : uri,
   URL of an embedded ``<audio controls>``.
 
 
+.. _template images:
+
+``images.html``
+---------------
+
+The images are displayed as small thumbnails in the main results list.
+
+title :  :py:class:`str`
+  Title of the image.
+
+thumbnail_src : :py:class:`str`
+  URL of a preview of the image.
+
+resolution :py:class:`str`
+  The resolution of the image (e.g. ``1920 x 1080`` pixel)
+
+
+Image labels
+~~~~~~~~~~~~
+
+Clicking on the preview opens a gallery view in which all further metadata for
+the image is displayed.  Addition fields used in the :origin:`images.html
+<searx/templates/simple/result_templates/images.html>`:
+
+img_src : :py:class:`str`
+  URL of the full size image.
+
+content:  :py:class:`str`
+  Description of the image.
+
+author:  :py:class:`str`
+  Name of the author of the image.
+
+img_format : :py:class:`str`
+  The format of the image (e.g. ``png``).
+
+source : :py:class:`str`
+  Source of the image.
+
+filesize: :py:class:`str`
+  Size of bytes in :py:obj:`human readable <searx.humanize_bytes>` notation
+  (e.g. ``MB`` for 1024 \* 1024 Bytes filesize).
+
+url : :py:class:`str`
+  URL of the page from where the images comes from (source).
+
+
 .. _template videos:
 
 ``videos.html``

docs/own-instance.rst

@@ -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

docs/src/searx.botdetection.rst

@@ -4,6 +4,11 @@
 Bot Detection
 =============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.botdetection
   :members:
 

docs/src/searx.favicons.rst

@@ -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:
+
+
+

docs/src/searx.locales.rst

@@ -4,6 +4,11 @@
 Locales
 =======
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.locales
    :members:
 

docs/src/searx.search.processors.rst

@@ -4,6 +4,12 @@
 Search processors
 =================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 Abstract processor class
 ========================
 

docs/user/configured_engines.rst

@@ -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() %}

docs/user/index.rst

@@ -2,6 +2,11 @@
 User information
 ================
 
+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 .. toctree::
    :maxdepth: 2
 

docs/utils/searxng.sh.rst

@@ -15,6 +15,12 @@ script :origin:`utils/searxng.sh`.
    - :ref:`installation nginx`
    - :ref:`installation apache`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 Install
 =======
 

requirements-dev.txt

@@ -4,25 +4,23 @@ cov-core==1.15.0
 black==25.9.0
 pylint==4.0.5
 splinter==0.21.0
-selenium==4.44.0
-Sphinx==8.2.3;python_version <= "3.11"
-Sphinx==9.1.0; python_version > "3.11"
+selenium==4.43.0
+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.5
-basedpyright==1.39.6
+granian[reload]==2.7.3
+basedpyright==1.39.2
 types-lxml==2026.2.16

requirements-server.txt

@@ -1,2 +1,2 @@
-granian==2.7.5
-granian[pname]==2.7.5
+granian==2.7.3
+granian[pname]==2.7.3

requirements.txt

@@ -1,9 +1,9 @@
-certifi==2026.5.20
+certifi==2026.2.25
 babel==2.18.0
 flask-babel==4.0.0
 flask==3.1.3
 jinja2==3.1.6
-lxml==6.1.1
+lxml==6.0.4
 pygments==2.20.0
 python-dateutil==2.9.0.post0
 pyyaml==6.0.3
@@ -11,9 +11,9 @@ httpx[http2]==0.28.1
 httpx-socks[asyncio]==0.10.0
 sniffio==1.3.1
 valkey==6.1.1
-markdown-it-py==4.2.0
+markdown-it-py==4.0.0
 msgspec==0.21.1
-typer==0.26.7
+typer==0.24.1
 isodate==0.7.2
 whitenoise==6.12.0
 typing-extensions==4.15.0