From 036b46493bb2cc89f5c9a9c278ce203444297080 Mon Sep 17 00:00:00 2001 From: Linerly Date: Sat, 2 Apr 2022 20:51:11 +0000 Subject: [PATCH 1/4] Improve the about page --- searx/infopage/en/about.md | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/searx/infopage/en/about.md b/searx/infopage/en/about.md index 9f323870e..d27cc3696 100644 --- a/searx/infopage/en/about.md +++ b/searx/infopage/en/about.md @@ -4,39 +4,39 @@ SearXNG is a fork from the well-known [searx] [metasearch engine], aggregating the results of other {{link('search engines', 'preferences')}} while not storing information about its users. -More about SearXNG ... +More about SearXNG… * [SearXNG sources]({{GIT_URL}}) -* [weblate] +* [Weblate] ## Why use it? -* SearXNG may not offer you as personalised results as Google, but it doesn't +* 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 it can't be used to compromise you. + 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 +* SearXNG is free software, the code is 100% open, and you can help to make it better. See more on [SearXNG sources]({{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 +own server! -## Technical details - How does it work? +## The technical details—how does it work? -SearXNG is a [metasearch engine], inspired by the [seeks project]. It provides +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 +(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: SearXNG 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? +## 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: @@ -46,9 +46,9 @@ search engine, see your browser's documentation: * 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 ? +## Where do I find anonymous usage statistics of this instance? -{{link('Stats page', 'stats')}} contains some useful data about the engines +The {{link('stats page', 'stats')}} contains some useful data about the engines used. ## How can I make it my own? @@ -58,18 +58,18 @@ SearXNG appreciates your concern regarding logs, so take the code from the 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! +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]({{get_setting('brand.docs_url')}}) and [SearXNG -sources]({{GIT_URL}}) +sources]({{GIT_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/ +[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 [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 From 655db9b003728d756c7209d5de74f3b94b48b1f5 Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Wed, 6 Apr 2022 13:05:20 +0200 Subject: [PATCH 2/4] [mod] review of the "About SearXNG" page (en) Signed-off-by: Markus Heiser --- searx/infopage/en/about.md | 68 +++++++++++++++++++------------------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/searx/infopage/en/about.md b/searx/infopage/en/about.md index d27cc3696..a628da254 100644 --- a/searx/infopage/en/about.md +++ b/searx/infopage/en/about.md @@ -1,71 +1,70 @@ # About SearXNG -SearXNG is a fork from the well-known [searx] [metasearch engine], aggregating -the results of other {{link('search engines', 'preferences')}} while not -storing information about its users. +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 a open community, come join us on +Matrix if you have questions or just want to chat about SearXNG: -More about SearXNG… +- [#searxng:matrix.org] -* [SearXNG sources]({{GIT_URL}}) -* [Weblate] +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 +- 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 +- 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]({{GIT_URL}}). +- 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! -## The 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: SearXNG 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 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] -* Chromium-based browsers [only add websites that the user navigates to without - a path.](https://www.chromium.org/tab-to-search) +- [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. -## Where do I find anonymous usage statistics of this instance? -The {{link('stats page', 'stats')}} contains some useful data about the engines -used. +## How does it work? + +SearXNG is a fork from 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 project]({{GIT_URL}}) and run it yourself! +[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! -## Where are the docs & code of this instance? - -See the [SearXNG docs]({{get_setting('brand.docs_url')}}) and [SearXNG -sources]({{GIT_URL}}). +[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://weblate.bubu1.eu/projects/searxng/ @@ -73,3 +72,4 @@ sources]({{GIT_URL}}). [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 From 19ebd0e1ac2caa99904e808f75d526e4d6d41633 Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Wed, 6 Apr 2022 14:13:22 +0200 Subject: [PATCH 3/4] [mod] review of the "Search Syntax" page (en) Signed-off-by: Markus Heiser --- searx/infopage/en/search-syntax.md | 75 ++++++++++++++++++++++-------- 1 file changed, 55 insertions(+), 20 deletions(-) diff --git a/searx/infopage/en/search-syntax.md b/searx/infopage/en/search-syntax.md index ae820dfbc..3cee88ffc 100644 --- a/searx/infopage/en/search-syntax.md +++ b/searx/infopage/en/search-syntax.md @@ -1,35 +1,70 @@ # Search syntax -SearXNG allows you to modify the default categories, engines and search language -via the search query. +SearXNG comes with a search syntax by with you can modify the categories, +engines, languages and more. See the {{link('preferences', 'preferences')}} for +the list of engines, categories and languages. -Prefix `!` to set category and engine names. +## `!` select engine and category -Prefix: `:` to set the language. +To set category and/or engine names use a `!` prefix. To give a few examples: -Abbrevations of the engines and languages are also accepted. Engine/category -modifiers are chainable and inclusive. E.g. with {{search('!map !ddg !wp paris')}} -search in map category **and** duckduckgo **and** wikipedia for -`paris`. +- search in wikipedia for **paris** -See the {{link('preferences', 'preferences')}} for the list of engines, -categories and languages. + - {{search('!wp paris')}} + - {{search('!wikipedia paris')}} -## Examples +- search in category **map** for **paris** -Search in wikipedia for `paris`: + - {{search('!map paris')}} -* {{search('!wp paris')}} -* {{search('!wikipedia paris')}} +- image search -Search in category `map` for `paris`: + - {{search('!images Wau Holland')}} -* {{search('!map paris')}} +Abbreviations of the engines and languages are also accepted. Engine/category +modifiers are chain able and inclusive. E.g. with {{search('!map !ddg !wp +paris')}} search in map category and duckduckgo and wikipedia for **paris**. -Image search: +## `:` select language -* {{search('!images Wau Holland')}} +To select language filter use a `:` prefix. To give an example: -Custom language in wikipedia: +- search wikipedia by a custom language -* {{search(':fr !wp Wau Holland')}} + - {{search(':fr !wp Wau Holland')}} + +## `!!` external bangs + +SearXNG supports the external bangs from [ddg]. To directly jump to a external +search page use the `!!` prefix. To give an example: + +- search wikipedia by a custom language + + - {{search('!!wfr Wau Holland')}} + +Please note, your search will be performed directly in the external search +engine, SearXNG cannot protect your privacy on this. + +[ddg]: https://duckduckgo.com/bang + +## 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 _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')}} From 22309f398b83c48ef1c269adf9cdf3d9d182b45c Mon Sep 17 00:00:00 2001 From: Linerly Date: Wed, 6 Apr 2022 12:36:17 +0000 Subject: [PATCH 4/4] Fix spelling and punctuation --- searx/infopage/en/about.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/searx/infopage/en/about.md b/searx/infopage/en/about.md index a628da254..48abda68f 100644 --- a/searx/infopage/en/about.md +++ b/searx/infopage/en/about.md @@ -2,16 +2,16 @@ 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 a open community, come join us on -Matrix if you have questions or just want to chat about SearXNG: +its users. -- [#searxng:matrix.org] +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. +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 +- 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? @@ -34,9 +34,9 @@ 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 +- [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 +- [Chromium]-based browsers only add websites that the user navigates to without a path.