Update after loosing z-tenya commit

book.toml

@@ -20,3 +20,8 @@ additional-css = ["css/kbd.css"]
 optional = true
 warning-policy = "warn"
 follow-web-links = true
+exclude = [ 'microsoft.com' ]
+
+[output.html.fold]
+enable = true
+level = 0

src/SUMMARY.md

@@ -2,23 +2,44 @@
 
 [Введение](intro.md)
 
-- [Общие сведения](background.md)
-- [Начало работы](getting-started.md)
-- [Изучение](studying.md)
-- [Добавление/изменение](editing.md)
-- [Шаблоны карточек](templates/intro.md)
+- [Background](background.md)
+- [Platform Notes](platform/intro.md)
+  - [Windows](platform/windows/installing.md)
+    - [Install & Upgrade](platform/windows/installing.md)
+    - [Installation Issues](platform/windows/installation-issues.md)
+    - [Startup Issues](platform/windows/startup-issues.md)
+    - [Display Issues](platform/windows/display-issues.md)
+    - [Copy and Paste Issues](platform/windows/copy-and-paste.md)
+    - [Text Size](platform/windows/text-size.md)
+    - [Permission Problems](platform/windows/permission-problems.md)
+  - [macOS](platform/mac/installing.md)
+    - [Install & Upgrade](platform/mac/installing.md)
+    - [Display Issues](platform/mac/display-issues.md)
+  - [Linux](platform/linux/installing.md)
+    - [Install & Upgrade](platform/linux/installing.md)
+    - [Missing Libraries](platform/linux/missing-libraries.md)
+    - [Display Issues](platform/linux/display-issues.md)
+    - [Fedora/OpenSUSE Blank](platform/linux/blank-window.md)
+    - [Linux Distro Packages](platform/linux/distro-packages.md)
+    - [Incorrect GTK Theme](platform/linux/gtk-theme.md)
+    - [Wayland](platform/linux/wayland.md)
+    - [Input Methods](platform/linux/input-methods.md)
+- [Getting Started](getting-started.md)
+- [Studying](studying.md)
+- [Adding/Editing](editing.md)
+- [Card Templates](templates/intro.md)
   - [Field Replacements](templates/fields.md)
   - [Card Generation](templates/generation.md)
   - [Styling & HTML](templates/styling.md)
-- [Настройки](preferences.md)
-- [Настройки колоды](deck-options.md)
+- [Preferences](preferences.md)
+- [Deck Options](deck-options.md)
 - [Syncing with AnkiWeb](syncing.md)
 - [Profiles](profiles.md)
-- [Обзор](browsing.md)
-- [Фильтрованные колоды](filtered-decks.md)
+- [Browsing](browsing.md)
+- [Filtered Decks](filtered-decks.md)
 - [Searching](searching.md)
 - [Importing](importing.md)
-- [Экспортирование](exporting.md)
+- [Exporting](exporting.md)
 - [Managing Files](files.md)
 - [Statistics](stats.md)
 - [Media](media.md)

src/addons.md

@@ -1,19 +1,24 @@
-# Add-ons
+# Дополнения (Add-ons)
 
-Anki's capabilities can be extended with add-ons. Add-ons can provide
-features like extra support for specific languages, extra control over
-scheduling, and so on.
+Возможности Anki могут быть расширены использованием дополнений.
+Дополнения могут предоставлять дополнительные возможности, такие как:
+поддержка определённых языков, расширенный контроль над расписанием и т.д.
 
-To browse the list of available add-ons, select the Tools>Add-ons
-menu item, then click on Get Add-ons.
+Чтобы посмотреть список доступных дополнений, выберите в меню Инструменты –> Дополнения,
+затем нажмите на «Загрузить дополнения…» и «Посмотреть дополнения».
 
-Many add-on authors include their email address in the add-on, so if you
-need to get in touch with the author, editing the add-on and looking at
-the top of the file may help.
+Если вы скачали дополнение, которое работает некорректно, или вы сделали ошибку 
+при редактировании дополнения, вы можете использовать опцию «Удалить» чтобы удалить его.
 
-If you have downloaded an add-on that is not working properly, or if you
-accidentally made a mistake when editing an add-on, you can use the
-"Delete" option in the menu to remove it.
+Дополнения используют и изменяют произвольные части кодовой базы Anki, 
+поэтому иногда обновление Anki может нарушить совместимость со старыми дополнениями.
+Если одно из ваших дополнений перестаёт работать после обновления Anki, пожалуйста,
+сообщите об этой проблеме автору дополнения. Если вам необходимо это дополнение, 
+вам нужно продолжить использование старой версии Anki до тех пор, пока дополнение не получит обновление. 
 
-To learn how to write your own add-ons, please see the [add-on writing
-guide](https://addon-docs.ankiweb.net).
+На большинстве страниц дополнений в Ankiweb есть кнопка «Contact Author», 
+и многие авторы включают адрес своей почты внутрь дополнения, если вам необходимо связаться с автором, 
+попробуйте открыть файл дополнения на редактирование и посмотреть в начале файла.
+
+Чтобы узнать, как написать своё собственное дополнение, пожалуйста, посмотрите 
+[руководство по созданию дополнений (англ.)](https://addon-docs.ankiweb.net/)

src/background.md

@@ -4,12 +4,12 @@
 
 Anki — это программа, облегчающая процесс запоминания. Поскольку используемая
 техника намного эффективнее традиционных методов обучения, вы можете
-значительно сократить время потраченное на заучивание материала или значительно
+значительно сократить время, потраченное на заучивание материала или значительно
 увеличить объем выученного.
 
-Любому, кому необходимо что-либо запоминать своей повседневной жизни,
+Любому, кому необходимо что-либо запоминать в своей повседневной жизни,
 Anki будет полезна. Так как программа не зависит от типа содержимого и
-поддерживает изображения, аудио, видео и научную разметку (по средствам LaTeX),
+поддерживает изображения, аудио, видео и научную разметку (посредством LaTeX),
 её возможности бесконечны. Например:
 
 - изучение языка
@@ -76,7 +76,7 @@ _пассивному обучению_, когда мы читаем, смот
 Решение, однако, очень простое: _повтор пройденного материала_. Пересматривая
 свеже изученный материал, мы можем значительно снизить количество забытого.
 
-Единственная проблема в том, что обычный просмотр был не достаточно удобным. Если
+Единственная проблема в том, что обычный просмотр был недостаточно удобным. Если
 вы используете бумажные флэш-карточки, то их легко просматривать когда их только 30,
 но когда число возрастёт до 300 или 3000, это станет практически невыполнимым.
 
@@ -94,9 +94,9 @@ _интервальным повторением_.
 Разделяя бумажные карточки на несколько коробок в зависимости от того, удалось
 или нет вспомнить ответ, можно было сразу получить приблизительное
 представление о том, насколько хорошо была выучена карточка и когда следует
-снова пересмотреть её. Это было намного лучше чем складывание всех карточек в
+снова пересмотреть её. Это было намного лучше, чем складывание всех карточек в
 одной коробке и в последствии такой подход стал широко использоваться в
-компьютерных программах имитирующих работу с бумажными флеш-карточками. Однако
+компьютерных программах, имитирующих работу с бумажными флеш-карточками. Однако
 это довольно грубый подход, поскольку он не может дать точной даты, когда вы
 должны пересмотреть что-то в следующий раз и не очень хорошо справляется с
 материалами различной сложности.
@@ -130,12 +130,12 @@ SuperMemo впервые разработала концепцию систем
 исходным данным. И хотя очень старые версии доступны бесплатно, они весьма
 ограничены для современного использования.
 
-Anki решает эти вопросы. Бесплатные клиенты для Anki доступны на большинстве
-платформ, что не оставит в стороне студентов и учителей с ограниченным
-бюджетом. Это открытый исходный код с уже процветающей библиотекой дополнений,
-предоставленных конечными пользователями. Это мультиплатформенность — работает
-на Windows, Mac OSX, Linux/FreeBSD и некоторых мобильных устройствах.
-И значительно проще в использовании, чем SuperMemo.
+Anki addresses these issues. There are free clients for Anki available
+on many platforms, so struggling students and teachers with budgetary
+constraints are not left out. Anki is open source, with an already
+flourishing library of add-ons contributed by end-users. It is
+multi-platform, running on Windows, macOS, Linux/FreeBSD, and some
+mobile devices. And it is considerably easier to use than SuperMemo.
 
 Система интервальных повторений Anki основана на более старой версии алгоритма
 SuperMemo, который называется [SM-2](faqs.md).