Update translations

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md

@@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect
 
 :::
 
-In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads.
+In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets) to deal with even the complex ads, such as YouTube ads.
 
 ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg)
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md

@@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature
 
 ## What it does
 
-By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example.
+By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube.
 
 AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules.
 
 Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it.
 
 ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1)
-> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar.
+
+> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar.
 
 You will see the following list of options:
 
@@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi
 
 ### In Safari
 
-Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon).
+You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon).
 
 ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png)
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md

@@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension.
 
 ## AdGuard for Safari
 
-*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube.
+*AdGuard for Safari activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.
 
 ## How to manage Safari extensions
 
-1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png)
+1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu.
+
+    ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png)
+
 1. Click *Settings...*
-1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png)
+
+1. Select *Extensions*.
+
+    ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png)
 
 ## Why AdGuard for Safari requires permission
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md

@@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote
 
 :::
 
-AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones.
+AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones.
 
 ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png)
 

i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md

@@ -4410,6 +4410,7 @@ where:
         - `adguard_app_ios` — AdGuard for iOS
         - `adguard_ext_safari` — AdGuard for Safari
         - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge)
+        - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3]
         - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox
         - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy
         - `adguard_ext_opera` — AdGuard Browser Extension for Opera

i18n/be/docusaurus-plugin-content-docs/current/general/extensions.md

@@ -0,0 +1,301 @@
+---
+title: Extensions
+sidebar_position: 6
+---
+
+## Userscripts
+
+Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra.
+
+:::note Supported apps
+
+AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions).
+
+:::
+
+### Recommended AdGuard scripts
+
+These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer.
+
+#### AdGuard Extra
+
+An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra).
+
+![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png)
+
+#### AdGuard Popup Blocker
+
+The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker).
+
+![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png)
+
+#### AdGuard Assistant (legacy version)
+
+This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.).
+
+:::note
+
+This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant).
+
+:::
+
+#### Disable AMP
+
+A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP).
+
+![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png)
+
+### Top picks outside AdGuard{#top-picks}
+
+These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation.
+
+#### Don't track me Google
+
+This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL.
+
+Its source code is [available on GitHub](https://github.com/Rob--W/dont-track-me-google). This userscript can be downloaded from [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) and installed in any AdGuard CoreLibs-based app.
+
+#### microShield
+
+A userscript for people visiting Korean websites and some international websites. The microShield userscript blocks Ad-Shield ads and anti-adblocks. Its original source code is available at [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) and [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and [quoid/userscripts](https://github.com/quoid/userscripts). Learn more about microShield and how to install it on [GitHub](https://github.com/List-KR/microShield).
+
+### Where can you get more userscripts?{#more-userscripts}
+
+Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient.
+
+Here we will describe some of the most popular userscript catalogs.
+
+#### Userscript.Zone
+
+[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed.
+
+#### Greasy Fork
+
+[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher.
+
+#### OpenUserJS.org
+
+[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts.
+
+#### Community
+
+If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites:
+
+- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts)
+- [FreeNode](https://webchat.freenode.net/#greasemonkey)
+- [Reddit](https://www.reddit.com/r/userscripts/)
+
+### Development
+
+#### Request license
+
+If you are developing your own custom script and want to test how it works with AdGuard, you can request a beta license key for the app.
+
+To get it, please send an email to devteam@adguard.com with the following information:
+
+**Subject:** Userscript author license request
+
+**Body:** Please tell us about the userscripts you are working on.
+
+Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK).
+
+#### Compatibility
+
+#### Metadata block
+
+#### Supported properties
+
+```text
+@name
+@namespace
+@description
+@version
+@match
+@include
+@exclude
+@grant
+@connect
+@require
+@resource
+@downloadURL
+@updateURL
+@supportURL
+@homepageURL
+@homepage
+@website
+@source
+@run-at
+@noframes
+@icon
+@iconURL
+@defaulticon
+@icon64
+@icon64URL
+```
+
+#### Unsupported properties
+
+These properties will be simply ignored by AdGuard.
+
+```text
+@unwrap
+```
+
+#### Supported GM functions
+
+AdGuard supports both old GM\_ functions and new GM4 API that use GM object.
+
+#### Values
+
+:::note
+
+All listed old Greasemonkey functions are deprecated but still supported.
+
+:::
+
+```text
+GM.info / GM_info
+GM.setValue / GM_setValue
+GM.getValue / GM_getValue
+GM.listValues / GM_listValues
+GM.deleteValue / GM_deleteValue
+GM.getResourceUrl / GM_getResourceURL
+GM.setClipboard / GM_setClipboard
+GM.xmlHttpRequest / GM_xmlhttpRequest
+GM.openInTab / GM_openInTab
+GM.notification
+unsafeWindow
+GM_getResourceText
+GM_addStyle
+GM_log
+```
+
+[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API.
+
+#### Example
+
+```javascript
+// ==UserScript==
+// @name            Name as shown to the user when locale is english or unknown
+// @name:ru         Name as shown to the user when locale is russian
+// @description     Description as shown to the user when locale is english or unknown
+// @description:ru  Description as shown to the user when locale is russian
+// @icon            https://myhomepage.com/myuserscript.png
+// @version         1.0.0.0
+// @downloadURL     https://dl.myhomepage.org/myuserscript.user.js
+// @updateURL       https://dl.myhomepage.org/myuserscript.meta.js
+// @homepageURL     https://myhomepage.com/myuserscript
+// @include         *
+// @exclude         *://website.com/*
+// @resource        https://myhomepage.com/myuserscript.css
+// @require         https://myhomepage.com/mylibrary.js
+// @grant           property:settings
+// @grant           GM_getValue
+// @grant           GM_setValue
+// @grant           GM_deleteValue
+// @grant           GM_listValues
+// @grant           GM_getResourceText
+// @grant           GM_getResourceURL
+// @grant           GM_addStyle
+// @grant           GM_log
+// @grant           GM_setClipboard
+// @grant           GM_xmlhttpRequest
+// @grant           unsafeWindow
+// @grant           GM_info
+// @grant           GM_openInTab
+// @grant           GM_registerMenuCommand
+// @run-at document-start
+// ==/UserScript==
+!function(){(
+    console.log("I am loaded!");
+)}();
+```
+
+## Userstyles
+
+Userstyles allow users to customize their online experience. Whether you’re looking to change the appearance of a website or automate repetitive tasks, styles offer a world of possibilities.
+
+AdGuard has the option to upload or create your own userstyles. This is an advanced feature, so you will need some knowledge of HTML and CSS.
+
+:::info Supported apps
+
+Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future.
+
+:::
+
+This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at <support@adguard.com>.
+
+### How to set up a userstyle in AdGuard
+
+You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard.
+
+1. Follow the link above and choose the userstyle you like
+
+2. Right-click the _Install_ button and choose _Copy Link Address_
+
+3. Open AdGuard settings → _Extensions_
+
+4. Press the [+] button and paste the userstyle link
+
+5. Done!
+
+If you’re familiar with CSS rules, you can also create the userstyles yourself.
+
+:::note
+
+We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value.
+
+:::
+
+1. Open AdGuard settings → _Extensions_
+
+2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen
+
+3. To create a userstyle, first write the title with metadata, for example
+
+   ```CSS
+   /* ==UserStyle==
+   @name New userstyle
+   @version 1.0
+   ==/UserStyle== */
+   ```
+
+4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example:
+
+   ```CSS
+   body {
+     background: gray;
+     }
+   ```
+
+   Or:
+
+   ```CSS
+   @-moz-document domain('example.org'),
+   domain('example.net'),
+   domain('example.com') body {
+     background: gray;
+     }
+   ```
+
+5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard
+
+### Example
+
+```css
+/* ==UserStyle==
+@name         Example userstyle
+@namespace    https://example.org/userstyle
+@homepageURL  https://example.org/userstyle
+@version      1.0.0
+@license      Other
+@description  This is an example
+@author       example
+@preprocessor default
+==/UserStyle== */
+@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") {
+    body {
+        background-color: #000000 !important;
+    }
+}
+```

i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md

@@ -1,6 +1,6 @@
 ---
 title: How to install AdGuard
-sidebar_position: 8
+sidebar_position: 9
 ---
 
 Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: