From 284ac8bfd8a3d1f762c98a0195b98a45cdd089d3 Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Sat, 15 Jan 2022 09:01:38 +0100 Subject: [PATCH] [help] convert about.html to Markdown To facilitate translation the new user documentation shall be written in Markdown (which is more human-friendly than HTML and reStructuredText). --- requirements.txt | 1 + searx/help/about.html | 102 ------------------------------------------ searx/help/about.md | 80 +++++++++++++++++++++++++++++++++ searx/user_help.py | 5 ++- 4 files changed, 84 insertions(+), 104 deletions(-) delete mode 100644 searx/help/about.html create mode 100644 searx/help/about.md diff --git a/requirements.txt b/requirements.txt index e9fd942d1..95b85578e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -14,3 +14,4 @@ httpx-socks[asyncio]==0.7.2 langdetect==1.0.9 setproctitle==1.2.2 redis==4.1.1 +mistletoe==0.8.1 diff --git a/searx/help/about.html b/searx/help/about.html deleted file mode 100644 index 5a9065f03..000000000 --- a/searx/help/about.html +++ /dev/null @@ -1,102 +0,0 @@ - -

About searxng

- -

- SearXNG is a fork from the well-known searx - metasearch engine, - aggregating the results of other search engines - while not storing information about its users. -

- -

More about SearXNG ...

- - - -
- -

Why use it?

- - - -

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

- -

Technical details - How does it work?

- -

- SearXNG is a metasearch engine, - inspired by the seeks project. - - It provides basic privacy by mixing your queries with searches on other - platforms without storing search data. Queries are made using a POST request - on every browser (except Chromium-based browsers*). Therefore they show up - in neither our logs, nor your url history. In the case of Chromium-based - browser users there is an exception: searx uses the search bar to perform GET - requests. - - SearXNG can be added to your browser's search bar; moreover, it can be set as - the default search engine. -

- -

How to set as the default search engine?

- -

- SearXNG supports OpenSearch. - For more information on changing your default search engine, see your browser's documentation: -

- - - -

Where to find anonymous usage statistics of this instance ?

- -

- Stats page contains some useful data about the engines used. -

- -

How can I make it my own?

- -

- SearXNG appreciates your concern regarding logs, so take the code from - the SearXNG project and - run it yourself! -

-

- Add your instance to this list of - 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! -

- -

Where are the docs & code of this instance?

- -

- See the SearXNG docs - and SearXNG sources -

- - -{% include "__common__/aboutextend.html" ignore missing %} diff --git a/searx/help/about.md b/searx/help/about.md new file mode 100644 index 000000000..00822e89c --- /dev/null +++ b/searx/help/about.md @@ -0,0 +1,80 @@ +# About [searxng][url_for:index] + +SearXNG is a fork from the well-known [searx] [metasearch engine], aggregating +the results of other [search engines][url_for:preferences] while not storing +information about its users. + +More about SearXNG ... + +* [SearXNG sources][brand.git_url] +* [weblate] + +--- + +## Why use it? + +* SearXNG may not offer you as personalised 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 it can't be used to compromise you. + +* SearXNG is free software, the code is 100% open and you can help + to make it better. See more on [SearXNG sources][brand.git_url]. + +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 + +## Technical details - How does it work? + +SearXNG is a [metasearch engine], inspired by the [seeks project]. It provides +basic privacy by mixing your queries with searches on other platforms without +storing search data. Queries are made using a POST request on every browser +(except Chromium-based browsers*). Therefore they show up in neither our logs, +nor your url history. In the case of Chromium-based browser users there is an +exception: searx uses the search bar to perform GET requests. SearXNG can be +added to your browser's search bar; moreover, it can be set as the default +search engine. + + +## How to set as the default search engine? + +SearXNG supports [OpenSearch]. For more information on changing your default +search engine, see your browser's documentation: + +* [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-based browsers [only add websites that the user navigates to without a path.](https://www.chromium.org/tab-to-search) + +## Where to find anonymous usage statistics of this instance ? + +[Stats page][url_for:stats] contains some useful data about the engines used. + +## How can I make it my own? + +SearXNG appreciates your concern regarding logs, so take the code from +the [SearXNG project][brand.git_url] and run it yourself! + +Add your instance to this [list of public instances][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! + +## Where are the docs & code of this instance? + +See the [SearXNG docs][brand.docs_url] and [SearXNG sources][brand.git_url] + +[url_for:index]: {{ url_for('index') }} +[url_for:preferences]: {{ url_for('preferences') }} +[url_for:stats]: {{ url_for('stats') }} +[brand.git_url]: {{ searx_git_url }} +[brand.public_instances]: {{ get_setting('brand.public_instances') }} +[brand.docs_url]: {{ get_setting('brand.docs_url') }} + +[searx]: https://github.com/searx/searx +[metasearch engine]: https://en.wikipedia.org/wiki/Metasearch_engine +[weblate]: https://weblate.bubu1.eu/projects/searxng/ +[seeks project]: https://beniz.github.io/seeks/ +[OpenSearch]: https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md + +{% include "__common__/aboutextend.html" ignore missing %} diff --git a/searx/user_help.py b/searx/user_help.py index 2822d3a0d..1d3cbef37 100644 --- a/searx/user_help.py +++ b/searx/user_help.py @@ -3,6 +3,7 @@ import os.path import pkg_resources import flask +import mistletoe from . import get_setting from .version import GIT_URL @@ -20,7 +21,7 @@ def render(app: flask.Flask): """ for filename in pkg_resources.resource_listdir(__name__, 'help'): rootname, ext = os.path.splitext(filename) - if ext != '.html': + if ext != '.md': continue text = pkg_resources.resource_string(__name__, 'help/' + filename).decode() @@ -35,4 +36,4 @@ def render(app: flask.Flask): interpolated = flask.render_template_string(text, get_setting=get_setting, searx_git_url=GIT_URL) - HELP[rootname] = interpolated + HELP[rootname] = mistletoe.markdown(interpolated)