Migrate knowledge base to docusaurus v3

docs/adguard-browser-extension/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-browser-extension",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-browser-extension/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 6,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-browser-extension",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-android/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-for-android",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-android/features/protection/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Protection",
+    "key": "protection-adguard-for-android-features",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-android/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 3,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-android",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-android/solving-problems/battery.md

@@ -33,9 +33,9 @@ And with *Mobile data usage* and *Wi-Fi data usage*, you can see how much traffi
 
 First, let us lay down a bit of theory and links with necessary data.
 
-1. Android derives traffic consumption judging on so-called Power Profile, which is given by every manufacturer: <https://source.android.com/devices/tech/power/values.html>
+1. Android derives traffic consumption judging on so-called Power Profile, which is given by every manufacturer: [https://source.android.com/devices/tech/power/values.html](https://source.android.com/devices/tech/power/values.html)
 
-1. Main part of Power Profile is a set of values in mAh which define battery consumption for every component of the device: <https://source.android.com/devices/tech/power/values.html>
+1. Main part of Power Profile is a set of values in mAh which define battery consumption for every component of the device: [https://source.android.com/devices/tech/power/values.html](https://source.android.com/devices/tech/power/values.html)
 
     For example, from the table above:
 

docs/adguard-for-android/solving-problems/compatibility-issues.md

@@ -38,7 +38,7 @@ Some device manufacturers keep Private DNS settings hidden and set 'Automatic' m
 
 To be able to filter HTTPS traffic, AdGuard requires the user to add a certificate to the device's trusted user certificates. Unfortunately, UC browsers don't trust user certificates, so AdGuard cannot perform HTTPS filtering there.
 
-- To solve this problem, move the [certificate to the system certificate store](../solving-problems/https-certificate-for-rooted.md/)
+- To solve this problem, move the [certificate to the system certificate store](../solving-problems/https-certificate-for-rooted.md)
 
 :::note Compatibility
 

docs/adguard-for-android/solving-problems/log.md

@@ -35,5 +35,5 @@ To collect **debug** log and send it to us, you need to perform following steps:
 If you're interested in following the resolution of your issue and engaging in a dialogue with the developers, we recommend that you take the following steps after completing the first three:
 
 1. Wait a while, then return to the *Advanced* screen and export logs via *Export logs and system info*. Then report a bug on GitHub by following these [instructions](/guides/report-bugs.md).
-1. After creating an issue on GitHub, send the log file to <devteam@adguard.com>. Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title).
-Alternatively, you can upload the log file to Google Drive and send it to <devteam@adguard.com>. Add the file link to your GitHub issue
+1. After creating an issue on GitHub, send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title).
+Alternatively, you can upload the log file to Google Drive and send it to [devteam@adguard.com](mailto:devteam@adguard.com). Add the file link to your GitHub issue

docs/adguard-for-android/solving-problems/logcat.md

@@ -99,7 +99,7 @@ It is important to reproduce the problem after you're done with the first part.
 
     `adb logcat -v threadtime -d > C:\Program Files\platform-tools\logs.txt`
 
-    Email the created `txt` file as well as the time the problem was reproduced (from part #2) to our support team at <support@adguard.com>.
+    Email the created `txt` file as well as the time the problem was reproduced (from part #2) to our support team at [support@adguard.com](mailto:support@adguard.com).
 
 ### Alternative way for ROOT users
 

docs/adguard-for-android/solving-problems/manual-certificate.md

@@ -51,4 +51,4 @@ Despite these warnings, your traffic remains secure. Your connection to remote s
 
 [Learn more about HTTPS filtering and how the certificate works](/general/https-filtering/what-is-https-filtering.md).
 
-If you still encounter a problem and can’t install the certificate, please contact our support team at <support@adguard.com>.
+If you still encounter a problem and can’t install the certificate, please contact our support team at [support@adguard.com](mailto:support@adguard.com).

docs/adguard-for-ios/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-for-ios",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-ios/features/dns-protection.md

@@ -67,7 +67,7 @@ How to access:
 
 #### DNS filters {#dns-filters}
 
-Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [this exhaustive manual](adguard-for-ios/solving-problems/system-wide-filtering).
+Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [this exhaustive manual](/adguard-for-ios/solving-problems/system-wide-filtering).
 
 #### Allowlist and Blocklist {#allowlist-blocklist}
 

docs/adguard-for-ios/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 4,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-ios",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-linux/feedback.md

@@ -30,7 +30,7 @@ If you want to support the implementation of a new feature or bugfix, you can vo
 
     The archived log file will be downloaded to the application folder by default, and the path to the logs will be written to the console.
 
-1. Send the log file to <devteam@adguard.com>. Specify the time of the error and attach a link to your GitHub issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and share it with <devteam@adguard.com>. Attach the file link to your GitHub issue.
+1. Send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Specify the time of the error and attach a link to your GitHub issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and share it with [devteam@adguard.com](mailto:devteam@adguard.com). Attach the file link to your GitHub issue.
 
 1. Switch the logging mode back to `info`:
 

docs/adguard-for-mac/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-for-mac",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-mac/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 3,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-mac",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-safari/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-for-safari",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-safari/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 4,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-safari",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-windows-8/protection/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 2,
     "label": "Protection",
+    "key": "protection-adguard-for-windows-8",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-windows-8/settings/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 5,
     "label": "Settings",
+    "key": "settings-adguard-for-windows-8",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-windows-8/settings/app-settings/filter-editor.md

@@ -21,4 +21,4 @@ With the Filter editor, you can:
 
 The Filter editor is especially useful for advanced users who want to fine-tune ad blocking by precisely controlling what is blocked or allowed. If you’re not familiar with creating your own rules, we have an article to help you learn how.
 
-[How to create own rules](general/ad-filtering/create-own-filters/)
+[How to create own rules](/general/ad-filtering/create-own-filters/)

docs/adguard-for-windows-8/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 6,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-windows-8",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-windows/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 1,
     "label": "Features",
+    "key": "features-adguard-for-windows",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-for-windows/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 4,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-for-windows",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-mini-for-mac/features/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 2,
     "label": "Features",
+    "key": "features-adguard-mini-for-mac",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-mini-for-mac/features/settings/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 5,
     "label": "Settings",
+    "key": "settings-adguard-mini-for-mac",
     "collapsible": true,
     "collapsed": true
 }

docs/adguard-mini-for-mac/solving-problems/_category_.json

@@ -1,6 +1,7 @@
 {
     "position": 4,
     "label": "Solving problems",
+    "key": "solving-problems-adguard-mini-for-mac",
     "collapsible": true,
     "collapsed": true
 }

docs/general/browsing-security.md

@@ -63,11 +63,11 @@ We automatically analyze complaints about suspicious sites and spend a great dea
 
 ### Want to help?
 
-Any help is welcome! If you encounter a phishing or malware website, please report it to <support@adguard.com>.
+Any help is welcome! If you encounter a phishing or malware website, please report it to [support@adguard.com](mailto:support@adguard.com).
 
 ### False-positive responses
 
-Occasionally, some non-malicious websites are added to AdGuard’s filters. We do our best to reduce the percentage of false positives, but they still occur. If you encounter this behavior from AdGuard, please report the false positive to our technical support at <support@adguard.com>.
+Occasionally, some non-malicious websites are added to AdGuard’s filters. We do our best to reduce the percentage of false positives, but they still occur. If you encounter this behavior from AdGuard, please report the false positive to our technical support at [support@adguard.com](mailto:support@adguard.com).
 
 ## If you are suspicious about a website
 

docs/general/extensions.md

@@ -427,7 +427,7 @@ Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard f
 
 :::
 
-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>.
+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](mailto:support@adguard.com).
 
 ### How to set up a userstyle in AdGuard
 

docusaurus.config.js

@@ -1,5 +1,6 @@
-const lightCodeTheme = require('prism-react-renderer/themes/github');
-const darkCodeTheme = require('prism-react-renderer/themes/dracula');
+const { themes } = require('prism-react-renderer');
+const lightCodeTheme = themes.github;
+const darkCodeTheme = themes.dracula;
 
 const ADGUARD_WEBSITE_URL = 'https://adguard.com';
 
@@ -14,12 +15,22 @@ const typesenseApiKey = process.env.SEARCH_API_KEY || 'test';
 
 /** @type {import('@docusaurus/types').DocusaurusConfig} */
 module.exports = {
+  future: {
+    faster: true,
+    v4: {
+      removeLegacyPostBuildHeadAttribute: true,
+    },
+  },
   title: 'AdGuard Knowledge Base',
   tagline: 'Knowledge Base for AdGuard products',
   url: url,
   baseUrl: baseUrl,
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
   favicon: 'img/favicon.ico',
   trailingSlash: true,
   organizationName: 'AdGuard',
@@ -247,21 +258,4 @@ module.exports = {
       },
     ],
   ],
-  webpack: {
-    jsLoader: (isServer) => ({
-      loader: require.resolve('swc-loader'),
-      options: {
-        jsc: {
-          parser: {
-            syntax: 'typescript',
-            tsx: true,
-          },
-          target: 'es2017',
-        },
-        module: {
-          type: isServer ? 'commonjs' : 'es6',
-        },
-      },
-    }),
-  },
 };

i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/availability.md

@@ -23,4 +23,4 @@ We have a standalone extension for Safari. Since the release of [Safari 13](http
 
 :::
 
-**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](adguard-browser-extension/comparison-standalone).
+**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](/adguard-browser-extension/comparison-standalone).

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/battery.md

@@ -33,9 +33,9 @@ And with *Mobile data usage* and *Wi-Fi data usage*, you can see how much traffi
 
 First, let us lay down a bit of theory and links with necessary data.
 
-1. Android derives traffic consumption judging on so-called Power Profile, which is given by every manufacturer: <https://source.android.com/devices/tech/power/values.html>
+1. Android derives traffic consumption judging on so-called Power Profile, which is given by every manufacturer: [https://source.android.com/devices/tech/power/values.html](https://source.android.com/devices/tech/power/values.html)
 
-1. Main part of Power Profile is a set of values in mAh which define battery consumption for every component of the device: <https://source.android.com/devices/tech/power/values.html>
+1. Main part of Power Profile is a set of values in mAh which define battery consumption for every component of the device: [https://source.android.com/devices/tech/power/values.html](https://source.android.com/devices/tech/power/values.html)
 
     For example, from the table above:
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/compatibility-issues.md

@@ -38,7 +38,7 @@ Some device manufacturers keep Private DNS settings hidden and set 'Automatic' m
 
 To be able to filter HTTPS traffic, AdGuard requires the user to add a certificate to the device's trusted user certificates. Unfortunately, UC browsers don't trust user certificates, so AdGuard cannot perform HTTPS filtering there.
 
-- To solve this problem, move the [certificate to the system certificate store](../solving-problems/https-certificate-for-rooted.md/)
+- To solve this problem, move the [certificate to the system certificate store](../solving-problems/https-certificate-for-rooted.md)
 
 :::note Compatibility
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/log.md

@@ -35,4 +35,4 @@ To collect **debug** log and send it to us, you need to perform following steps:
 If you're interested in following the resolution of your issue and engaging in a dialogue with the developers, we recommend that you take the following steps after completing the first three:
 
 1. Wait a while, then return to the *Advanced* screen and export logs via *Export logs and system info*. Then report a bug on GitHub by following these [instructions](/guides/report-bugs.md).
-1. After creating an issue on GitHub, send the log file to <devteam@adguard.com>. Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and send it to <devteam@adguard.com>. Add the file link to your GitHub issue
+1. After creating an issue on GitHub, send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and send it to [devteam@adguard.com](mailto:devteam@adguard.com). Add the file link to your GitHub issue

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/logcat.md

@@ -101,7 +101,7 @@ It is important to reproduce the problem after you're done with the first part.
 
     `adb logcat -v threadtime -d > C:\Program Files\platform-tools\logs.txt`
 
-    Email the created `txt` file as well as the time the problem was reproduced (from part #2) to our support team at <support@adguard.com>.
+    Email the created `txt` file as well as the time the problem was reproduced (from part #2) to our support team at [support@adguard.com](mailto:support@adguard.com).
 
 ### Alternative way for ROOT users
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/manual-certificate.md

@@ -51,4 +51,4 @@ Despite these warnings, your traffic remains secure. Your connection to remote s
 
 [Learn more about HTTPS filtering and how the certificate works](/general/https-filtering/what-is-https-filtering.md).
 
-If you still encounter a problem and can’t install the certificate, please contact our support team at <support@adguard.com>.
+If you still encounter a problem and can’t install the certificate, please contact our support team at [support@adguard.com](mailto:support@adguard.com).

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

@@ -67,7 +67,7 @@ _Protection_ (the shield icon in the bottom menu bar) → _DNS protection_ → _
 
 #### DNS filters {#dns-filters}
 
-Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [this exhaustive manual](adguard-for-ios/solving-problems/system-wide-filtering).
+Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [this exhaustive manual](/adguard-for-ios/solving-problems/system-wide-filtering).
 
 #### Allowlist and Blocklist {#allowlist-blocklist}
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-linux/feedback.md

@@ -30,7 +30,7 @@ If you want to support the implementation of a new feature or bugfix, you can vo
 
     The archived log file will be downloaded to the application folder by default, and the path to the logs will be written to the console.
 
-4. Send the log file to <devteam@adguard.com>. Specify the time of the error and attach a link to your GitHub issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and share it with <devteam@adguard.com>. Attach the file link to your GitHub issue.
+4. Send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Specify the time of the error and attach a link to your GitHub issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and share it with [devteam@adguard.com](mailto:devteam@adguard.com). Attach the file link to your GitHub issue.
 
 5. Switch the logging mode back to `info`: