filips123 · Hikari-Fox · Jan 14, 2025 · Jan 14, 2025 · Jan 14, 2025 · Jan 15, 2025
diff --git a/docs/docs/about/contributing.md → docs/docs/en/about/contributing.md b/docs/docs/about/contributing.md → docs/docs/en/about/contributing.md
diff --git a/docs/docs/about/current-limitations.md → docs/docs/en/about/current-limitations.md b/docs/docs/about/current-limitations.md → docs/docs/en/about/current-limitations.md
diff --git a/docs/docs/about/how-it-works.md → docs/docs/en/about/how-it-works.md b/docs/docs/about/how-it-works.md → docs/docs/en/about/how-it-works.md
diff --git a/docs/docs/about/privacy-policy.md → docs/docs/en/about/privacy-policy.md b/docs/docs/about/privacy-policy.md → docs/docs/en/about/privacy-policy.md
diff --git a/docs/docs/about/supported-features.md → docs/docs/en/about/supported-features.md b/docs/docs/about/supported-features.md → docs/docs/en/about/supported-features.md
diff --git a/docs/docs/help/faq.md → docs/docs/en/help/faq.md b/docs/docs/help/faq.md → docs/docs/en/help/faq.md
diff --git a/docs/docs/help/support.md → docs/docs/en/help/support.md b/docs/docs/help/support.md → docs/docs/en/help/support.md
diff --git a/docs/docs/help/troubleshooting.md → docs/docs/en/help/troubleshooting.md b/docs/docs/help/troubleshooting.md → docs/docs/en/help/troubleshooting.md
diff --git a/docs/docs/index.md → docs/docs/en/index.md b/docs/docs/index.md → docs/docs/en/index.md
@@ -1,11 +1,13 @@
 ---
 hide:
   - path
+title: Home
 ---
 
 <style>
-.md-sidebar--primary {
-  visibility: hidden;
+.md-sidebar--primary,
+a.md-nav__link:nth-child(3) > span:nth-child(1) {
+  visibility:hidden;
 }
 </style>
 

diff --git a/docs/docs/installation/extension.md → docs/docs/en/installation/extension.md b/docs/docs/installation/extension.md → docs/docs/en/installation/extension.md
diff --git a/docs/docs/installation/native.md → docs/docs/en/installation/native.md b/docs/docs/installation/native.md → docs/docs/en/installation/native.md
diff --git a/docs/docs/installation/requirements.md → docs/docs/en/installation/requirements.md b/docs/docs/installation/requirements.md → docs/docs/en/installation/requirements.md
diff --git a/docs/docs/installation/updates.md → docs/docs/en/installation/updates.md b/docs/docs/installation/updates.md → docs/docs/en/installation/updates.md
diff --git a/...ocs/resources/installation-directories.md → .../en/resources/installation-directories.md b/...ocs/resources/installation-directories.md → .../en/resources/installation-directories.md
diff --git a/docs/docs/resources/profile-properties.md → docs/docs/en/resources/profile-properties.md b/docs/docs/resources/profile-properties.md → docs/docs/en/resources/profile-properties.md
diff --git a/docs/docs/resources/specific-website-tips.md → ...ocs/en/resources/specific-website-tips.md b/docs/docs/resources/specific-website-tips.md → ...ocs/en/resources/specific-website-tips.md
diff --git a/docs/docs/resources/web-app-properties.md → docs/docs/en/resources/web-app-properties.md b/docs/docs/resources/web-app-properties.md → docs/docs/en/resources/web-app-properties.md
diff --git a/docs/docs/user-guide/browser.md → docs/docs/en/user-guide/browser.md b/docs/docs/user-guide/browser.md → docs/docs/en/user-guide/browser.md
diff --git a/docs/docs/user-guide/console.md → docs/docs/en/user-guide/console.md b/docs/docs/user-guide/console.md → docs/docs/en/user-guide/console.md
diff --git a/docs/docs/user-guide/extension.md → docs/docs/en/user-guide/extension.md b/docs/docs/user-guide/extension.md → docs/docs/en/user-guide/extension.md
diff --git a/docs/docs/ru/about/contributing.md b/docs/docs/ru/about/contributing.md
@@ -0,0 +1,38 @@
+# Участие в проекте
+
+<style>
+.brands > ul { list-style: none !important; }
+.brands > ul > li { margin-left: .1rem !important; }
+.brand { padding-right: .4rem; }
+.brand-patreon { color: #FF424D; }
+.brand-liberapay { color: #F6C915; }
+.brand-kofi { color: #FF5E5B; }
+.brand-buymeacoffee { color: #FFDD00; }
+.brand-donorbox { color: #056BBF; }
+</style>
+
+## Как внести вклад {: id="как_внести_вклад"}
+
+Вы можете прочитать [наше руководство по контрибуции][link-contributing] на GitHub. При работе с
+вопросами безопасности, пожалуйста, также ознакомьтесь с [нашей политикой безопасности][link-security].
+
+[link-contributing]: https://github.com/filips123/PWAsForFirefox/blob/main/.github/CONTRIBUTING.md
+[link-security]: https://github.com/filips123/PWAsForFirefox/blob/main/.github/SECURITY.md
+
+## Донаты {: id="донаты"}
+
+Спасибо за ваш интерес помощи проекту! Донаты могут помочь покрыть расходы, связанные с проектом и сопутствующими услугами.
+С вашей поддержкой я смогу больше времени уделять проекту, чтобы развивать новые функции и быстрее исправлять баги.
+
+Доступные сервисы для донатов:
+
+<div class="brands" markdown>
+
+* :simple-github:{ .brand .brand-github .invisible } [GitHub Sponsors](https://github.com/sponsors/filips123)
+* :simple-patreon:{ .brand .brand-patreon .invisible } [Patreon](https://patreon.com/filips)
+* :simple-liberapay:{ .brand .brand-liberapay .invisible } [Liberapay](https://liberapay.com/filips)
+* :simple-kofi:{ .brand .brand-kofi .invisible } [Ko-Fi](https://ko-fi.com/filips)
+* :simple-buymeacoffee:{ .brand .brand-buymeacoffee .invisible } [Buy Me a Coffee](https://www.buymeacoffee.com/filips)
+* :material-heart-box:{ .brand .brand-donorbox .invisible } [Donorbox](https://donorbox.org/filips)
+
+</div>
diff --git a/docs/docs/ru/about/current-limitations.md b/docs/docs/ru/about/current-limitations.md
@@ -0,0 +1,42 @@
+# Текущие ограничения
+
+<style>
+.md-typeset h2 {
+  font-size: .845rem;
+  font-weight: 700;
+}
+</style>
+
+Это вещи, которые я хотел бы исправить в конечном итоге, но которые в настоящее время остаются, либо потому, что их слишком трудно исправить, я не знаю, как их исправить, либо это потребует изменения исходного кода Firefox. Вы можете проверить полный список проблем на странице [GitHub Projects][link-projects]. Я буду признателен за любую помощь в их исправлении.
+
+## Все веб-приложения объединяются с первым, которое было открыто (macOS) {: id="все_веб-приложения_объединяются_с_первым_которое_было_открыто_macos"}
+
+Когда какое-либо веб-приложение уже запущено, все вновь запущенные веб-приложения будут объединены с ним и останутся объединенными, пока все они не будут закрыты. Это приведёт к тому, что меню приложений будет отображать все веб-приложения как часть первого веб-приложения, которое было запущено, с его иконкой и действиями на рабочем столе.
+
+Это происходит потому, что Apple позволяет процессу быть связанным только с одним приложением в любое время. Возможно, это можно решить, используя IPC-соединение между хост-процессом и основным процессом выполнения Firefox, так же, как родительский процесс Firefox обрабатывает свои процессы контента. Это всего лишь дикая теория, и её нужно будет исследовать дальше.
+
+Эту проблему можно предотвратить, установив каждое веб-приложение в отдельный профиль, что является поведением по умолчанию на macOS.
+
+Проверьте [этот комментарий][link-merged-comment] и связанные обсуждения для идей и возможных решений для исправления этого. Эта проблема отслеживается как проблема [#81][link-merged-issue].
+
+## Расширение не может обнаружить нативную программу при использовании песочницы Firefox (Linux Flatpak) {: id="расширение_не_может_обнаружить_нативную_программу_при_использовании_песочницы_firefox_linux_flatpak"}
+
+При использовании Firefox, распространяемого в виде пакета Flatpak, расширение не может обнаружить используемую нативную программу. Это происходит потому, что пакеты Flatpak изолированы и не могут получать доступ/запускать другие программы, что необходимо для API нативного обмена сообщениями. Это не может быть исправлено, пока API нативного обмена сообщениями не получит поддержку для работы в песочницах браузеров.
+
+Обходным решением является удаление Firefox на базе Flatpak и установка обычного пакета DEB. См. [#76][link-flatpak-issue] для получения дополнительных сведений.
+
+Ранее эта проблема также присутствовала в Snap, но была недавно исправлена. Если вы всё ещё не можете обнаружить нативную программу, вы можете ознакомиться с [посвящённой записью в ЧАВО](../help/faq.md#почему_расширение_не_может_обнаружить_нативную_программу_на_linux) о распространённых проблемах в Linux.
+
+## Веб-приложения не запоминают предыдущие позиции окон и не восстанавливают сессии {: id="веб-приложения_не_запоминают_предыдущие_позиции_окон_и_не_восстанавливают_сессии"}
+
+Когда несколько веб-приложений установлены в одном профиле, отдельные веб-приложения не запоминают свои предыдущие позиции и размеры окон. Это затрудняет автоматическое открытие веб-приложения с определённой позицией и размером окна.
+
+Это происходит потому, что Firefox отслеживает позиции окон глобально (по профилю), и трудно изменить это, используя только скрипты UserChrome. См. [#256][link-session-issue] для получения дополнительных сведений.
+
+Обходным решением является установка каждого веб-приложения в отдельный профиль.
+
+[link-projects]: https://github.com/users/filips123/projects/1/views/1?filterQuery=status%3A%22On+Hold%22
+[link-merged-comment]: https://github.com/filips123/PWAsForFirefox/issues/33#issuecomment-888511078
+[link-merged-issue]: https://github.com/filips123/PWAsForFirefox/issues/81
+[link-flatpak-issue]: https://github.com/filips123/PWAsForFirefox/issues/76
+[link-session-issue]: https://github.com/filips123/PWAsForFirefox/issues/256
diff --git a/docs/docs/ru/about/how-it-works.md b/docs/docs/ru/about/how-it-works.md
@@ -0,0 +1,26 @@
+# Как это работает
+
+Проект состоит из трёх частей: расширения браузера, нативной программы и модификаций UserChrome браузера. Эти части бесшовно интегрированы друг с другом, чтобы весь проект работал. Расширение предоставляет инструкции в браузере для установки нативной программы, которая также устанавливает модификации UserChrome.
+
+Эта страница может быть полезна тем, кто хочет лучше понять, как работает проект и как он реализован.
+
+## Расширение {: id="расширение"}
+
+Расширение браузера является основным интерфейсом, с которым пользователи будут сталкиваться при использовании проекта. Оно предоставляет удобный способ установки, редактирования и удаления сайтов и профилей непосредственно из основного браузера. Однако, поскольку [расширения браузера][link-webextensions] ограничены и не могут напрямую получать доступ к операционной системе, что необходимо для установки веб-приложений, проект использует [API нативного обмена сообщениями][link-native-messaging] для связи с нативной программой.
+
+[link-webextensions]: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions
+[link-native-messaging]: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_messaging
+
+## Нативная программа {: id="нативная_программа"}
+
+Нативная программа написана на [Rust][link-rust] и обрабатывает функции, которые расширение само не может выполнить. Она общается с расширением, используя протокол нативного обмена сообщениями. Функции нативной программы включают установку среды выполнения Firefox, патчинг её с модификациями UserChrome, установку сайтов, применение системной интеграции и их запуск.
+
+Нативная программа также предоставляет командную строку для пользователей, которые предпочитают CLI графическому интерфейсу.
+
+[link-rust]: https://www.rust-lang.org/
+
+## Модификации UserChrome {: id="модификации_userchrome"}
+
+Оставшаяся часть проекта заключается в модификации интерфейса Firefox, чтобы создать более «приложенческий» вид. Это делается с помощью модификаций [UserChromeJS (Автоконфигурация скриптов запуска)][link-userchromejs], которые могут выполнять *низкоуровневый* JavaScript-код, который может изменять интерфейс Firefox. Эти модификации скрывают адресную строку и вкладки, перемещают некоторые кнопки браузера, предоставляют дополнительные полезные виджеты и настройки и обрабатывают область PWA и системную интеграцию.
+
+[link-userchromejs]: https://www.userchrome.org/what-is-userchrome-js.html
diff --git a/docs/docs/ru/about/privacy-policy.md b/docs/docs/ru/about/privacy-policy.md
@@ -0,0 +1,22 @@
+# Политика конфиденциальности
+
+## Политика конфиденциальности расширения {: id="политика_конфиденциальности_расширения"}
+
+Расширение обменивается личными данными (URL текущего веб-сайта и манифеста, а также другими деталями PWA) с нативной программой, когда пользователь инициирует установку веб-приложения. Это необходимо для правильного получения и разбора манифеста веб-приложения и установки веб-приложения. Данные хранятся на компьютере до тех пор, пока это веб-приложение установлено. Никакие личные данные не покидают компьютер и не отправляются третьим лицам.
+
+## Политика конфиденциальности среды выполнения {: id="политика_конфиденциальности_среды_выполнения"}
+
+Поскольку установленные веб-приложения работают внутри браузера Mozilla Firefox, вы должны согласиться с [Уведомлением о конфиденциальности Firefox](https://www.mozilla.org/privacy/firefox/).
+
+## Политика конфиденциальности веб-сайта {: id="политика_конфиденциальности_веб-сайта"}
+
+Этот веб-сайт использует или получает доступ к следующим сторонним сервисам:
+
+* [Cloudflare Pages](https://www.cloudflare.com/privacypolicy/)
+* [Cloudflare Analytics](https://www.cloudflare.com/privacypolicy/)
+* [Google Fonts](https://developers.google.com/fonts/faq/privacy)
+* [Contrib.rocks](https://contrib.rocks/)
+* [Shields.io](https://shields.io/)
+* [GitHub](https://docs.github.com/en/site-policy/privacy-policies)
+
+При открытии страницы или взаимодействии с кнопками обратной связи будет сделан запрос к нашему самохостингу. Этот запрос включает только URL страницы и действие (просмотр или статус обратной связи) без каких-либо личных данных. Предоставленные данные хранятся агрегированными по странице и дню, также без каких-либо личных данных, и используются для улучшения документации.