blob: 9627da07d25dc8af8c19aae4a2e65cc72a8f11e2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
# SPDX-License-Identifier: AGPL-3.0-or-later
"""Implementations needed for a branding of SearXNG."""
# pylint: disable=too-few-public-methods
# Struct fields aren't discovered in Python 3.14
# - https://github.com/searxng/searxng/issues/5284
from __future__ import annotations
__all__ = ["SettingsBrand"]
import msgspec
class BrandCustom(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
"""Custom settings in the brand section."""
links: dict[str, str] = {}
"""Custom entries in the footer of the WEB page: ``[title]: [link]``"""
class SettingsBrand(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
"""Options for configuring brand properties.
.. code:: yaml
brand:
issue_url: https://github.com/searxng/searxng/issues
docs_url: https://docs.searxng.org
public_instances: https://searx.space
wiki_url: https://github.com/searxng/searxng/wiki
custom:
links:
Uptime: https://uptime.searxng.org/history/example-org
About: https://example.org/user/about.html
"""
issue_url: str = "https://github.com/searxng/searxng/issues"
"""If you host your own issue tracker change this URL."""
docs_url: str = "https://docs.searxng.org"
"""If you host your own documentation change this URL."""
public_instances: str = "https://searx.space"
"""If you host your own https://searx.space change this URL."""
wiki_url: str = "https://github.com/searxng/searxng/wiki"
"""Link to your wiki (or ``false``)"""
custom: BrandCustom = msgspec.field(default_factory=BrandCustom)
"""Optional customizing.
.. autoclass:: searx.brand.BrandCustom
:members:
"""
# new_issue_url is a hackish solution tailored for only one hoster (GH). As
# long as we don't have a more general solution, we should support it in the
# given function, but it should not be expanded further.
new_issue_url: str = "https://github.com/searxng/searxng/issues/new"
"""If you host your own issue tracker not on GitHub, then unset this URL.
Note: This URL will create a pre-filled GitHub bug report form for an
engine. Since this feature is implemented only for GH (and limited to
engines), it will probably be replaced by another solution in the near
future.
"""
|
