Merge pull request #626 from Blueberryy/main

Russian translation (CONTRIBUTING + FAQ + SECURITY FAQ) and readme with website changes

5 files changed, 145 insertions, 33 deletions

diff --git a/CONTRIBUTINGru.md b/CONTRIBUTINGru.md
new file mode 100644
index 0000000..e217046
--- /dev/null
+++ b/CONTRIBUTINGru.md
@@ -0,0 +1,60 @@
+Прочитать на других языках: [English](CONTRIBUTING.md)

+

+# Добро пожаловать в руководство по внесению вклада Return YouTube Dislikes

+

+Благодарим вас за то, что вы потратили своё время на участие в нашем проекте! Все ваши изменения будут отражены в следующей версии расширения (или на [сайте](https://www.returnyoutubedislike.com/)).

+

+## Приступая к работе

+Пожалуйста, используйте Prettier с настройками по умолчанию для форматирования кода.

+

+#### Необходимое

+

+Вам необходимо иметь установленные node и npm, чтобы создать bundled-версию источника.

+

+Версии, используемые при настройке:

+

+- node: 12.18.4

+- npm: 6.14.6

+

+Для создания `bundled-content-script.js` который содержит большую часть бизнес-логики этого расширения, вы должны сначала установить все зависимости.

+

+1. Перейдите в корень репозитория и выполните следующее:

+

+```

+npm install

+```

+

+2. Выполните следующую команду, чтобы создать `bundled-content-script.js`, который используется в `manifest.json`

+

+```

+npm start // для создания файла(ов) сборки и запуска наблюдателя за файлами, который выполняет hot-reload при сохранении

+

+// или

+

+npm run build // для создания файла(ов) сборки один раз

+```

+

+Поздравляем, теперь вы готовы к разработке!

+

+Если вы новичок в разработке расширений Chrome или вам нужна дополнительная помощь, посмотрите [это руководство на YouTube (англ.)](https://www.youtube.com/watch?v=mdOj6HYE3_0)

+

+

+### Вопросы

+#### Открытие нового вопроса/проблемы

+Если у вас возникли проблемы с расширением, пожалуйста, поищите, чтобы убедиться, что о проблеме ещё не сообщалось. Если это не так, откройте вопрос(issue), использование формы проблемы настоятельно рекомендуется, но не является обязательным.

+

+#### Решение вопроса

+Если вы нашли проблему, которую, как вам кажется, вы можете решить, не стесняйтесь. Откройте запрос на извлечение(pull request) с исправлением и обязательно укажите вопрос, который вы устраняете.

+

+### Запрос функции

+#### Открытие запроса на новую функцию

+Если у вас есть идея для расширения, не стесняйтесь открыть запрос на функцию, но, пожалуйста, прежде поищите другие запросы, чтобы убедиться, что функция уже не предложена. Использование формы запроса функции настоятельно рекомендуется, но не является обязательным

+

+#### Внедрение запроса на функцию

+Если вы нашли функцию, которую, как вам кажется, вы могли бы реализовать, не стесняйтесь. Откройте запрос на извлечение(pull request) с исправлением и обязательно укажите функцию, которую вы реализуете.

+

+### Какие запросы на извлечение(pull request) мы принимаем?

+- Исправления проблем.

+- Внедрения новых функций.

+- Исправления опечаток и упрощение текста.

+- Улучшения сайта.
\ No newline at end of file
diff --git a/Docs/FAQru.txt b/Docs/FAQru.txt
new file mode 100644
index 0000000..5c770df
--- /dev/null
+++ b/Docs/FAQru.txt
@@ -0,0 +1,21 @@
+# Часто задаваемые вопросы

+## Прежде чем задать вопрос на GitHub или в Discord, пожалуйста, ознакомьтесь с этим.

+

+### **1. Откуда это расширение получает данные?**

+Комбинация API Google и старых данных.

+

+Мы сохраняем все имеющиеся данные в нашей базе данных, чтобы они были доступны после того, как Google прекратит подсчёт отметок «Не нравится» в своём API.

+

+### **2. Количество не понравившихся видео не обновляется**

+В настоящее время видео с отметками «Не нравится» кэшируются и обновляются не очень часто. Раз в 2-3 дня, не чаще.

+

+Да, это не идеально, но это то, что есть. Мы работаем над тем, чтобы улучшить частоту их обновления.

+

+### **3. Как это работает?**

+Расширение собирает идентификатор видео, которое вы смотрите, извлекает данные об отметках «Не нравится» (и другие поля, такие как просмотры, отметки «Нравится» и т.д.) с помощью нашего API, если видео было извлечено нашим API впервые, оно использует YouTube API для получения данных, затем сохраняет данные в базе данных для кэширования (кэшируются около 2-3 дней) и архивирования и возвращает их вам. После этого расширение отображает отметки «Не нравится» вам.

+

+### **4. Что произойдёт после того, как API YouTube перестанет возвращать данные о количестве отметок «Не нравится»?**

+Внутренняя часть нашего сервера переключится на использование комбинации архивных статистик отметок «Не нравится», оценок, экстраполированных из данных о пользователях расширения, и оценок, основанных на соотношении просмотров и отметок «Нравится» для видео, чьи отметки «Не нравится» не были заархивированы, и для устаревших архивов с отметками «Не нравится».

+

+## Я беспокоюсь о безопасности / конфиденциальности

+Более подробную информацию смотрите на [этой странице](SECURITY-FAQ.md).
\ No newline at end of file
diff --git a/Docs/SECURITY-FAQru.md b/Docs/SECURITY-FAQru.md
new file mode 100644
index 0000000..f69257e
--- /dev/null
+++ b/Docs/SECURITY-FAQru.md
@@ -0,0 +1,31 @@
+Прочитать на других языках: [English](SECURITY-FAQ.md)

+

+# Безопасность

+

+### Вы отслеживаете мою историю просмотров?

+

+Нет. Код расширения находится в открытом доступе, и вы можете ознакомиться с ним самостоятельно. Единственная передаваемая информация - это идентификатор видео, который необходим для получения данных о количестве просмотров видео. Никаких дополнительных заголовков не передаётся. На коммуникационном уровне серверу будет передан ваш публичный IP-адрес, а также время, когда был сделан запрос. Однако ничто из этого не идентифицирует вас каким-либо образом. Предполагая среду с нулевым доверием, лучшее, что мы можем получить, это динамический IP. Который сегодня ваш, а завтра - вашего соседа. Если вы действительно беспокоитесь о том, что ваш IP может быть отслежен, вы, вероятно, уже используете какой-нибудь VPN.

+

+### Можете ли вы однозначно идентифицировать меня, если я оставил отметку «Не нравится»?

+

+Да. Когда вы оставляете видео отметку «Не нравится», мы создаём для вас случайно созданный уникальный идентификатор, который не привязан к вашему аккаунту Google. Это делается для избежания ботов. Но нет никакого способа привязать этот случайный идентификатор к вам или вашему личному аккаунту YouTube.

+

+### Какой именно информацией вы располагаете?

+

+Только идентификатор видео. Ни ваших комментариев, ни вашего имени пользователя, ни того, с кем вы поделились видео, ни каких-либо дополнительных метаданных. Ничего. Только идентификатор видео. 

+

+### Как хранится мой IP-адрес?

+

+Внутренняя часть нашего сервера хранит нехешированные IP-адреса только в энергозависимой памяти (ОЗУ). Эти адреса не хранятся на жёстком диске и поэтому не регистрируются. Мы хэшируем IP-адреса, и оно хранится вместо них. Это сделано для предотвращения вандализма в базе данных.

+

+### Я слышал обсуждение OAuth и доступа к моему аккаунту на YouTube!

+

+Эта функция будет необязательной и очень нужной. Если вы являетесь создателем YouTube и хотите поделиться с нами статистикой отметок «Не нравится», вы можете это сделать. По своей структуре [OAuth](https://ru.wikipedia.org/wiki/OAuth#:~:text=%D0%B1%D0%B5%D0%B7%20%D0%BF%D0%B5%D1%80%D0%B5%D0%B4%D0%B0%D1%87%D0%B8%20%D0%B5%D0%B9%20(%D1%82%D1%80%D0%B5%D1%82%D1%8C%D0%B5%D0%B9%20%D1%81%D1%82%D0%BE%D1%80%D0%BE%D0%BD%D0%B5)%20%D0%BB%D0%BE%D0%B3%D0%B8%D0%BD%D0%B0%20%D0%B8%20%D0%BF%D0%B0%D1%80%D0%BE%D0%BB%D1%8F) очень безопасен. Вы можете отозвать доступ к своему аккаунту в любое время, и можете дать нам ограниченные разрешения. Мы не будем запрашивать никаких разрешений, которые не требуются. Мы будем запрашивать разрешения только для просмотра статистики ваших видео.  

+

+### Как я могу доверять этому счётчику отметок «Не нравится»?

+

+Мы приняли меры по предотвращению атак ботов и собираемся продолжать работать над повышением эффективности системы предотвращения ботов: это поможет нам сохранить подсчёт отметок «Не нравится» как хороший представитель фактического количества. Конечно, он никогда не будет точным на 100%, поэтому вы сами решаете, доверять ему или нет.

+

+### Почему бы вам не поделиться кодом внутренней части своего сервера? 

+

+Мы поделимся им в какой-то момент - но сейчас нет никаких реальных причин делиться ею. Это даёт ложное чувство безопасности - ведь в системе с нулевым доверием мы можем с таким же успехом раскрыть одну версию, но развернуть другую. Есть много причин держать код в тайне, в частности, как мы боремся со спамом. Скрытие и запутывание кода обработки спама - это довольно стандартная практика.

diff --git a/READMEru.md b/READMEru.md
index 2325060..93b4b58 100644
--- a/READMEru.md
+++ b/READMEru.md
@@ -22,13 +22,13 @@
 
 10 ноября 2021 года Google [объявили](https://blog.youtube/news-and-events/update-to-youtube/), что счётчик «Не нравится» на YouTube будет удален.  
   
-Кроме того, поле отметок `«Не нравится»` в API YouTube было [удалено]](https://support.google.com/youtube/thread/134791097/update-to-youtube-dislike-counts) 13 декабря 2021 года, удалив любую возможность судить о качестве контента перед просмотром.
+Кроме того, поле отметок `dislike` в API YouTube было [удалено]](https://support.google.com/youtube/thread/134791097/update-to-youtube-dislike-counts) 13 декабря 2021 года, удалив любую возможность судить о качестве контента перед просмотром.
 
 ## Как оно работает
 
 С удалением статистики отметок из API YouTube наш сервер переключился на использование комбинации собранной статистики отметок «Не нравится», оценок, экстраполированных из пользовательских данных расширения.
 
-[ЧаВО (англ.)](https://github.com/Anarios/return-youtube-dislike/blob/main/Docs/FAQ.md)
+[ЧаВО](https://github.com/Anarios/return-youtube-dislike/blob/main/Docs/FAQru.md)
 
 ## Почему это важно
 
@@ -38,8 +38,8 @@
 
 Стороннее использование этого открытого API разрешено со следующими ограничениями:
 
-- **Атрибуция**: Этот проект должен быть четко атрибутирован со ссылкой на [returnyoutubedislike.com](https://returnyoutubedislike.com/).
-- **Ограничение**: Существуют ограничения скорости для каждого клиента вместо 100 в минуту и 10 000 в день. Это выдаст код ошибки *429*, указывающий на то, что ваше приложение должно быть отключено.
+- **Атрибуция**: Этот проект должен быть чётко описан со ссылкой на [returnyoutubedislike.com](https://returnyoutubedislike.com/).
+- **Ограничение**: Существуют ограничения скорости для каждого клиента - 100 в минуту и 10 000 в день. Это выдаст код ошибки *429*, указывающий на то, что ваше приложение должно быть отключено.
 
 API доступен по следующему основному URL-адресу:  
 https://returnyoutubedislikeapi.com  
@@ -64,8 +64,8 @@ https://returnyoutubedislikeapi.com/swagger/index.html
 ```
 
 
-Ни один существующий идентификатор YouTube не выдаст код ошибки *404* "Не найдено".  
-Неправильно сформированный идентификатор YouTube выдаст *400* "Неверный запрос".
+Неверный идентификатор YouTube выдаст код ошибки *404* "Не найдено".  
+Неправильно отформатированный идентификатор YouTube выдаст код ошибки *400* "Неверный запрос".
 
 
 
@@ -78,7 +78,7 @@ https://returnyoutubedislikeapi.com/swagger/index.html
 
 ## Участие/помощь в разработке
 
-Пожалуйста, ознакомьтесь с [руководством по внесению вклада в проект (англ.)](https://github.com/Anarios/return-youtube-dislike/blob/main/CONTRIBUTING.md).
+Пожалуйста, ознакомьтесь с [руководством по внесению вклада в проект](https://github.com/Anarios/return-youtube-dislike/blob/main/CONTRIBUTINGru.md).
 
 ## Поддержите этот проект!
 
diff --git a/Website/_locales/ru.ts b/Website/_locales/ru.ts
index e4a0601..28b8fc0 100644
--- a/Website/_locales/ru.ts
+++ b/Website/_locales/ru.ts
@@ -4,8 +4,8 @@ export default {
     ...ru,
     home: {
         name: 'Главная',
-        title: 'Вернуть YouTube Дизлайки',
-        subtitle: 'Расширение для браузера и API, которые показывают вам дизлайки в Youtube',
+        title: 'Вернуть YouTube дизлайки',
+        subtitle: 'Расширение для браузера и API, которые показывают вам отметки «Не нравится» в Youtube',
         ukraine: 'Поддержите Украину',
         sponsors: 'Спонсоры',
     },
@@ -14,7 +14,7 @@ export default {
         title: 'Выберите свою платформу',
         subtitle: 'Доступно в Firefox и во всех Chromium браузерах',
         title2: 'Другие платформы',
-        subtitle2: 'Если ваш браузер еще не поддерживается, попробуйте этот пользовательский скрипт',
+        subtitle2: 'Если ваш браузер ещё не поддерживается, попробуйте этот пользовательский скрипт',
         title3: 'От других разработчиков',
         subtitle3: 'Никакой ответственности с нашей стороны, используйте на свой страх и риск',
     },
@@ -26,28 +26,28 @@ export default {
             title: 'Права пользования',
             subtitle: 'Использование этого открытого API третьими лицами разрешено со следующими ограничениями:',
             bullet1: 'Aтрибуция: ',
-            bullet1text: 'Этот проект должен быть четко описан либо ссылкой на этот репозиторий, либо ссылкой на returnyoutubedislike.com',
-            bullet2: 'Ограничение Скорости',
-            bullet2text: 'Существуют ограничения на скорость для каждого клиента - 100 в минуту и 10 000 в день. Это вернет код 429, указывающий на то, что ваше приложение превысило лимит',
+            bullet1text: 'Этот проект должен быть чётко описан либо ссылкой на этот репозиторий, либо ссылкой на returnyoutubedislike.com',
+            bullet2: 'Ограничение',
+            bullet2text: 'Существуют ограничения на скорость для каждого клиента - 100 в минуту и 10 000 в день. Это выдаст код ошибки 429, указывающее на то, что ваше приложение превысило лимит',
         },
         url: {
             title: 'Информация о URL-адресе',
-            subtitle: 'API доступен по следующему базовому URL-адресу: ',
+            subtitle: 'API доступен по следующему URL-адресу: ',
         },
         endpoints: {
-            title: 'Доступные Конечные точки',
+            title: 'Доступные конечные точки (эндпоинты)',
             subtitle: 'Список доступных конечных точек доступен здесь: ',
         },
         fetching: {
             title: 'Базовое руководство по выборке',
-            subtitle: 'Пример получения голосов на заданный видео ID на YouTube ',
+            subtitle: 'Пример получения голосов на заданный видео идентификатор на YouTube ',
             title2: 'Пример запроса: ',
             url: 'URL-адрес запроса: ',
             method: 'Способ запроса: ',
-            headers: 'Шапка: ',
+            headers: 'Заголовок: ',
             response: 'Ответ: ',
-            error1: 'Неверный YouTube ID вернет код состояния 404 "Не найден"',
-            error2: 'Неправильно отформатированный YouTube ID вернет 400 "Неверный запрос"'
+            error1: 'Неверный идентификатор YouTube выдаст код ошибки 404 "Не найдено"',
+            error2: 'Неправильно отформатированный идентификатор YouTube выдаст код ошибки 400 "Неверный запрос"'
         },
     },
     help: {
@@ -69,23 +69,23 @@ export default {
         chrome: 'для Chrome, Edge, Brave, Opera, Vivaldi',
     },
     faq: {
-        name: 'FAQ',
-        title: 'Частые Вопросы',
-        subtitle: 'Все еще есть вопросы? Не стесняйтесь заглянуть в наш Дискорд!',
+        name: 'ЧаВО',
+        title: 'Частые вопросы',
+        subtitle: 'Всё ещё есть вопросы? Не стесняйтесь заглянуть в наш Discord!',
         bullet1: 'Откуда расширение получает данные?',
-        bullet1text: 'Комбинация архивных данных, полученных до закрытия официального YouTube дизлайк API, и экстраполяция поведения пользователей расширения.',
-        bullet2: 'Почему количество дизлайков не обновляется?',
-        bullet2text: 'На данный момент видео дизлайки кэшируются, и обновляются не очень часто. Это зависит от популярности видео, но обновление может занять от нескольких часов до нескольких дней.',
+        bullet1text: 'Комбинация архивных данных, полученных до закрытия официального API YouTube с отметками «Не нравится», и экстраполяция поведения пользователей расширения.',
+        bullet2: 'Почему количество отметок «Не нравится» не обновляется?',
+        bullet2text: 'На данный момент видео отметки «Не нравится» кэшируются, и обновляются не очень часто. Это зависит от популярности видео, но обновление может занять от нескольких часов до нескольких дней.',
         bullet3: 'Как это работает?',
-        bullet3text: 'Расширение берет ID видео которое вы смотрите, извлекает количество дизлайков (и другие поля, такие как просмотры, лайки и т.д.) используя наш API. Затем расширение отображает количество дизлайков на странице. Если если вы лайкаете или дизлайкаете видео, это записывается и отправляется в базу данных, чтобы можно было экстраполировать точное количество дизлайков.',
-        bullet4: 'Могу я поделиться с вами своим количеством дизлайков?',
-        bullet4text: 'Скоро. Мы рассматриваем возможность использования Oauth или другого API, доступного только для чтения, с ограниченной областью действия, чтобы создатели могли делиться своим количеством дизлайков.',
+        bullet3text: 'Расширение берёт идентификатор видео которое вы смотрите, извлекает количество отметок «Не нравится» (и другие поля, такие как просмотры, отметки «Нравится» и т.д.) используя наш API. Затем расширение отображает количество отметок «Не нравится» на странице. Если если вы оставляете отметки «Нравится» или «Не нравится», это записывается и отправляется в базу данных, чтобы можно было экстраполировать точное количество отметок.',
+        bullet4: 'Могу я поделиться с вами своим количеством отметок «Не нравится»?',
+        bullet4text: 'Скоро. Мы рассматриваем возможность использования Oauth или другого API, доступного только для чтения, с ограниченной областью действия, чтобы создатели могли делиться своим количеством отметок «Не нравится».',
         bullet5: 'Какие данные вы собираете и как они обрабатываются?',
-        bullet5text: 'Расширение собирает только те данные, которые строго необходимы для его правильной работы, такие как IP-адрес или ID видео которое вы смотрите. Ваши данные никогда не будут проданы третьим лицам. Если вы хотите узнать больше о том, как мы обеспечиваем безопасность и конфиденциальность, ознакомьтесь с нашим <a href="https://github.com/Anarios/return-youtube-dislike/blob/main/Docs/SECURITY-FAQ.md">FAQ по безопасности</a>.',
+        bullet5text: 'Расширение собирает только те данные, которые строго необходимы для его правильной работы, такие как IP-адрес или идентификатор видео которое вы смотрите. Ваши данные никогда не будут проданы третьим лицам. Если вы хотите узнать больше о том, как мы обеспечиваем безопасность и конфиденциальность, ознакомьтесь с нашим <a href="https://github.com/Anarios/return-youtube-dislike/blob/main/Docs/SECURITY-FAQru.md">ЧаВО по безопасности</a>.',
         bullet6: 'Как работает API/серверная часть?',
-        bullet6text: 'Серверная часть использует архивные данные с тех пор, когда YouTube API все еще возвращал количество дизлайков, количество лайков/дизлайков пользователей расширения и экстраполяцию. В ближайшем будущем мы позволим создателям контента легко и безопасно отправлять количество своих дизлайков, и мы добавим архивные данные ArchiveTeam (4,56 миллиарда видео) в нашу текущую базу данных. Вы также можете просмотреть видео на эту тему.',
-        bullet7: 'Почему дизлайки показывают \'DISLIKES DISABLED\'?',
-        bullet7text: 'Иногда недавно загруженное видео может показывать "DISLIKES DISABLED", это связано с тем как мы определяем отключены ли дизлайки, должно исчезнуть через несколько часов или после лайка или дизлайка видео и обновления страницы (надеюсь).',
+        bullet6text: 'Серверная часть использует архивные данные с тех пор, когда YouTube API всё ещё выдавал количество отметок «Не нравится», количество отметок «Нравится» и «Не нравится» пользователей расширения и экстраполяцию. В ближайшем будущем мы позволим создателям контента легко и безопасно отправлять количество своих отметок «Не нравится», и мы добавим архивные данные ArchiveTeam (4,56 миллиарда видео) в нашу текущую базу данных. Вы также можете просмотреть видео на эту тему.',
+        bullet7: 'Почему счётчик отметок «Не нравится» показывает \'DISLIKES DISABLED\'?',
+        bullet7text: 'Иногда недавно загруженное видео может показывать "DISLIKES DISABLED", это связано с тем как мы определяем отключены ли отметки «Не нравится», и должно исчезнуть через несколько часов или после получения отметки «Нравится» или «Не нравится» и обновления страницы (надеюсь).',
     },
     donate: {
         name: 'Пожертвовать',
@@ -97,7 +97,7 @@ export default {
         subtitle: 'Ссылки на проект и его разработчиков',
         contact: 'Связаться',
         translators: 'Переводчики',
-        sponsorBlockDescription: 'Проматывает рекламу встроенную в видео',
+        sponsorBlockDescription: 'Проматывает рекламу, встроенную в видео',
         filmotDescription: 'Поиск по субтитрам YouTube'
     },
 }