first commit

searx/infopage/__init__.py

@@ -0,0 +1,198 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+"""Render SearXNG instance documentation.
+
+Usage in a Flask app route:
+
+.. code:: python
+
+  from searx import infopage
+  from searx.extended_types import sxng_request
+
+  _INFO_PAGES = infopage.InfoPageSet(infopage.MistletoePage)
+
+  @app.route('/info/<pagename>', methods=['GET'])
+  def info(pagename):
+
+      locale = sxng_request.preferences.get_value('locale')
+      page = _INFO_PAGES.get_page(pagename, locale)
+
+"""
+
+from __future__ import annotations
+
+__all__ = ['InfoPage', 'InfoPageSet']
+
+import os
+import os.path
+import logging
+import typing
+
+import urllib.parse
+from functools import cached_property
+import jinja2
+from flask.helpers import url_for
+from markdown_it import MarkdownIt
+
+from .. import get_setting
+from ..version import GIT_URL
+from ..locales import LOCALE_NAMES
+
+
+logger = logging.getLogger('searx.infopage')
+_INFO_FOLDER = os.path.abspath(os.path.dirname(__file__))
+INFO_PAGES: 'InfoPageSet'
+
+
+def __getattr__(name):
+    if name == 'INFO_PAGES':
+        global INFO_PAGES  # pylint: disable=global-statement
+        INFO_PAGES = InfoPageSet()
+        return INFO_PAGES
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+class InfoPage:
+    """A page of the :py:obj:`online documentation <InfoPageSet>`."""
+
+    def __init__(self, fname):
+        self.fname = fname
+
+    @cached_property
+    def raw_content(self):
+        """Raw content of the page (without any jinja rendering)"""
+        with open(self.fname, 'r', encoding='utf-8') as f:
+            return f.read()
+
+    @cached_property
+    def content(self):
+        """Content of the page (rendered in a Jinja context)"""
+        ctx = self.get_ctx()
+        template = jinja2.Environment().from_string(self.raw_content)
+        return template.render(**ctx)
+
+    @cached_property
+    def title(self):
+        """Title of the content (without any markup)"""
+        t = ""
+        for l in self.raw_content.split('\n'):
+            if l.startswith('# '):
+                t = l.strip('# ')
+        return t
+
+    @cached_property
+    def html(self):
+        """Render Markdown (CommonMark_) to HTML by using markdown-it-py_.
+
+        .. _CommonMark: https://commonmark.org/
+        .. _markdown-it-py: https://github.com/executablebooks/markdown-it-py
+
+        """
+        return (
+            MarkdownIt("commonmark", {"typographer": True}).enable(["replacements", "smartquotes"]).render(self.content)
+        )
+
+    def get_ctx(self):
+        """Jinja context to render :py:obj:`InfoPage.content`"""
+
+        def _md_link(name, url):
+            url = url_for(url, _external=True)
+            return "[%s](%s)" % (name, url)
+
+        def _md_search(query):
+            url = '%s?q=%s' % (url_for('search', _external=True), urllib.parse.quote(query))
+            return '[%s](%s)' % (query, url)
+
+        ctx = {}
+        ctx['GIT_URL'] = GIT_URL
+        ctx['get_setting'] = get_setting
+        ctx['link'] = _md_link
+        ctx['search'] = _md_search
+
+        return ctx
+
+    def __repr__(self):
+        return f'<{self.__class__.__name__} fname={self.fname!r}>'
+
+
+class InfoPageSet:  # pylint: disable=too-few-public-methods
+    """Cached rendering of the online documentation a SearXNG instance has.
+
+    :param page_class: render online documentation by :py:obj:`InfoPage` parser.
+    :type page_class: :py:obj:`InfoPage`
+
+    :param info_folder: information directory
+    :type info_folder: str
+    """
+
+    def __init__(
+        self, page_class: typing.Optional[typing.Type[InfoPage]] = None, info_folder: typing.Optional[str] = None
+    ):
+        self.page_class = page_class or InfoPage
+        self.folder: str = info_folder or _INFO_FOLDER
+        """location of the Markdown files"""
+
+        self.CACHE: typing.Dict[tuple, typing.Optional[InfoPage]] = {}
+
+        self.locale_default: str = 'en'
+        """default language"""
+
+        self.locales: typing.List[str] = [
+            locale.replace('_', '-') for locale in os.listdir(_INFO_FOLDER) if locale.replace('_', '-') in LOCALE_NAMES
+        ]
+        """list of supported languages (aka locales)"""
+
+        self.toc: typing.List[str] = [
+            'search-syntax',
+            'about',
+            'donate',
+        ]
+        """list of articles in the online documentation"""
+
+    def get_page(self, pagename: str, locale: typing.Optional[str] = None):
+        """Return ``pagename`` instance of :py:obj:`InfoPage`
+
+        :param pagename: name of the page, a value from :py:obj:`InfoPageSet.toc`
+        :type pagename: str
+
+        :param locale: language of the page, e.g. ``en``, ``zh_Hans_CN``
+                       (default: :py:obj:`InfoPageSet.i18n_origin`)
+        :type locale: str
+
+        """
+        locale = locale or self.locale_default
+
+        if pagename not in self.toc:
+            return None
+        if locale not in self.locales:
+            return None
+
+        cache_key = (pagename, locale)
+
+        if cache_key in self.CACHE:
+            return self.CACHE[cache_key]
+
+        # not yet instantiated
+
+        fname = os.path.join(self.folder, locale.replace('-', '_'), pagename) + '.md'
+        if not os.path.exists(fname):
+            logger.info('file %s does not exists', fname)
+            self.CACHE[cache_key] = None
+            return None
+
+        page = self.page_class(fname)
+        self.CACHE[cache_key] = page
+        return page
+
+    def iter_pages(self, locale: typing.Optional[str] = None, fallback_to_default=False):
+        """Iterate over all pages of the TOC"""
+        locale = locale or self.locale_default
+        for page_name in self.toc:
+            page_locale = locale
+            page = self.get_page(page_name, locale)
+            if fallback_to_default and page is None:
+                page_locale = self.locale_default
+                page = self.get_page(page_name, self.locale_default)
+            if page is not None:
+                # page is None if the page was deleted by the administrator
+                yield page_name, page_locale, page

searx/infopage/de/about.md

@@ -0,0 +1,88 @@
+# Über SearXNG
+
+SearXNG ist eine [Metasuchmaschine], welche die Ergebnisse anderer
+{{link('Suchmaschinen', 'preferences')}} sammelt und aufbereitet ohne dabei
+Informationen über seine Benutzer zu sammeln oder an andere Suchmaschinen weiter
+zu geben.
+
+Das SearXNG Projekt wird von einer offenen Gemeinschaft entwickelt; wenn Sie
+Fragen haben oder einfach nur über SearXNG plaudern möchten, besuchen Sie uns
+auf Matrix unter: [#searxng:matrix.org]
+
+Werden Sie Teil des Projekts und unterstützen Sie SearXNG:
+
+- Sie können die SearXNG Übersetzungen ergänzen oder korrigieren: [Weblate]
+- oder folgen Sie den Entwicklungen, senden Sie Beiträge und melden Sie Fehler:
+  [SearXNG Quellen]
+- Mehr Informationen sind in der [SearXNG Dokumentation] zu finden.
+
+## Warum sollte ich SearXNG benutzen?
+
+- SearXNG bietet Ihnen vielleicht nicht so personalisierte Ergebnisse wie
+  Google, aber es erstellt auch kein Profil über Sie.
+- SearXNG kümmert sich nicht darum, wonach Sie suchen, gibt niemals etwas an
+  Dritte weiter und kann nicht dazu verwendet werden Sie zu kompromittieren.
+- SearXNG ist freie Software, der Code ist zu 100% offen und jeder ist
+  willkommen ihn zu verbessern.
+
+Wenn Ihnen die Privatsphäre wichtig ist, Sie ein bewusster Nutzer sind und Sie
+an die digitale Freiheit glauben, sollten Sie SearXNG zu Ihrer
+Standardsuchmaschine machen oder eine SearXNG Instanz auf Ihrem eigenen Server
+betreiben.
+
+## Wie kann ich SearXNG als Standardsuchmaschine festlegen?
+
+SearXNG unterstützt [OpenSearch].  Weitere Informationen zum Ändern Ihrer
+Standardsuchmaschine finden Sie in der Dokumentation zu Ihrem [WEB-Browser]:
+
+- [Firefox]
+- [Microsoft Edge] - Hinter dem Link finden sich auch nützliche Hinweise zu
+  Chrome und Safari.
+- [Chromium]-basierte Browser fügen nur Websites hinzu, zu denen der Benutzer
+  ohne Pfadangabe navigiert.
+
+Wenn Sie eine Suchmaschine hinzufügen, darf es keine Duplikate mit demselben
+Namen geben.  Wenn Sie auf ein Problem stoßen, bei dem Sie die Suchmaschine
+nicht hinzufügen können, dann können Sie entweder:
+
+- das Duplikat entfernen (Standardname: SearXNG) oder
+- den Eigentümer kontaktieren, damit dieser der Instance einen anderen Namen als
+  den Standardnamen gibt.
+
+## Wie funktioniert SearXNG?
+
+SearXNG ist ein Fork der bekannten [searx] [Metasuchmaschine], die durch das
+[Seeks-Projekt] inspiriert wurde (diese beide Projekte werden heute nicht mehr
+aktiv weiterentwickelt).  SearXNG bietet einen grundlegenden Schutz der
+Privatsphäre, indem es die Suchanfragen der Benutzer mit Suchen auf anderen
+Plattformen vermischt ohne dabei Suchdaten zu speichern.  SearXNG kann im
+[WEB-Browser] als weitere oder Standard-Suchmaschine hinzugefügt werden.
+
+Die {{link('Suchmaschinenstatistik', 'stats')}} enthält einige nützliche
+Statistiken über die verwendeten Suchmaschinen.
+
+## Wie kann ich einen eigenen SearXNG Server betreiben?
+
+Jeder der mit dem Betrieb von WEB-Servern vertraut ist kann sich eine eigene
+Instanz einrichten; die Software dazu kann über die [SearXNG Quellen] bezogen
+werden. Weitere Informationen zur Installation und zum Betrieb finden sich in
+der [SearXNG Dokumentation].
+
+Fügen Sie Ihre Instanz zu der [Liste der öffentlich zugänglichen
+Instanzen]({{get_setting('brand.public_instances')}}) hinzu um auch anderen
+Menschen zu helfen ihre Privatsphäre zurückzugewinnen und das Internet freier zu
+machen.  Je dezentraler das Internet ist, desto mehr Freiheit haben wir!
+
+
+[SearXNG Quellen]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[SearXNG Dokumentation]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[Metasuchmaschine]: https://de.wikipedia.org/wiki/Metasuchmaschine
+[Weblate]: https://translate.codeberg.org/projects/searxng/
+[Seeks-Projekt]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine
+[Chromium]: https://www.chromium.org/tab-to-search
+[WEB-Browser]: https://de.wikipedia.org/wiki/Webbrowser

searx/infopage/de/search-syntax.md

@@ -0,0 +1,93 @@
+# Suchbegriffe
+
+SearXNG verfügt über eine Syntax mit der in einer Suchanfrage die Kategorien,
+Suchmaschinen, Sprachen und mehr geändert werden können.  In den
+{{link('Eigenschaften','preferences')}} sind die Kategorien, Suchmaschinen und
+Sprachen zu finden, die zur Verfügung stehen.
+
+## `!` Suchmaschine und Kategorie auswählen
+
+Zum Festlegen von Kategorie- und/oder Suchmaschinen dient das Präfix `!`.  Um
+ein paar Beispiele zu geben:
+
+- in der Wikipedia nach dem Begriff **paris** suchen
+
+  - {{search('!wp paris')}}
+  - {{search('!wikipedia paris')}}
+
+- in der Kategorie **Karte** nach dem Begriff **paris** suchen:
+
+  - {{search('!map paris')}}
+
+- in der Kategorie **Bilder** suchen
+
+  - {{search('!images Wau Holland')}}
+
+Abkürzungen der Suchmaschinen und Kategorien sind ebenfalls möglich und können
+auch kombiniert werden.  So wird z.B. mit {{search('!map !ddg !wp paris')}} in
+der Kategorie **Karte** als auch mit den Suchmaschinen DuckDuckGo und Wikipedia
+nach dem Begriff **paris** gesucht.
+
+## `:` Sprache auswählen
+
+Um einen Sprachfilter auszuwählen, verwenden Sie das Präfix `:`.  Um ein
+einfaches Beispiel zu geben:
+
+- Wikipedia mit einer benutzerdefinierten Sprache durchsuchen
+
+  - {{search(':de !wp Wau Holland')}}
+
+## `!!<bang>` external bangs
+
+SearXNG unterstützt die _external bangs_ von [DuckDuckGo].  Das Präfix `!!` kann
+verwendet werden um direkt zu einer externen Suchseite zu springen.  Um ein
+Beispiel zu geben:
+
+- In Wikipedia mit einer benutzerdefinierten Sprache eine Suche durchführen
+
+  - {{search('!!wde Wau Holland')}}
+
+Bitte beachten; die Suche wird direkt in der externen Suchmaschine durchgeführt.
+SearXNG kann die Privatsphäre des Benutzers in diesem Fall nur eingeschränkt
+schützen, dennoch wird diese Funktion von manchen Benutzern als sehr nützlich
+empfunden.
+
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## `!!` automatic redirect
+
+Bei der Verwendung von `!!` innerhalb der Suchanfrage (durch Leerzeichen
+getrennt), wird automatisch zum ersten Ergebnis weitergeleitet.  Dieses
+Verhalten ist vergleichbar mit der "Feeling Lucky"-Funktion von DuckDuckGo.  Um
+ein Beispiel zu geben:
+
+- Suchanfrage und direkte Weiterleitung zum ersten Ergebnis
+
+  - {{search('!! Wau Holland')}}
+
+Bitte beachten: das Ergebnis zu dem weitergeleitet wird, kann nicht auf seine
+Vertrauenswürdigkeit überprüft werden.  SearXNG kann die Privatsphäre des
+Benutzers in diesem Fall nicht schützen, dennoch wird diese Funktion von manchen
+Benutzern als sehr nützlich empfunden.
+
+## Besondere Abfragen
+
+In den {{link('Eigenschaften', 'preferences')}} finden sich Schlüsselwörter für
+_besondere Abfragen_.  Um ein paar Beispiele zu geben:
+
+- Zufallsgenerator für eine UUID
+
+  - {{search('random uuid')}}
+
+- Bestimmung des Mittelwerts
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- anzeigen des _user agent_ Ihres WEB-Browsers (muss aktiviert sein)
+
+  - {{search('user-agent')}}
+
+- Zeichenketten in verschiedene Hash-Digests umwandeln  (muss aktiviert sein)
+
+  - {{search('md5 lorem ipsum')}}
+  - {{search('sha512 lorem ipsum')}}

searx/infopage/en/about.md

@@ -0,0 +1,79 @@
+# About SearXNG
+
+SearXNG is a [metasearch engine], aggregating the results of other
+{{link('search engines', 'preferences')}} while not storing information about
+its users.
+
+The SearXNG project is driven by an open community. Come join us on Matrix if
+you have questions or just want to chat about SearXNG at [#searxng:matrix.org]
+
+Make SearXNG better:
+
+- You can improve SearXNG translations at [Weblate], or...
+- Track development, send contributions, and report issues at [SearXNG sources].
+- To get further information, visit SearXNG's project documentation at [SearXNG
+  docs].
+
+## Why use it?
+
+- SearXNG may not offer you as personalized results as Google, but it doesn't
+  generate a profile about you.
+- SearXNG doesn't care about what you search for, never shares anything with a
+  third-party, and can't be used to compromise you.
+- SearXNG is free software; the code is 100% open, and everyone is welcome to
+  make it better.
+
+If you do care about privacy, want to be a conscious user, or otherwise believe
+in digital freedom, make SearXNG your default search engine or run it on your
+own server!
+
+## How do I set it as the default search engine?
+
+SearXNG supports [OpenSearch].  For more information on changing your default
+search engine, see your browser's documentation:
+
+- [Firefox]
+- [Microsoft Edge] - Behind the link, you will also find some useful instructions
+  for Chrome and Safari.
+- [Chromium]-based browsers only add websites that the user navigates to without
+  a path.
+
+When adding a search engine, there must be no duplicates with the same name.  If
+you encounter a problem where you cannot add the search engine, you can either:
+
+- Remove the duplicate (default name: SearXNG) or
+- Contact the owner to give the instance a different name from the default.
+
+## How does it work?
+
+SearXNG is a fork of the well-known [searx] [metasearch engine] which was
+inspired by the [Seeks project].  It provides basic privacy by mixing your
+queries with searches on other platforms without storing search data.  SearXNG
+can be added to your browser's search bar; moreover, it can be set as the
+default search engine.
+
+The {{link('stats page', 'stats')}} contains some useful anonymous usage
+statistics about the engines used.
+
+## How can I make it my own?
+
+SearXNG appreciates your concern regarding logs, so take the code from the
+[SearXNG sources] and run it yourself!
+
+Add your instance to this [list of public
+instances]({{get_setting('brand.public_instances')}}) to help other people
+reclaim their privacy and make the internet freer.  The more decentralized the
+internet is, the more freedom we have!
+
+
+[SearXNG sources]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[SearXNG docs]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[metasearch engine]: https://en.wikipedia.org/wiki/Metasearch_engine
+[Weblate]: https://translate.codeberg.org/projects/searxng/
+[Seeks project]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine
+[Chromium]: https://www.chromium.org/tab-to-search

searx/infopage/en/search-syntax.md

@@ -0,0 +1,84 @@
+# Search syntax
+
+SearXNG comes with a search syntax by which you can modify the categories,
+engines, languages, and more.  See the {{link('preferences', 'preferences')}} for
+the list of engines, categories, and languages.
+
+## `!` Select engine and category
+
+To set category and/or engine names, use a `!` prefix.  To give a few examples:
+
+- Search Wikipedia for **paris**:
+
+  - {{search('!wp paris')}}
+  - {{search('!wikipedia paris')}}
+
+- Search in category **map** for **paris**:
+
+  - {{search('!map paris')}}
+
+- Image search
+
+  - {{search('!images Wau Holland')}}
+
+Abbreviations of the engines and languages are also accepted.  Engine/category
+modifiers are chainable and inclusive.  For example, {{search('!map !ddg !wp
+paris')}} searches in the map category and searches DuckDuckGo and Wikipedia for **paris**.
+
+## `:` Select language
+
+To select a language filter use a `:` prefix.  To give an example:
+
+- Search Wikipedia with a custom language:
+
+  - {{search(':fr !wp Wau Holland')}}
+
+## `!!<bang>` External bangs
+
+SearXNG supports the external bangs from [DuckDuckGo].  To directly jump to a
+external search page use the `!!` prefix.  To give an example:
+
+- Search Wikipedia with a custom language:
+
+  - {{search('!!wfr Wau Holland')}}
+
+Please note that your search will be performed directly in the external search
+engine.  SearXNG cannot protect your privacy with this.
+
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## `!!` automatic redirect
+
+When including `!!` within your search query (separated by spaces), you will
+automatically be redirected to the first result.  This behavior is comparable to
+the "Feeling Lucky" feature from DuckDuckGo.  To give an example:
+
+- Search for a query and get redirected to the first result
+
+  - {{search('!! Wau Holland')}}
+
+Please keep in mind that the result you are being redirected to can't be
+verified for trustworthiness and SearXNG cannot protect your personal privacy
+when using this feature.  Use it at your own risk.
+
+## Special Queries
+
+In the {{link('preferences', 'preferences')}} page you find keywords for
+_special queries_.  To give a few examples:
+
+- Generate a random UUID
+
+  - {{search('random uuid')}}
+
+- Find the average
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- Show the _user agent_ of your browser (needs to be activated)
+
+  - {{search('user-agent')}}
+
+- Convert strings to different hash digests (needs to be activated)
+
+  - {{search('md5 lorem ipsum')}}
+  - {{search('sha512 lorem ipsum')}}

searx/infopage/fa_IR/about.md

@@ -0,0 +1,74 @@
+# درباره SearXNG
+
+
+SearXNG یک [موتور فراجستجو]
+ است که نتایج دیگر {{link('موتور جستجوها', 'preferences')}} را جمع می کند در حالی که اطلاعات مربوط به جستجو را ذخیره نمی‌کند
+
+پروژه SearXNG توسط یک جامعه باز هدایت می شود،  در Matrix به ما بپیوندید اگر
+سؤالی دارید یا فقط می خواهید در مورد SearXNG در [#searxng:matrix.org] چت کنید.
+و SearXNG را بهتر کنید.
+
+- می توانید ترجمه های SearXNG را در [وب سایت] بهبود بخشید، یا...
+- توسعه را ردیابی کنید، مشارکت ها را ارسال کنید و مشکلات را در [کد منبع SearXNG] گزارش کنید.
+- برای دریافت اطلاعات بیشتر، از مستندات پروژه SearXNG در [اسناد SearXNG] استفاده کنید.
+
+## چرا از SearXNG استفاده کنید؟
+
+- ممکن است SearXNG به اندازه Google نتایج شخصی سازی شده را به شما ارائه ندهد، اما اطلاعات شما را ردیابی نمیکند.
+- SearXNG به آنچه شما جستجو می کنید اهمیتی نمی دهد، هرگز چیزی را با افراد شخص ثالث به اشتراک نمی گذارد
+   ، و نمی توان از آن برای به خطر انداختن شما استفاده کرد.
+- SearXNG نرم افزار رایگان است، کد 100٪ باز است و همه از آن استقبال می کنند
+   بهترش کنید.
+
+اگر به حریم خصوصی اهمیت می دهید، می خواهید یک کاربر آگاه باشید، یا می‌خواهید در آزادی دیجیتال باشید،
+ SearXNG را موتور جستجوی پیش فرض خود قرار دهید یا آن را بر روی سرور خود اجرا کنید
+
+## چگونه آن را به عنوان موتور جستجوی پیش فرض تنظیم کنم؟
+
+SearXNG از [OpenSearch] پشتیبانی می کند. برای اطلاعات بیشتر در مورد تغییر پیش فرض خود
+موتور جستجو، مستندات مرورگر خود را ببینید:
+
+- [Firefox]
+- [Microsoft Edge] - در پشت پیوند، دستورالعمل های مفیدی نیز خواهید یافت
+   برای کروم و سافاری
+- مرورگرهای مبتنی بر [Chromium] فقط وب سایت هایی را اضافه می کنند که کاربر بدون مسیر به آنها پیمایش می کند.
+
+هنگام اضافه کردن یک موتور جستجو، نباید تکراری با همان نام وجود داشته باشد. اگر
+شما با مشکلی روبرو می شوید که نمی توانید موتور جستجو را اضافه کنید، می توانید یکی از موارد زیر را انجام دهید:
+
+- حذف تکراری (نام پیش فرض: SearXNG) یا
+- با مالک تماس بگیرید تا نمونه را نامی متفاوت از پیش فرض قرار دهد.
+
+## چگونه کار می کند؟
+
+SearXNG یک انشعاب از [searx] [موتور فراجستجو] معروف است که بود
+با الهام از [پروژه Seeks]. این حریم خصوصی اولیه را برای شما فراهم می کند
+پرس و جوهایی با جستجو در سایر سیستم عامل ها بدون ذخیره داده های جستجو. SearXNG
+می تواند به نوار جستجوی مرورگر شما اضافه شود. علاوه بر این، می توان آن را به عنوان موتور جستجوی پیش فرض
+ تنظیم کرد
+
+ حاوی چند کاربرد ناشناس مفید است
+آمار موتورهای مورد استفاده : {{link('صفحه آمار', 'stats')}}
+
+## چگونه می توانم آن را مال خودم کنم؟
+
+SearXNG از نگرانی شما در مورد گزارش‌ها قدردانی می‌کند، بنابراین کد را از
+[کد منبع SearXNG] دریافت کنید و خودتان آن را اجرا کنید!
+
+نمونه خود را به این [لیست عمومی اضافه کنید
+instances]({{get_setting('brand.public_instances')}}) برای کمک به افراد دیگر
+حفظ حریم خصوصی و آزادتر کردن اینترنت. هر چه اینترنت غیرمتمرکزتر باشد
+، آزادی بیشتر است!
+
+
+[کد منبع SearXNG]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[اسناد SearXNG]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[موتور فراجستجو]: https://fa.wikipedia.org/wiki/Metasearch_engine
+[وب سایت]: https://translate.codeberg.org/projects/searxng/
+[پروژه Seeks]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine
+[Chromium]: https://www.chromium.org/tab-to-search

searx/infopage/fa_IR/search-syntax.md

@@ -0,0 +1,64 @@
+# نحو جستجو
+SearXNG با یک متن جستجو همراه است که می توانید دسته ها را تغییر دهید،
+موتورها، زبان ها و موارد دیگر. {{link('اولویت ها', 'preferences')}}  رابرای
+لیست موتورها، دسته ها و زبان ها ببینید.
+## `!` موتور و دسته را انتخاب کنید
+
+برای تنظیم نام دسته و/یا موتور از پیشوند «!» استفاده کنید. برای ذکر چند مثال:
+
+- در ویکی پدیا برای **paris** جستجو کنید
+
+  - {{search('!wp paris')}}
+  - {{search('!wikipedia paris')}}
+
+- جستجو در دسته **نقشه** برای **پاریس**
+  - {{search('!map paris')}}
+
+- جستجوی تصویر
+  - {{search('!images Wau Holland')}}
+
+اختصارات موتورها و زبان ها نیز پذیرفته می شود. موتور/رده
+اصلاح کننده ها زنجیره ای و فراگیر هستند. به عنوان مثال. با {{search('!map !ddg !wp
+paris')}} در دسته بندی نقشه و DuckDuckGo و Wikipedia برای **paris** جستجو کنید..
+
+## `:` زبان را انتخاب کنید
+
+برای انتخاب فیلتر زبان از پیشوند «:» استفاده کنید. برای مثال زدن:
+
+- ویکی پدیا را با یک زبان سفارشی جستجو کنید
+
+  - {{search(':fr !wp Wau Holland')}}
+
+## `<bang>!!` چتری خارجی
+
+SearXNG از ضربه های خارجی پشتیبانی می کند [DuckDuckGo] .  To مستقیماً به a
+صفحه جستجوی خارجی از پیشوند «!!» استفاده کنید. برای مثال زدن:
+
+- ویکی پدیا را با یک زبان سفارشی جستجو کنید
+  - {{search('!!wfr Wau Holland')}}
+
+لطفاً توجه داشته باشید، جستجوی شما مستقیماً در جستجوی خارجی انجام می شود
+موتور، SearXNG نمی تواند از حریم خصوصی شما در این مورد محافظت کند.
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## سوالات ویژه
+
+در صفحه {{link('preferences', 'preferences')}} کلمات کلیدی را پیدا می کنید
+_پرسش های ویژه_. برای ذکر چند مثال:
+
+- ایجاد یک UUID تصادفی
+
+  - {{search('random uuid')}}
+
+- محاسبه میانگین
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- نشان دادن _user agent_ مرورگر شما (باید فعال شود)
+
+  - {{search('user-agent')}}
+
+- تبدیل رشته ها به هش های مختلف (باید فعال شود)
+
+  - {{search('md5 lorem ipsum')}}
+  - {{search('sha512 lorem ipsum')}}

searx/infopage/fr/about.md

@@ -0,0 +1,87 @@
+# A propos de SearXNG
+
+SearXNG est un [Métamoteur] qui agrège les résultats d'autres
+{{link('moteurs de recherche', 'preferences')}} tout en ne sauvegardant
+aucune informations à propos de ses utilisateurs.
+
+Le projet SearXNG est maintenu par une communauté ouverte.
+Rejoignez-nous sur Matrix si vous avez des questions ou simplement pour
+discuter de SearXNG: [#searxng:matrix.org].
+
+Aidez-nous à rendre SearXNG meilleur.
+
+- Vous pouvez améliorer les traductions de SearXNG avec l'outil
+  [Weblate].
+- Suivez le développement, contribuez au projet ou remontez des erreurs
+  en utilisant le [dépôt de sources].
+- Pour obtenir de plus amples informations, consultez la documentation
+  en ligne du [projet SearXNG].
+
+## Pourquoi l'utiliser ?
+
+- SearXNG ne vous fournira pas de résultats aussi personnalisés que
+  Google, mais il ne générera pas non plus de suivi sur vous.
+- SearXNG ne se soucis pas des recherches que vous faites, ne partage
+  aucune information avec des tiers et ne peut pas être utilisé contre
+  vous.
+- SearXNG est un logiciel libre. Son code source est 100% ouvert et tout
+  le mode est encouragé à l'améliorer.
+
+Si vous êtes soucieux du respect de la vie privée et des libertés sur
+Internet, faites de SearXNG votre moteur de recherche par défaut. Vous
+pouvez aussi installer et utiliser SearXNG sur votre propre serveur.
+
+## Comment le configurer comme moteur de recherche par défaut ?
+
+SearXNG prend en charge [OpenSearch]. Pour plus d'informations sur la
+manière de modifier votre moteur de recherche par défaut, veuillez
+consulter la documentation de votre navigateur :
+
+- [Firefox]
+- [Microsoft Edge] - Ce lien propose aussi les instructions pour les
+  navigateurs Chrome et Safari.
+- Les navigateurs basés sur [Chromium] permettent d'ajouter des sites de
+  navigation sans même y accéder.
+
+Lorsqu'un moteur de recherche est ajouté, son nom doit être unique. Si
+vous ne pouvez pas ajouter un moteur de recherche, veuillez :
+
+- Supprimer le doublon (le nom par défaut est SearXNG) ou bien
+- Contacter le propriétaire de l'instance que vous souhaitez utiliser
+  afin qu'il modifie le nom  de celle-ci.
+
+## Comment ça marche ?
+
+SearXNG est une reprise logicielle du projet [searx] [Métamoteur],
+lui-même inspiré du [projet Seeks]. Il assure la confidentialité en
+mélangeant vos recherches vers d'autres plateformes sans stocker aucune
+données de recherche. SearXNG peut être ajouté à la barre de recherche
+de votre navigateur et même être utilisé comme moteur de recherche par
+défaut.
+
+Le lien "{{link('statistiques des moteurs', 'stats')}}" présente des
+informations anonymisées concernant l'utilisation des divers moteurs de
+recherche.
+
+## Comment reprendre la main ?
+
+SearXNG apprécie votre préoccupation concernant les traces de recherche.
+N'hésitez pas à utiliser le [dépôt de sources] et à maintenir votre
+propre instance de recherche.
+
+Ajouter votre instance à la [liste d'instances
+publiques]({{get_setting('brand.public_instances')}}) afin d'aider
+d'autres personnes à protéger leur vie privée et rendre l'Internet plus
+libre. Plus Internet sera décentralisé, plus nous aurons de liberté !
+
+[dépôt de sources]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[projet SearXNG]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[Métamoteur]: https://fr.wikipedia.org/wiki/M%C3%A9tamoteur
+[Weblate]: https://translate.codeberg.org/projects/searxng/
+[projet Seeks]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine
+[Chromium]: https://www.chromium.org/tab-to-search

searx/infopage/fr/search-syntax.md

@@ -0,0 +1,97 @@
+# Syntaxe de recherche
+
+SearXNG permet de modifier les catégories de recherche, les moteurs
+utilisés ou encore la langue de recherche par l'intermédiaire d'une
+syntaxe dédiée. La liste des moteurs de recherche, de catégories et de
+langues disponibles est accessible depuis la page de
+{{link('préférences', 'preferences')}}.
+
+## `!` Spécifier un moteur ou une catégorie
+
+Pour restreindre la recherche à un moteur ou une catégorie, utilisez le
+caractère "!". Voici quelques exemples d'utilisation :
+
+- Rechercher **paris** sur Wikipédia.
+
+  - {{search('!wp paris')}}
+  - {{search('!wikipedia paris')}}
+
+- Rechercher **paris** dans la catégorie **Carte**.
+
+  - {{search('!map paris')}}
+
+- Rechercher des **Images**.
+
+  - {{search('!images Wau Holland')}}
+
+Les abréviations de moteurs et de langues sont aussi valides. Il est
+possible d'accumuler les moteurs et catégories dans une requête
+complexe. Par exemple, {{search('!map !ddg !wp paris')}} recherchera
+**paris** dans la catégorie **Carte** de DuckDuckGo et Wikipédia.
+
+## `:` Spécifier une langue
+
+Utilisez le préfixe ":" pour limiter la recherche à une langue en
+particulier. Par exemple :
+
+- Rechercher dans les pages françaises de Wikipédia.
+
+  - {{search(':fr !wp Wau Holland')}}
+
+## `!!<bang>` Recherches externes (!Bang)
+
+SearXNG supporte les recherches [DuckDuckGo] de type "!Bang". Utilisez
+le préfixe "!!" pour être automatiquement redirigé vers un moteur de
+recherche externe. Par exemple :
+
+- Rechercher sur Wikipédia en langue française.
+
+  - {{search('!!wfr Wau Holland')}}
+
+Prenez garde au fait que de telles recherches sont exécutées directement
+sur le moteur externe. Dans ce cas, SearXNG ne peut pas protéger votre
+vie privée.
+
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## `!!` Redirection automatique
+
+En utilisant "!!" suivi d'un ou plusieurs espaces lors de votre
+recherche, vous serez automatiquement redirigé vers le premier résultat
+de recherche. Cela correspondant au fonctionnement "J'ai de la chance"
+du moteur Google. Par exemple :
+
+- Rechercher et être redirigé directement vers le premier lien
+  correspondant.
+
+  - {{search('!! Wau Holland')}}
+
+Prenez garde au fait qu'aucune vérification ne peut être faite
+concernant le premier lien retourné. Il pourrait même s'agir d'un site
+dangereux. Dans ce cas, SearXNG ne peut pas protéger votre vie
+privée. Soyez prudent en utilisant cette fonctionnalité.
+
+## Requêtes spéciales
+
+Dans la section _requêtes spéciales_ de la page de {{link('préférences',
+'preferences')}} se trouve une liste de mots clés à usage particulier.
+Par exemple :
+
+- Générer une valeur aléatoire.
+
+  - {{search('random uuid')}}
+
+- Calculer une moyenne.
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- Afficher la valeur de la variable _User-Agent_ utilisée par votre
+  navigateur (doit être activé manuellement).
+
+  - {{search('user-agent')}}
+
+- Convertir une chaîne de caractères en valeurs de hachage ("hash digests")
+  (doit être activé manuellement).
+
+  - {{search('md5 lorem ipsum')}}
+  - {{search('sha512 lorem ipsum')}}

searx/infopage/id/about.md

@@ -0,0 +1,82 @@
+# Tentang SearXNG
+
+SearXNG adalah sebuah [mesin pencari meta], yang mendapatkan hasil dari
+{{link('mesin pencari', 'preferences')}} lainnya sambil tidak melacak
+penggunanya.
+
+Proyek SearXNG diarahkan oleh sebuah komunitas terbuka, bergabung dengan kami di
+Matrix jika Anda memiliki pertanyaan atau ingin mengobrol tentang SearXNG di
+[#searxng:matrix.org]
+
+Buat SearXNG lebih baik.
+
+- Anda dapat membuat terjemahan SearXNG lebih baik di [Weblate], atau...
+- Lacak pengembangan, kirim kontribusi, dan laporkan masalah di [sumber
+  SearXNG].
+- Untuk mendapatkan informasi lanjut, kunjungi dokumentasi proyek SearXNG di
+  [dokumentasi SearXNG].
+
+## Kenapa menggunakan SearXNG?
+
+- SearXNG mungkin tidak menawarkan Anda hasil yang dipersonalisasikan seperti
+  Google, tetapi tidak membuat sebuah profil tentang Anda.
+- SearXNG tidak peduli apa yang Anda cari, tidak akan membagikan apa pun dengan
+  pihak ketiga, dan tidak dapat digunakan untuk mengkompromikan Anda.
+- SearXNG adalah perangkat lunak bebas, kodenya 100% terbuka, dan semuanya
+  dipersilakan untuk membuatnya lebih baik.
+
+Jika Anda peduli dengan privasi, ingin menjadi pengguna yang sadar, ataupun
+percaya dalam kebebasan digital, buat SearXNG sebagai mesin pencari bawaan atau
+jalankan di server Anda sendiri!
+
+## Bagaimana saya dapat membuat SearXNG sebagai mesin pencari bawaan?
+
+SearXNG mendukung [OpenSearch].  Untuk informasi lanjut tentang mengubah mesin
+pencari bawaan Anda, lihat dokumentasi peramban Anda:
+
+- [Firefox]
+- [Microsoft Edge] - Dibalik tautan, Anda juga akan menemukan beberapa instruksi
+  berguna untuk Chrome dan Safari.
+- Peramban berbasis [Chromium] hanya menambahkan situs web yang dikunjungi oleh
+  pengguna tanpa sebuah jalur.
+
+Apabila menambahkan mesin pencari, tidak boleh ada duplikat dengan nama yang
+sama.  Jika Anda menemukan masalah di mana Anda tidak bisa menambahkan mesin
+pencari, Anda bisa:
+
+- menghapus duplikat (nama default: SearXNG) atau
+- menghubungi pemilik untuk memberikan nama yang berbeda dari nama default.
+
+## Bagaimana caranya SearXNG bekerja?
+
+SearXNG adalah sebuah *fork* dari [mesin pencari meta] [searx] yang banyak
+dikenal yang diinspirasi oleh [proyek Seeks].  SearXNG menyediakan privasi dasar
+dengan mencampur kueri Anda dengan pencarian pada *platform* lainnya tanpa
+menyimpan data pencarian.  SearXNG dapat ditambahkan ke bilah pencarian peramban
+Anda; lain lagi, SearXNG dapat diatur sebagai mesin pencarian bawaan.
+
+{{link('Laman statistik', 'stats')}} berisi beberapa statistik penggunaan anonim
+berguna tentang mesin pencarian yang digunakan.
+
+## Bagaimana caranya untuk membuat SearXNG milik saya?
+
+SearXNG menghargai kekhawatiran Anda tentang pencatatan (*log*), jadi ambil
+kodenya dari [sumber SearXNG] dan jalankan sendiri!
+
+Tambahkan instansi Anda ke [daftar instansi
+publik]({{get_setting('brand.public_instances')}}) ini untuk membantu orang lain
+mendapatkan kembali privasi mereka dan membuat internet lebih bebas.  Lebih
+terdesentralisasinya internet, lebih banyak kebebasan yang kita punya!
+
+
+[sumber SearXNG]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[dokumentasi SearXNG]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[mesin pencari meta]: https://id.wikipedia.org/wiki/Mesin_pencari_web#Mesin_Pencari_dan_Mesin_Pencari-meta
+[Weblate]: https://translate.codeberg.org/projects/searxng/
+[proyek Seeks]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/id/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/id-id/microsoft-edge/ubah-mesin-pencarian-default-anda-f863c519-5994-a8ed-6859-00fbc123b782
+[Chromium]: https://www.chromium.org/tab-to-search

searx/infopage/id/search-syntax.md

@@ -0,0 +1,73 @@
+# Sintaks pencarian
+
+SearXNG mempunyai sintaks pencarian memungkinkan Anda untuk mengubah kategori,
+mesin pencari, bahasa dan lainnya.  Lihat {{link('preferensi', 'preferences')}}
+untuk daftar mesin pencari, kategori dan bahasa.
+
+## `!` pilih mesin pencari dan kategori
+
+Untuk menetapkan nama kategori dan/atau mesin pencari gunakan awalan `!`.
+Sebagai contoh:
+
+- cari di Wikipedia tentang **Jakarta**
+
+  - {{search('!wp Jakarta')}}
+  - {{search('!wikipedia Jakarta')}}
+
+- cari dalam kategori **peta** untuk **Jakarta**
+
+  - {{search('!map Jakarta')}}
+
+- pencarian gambar
+
+  - {{search('!images kucing')}}
+
+Singkatan mesin pencari dan bahasa juga diterima.  Pengubah mesin/kategori dapat
+dirantai dan inklusif.  Misalnya dengan pencarian {{search('!map !ddg !wp
+Jakarta')}} dalam kategori peta dan DuckDuckGo dan Wikipedia tentang
+**Jakarta**.
+
+## `:` pilih bahasa
+
+Untuk memilih saringan bahasa gunakan awalan `:`.  Sebagai contoh:
+
+- cari Wikipedia dengan bahasa lain
+
+  - {{search(':en !wp Jakarta')}}
+
+## `!!<bang>` mesin pencarian (*bangs*) eksternal
+
+SearXNG mendukung mesin pencarian eksternal (*bangs*) dari [DuckDuckGo].  Untuk
+langsung lompat ke sebuah laman pencarian eksternal gunakan awalan `!!`.
+Sebagai contoh:
+
+- cari Wikipedia dengan bahasa yang lain
+
+  - {{search('!!wen cat')}}
+
+Diingat, pencarian Anda akan dilakukan secara langsung di mesin pencari
+eksternal, SearXNG tidak dapat melindungi privasi Anda di sana.
+
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## Kueri Khusus
+
+Dalam laman {{link('preferensi', 'preferences')}} Anda akan menemukan kata kunci
+_kueri khusus_.  Sebagai contoh:
+
+- buat sebuah UUID acak
+
+  - {{search('random uuid')}}
+
+- temukan rata-rata
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- tampilkan _user agent_ (agen pengguna) dari peramban Anda (harus diaktifkan)
+
+  - {{search('user-agent')}}
+
+- ubah _string_ (teks) ke intisari *hash* yang berbeda (harus diaktifkan)
+
+  - {{search('md5 kucing sphynx')}}
+  - {{search('sha512 kucing sphynx')}}

searx/infopage/it/about.md

@@ -0,0 +1,84 @@
+# Informazioni su SearXNG
+
+SearXNG è un [metamotore di ricerca] che aggrega i risultati di altri motori di
+ricerca.  {{link('motori di ricerca', 'preferences')}} e non memorizza
+informazioni sui suoi utenti.
+
+Il progetto SearXNG è guidato da una comunità aperta, unisciti a noi su Matrix
+se hai domande o vuoi semplicemente chiacchierare.  Se avete domande o volete
+semplicemente parlare di SearXNG a [#searxng:matrix.org].
+
+Migliorate SearXNG.
+
+- Potete migliorare le traduzioni di SearXNG su [Weblate], oppure...
+- Seguire lo sviluppo, inviare contributi e segnalare problemi a [sorgenti di
+  SearXNG].
+- Per ulteriori informazioni, visitate la documentazione del progetto SearXNG su
+  [SearXNG docs].
+
+## Perché usarlo?
+
+- SearXNG non offre risultati personalizzati come Google, ma non genera un
+  profilo dell'utente.
+- SearXNG non si preoccupa di ciò che cercate, non condivide mai nulla con terze
+  parti e non può essere usato per compromettere l'utente.
+- SearXNG è un software libero, il codice è aperto al 100% e tutti sono invitati
+  a migliorarlo.
+
+Se avete a cuore la privacy, se volete essere un utente consapevole o se credete
+nella libertà digitale, fate di SearXNG il vostro motore di ricerca predefinito
+o eseguitelo sul vostro server!
+
+## Come si imposta come motore di ricerca predefinito?
+
+SearXNG supporta [OpenSearch].  Per ulteriori informazioni sulla modifica del
+motore di ricerca motore di ricerca predefinito, consultare la documentazione
+del browser:
+
+- [Firefox]
+- [Microsoft Edge] - nei link, troverete anche alcune utili istruzioni per
+  Chrome e Safari.
+- I browser basati su [Chromium] aggiungono solo i siti web a cui l'utente
+  naviga senza un percorso.
+
+Quando si aggiunge un motore di ricerca, non devono esserci duplicati con lo
+stesso nome.  Se si verifica un problema per cui non si riesce ad aggiungere il
+motore di ricerca, è possibile:
+
+- rimuovere il duplicato (nome predefinito: SearXNG) o
+- contattare il proprietario per assegnare all'istanza un nome diverso da quello
+  predefinito.
+
+## Come funziona?
+
+SearXNG è un fork del ben noto [searx] [metamotore di ricerca] che è stato
+ispirato dal [progetto Seeks].  Fornisce una privacy di base mescolando le
+ricerche su altre piattaforme senza memorizzare i dati di ricerca.  SearXNG può
+essere aggiunto alla barra di ricerca del browser; inoltre, può essere impostato
+come motore di ricerca predefinito.
+
+Il {{link('statistiche', 'stats')}} contiene alcune utili statistiche anonime di
+utilizzo dei motori utilizzati.
+
+## Come posso renderlo mio?
+
+SearXNG apprezza la vostra preoccupazione per i log, quindi prendete il codice
+dal file [sorgenti di SearXNG] ed eseguitelo voi stessi!
+
+Aggiungete la vostra istanza a questo [elenco di istanze
+pubbliche]({{get_setting('brand.public_instances')}}) per aiutare altre persone
+a reclamare la propria privacy e a rendere Internet più libero.  Più internet è
+decentralizzato più libertà abbiamo!
+
+
+[sorgenti di SearXNG]: {{GIT_URL}}
+[#searxng:matrix.org]: https://matrix.to/#/#searxng:matrix.org
+[SearXNG docs]: {{get_setting('brand.docs_url')}}
+[searx]: https://github.com/searx/searx
+[metamotore di ricerca]: https://it.wikipedia.org/wiki/Metamotore
+[Weblate]: https://translate.codeberg.org/projects/searxng/
+[progetto Seeks]: https://beniz.github.io/seeks/
+[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md
+[Firefox]: https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox
+[Microsoft Edge]: https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine
+[Chromium]: https://www.chromium.org/tab-to-search

searx/infopage/it/search-syntax.md

@@ -0,0 +1,89 @@
+# Sintassi di ricerca
+
+SearXNG è dotato di una sintassi di ricerca che consente di modificare le
+categorie, motori, lingue e altro ancora.  Vedere il {{link('preferenze',
+'preferences')}} per l'elenco dei motori, delle categorie e delle lingue.
+
+## `!` seleziona motore e gategoria
+
+Per impostare i nomi delle categorie e/o dei motori, utilizzare il prefisso `!`.
+Per fare qualche esempio:
+
+- ricerca in Wikipedia per **parigi**
+
+  - {{search('!wp parigi')}}
+  - {{search('!wikipedia parigi')}}
+
+- ricerca nella categoria **mappa** per **parigi**
+
+- {{search('!map parigi')}}
+
+- ricerca per immagini
+
+- {{search('!images Wau Holland')}}
+
+Sono accettate anche le abbreviazioni dei motori e delle lingue.  I modificatori
+di motore/categoria sono modificatori a catena e inclusivi.  Ad esempio, con
+{{search('!map !ddg !wp parigi')}} si cerca nella categoria mappe e DuckDuckGo e
+Wikipedia per **parigi**.
+
+## `:` selziona lingua
+
+Per selezionare il filtro lingua utilizzare il prefisso `:`.  Per fare un esempio:
+
+- cercare Wikipedia in base a una lingua personalizzata
+
+  - {{search(':it !wp Wau Holland')}}
+
+## `!!<bang>` bangs esterni
+
+SearXNG supporta i bang esterni di [DuckDuckGo].  Per saltare direttamente a una
+pagina di ricerca esterna utilizzare il prefisso `!!`.  Per fare un esempio:
+
+- ricerca su Wikipedia in base a una lingua personalizzata
+
+  - {{search('!!wde Wau Holland')}}
+
+Si noti che la ricerca verrà eseguita direttamente nel motore di ricerca
+esterno.  motore di ricerca esterno, SearXNG non può proteggere la privacy
+dell'utente.
+
+[DuckDuckGo]: https://duckduckgo.com/bang
+
+## `!!` reindirizzamento automatico
+
+Quando si menziona `!!` all'interno della query di ricerca (separata da spazi),
+si viene automaticamente reindirizzati al primo risultato.  Questo comportamento
+è paragonabile alla funzione "Mi sento fortunato" di DuckDuckGo.  Per fare un
+esempio:
+
+- cercare una query e venire reindirizzati al primo risultato
+
+  - {{search('!! Wau Holland')}}
+
+Si tenga presente che il risultato a cui si viene reindirizzati non può essere
+verificato come affidabile, SearXNG non è in grado di proteggere la vostra
+privacy personale quando utilizzate questa funzione.  Utilizzatela a vostro
+rischio e pericolo.
+
+## Queries Speciali
+
+Nella pagina {{link('preferenze', 'preferences')}} si trovano parole chiave per
+_query speciali_.  Per fare qualche esempio:
+
+- Generare un UUID casuale
+
+  - {{search('random uuid')}}
+
+- Trovare la media
+
+  - {{search('avg 123 548 2.04 24.2')}}
+
+- Mostra l'_user agent_ del browser (deve essere attivato)
+
+  - {{search('user-agent')}}
+
+- Converte le stringhe in diversi hash digest (deve essere attivato)
+
+  - {{search('md5 lorem ipsum')}}
+  - {{search('sha512 lorem ipsum')}}