From 5400f1f9a93d441e476ef1320155e3ca415871b5 Mon Sep 17 00:00:00 2001 From: alexeygorelov Date: Wed, 2 Feb 2022 12:02:50 +0300 Subject: [PATCH] Update after loosing z-tenya commit --- book.toml | 5 + src/SUMMARY.md | 41 +++- src/addons.md | 33 +-- src/background.md | 24 +-- src/browsing.md | 66 +++--- src/contrib.md | 9 +- src/deck-options.md | 73 ++++--- src/editing.md | 138 +++++++++---- src/files.md | 4 +- src/filtered-decks.md | 10 +- src/getting-started.md | 53 +++-- src/math.md | 6 +- src/media.md | 14 +- src/media/find_and_replace.png | Bin 0 -> 6886 bytes src/misc.md | 6 +- src/platform/intro.md | 4 + src/platform/linux/blank-window.md | 8 + src/platform/linux/display-issues.md | 15 ++ src/platform/linux/distro-packages.md | 22 ++ src/platform/linux/gtk-theme.md | 11 + src/platform/linux/input-methods.md | 11 + src/platform/linux/installing.md | 64 ++++++ src/platform/linux/missing-libraries.md | 14 ++ src/platform/linux/wayland.md | 9 + src/platform/mac/display-issues.md | 10 + src/platform/mac/installing.md | 39 ++++ src/platform/windows/copy-and-paste.md | 6 + src/platform/windows/display-issues.md | 20 ++ src/platform/windows/installation-issues.md | 22 ++ src/platform/windows/installing.md | 50 +++++ src/platform/windows/permission-problems.md | 36 ++++ src/platform/windows/startup-issues.md | 93 +++++++++ src/platform/windows/text-size.md | 21 ++ src/preferences.md | 10 + src/profiles.md | 10 + src/resources.md | 3 + src/searching.md | 15 +- src/stats.md | 50 ++--- src/studying.md | 216 +++++++++++--------- src/syncing.md | 2 +- src/templates/fields.md | 2 +- src/templates/styling.md | 22 +- 42 files changed, 963 insertions(+), 304 deletions(-) create mode 100644 src/media/find_and_replace.png create mode 100644 src/platform/intro.md create mode 100644 src/platform/linux/blank-window.md create mode 100644 src/platform/linux/display-issues.md create mode 100644 src/platform/linux/distro-packages.md create mode 100644 src/platform/linux/gtk-theme.md create mode 100644 src/platform/linux/input-methods.md create mode 100644 src/platform/linux/installing.md create mode 100644 src/platform/linux/missing-libraries.md create mode 100644 src/platform/linux/wayland.md create mode 100644 src/platform/mac/display-issues.md create mode 100644 src/platform/mac/installing.md create mode 100644 src/platform/windows/copy-and-paste.md create mode 100644 src/platform/windows/display-issues.md create mode 100644 src/platform/windows/installation-issues.md create mode 100644 src/platform/windows/installing.md create mode 100644 src/platform/windows/permission-problems.md create mode 100644 src/platform/windows/startup-issues.md create mode 100644 src/platform/windows/text-size.md diff --git a/book.toml b/book.toml index 5ed0a33..f380b57 100644 --- a/book.toml +++ b/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 diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 4b5fe87..9429107 100644 --- a/src/SUMMARY.md +++ b/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) diff --git a/src/addons.md b/src/addons.md index a2000f7..142f063 100644 --- a/src/addons.md +++ b/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/) diff --git a/src/background.md b/src/background.md index 4e3fec6..68d0d42 100644 --- a/src/background.md +++ b/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). diff --git a/src/browsing.md b/src/browsing.md index f4286d8..33b3596 100644 --- a/src/browsing.md +++ b/src/browsing.md @@ -17,8 +17,8 @@ of the search area, or pressing Alt+T. The switch also indicates if **C**ards or **N**otes are currently shown. **Note**: For the sake of simplicity, this manual generally assumes the Cards -mode to be the active one. Whenever "cards" is mentioned while selecting, finding, etc., -the reader may substitute it for “notes", depending on the active mode. +mode to be the active one. Whenever selecting/finding/etc. "cards" is mentioned, +the reader may substitute it for "cards or notes depending on the active mode". ## Sidebar @@ -46,7 +46,7 @@ cards from either of the decks in the same view. You can hold down Alt (Option on Mac) in order to reverse the search (prepend a `-`): for example, to show all cards in a current deck that do _not_ have a certain tag. Alt/Option can be combined with -either Ctrl or Shift (e.g. clicking Ctrl+Alt +either Ctrl or Shift (e.g. clicking with Ctrl+Alt will result in adding a new search term that is negated). On Anki 2.1.39+, you can also hold down both Ctrl and @@ -54,15 +54,15 @@ On Anki 2.1.39+, you can also hold down both Ctrl and same kind of search with the new one. Let's say you had previously typed in a complicated search expression like `deck:Swahili (is:due or tag:important)` -and now want to perform the same search for your Urdu deck. You can hold +and now want to perform the same search for your Urdu deck. You can hold down Ctrl+Shift while clicking the Urdu deck in the sidebar to obtain the following search expression: `deck:Urdu (is:due or tag:important)`. ### Selection Tool -The Selection tool allows for selecting multiple items at the same time by holding down Ctrl- -and Shift together, while clicking. It also enables drag-and-drop to reorder decks and +The Selection tool allows for selecting multiple items at the same time by holding down Ctrl +or Shift while clicking. It also enables drag-and-drop to reorder decks and tags. Here is an example: Say you have the tags `Math`, `Calculus`, and `Algebra`. @@ -72,7 +72,7 @@ both children of this tag. Behind the scene, Anki has renamed the two tags to `Math::Calculus` and `Math::Algebra` respectively and updated your notes accordingly. Another use case for selecting multiple items is searching: If you right-click on -a selection of items, you can choose **Search > All/Any Selected Items**. This +a selection of items, you can choose **Search > All/Any Selected**. This can be combined with keyboard modifiers as described in [Search Tool](#search-tool) to append the resulting search to the current search. @@ -81,6 +81,8 @@ to append the resulting search to the current search. If you regularly search for the same thing, you can save the current search by right-clicking the topmost item in the sidebar, choosing “Save Current Search” and typing in a name. +You can also drag and drop any sidebar item onto this area to add an equivalent +saved search, effectively pinning it at the top. ### Editing Items @@ -114,8 +116,9 @@ of the active mode. Therefore in Cards mode, a note is considered to be selected if any of its cards is selected, and in Notes mode, a card is considered to be selected if its note is selected. -Other operations (like showing card information) only operate on a single card — the so-called -_current_, card or note, which is usually the one that was last selected or clicked. +Other operations (like showing card information) only operate on a single card +or note. This is called the _current_ card or note, which is usually the one that +was last selected or clicked. In Cards Mode, again, the current note is the note of the current card and in Notes mode, the current card is the first card of the current note. @@ -168,8 +171,8 @@ more information about cards and notes, see [Getting Started](getting-started.md For more information on formatting buttons, see [Editing](editing.md). You can see a preview of what the currently selected card would look -like when reviewing by clicking the **Preview** button next to the search -box. Note that this will not display any type-the-answer fields on your +like when reviewing by clicking the **Preview** button at the top of the editing area. +Note that this will not display any type-the-answer fields on your cards, which makes it easier to preview the cards quickly. In Notes mode, the preview is shown for the first card of the selected note. @@ -183,7 +186,7 @@ turn offer various actions that can be performed in the browser. | Name | Action | |-|-| -| Undo | Cancels the most recently performed operation. | +| Undo | Revert the most recently performed operation. | | Select All | Select all rows displayed. | | Select Notes | Show only the currently selected notes and select all rows. | | Invert Selection | Select those rows not selected, and deselect the currently selected rows. | @@ -220,9 +223,9 @@ they can be found in a submenu of the context menu. | Name | Action | |-|-| | Change Deck | Move currently selected cards to a different deck. | -| Set Due Date | Turn cards into review cards, and make them due on a certain date. This can be useful for moving cards forward or back a few days when your study schedule is interrupted. Entering a range like `60-90` will give cards an interval between 60 and 90 days, which can be useful when you've imported a bunch of material you already know. +| Set Due Date | Turn cards into review cards, and make them due on a certain date. This can be useful for moving cards forward or back a few days when your study schedule is interrupted. Entering a range like `60-90` will make the selected cards due between 60 and 90 days from now. New cards will have their interval set to the same delay, but reviews will be rescheduled without changing their current interval, unless '!' is included at the end of the range. | Forget | Move currently selected cards to the end of the new queue. The existing review history is preserved. | -| Reposition | Change the order new cards will appear in. You can find out the existing positions by enabling the _due_ column, as described in the [table](#cardnote-table) section above. If you run the reposition command when multiple cards are selected, it will apply increasing numbers to each card in turn. By default the number increases by one for each card, but this can be adjusted by changing the "step" setting. The **Shift position of existing cards** option allows you to insert cards between currently existing ones, pushing the currently existing ones apart. For instance, if you have five cards and you want to move 3, 4, and 5 between 1 and 2, selecting this setting would cause the cards to end up in the order 1, 3, 4, 5, 2. By contrast, if you turn this option off, 1 and 2 will get the same position number (and it will thus be unpredictable which of the cards with the same number comes up first). Please note that when enabled, any card with a higher position will be modified, and all of those changed cards will need to be sent the next time you sync. || +| Reposition | Change the order new cards will appear in. You can find out the existing positions by enabling the _due_ column, as described in the [table](#cardnote-table) section above. If you run the reposition command when multiple cards are selected, it will apply increasing numbers to each card in turn. By default the number increases by one for each card, but this can be adjusted by changing the "step" setting. The **Shift position of existing cards** option allows you to insert cards between currently existing ones, pushing the currently existing ones apart. For instance, if you have five cards and you want to move 3, 4, and 5 between 1 and 2, selecting this setting would cause the cards to end up in the order 1, 3, 4, 5, 2. By contrast, if you turn this option off, 1 and 2 will get the same position number (and it will thus be unpredictable which of the cards with the same number comes up first). Please note that when enabled, any card with a higher position will be modified, and all of those changed cards will need to be sent the next time you sync. | | Toggle Suspend | [Suspend](studying.md#editing-and-more) or unsuspend all selected cards, depending on whether the current card is suspended or not. | | Flag | Toggle the flags of all selected cards. Whether a flag is added or removed depends on whether the current card has the chosen flag. | | Info | Show various information about the current card, including its review history. For more information, see [Card Info](stats.md#card-info). | @@ -234,37 +237,38 @@ parts of the browser, and to go up and down the card list. ## Find and Replace -To replace text in selected notes, you can either: +This dialog allows for replacing text on notes. As described above, it is available +from the toolbar and the table's context menu. -- Right click on selected notes in the _card list_, and click **Find and Replace**. +The first input field is for the text that is going to be replaced, the second +one for the replacement. Next, there is a dropdown menu that allows you to specify +where Anki should look for text to replace: in a note's tags (requires Anki 2.1.45+), +in all fields, or just in a specific field (only fields belonging to a selected +note will be listed). -- In the **Browser** window, click **Notes** in the menu bar and click **Find and Replace**. +By default, only selected notes will be affected. If you want to lift that +restriction, you can untick the "selected notes only" checkbox (requires Anki 2.1.45+). The regular expression option allows you to perform complex replacements. -For example, given the following text in a field: +For example, assume there is the following text in a field: -Searching for: +We use these settings: - +![Find and Replace dialog](media/find_and_replace.png) -and on Anki 2.1.28, replacing with: +(Note that on Anki versions prior to 2.1.28, you would need to replace `${1}` +with `\1`.) - ${1} - -on older Anki versions, replacing with: - - \1 - -Will change the card to: +Then the assumed field content will change to: pic.jpg A full discussion on regular expressions is outside the scope of this document. There are a number of syntax guides available on the web: -- For Anki 2.1.28+, see . +- For Anki 2.1.28+, see . - For older Anki versions, see . ## Finding Duplicates @@ -283,12 +287,12 @@ The **Optional filter** text box allows you to narrow down where Anki will look for duplicates. If you only want to search for duplicates in the "French Vocab" and "French Verbs" note types, you would enter: - note:'french vocab' or note:'french verbs' + "note:french vocab" or "note:french verbs" Or you might want to look only for duplicates in a particular deck, so you could use: - deck:'myDeck' + "deck:myDeck" The search syntax is the same as used when searching in the browser. For more information, see [Searching](searching.md). diff --git a/src/contrib.md b/src/contrib.md index 6522e2a..37d21ef 100644 --- a/src/contrib.md +++ b/src/contrib.md @@ -18,7 +18,11 @@ When updating a deck, AnkiWeb expects the deck to be at the same location as before. If you shared a deck when it was called "Korean Verbs" for example, and then renamed it to "Korean::Korean Verbs", resharing will not be able to update the existing copy. If you have -forgotten the original name, please contact support. +forgotten the original name, you can guess it by downloading the +deck on ankiweb and importing it (File > Import) in a new profile +(File > Switch profile > Add). Then you can copy the exact name of the +deck when it was first shared. If this doesn't work, please contact +support. When you update a shared deck, users who downloaded the deck previously will not automatically receive updates. If they download the deck again @@ -66,5 +70,4 @@ Please see Anki's source code is available at -Before contributing, please see the README.contributing file in that -repo. +Before contributing, please see [contributing.md](https://github.com/ankitects/anki/blob/main/docs/contributing.md). diff --git a/src/deck-options.md b/src/deck-options.md index b6fc817..30d5c21 100644 --- a/src/deck-options.md +++ b/src/deck-options.md @@ -54,10 +54,10 @@ deck you select to study, not the deck of the current card. For example, let's say you have this collection: -- Deck A (Preset 1) - - Deck A::Subdeck B (Preset 2) - - Card B1 - - Card B2 + - Deck A (Preset 1) + - Deck A::Subdeck B (Preset 2) + - Card B1 + - Card B2 Preset 1 and 2 are identical, with two exceptions: @@ -85,7 +85,7 @@ Controls how many new cards are introduced each day you open the program. If you study fewer than the limit, or miss a day, the next day the counts will be back to your limit - they do not accumulate. -In [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html), Anki +In [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html#daily-limits), Anki uses the limits of the deck you select as an upper limit on the number of cards. This means if "French" has a limit of 20 cards and "French::Lesson 1" and "French::Lesson 2" both have limits of 15 cards, when you click on "French", @@ -94,8 +94,21 @@ you’ll get at most 15 cards from either child deck, and only 20 cards in total In the v1 or v2 scheduler, each parent applies its limits to its children. If you have decks in a grandparent-parent-child arrangement, both the grandparent and parent limits will alter how many cards are shown from the child, even if you -click directly on the child. - +click directly on the child. In the v3 scheduler, this has been simplified, and +now each deck's limit controls how many cards from that specific deck can be used. +Imagine that you have this collection: + + - Parent deck (New Cards/Day: 20) + - Child deck (New Cards/Day: 7) + - Grandchild deck A (New Cards/Day: 5) + - Cards 1 to 50 + - Grandchild deck B (New Cards/Day: 5) + - Cards 51 to 100 + +- If you click on the Parent deck, you will get 10 new cards (from Grandchild decks A and B). +- If you click on the Child deck, you will get 7 new cards (from Grandchild decks A and B). +- If you click on any of the Grandchild decks, you will get 5 new cards. + Studying new cards will temporarily increase the number of reviews you need to do a day, as freshly learnt material needs to be repeated a number of times before the delay between repetitions can increase appreciably. If you are @@ -106,7 +119,7 @@ your review burden decreases. More than one Anki user has excitedly studied hundreds of new cards over their first few days of using the program, and then become overwhelmed by the reviews required. -If using [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html), +If using [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html#daily-limits), please keep in mind that the new count is capped by the review count. If your review limit is set to 200, and you have 190 reviews waiting, a maximum of 10 new cards will be introduced. If your review limit has been reached, no new @@ -126,7 +139,7 @@ heart attack when returning to Anki after a week off. When reviews have been hidden due to this option, a message will appear in the congratulations screen, suggesting you consider increasing the limit if you have time. -In [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html) and +In [the v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html#daily-limits) and v1 schedulers, the counts are affected by parents/selected decks in the same way as new cards. @@ -139,9 +152,9 @@ so those learning cards will be subject to the daily limit. ## New Cards The settings in this section only affect new cards and cards in initial -[learning](https://docs.ankiweb.net/studying.html?#learning) mode. Once a card +[learning](studying.md#learningrelearning-cards) mode. Once a card has graduated (i.e. there are no more learning steps for this card), it becomes a -[review card](https://docs.ankiweb.net/studying.html?#reviewing), and the +[review card](studying.md#review-cards), and the settings in this section are no longer applicable. ### Learning Steps @@ -166,20 +179,19 @@ If there’s nothing else to study, Anki will show cards up to 20 minutes early by default. The amount of time to look ahead is configurable in the [preferences](preferences.md). -Anki treats small steps and steps that cross a day boundary differently. -With small steps, the cards are shown as soon as the delay has passed, -in preference to other waiting cards like reviews. This is done so that -you can answer the card as closely to your requested delay as possible. -In contrast, cards that cross a day boundary are scheduled on a per-day -basis like reviews are. By default they are shown after normal reviews; -this can be customized in the [display order](#display-order) section for -the v3 scheduler, and in the preferences screen for older schedulers. - -Please see the [learning](studying.md#learning) section for more info on how +Please see the [learning](studying.md#learningrelearning-cards) section for more info on how steps work. Also, check [this forum's post](https://forums.ankiweb.net/t/deck-options-explained/213) for more examples. +#### Day Boundaries +Anki treats small steps and steps that [cross a day boundary](./preferences.md#scheduling) differently. +With small steps, the cards are shown as soon as the delay has passed, +in preference to other waiting cards like reviews. This is done so that +you can answer the card as closely to your requested delay as possible. +In contrast, if the interval crosses a day boundary, it is automatically +converted to days. + ### Graduating Interval The delay in days between answering "Good" on a learning card with no steps left, @@ -343,22 +355,23 @@ higher retention. Controls the easiness that cards start out with. It is set when a card graduates from learning for the first time. It defaults -to 250%, meaning that once you have finished learning a card, answering +to 2.50, meaning that once you have finished learning a card, answering `Good` on subsequent reviews will increase the delay by approximately -2.5 (e.g. if the last delay was 10 days, the next delay would be around 25 +2.5x (e.g. if the last delay was 10 days, the next delay would be around 25 days). Based upon how you rate the card in subsequent reviews, the easiness may increase or decrease from its starting value. ### Easy Bonus An extra multiplier applied to the interval when a review card is answered -`Easy`. With the default value of 130%, `Easy` will give an interval that is -1.3 times the `Good` interval. +`Easy`. With the default value of 1.30, `Easy` will give an interval that is +1.3 times the `Good` interval (e.g. if the last interval was 10 days, the next +interval would be around 13 days). ### Interval Modifier -An extra multiplier that is applied to all reviews. At its default of 100% it -does nothing. If you set it to 80%, though, for example, intervals will be generated at +An extra multiplier that is applied to all reviews. At its default of 1.00 it +does nothing. If you set it to 0.80, though, for example, intervals will be generated at 80% of their normal size (so a 10 day interval would become 8 days). You can thus use the multiplier to make Anki present cards more or less frequently than it would otherwise, trading study time for retention or vice versa. @@ -408,19 +421,19 @@ learning mode steps, instead of by adjusting this modifier. ### Hard Interval The multiplier used when you use the `Hard` button. The percentage is relative -to the previous interval: e.g. with a default of 120%, a card with a 10-day interval +to the previous interval: e.g. with a default of 1.20, a card with a 10-day interval will be given 12 days. ### New Interval The multiplier used when you use the `Again` button on a review card. The -default 0% means that a review card's delay is reset to zero when you forget it +default 0.00 means that a review card's delay is reset to zero when you forget it (which then becomes 1 day after the [minimum interval](#minimum-interval) is applied). If changed from the default, it is possible for forgotten cards to preserve part of their previous delay. For example, if a card had a 100 day interval, and you set -the *New Interval* to 20%, the new interval would be 20 days. +the *New Interval* to 0.20, the new interval would be 20 days. While preserving part of the interval may seem to make sense, SuperMemo has observed that preserving part of the delay can actually [be counter-productive](https://supermemo.guru/wiki/Post-lapse_stability). For this reason, we recommend you leave it on the default setting. diff --git a/src/editing.md b/src/editing.md index b2d8033..e17e215 100644 --- a/src/editing.md +++ b/src/editing.md @@ -37,6 +37,11 @@ and placed into the deck you chose. If you would like to edit a card you added, you can click the history button to search for a recently added card in the [browser](browsing.md). +Дополнительные сведения о кнопках между типом записи и полями см. в разделе +[редактор](editing.md). + +### Duplicate Check + Anki checks the first field for uniqueness, so it will warn you if you enter two cards with a Front field of "apple" (for example). The uniqueness check is limited to the current note type, so if you're @@ -48,11 +53,10 @@ Anki does not check for duplicates in other fields automatically for efficiency reasons, but the browser has a "Find Duplicates" function, which you can run periodically. -Дополнительные сведения о кнопках между типом записи и полями см. в разделе -[редактор](editing.md). +### Effective Learning Разным людям нравится повторять по-разному,но есть некоторые общие концепции, -о которых следует помнить. Отличное введение --- [эта статья](http://www.supermemo.com/articles/20rules.htm) на сайте SuperMemo. В частности: +о которых следует помнить. Отличное введение — [эта статья](http://www.supermemo.com/articles/20rules.htm) на сайте SuperMemo. В частности: - **Keep it simple**: The shorter your cards, the easier they are to review. You may be tempted to include lots of information "just in @@ -135,15 +139,11 @@ answer](templates/fields.md#checking-your-answer) section.) Поле сортировки обозревателя. Это можно использовать для сортировки карточек по этому полю. Одновременно только одно поле может быть полем сортировки. -When **Remember last input…​** is checked, Anki will not clear out this -field's content after a note is added. If you find yourself entering the -same content into multiple notes, you may find this useful. - **Reverse text direction** is useful if you are studying languages that display text from right to left (RTL), such as Arabic or Hebrew. This setting currently only controls editing; to make sure the text displays correctly during review, you'll need to adjust your -[template](templates/styling.md). +[template](templates/styling.md#text-direction). After you have added fields, you will probably want to add them to the front or back of your cards. For more information on that, please see the @@ -156,53 +156,107 @@ and the top right button to change deck. The window that opens up will not only allow you to select a deck or note type, but also to add new decks or manage your note types. -## Правильное использование колод +## Organizing Content + +### Using Decks Appropriately -Decks are designed to divide your content up into broad categories that -you wish to study separately, such as English, Geography, and so on. You -may be tempted to create lots of little decks to keep your content -organized, such as "my geography book chapter 1", or "food verbs", but +[Decks](getting-started.md#decks) are designed to divide your content up into +broad categories that you wish to study separately, such as English, Geography, +and so on. You may be tempted to create lots of little decks to keep your +content organized, such as "my geography book chapter 1", or "food verbs", but this is not recommended, for the following reasons: -- Lots of little decks mean you end up reviewing cards in a - recognizable order. Whether it is because you are clicking on each - deck in turn (which is slow) or you have added a number of decks under - a single parent deck, you will end up seeing all the "chapter 1" or - "food verb" cards together. This makes it easier to answer the +- Lots of little decks may mean you end up seeing cards in a + recognizable order. On older scheduler versions, new cards can only + be introduced in deck order. And if you were planning to click on each deck + in turn (which is slow), you will end up seeing all the "chapter 1" or + "food verb" reviews together. This makes it easier to answer the cards, as you can guess them from the context, which leads to weaker memories. When you need to recall the word or phrase outside Anki, - you won't have the luxury of being shown related content first! + you won't always have the luxury of being shown related content first! - While less of a problem than it was in earlier Anki versions, adding hundreds of decks may cause slowdowns, and very large deck trees with thousands of items can actually break the display of - the deck list in the current implementation. + the deck list in Anki versions before 2.1.50. + +### Using Tags Instead of creating lots of little decks, it's a better idea to use tags -and/or fields to classify your content. Instead of creating a "food -verbs" decks for example, you could add those cards to your main -language study deck, and tag the cards with "food" and "verb". Each card -can have multiple tags, which means you can do things like search for -all verbs, or all food-related vocabulary, or all verbs that are related -to food. +and/or fields to classify your content. Tags are a useful way to boost +search results, find specific content, and keep your collection +organized. +There are many ways of using tags and flags effectively, and +thinking in advance about how you want to use them will help you decide +what will work best for you. + +Some people prefer using decks and subdecks to keep their cards organized, +but using tags have a big advantage over decks for that: you can add several +tags to a single note, but a single card can only belong to one deck, which +makes tags a more powerful and flexible categorization system than +decks in most cases. You can also organize tags in trees [in the same way +as you can do for decks](getting-started.md#decks). + +For example, instead of creating a "food verbs" deck, you could add those +cards to your main language study deck, and tag the cards with "food" and +"verb". Since each card can have multiple tags, you can do things like +[search](searching.md#tags-decks-cards-and-notes) for all verbs, or all +food-related vocabulary, or all verbs that are related to food. + +You can add tags from the Edit window and from the [Browser](browsing.md), and you can also add, +delete, rename, or organize tags there. Please note that +tags work at [note](getting-started.md#notes--fields) level, which means that when you tag a card that has siblings, +all the siblings will be tagged as well. If you need to tag a single card, +but not its siblings, you should consider using flags instead. + +### Using Flags + +Flags are similar to tags, but they will appear during study in the review +window, showing a colored flag icon on the upper right area of the screen. +You can also search for flagged cards in the Browse screen, rename flags +from the browser and create filtered decks from flagged cards, but unlike tags, +a single card can have only one flag at a time. Another important difference +is that flags work at [card](getting-started.md#cards) level, so flagging a card that have siblings +won't have any effect on the card's siblings. + +You can flag / unflag cards directly while in review mode (by pressing +CTRL + 1-7 on Windows or CMD + 1-7 on Mac) +and from the [Browser.](browsing.md) + + +### The "Marked" Tag + +Anki treats a tag called "marked" specially. There are options in the review +screen and browse screen to add and remove the "marked" tag. The review screen +will show a star when the current card's note has that tag. And cards are +shown in a different color in the browse screen when their note is marked. + +Note: Marking is mainly left around for compatibility with older Anki +versions; most users will want to use flags instead. + + +### Using Fields For those who like to stay very organized, you can add fields to your notes to classify your content, such as "book", "page", and so on. Anki supports searching in specific fields, which means you can do a search -for "book:'my book' page:63" and immediately find what you're looking +for `"book:my book" page:63` and immediately find what you're looking for. -Anki's [custom study and filtered deck](filtered-decks.md) features make this -especially powerful, as you can create temporary decks out of search +### Custom Study and Filtered Decks + +Using [custom study and filtered deck](filtered-decks.md) you can create +temporary decks out of search terms. This allows you to review your content mixed together in a single deck most of the time (for optimum memory), but also create temporary decks when you need to focus on particular material, such as before a test. The general rule is that if you always want to be able to study some content separately, it should be in a normal deck; if you only occasionally need to be able to study it separately (for a test, when -under a backlog, etc.), then tags, fields, and filtered decks are better. +under a backlog, etc.), then filtered decks created from tags, flags, +marks or fields are better. -## Features +## Editing Features The editor is shown when [adding notes](editing.md), [editing a note](studying.md) during reviews, or [browsing](browsing.md). @@ -216,10 +270,11 @@ buttons allow you to subscript or superscript text, which is useful for chemical compounds like H2O or simple mathematical equations like x2. -The Fx button clears any formatting in the currently selected text — including the colour +The rubber eraser button clears any formatting in the currently selected text — including the colour of the text, whether the selected text is bold, etc. -The next two buttons allow you to change text colour. +The next three buttons allow creating lists, text alignment and text indent. +Then, there are two buttons to allow you to change text colour. The \[…​\] button is visible when a cloze note type is selected. @@ -233,10 +288,17 @@ about media, please see the [media](media.md) section. The microphone icon allows you to record from your computer's microphone and attach the recording to the note. -The last button shows more advanced features, such as editing the -underlying HTML of a field, and shortcuts to add MathJax or +The Fx button shows shortcuts to add MathJax or [LaTeX](math.md) to your notes. +The `` button allows editing the underlying HTML of a field. + +Anki 2.1.45+ supports adjusting sticky fields directly from the editing screen. +If you click on the pin icon on the right of a field, Anki will not clear out +the field's content after a note is added. If you find yourself entering the +same content into multiple notes, you may find this useful. On previous Anki +versions, sticky fields were toggled from the Fields screen. + Most of the buttons have shortcut keys. You can hover the mouse cursor over a button to see its shortcut. @@ -368,9 +430,9 @@ things to consider. Please see [this page](http://dotancohen.com/howto/rtl_right_to_left.html) for more information. -The toolkit, on which Anki is built, has trouble dealing with a few input -methods, such as holding down keys to select accented characters on Mac -OS X, and typing characters by holding down the Alt key and typing a +The toolkit on which Anki is built has trouble dealing with a few input +methods, such as holding down keys to select accented characters on macOS, +and typing characters by holding down the Alt key and typing a numeric code on Windows. ## Unicode Normalization diff --git a/src/files.md b/src/files.md index bfefcda..ed1f08f 100644 --- a/src/files.md +++ b/src/files.md @@ -105,7 +105,7 @@ On Windows, you can define the environment variable with: set "ANKI_BASE=C:/path/to/AnkiDataFolder" -On Linux and Mac OS, you can use: +On Linux and macOS, you can use: export ANKI_BASE="/path/to/AnkiDataFolder" @@ -263,7 +263,7 @@ installed already. On Windows, download Next, create a backup of your collection.anki2 file, in case something goes wrong with the steps below. -### Linux/OSX +### Linux/macOS Open a terminal, change to the folder your collection is located in, and type: diff --git a/src/filtered-decks.md b/src/filtered-decks.md index 6c29eaa..437b2c9 100644 --- a/src/filtered-decks.md +++ b/src/filtered-decks.md @@ -115,8 +115,7 @@ times, and so on. Please see the [searching](searching.md) section of the manual for more information on the different possibilities. Filtered decks cannot pull in cards that are suspended, buried, or already in a -different filtered deck. And if you are using the [v1 -scheduler], cards in +different filtered deck. And if you are using the v1 scheduler, cards in (re)learning will not be included either. For this reason, a search in the browser may reveal cards that do not end up in the filtered deck. @@ -126,9 +125,6 @@ in, and the order they will be reviewed in. If you select "most lapses" and a limit of 20 for example, then Anki will show you only the 20 most lapsed cards. -For efficiency reasons, if your cram deck contains more than 1000 cards, -only 1000 cards will be shown as due on the deck list and study screens. - ## Order The "cards selected by" option controls the order that cards will appear @@ -174,7 +170,7 @@ first, that you are most in danger of forgetting. ## Steps & Returning -Please see the section on [learning](studying.md#learning) as a reminder of how +Please see the section on [learning](studying.md#learningrelearning-cards) as a reminder of how steps work. By default, Anki will use the steps of a card’s home deck. If a new card @@ -191,7 +187,7 @@ In the v1 scheduler, the **custom steps** option allows you to override the home deck’s steps and provide your own steps instead. The provided steps apply to both cards being learnt, lapsed reviews, and reviews ahead of time. Please note, however, that from the [v2 scheduler](https://faqs.ankiweb.net/the-anki-2.1-scheduler.html) -filtered decks no longer support custom steps. +filtered decks [no longer support custom steps](https://forums.ankiweb.net/t/filtered-deck-interval-problem/11834/8). **v3 scheduler** diff --git a/src/getting-started.md b/src/getting-started.md index 7214afd..ac479ee 100644 --- a/src/getting-started.md +++ b/src/getting-started.md @@ -4,7 +4,11 @@ ## Установка и обновление -Инструкции по установке и обновлению смотрите на [сайте загрузок](https://apps.ankiweb.net). +Please see the instructions for your computer: + +- [Windows](./platform/windows/installing.md) +- [Mac](./platform/mac/installing.md) +- [Linux](./platform/linux/installing.md) ## Видео @@ -197,27 +201,32 @@ Anki позволяет создавать различные типы запи рекомендуется определить свои собственные типы записей для того материала который вы изучаете. -Основная -Содержит поля Лицо и Оборот, и будет создавать одну карточку. Текст напечатанный -в поле Лицо будет отображаться на лицевой стороне карточки, а текст который вы -введёте в поле Оборот будет отображаться на обратной стороне карточки. - -Основная (с обратной карточкой) -Как Основная, только создаёт две карточки для введённого вами текста: одну из -лицо→оборот и одну из оборот→лицо. - -Основная (обратная по выбору) -Это лицо→оборот карточка, а карточка оборот→лицо при необходимости. Для этого -есть третье поле под названием "Добавить обратную". Если в это поле будет -введён какой-либо текст [прим. перев. _Любой текст, чтобы эта функция -сработала_], обратная карточка будет создана. Дополнительные сведения об этом -см. в разделе [Шаблоны карточек](templates/intro.md) - -Задание с пропусками -Тип записи который облегчает выбор текста и превращение его в обучающие пропуски -(англ. _cloze deletion_) (например, "Человек приземлился на Луну в \[…​\] году" -→ "Человек приземлился на Луну в 1969 году"). Дополнительные сведения см. в -разделе [заполнение пропусков](editing.md#Заполнение-пропусков) +**Basic** +Has Front and Back fields, and will create one card. Text you enter in +Front will appear on the front of the card, and text you enter in Back +will appear on the back of the card. + +**Basic (and reversed card)** +Like Basic, but creates two cards for the text you enter: one from +front→back and one from back→front. + +**Basic (optional reversed card)** +This is a front→back card, and optionally a back→front card. To do this, +it has a third field called “Add Reverse.” If you enter any text into +that field, a reverse card will be created. More information about this +is available in the [Cards and Templates](templates/intro.md) section. + +**Basic (type in the answer)** +This is essentially Basic, with an extra text box on the front where you +can type your answer in, after flipping to the back your input would be +checked and compared with the answer. More information is available in the +[Checking Your Answer](templates/fields.md#checking-your-answer) section. + +**Cloze** +A note type which makes it easy to select text and turn it into a cloze +deletion (e.g., “Man landed on the moon in \[…​\]” → “Man landed on the +moon in 1969”). More information is available in the [cloze +deletion](editing.md#cloze-deletion) section. Чтобы добавить свои типы записей и изменить существующие, можно использовать Инструменты → Управлять типами записей из главного окна Anki. diff --git a/src/math.md b/src/math.md index 78c321d..15f8bfa 100644 --- a/src/math.md +++ b/src/math.md @@ -67,7 +67,7 @@ experience with LaTeX, please consult one of the many guides available on the internet. If you are having trouble with markup, please ask on a LaTeX forum. -To install LaTeX, on Windows use MiKTeX; on OSX use MacTex, and on Linux +To install LaTeX, on Windows use MiKTeX; on macOS use MacTex, and on Linux use your distro’s package manager. Dvipng must also be installed. On Windows, go to Settings in MikTek’s maintenance window, and make sure @@ -76,7 +76,7 @@ first". If you continue to have difficulties, one user reported that running Anki as an administrator until all the packages were fetched helped. -On OSX, LaTeX has only been tested with MacTex and BasicTex. If you use +On macOS, LaTeX has only been tested with MacTex and BasicTex. If you use BasicTex, you need to install dvipng separately, with the following command: @@ -270,7 +270,7 @@ following note text will read `[type] in C++ is a type-safe union`: {{c1::std::variant::~type~}} in C++ is a {{c2::type-safe union}} -### Unsafe commands +### Unsafe Commands Anki prohibits certain commands like \\input or \\def from being used on cards or in templates, because allowing them could allow malicious diff --git a/src/media.md b/src/media.md index 6f1d44e..ce7da44 100644 --- a/src/media.md +++ b/src/media.md @@ -6,7 +6,17 @@ locations](files.md) section. When you add media within Anki, either by using the paperclip icon in the [editor](editing.md) or by pasting it into a field, Anki will copy it from its original location into the media folder. This makes it easy to back up your collection’s media or move it -to another computer. +to another computer. + +If your media filenames contain spaces or other special characters such +as percentage signs, the way the filenames appear in the HTML editor will +differ from the way the filenames appear on disk. For example, a file called +`hello 100%.jpg` will appear as `hello%20100%25.jpg` in the HTML editor. +Internally, Anki still uses the original filenames, so if you would like to +[search](searching.md) for the file or modify the filename with [Find&Replace](browsing.md#find-and-replace), you will +need to use the name as it appears on disk, not as it appears in the +HTML editor. Exporting to a text file is another way to see the underlying +representation. You can use the Tools>Check Media menu option to scan your notes and media folder. It will generate a report of files in the media folder @@ -14,7 +24,7 @@ that are not used by any notes, and media referenced in notes but missing from your media folder. It does not scan question or answer templates, which is why you can’t place media references to fields in the template. If you need a static image or sound on every card, name it -with a leading \_ (e.g., '\_dog.jpg') to tell Anki to ignore it when +with a leading \_ (e.g., `\_dog.jpg`) to tell Anki to ignore it when checking for media. If you delete media using the unused media check, Anki will move it into your operating system’s trash folder, so you can recover if you accidentally delete media that shouldn’t have been diff --git a/src/media/find_and_replace.png b/src/media/find_and_replace.png new file mode 100644 index 0000000000000000000000000000000000000000..029c5cf4c4ebdc01c36bcf71275cd144dd57feff GIT binary patch literal 6886 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 key and press a highlighted letter to activate a particular menu. -OS X doesn’t support this feature, but it does allow you to assign -shortcuts to specific menu items instead. Please see +Although macOS doesn’t support this feature, it does allow you instead to assign +shortcuts to specific menu items. Please see for more information. @@ -17,7 +17,7 @@ for more information. Sometimes you may be asked to use the debug console to change a setting or check something. Unless asked to enter text in the "debug console", you will probably not need this. Advanced users may like to read more -about it in the [add-on writing guide](https://addon-docs.ankiweb.net/features-and-debugging.html#debugging). +about it in the [add-on writing guide](https://addon-docs.ankiweb.net/debugging.html#debug-console). When asked to enter text into the "debug console", please start Anki, and in the main window, press diff --git a/src/platform/intro.md b/src/platform/intro.md new file mode 100644 index 0000000..30d9249 --- /dev/null +++ b/src/platform/intro.md @@ -0,0 +1,4 @@ +# Platform Notes + +The way Anki is installed, and the possible problems you may encounter, depend +on the type of computer you are using. diff --git a/src/platform/linux/blank-window.md b/src/platform/linux/blank-window.md new file mode 100644 index 0000000..0e7c687 --- /dev/null +++ b/src/platform/linux/blank-window.md @@ -0,0 +1,8 @@ +# Blank Window + +Some users have reported a blank main window when starting Anki on recent OpenSUSE +and Fedora machines. Some workarounds are posted on the following threads: + +- +- +- \ No newline at end of file diff --git a/src/platform/linux/display-issues.md b/src/platform/linux/display-issues.md new file mode 100644 index 0000000..0eeafe1 --- /dev/null +++ b/src/platform/linux/display-issues.md @@ -0,0 +1,15 @@ +## Display Issues on Linux + +Hardware acceleration defaults to off on Linux. Enabling it +in the preferences screen and restarting Anki may make Anki’s interface +more responsive, but some users may experience missing menubars, blank +windows or crashes when it is enabled. + +You can adjust the display driver in Anki's Preferences screen. We +recommend you try both settings, and see which one works best for you. + +If you're unable to open Anki, you can adjust the driver in a terminal, +by writing either `auto` or `software` into +`~/.local/share/Anki2/gldriver`. Please note that if +you’re using nouveau, it is known to be buggy, and it only supports +software mode. diff --git a/src/platform/linux/distro-packages.md b/src/platform/linux/distro-packages.md new file mode 100644 index 0000000..065c9e3 --- /dev/null +++ b/src/platform/linux/distro-packages.md @@ -0,0 +1,22 @@ +# Packages Distributed by Linux Distributions + +We have seen a lot of issues caused by the customized versions of Anki +distributed by Linux distributions: + +- Anki depends on third-party libraries like Qt, and Linux distributions often + substitute different versions of those libraries, without testing the impact + of those changes. +- Sometimes the version of Anki they distribute is years old, or is an + alpha/beta version not intended for stable release. Distributions will often + disable the built-in update check as well, to prevent you from being notified + of newer versions. + +Compiled builds of Anki are available on . Most of the +necessary libraries are included, and Anki has been tested to work with these +library versions. If you're experiencing issues with your distro's version, the +first thing you should try is switching to the latest packaged version we +provide. + +You are welcome to continue using your distro's version of Anki if you prefer, +but if you run into any issues, you will need to report them to your +distribution's package maintainers. diff --git a/src/platform/linux/gtk-theme.md b/src/platform/linux/gtk-theme.md new file mode 100644 index 0000000..d1a765f --- /dev/null +++ b/src/platform/linux/gtk-theme.md @@ -0,0 +1,11 @@ +# Anki not picking up GTK theme on Gnome/Linux + +You can work around this issue by explicitly telling Anki what the GTK theme is. Run the following commands in a terminal: + +```shell +theme=$(gsettings get org.gnome.desktop.interface gtk-theme) +echo "gtk-theme-name=$theme" >> ~/.gtkrc-2.0 +echo "export GTK2_RC_FILES=$HOME/.gtkrc-2.0" >> ~/.profile +``` + +Then log out and log back into your computer, and Anki should pick up the GTK theme. diff --git a/src/platform/linux/input-methods.md b/src/platform/linux/input-methods.md new file mode 100644 index 0000000..f90759b --- /dev/null +++ b/src/platform/linux/input-methods.md @@ -0,0 +1,11 @@ +# Input Methods on Linux + +## Fcitx + +The standard Anki build includes fcitx support, but it may not work on +all distributions. If you are unable to use fcitx, you may want to run +Anki from [Python +wheels](https://betas.ankiweb.net/#via-pypipip) +instead. + + diff --git a/src/platform/linux/installing.md b/src/platform/linux/installing.md new file mode 100644 index 0000000..245bc1e --- /dev/null +++ b/src/platform/linux/installing.md @@ -0,0 +1,64 @@ +# Installing & Upgrading Anki on Linux + + + +## Requirements + +The packaged version requires a recent 64 bit Intel/AMD Linux, and common +libraries like libwayland-client and systemd. If you are on a different +architecture, or a barebones Linux distro, you will not be able to use the +packaged version, but you may be able to use the [Python +wheels](https://betas.ankiweb.net/#via-pypipip) +instead. + +On recent Ubuntu installations, please use the following before +installing: + +```shell +sudo apt install libxcb-xinerama0 +``` + +If Anki fails to start after installing, you may be [missing other libraries](./missing-libraries.md). + +## Installing + +To install Anki: + +1. Download Anki from to your Downloads folder. +2. Open a terminal and run the following commands, replacing the version +number as appropriate. + +```shell +tar xjf Downloads/anki-2.1.XX-linux.tar.bz2 +cd anki-2.1.XX-linux +sudo ./install.sh +``` + +3. You can then start Anki by typing 'anki' and hitting enter. If you encounter +any issues, please see the links on the left. + +## Upgrading + +If you were running Anki from a .deb/.rpm/etc in the past, please make +sure to remove the system version before installing the package +provided here. + +If you're upgrading from a previous package, simply repeat the +installation steps to upgrade to the latest version. Your user data +will be preserved. + +If you wish to downgrade to a previous version, please make sure you +[downgrade first](http://changes.ankiweb.net). + +## Add-on Compatibility + +Some add-ons have not been updated to support the latest Anki release yet. If an +add-on you depend on has not been ported to the latest release yet, you may have +more luck with 2.1.44 from the [releases +page](https://github.com/ankitects/anki/releases). + + +## Problems + +If you encounter any issues when installing or starting Anki, please see the +following links on the left. diff --git a/src/platform/linux/missing-libraries.md b/src/platform/linux/missing-libraries.md new file mode 100644 index 0000000..261217e --- /dev/null +++ b/src/platform/linux/missing-libraries.md @@ -0,0 +1,14 @@ +# Missing Libraries + +If Anki fails to start, please run it from a terminal with `anki`. If it says a +library is missing, please install it and try again. + +If it complains about no platform being available, please start Anki with the +following command line, which should reveal a missing library: + +```shell +QT_DEBUG_PLUGINS=1 anki +``` + +After installing the library with apt-get or similar, repeat the process. You +may need to do this a few times before all required libraries are installed. diff --git a/src/platform/linux/wayland.md b/src/platform/linux/wayland.md new file mode 100644 index 0000000..5f4228c --- /dev/null +++ b/src/platform/linux/wayland.md @@ -0,0 +1,9 @@ +# Wayland + +From Anki 2.1.48, you can force Anki to use Wayland by defining ANKI_WAYLAND=1 +before starting Anki. Wayland may give you better rendering across multiple +displays, but it is currently off by default, due to the following issues: + +- On some distros, Windows are rendered without borders. +- Bringing windows to the front is not possible, so for example, clicking on Add +to reveal an existing Add Cards window will not work. diff --git a/src/platform/mac/display-issues.md b/src/platform/mac/display-issues.md new file mode 100644 index 0000000..537bf79 --- /dev/null +++ b/src/platform/mac/display-issues.md @@ -0,0 +1,10 @@ +# Display Issues on macOS + +## eGPUs + +If you experience blank screens when using an external graphics card on a Mac, you can ctrl+click on the Anki app, click "Get Info", and enable the "prefer eGPU" option. + +## Monitors with different resolutions + +Please see [this forum post](https://forums.ankiweb.net/t/mac-known-issues-wording-suggestion/7331). + diff --git a/src/platform/mac/installing.md b/src/platform/mac/installing.md new file mode 100644 index 0000000..e9ccaf0 --- /dev/null +++ b/src/platform/mac/installing.md @@ -0,0 +1,39 @@ +# Installing & Upgrading Anki on macOS + + + +## Requirements + +Recent Anki releases require a Mac running macOS 10.13.4 or later. + +The last Anki release that supported macOS 10.10 to 10.13.3 was +2.1.35-alternate. If you're on an old machine, you can obtain the old +version from the [releases +page](https://github.com/ankitects/anki/releases). + +## Installing + +1. Download Anki from +2. Save the file to your desktop or downloads folder. +3. Open it, and drag Anki to your Applications folder or desktop. +4. Double-click on Anki in the location you placed it. + +## Upgrading + +To upgrade, close Anki if it is open, and then follow the steps above. Drag +the Anki icon into the same location you previously stored it, and when prompted, +overwrite the old version. Your card data will be preserved. + +## Add-on Compatibility + +Some add-ons have not been updated to support the latest Anki release yet. If an +add-on you depend on has not been ported to the latest release yet, you may have +more luck with 2.1.44 from the [releases +page](https://github.com/ankitects/anki/releases). + + +## Problems + +If you encounter any issues when installing or starting Anki, please see the +following links on the left. + diff --git a/src/platform/windows/copy-and-paste.md b/src/platform/windows/copy-and-paste.md new file mode 100644 index 0000000..1d92f93 --- /dev/null +++ b/src/platform/windows/copy-and-paste.md @@ -0,0 +1,6 @@ +# Copy and paste issues + +If you are experiencing problems with copying and pasting, please check if you +are running other programs on your computer that monitor the clipboard, such as +dictionary programs, clipboard managers or clipping tools. The toolkit Anki uses +can have trouble when such programs are running. diff --git a/src/platform/windows/display-issues.md b/src/platform/windows/display-issues.md new file mode 100644 index 0000000..d654576 --- /dev/null +++ b/src/platform/windows/display-issues.md @@ -0,0 +1,20 @@ +# Windows display issues + +On Windows, there are three ways of content being displayed on screen. The +default is *software*, which is slower, but the most compatible. There are two +other options that are faster: *OpenGL* and *ANGLE*. They are faster, but they +may not work, or may cause display issues such as missing menubars, blank +windows, and so on. Which one works best will depend on your computer. + +The display driver can be adjusted via the Tools>Preferences menu. Make sure +you restart Anki after adjusting it. + +If you’re unable to get to Anki’s preferences screen, and restarting Anki a few +times does not help, you may need to manually adjust the graphics driver. You +can do this by starting cmd.exe and typing the following: + +```bat +echo auto > %APPDATA%\Anki2\gldriver +``` + +The default is `software`; the other two drivers you can try are `angle` and `auto`. diff --git a/src/platform/windows/installation-issues.md b/src/platform/windows/installation-issues.md new file mode 100644 index 0000000..5eab6fa --- /dev/null +++ b/src/platform/windows/installation-issues.md @@ -0,0 +1,22 @@ +# Windows installation issues + +Some error messages you may encounter when installing Anki: + + + +Please also see [startup issues](./startup-issues.md). + +## "Error opening file for writing" + +If closing Anki and your browser does not help, please try restarting your +computer, then running the installer again. + +## "Windows protected your PC" + +When a new Anki version is released, Windows may display a scary-looking message +until it has seen enough people using the new version. To be able to proceed +with app installation, please use [Run +anyway](https://www.tekrevue.com/tip/windows-protected-your-pc-disable-smartscreen/). + +Antivirus programs may sometimes also report a [false +positive](https://faqs.ankiweb.net/my-antivirus-program-says-anki-is-infected.html). diff --git a/src/platform/windows/installing.md b/src/platform/windows/installing.md new file mode 100644 index 0000000..5ec18e9 --- /dev/null +++ b/src/platform/windows/installing.md @@ -0,0 +1,50 @@ +# Installing & Upgrading Anki on Windows + + + +## Requirements + +Recent Anki releases require a computer running the 64 bit version of Windows +7, 8, 10 or 11. + +The last Anki release that supported 32 bit Windows was Anki 2.1.35-alternate. +If you're on an old machine, you can obtain the old release from the [releases +page](https://github.com/ankitects/anki/releases). + +## Installing + +To install Anki: + +1. Download Anki from +2. Save the installer to your desktop or downloads folder. +3. Double-click on the installer to run it. If you see an error +message, please see the links on the left. +4. Once Anki is installed, double-click on the new star icon on your +desktop to start Anki. + +## Upgrading + +If upgrading from Anki 2.1.6+, there is no need to uninstall the previous +version first. All you need to do is close Anki if it is open, and then follow +the installation steps above. Your cards will be preserved when you upgrade. + +If upgrading from an Anki version before 2.1.6, or switching from the standard +to the alternate version or vice versa, we recommend uninstalling the old +version first, which will remove Anki's program data, but not delete your card +data. + +If you wish to downgrade to a previous version, please make sure you +[downgrade first](http://changes.ankiweb.net). + +## Add-on Compatibility + +Some add-ons have not been updated to support the latest Anki release yet. If an +add-on you depend on has not been ported to the latest release yet, you may have +more luck with 2.1.44 from the [releases +page](https://github.com/ankitects/anki/releases). + +## Problems + +If you encounter any issues when installing or starting Anki, please see the +following links on the left. + diff --git a/src/platform/windows/permission-problems.md b/src/platform/windows/permission-problems.md new file mode 100644 index 0000000..23a6193 --- /dev/null +++ b/src/platform/windows/permission-problems.md @@ -0,0 +1,36 @@ +# Windows permission problems + +**Permission Problems** + +If you receive "access denied" messages, some of Anki's files may be set to read only mode, meaning Anki is not able to write to them. + +To fix the problem, you can do the following: + +- in the search area of the start bar, type cmd.exe and hit enter +- in the window that opens, type the following and hit enter to see your username: + +whoami + +- type the following, hitting enter after each line, and replacing ____ (and keeping the :F part) with your username from the previous command + +cd %APPDATA% + +icacls Anki2 /grant ____:F /t + +That command should fix the permissions on Anki's data folder, and you should now be able to start the program. + +**Antivirus/Firewall/Anti-Malware** + +Some users have experienced "permission denied" or "readonly" errors that were caused by security software installed on their machine. You may need to add an exception for Anki, or try temporarily disabling the software to rule it out as the cause. Some users have reported that simply turning off their software did not fix the problem, and they either had to add an exception for Anki or uninstall the software. + +**Debugging Permission Problems** + +If problems persist after you've ruled out Antivirus and related programs, have performed the steps above to fix permissions, and don't use OneDrive, please run the following commands in cmd.exe, pressing enter after each one. + +whoami + +cd %APPDATA% + +icacls Anki2 /t + +Then please copy & paste or screenshot what you see, and post it to us in a support ticket. \ No newline at end of file diff --git a/src/platform/windows/startup-issues.md b/src/platform/windows/startup-issues.md new file mode 100644 index 0000000..86b5326 --- /dev/null +++ b/src/platform/windows/startup-issues.md @@ -0,0 +1,93 @@ +# Windows startup issues + + + +## No error, but app does not appear + +Recently there have been some reports of Anki failing to appear, without +any error message showing up. If you run into this situation, you can either: + +- Install the [latest windows-qt6 beta](https://apps.ankiweb.net/downloads/beta/?C=N&O=D) (try qt5 if you have add-on compatibility issues). +- Or you can try [adjusting your decimal separator](https://forums.ankiweb.net/t/windows-update-broke-anki/1822/75) if it is not a period. +- Or you can try the old 2.1.35-alternate build of Anki. + +## Windows updates + +When starting Anki, you may receive a message like the following: + +- *Error loading Python DLL* +- *The program can't start because api-ms-win.... is missing* +- *Failed to execute script runanki* +- *Failed to execute script pyi_rth_multiprocessing* +- *Failed to execute script pyi_rth_win32comgenpy* + +These errors are usually because your computer is missing a Windows update +or Windows library. + +Please open Windows update, and ensure your system has all updates installed. +If any needed to be installed, please restart your device after installing. + +## Windows 7/8 + +On Windows 7/8, you may need to manually install extra updates. Please try: + +- +- +- +- + +## Video driver issues + +Please see [display issues](./display-issues.md). + +## Multiple displays + +If you get a *LoadLibrary failed with error 126*, this may be caused by the +toolkit Anki is built on having trouble with [multiple +displays](https://forums.ankiweb.net/t/error-126-on-open-anki-desktop/13967) + +## Antivirus/firewall software + +Third-party software on your machine may prevent Anki from loading. You can +try adding an exception to Anki, or temporarily disabling your antivirus/firewall +to see if it helps. + +## Admin access + +Some users have reported that Anki did not run for them until they right-clicked +on the Anki icon and chose "Run as administrator". Anki stores all of its data in +your user folder, and should not need administrator privileges, but it's something +you can try if you've exhausted other options. + +## Multiple Anki installations present after updating + +If the update process leaves you with multiple Anki installs (such as within +`C:\Program Files\Anki` and `C:\Program Files (x86)\Anki`), they may be left in a +non-working state, and Anki may refuse to start without showing an error message. + +Try uninstalling all copies - you may be able to do so with the Windows `Apps & +features` settings menu, or by running `uninstall.exe` in each Anki program +folder. Afterward, install Anki again. + +## Debugging + +Starting Anki from a terminal may reveal a bit more information about some +errors. After installing the latest Anki version and ensuring all Windows +updates are installed, instead of running Anki directly, use Start>Run +and type cmd.exe. When a console window appears, type + +```bat +cd \program files\anki & anki-console +``` + +Presumably Anki will fail to open like before, but it may reveal something about +what is causing the problem. + +## If all else fails + +If you are unable to start Anki after trying the above workarounds, you have +two remaining options: + +- You can try [running from Python](https://faqs.ankiweb.net/running-from-python.html). +- You can try an older Anki version built with an older toolkit, such as + 2.1.35-alternate, and 2.1.15. diff --git a/src/platform/windows/text-size.md b/src/platform/windows/text-size.md new file mode 100644 index 0000000..ad48839 --- /dev/null +++ b/src/platform/windows/text-size.md @@ -0,0 +1,21 @@ +# Text Size + +If you find the text is the wrong size, there are two environmental +variables you can try: + +- ANKI_NOHIGHDPI=1 will turn off some of Qt’s high dpi support + +- ANKI_WEBSCALE=1 will alter the scale of Anki’s web views (like the + deck list, study screen, etc), while leaving interface elements like + the menu bar alone. Replace 1 with the desired scale, such as 1.5 or + 0.75. + +On Windows you can add these to a batch file to make it easier to start +Anki. For example, create a file called startanki.bat on your desktop +with the following text: + + set ANKI_WEBSCALE=0.75 + start "Anki" "C:\Program Files\Anki\anki" + +After saving, you can double click on the file to start Anki with that +setting. diff --git a/src/preferences.md b/src/preferences.md index 7097990..70cb28e 100644 --- a/src/preferences.md +++ b/src/preferences.md @@ -48,6 +48,14 @@ note type (and opens the add window to the last-used note type when you choose Add). This may be more convenient if you always use a single note type for each deck. +**Default search text** +Allows you to customize the starting search text in the browser (eg, to start +with "deck:current"). + +**User interface size** +If you find that the interface elements are too small for you, you can +try to increase this setting. + ## Scheduling **Show next review time above answer buttons** @@ -79,6 +87,8 @@ setting of 4AM ensures that if you’re studying around midnight, you won’t ha two days' worth of cards shown to you in one session. If you stay up very late or wake up very early, you may want to adjust this to a time you’re usually sleeping. Note that the start of the next day is relative to your current timezone. +Also note that any cards that cross a day boundary [will appear at the start of +the day they are scheduled for](./deck-options.md#day-boundaries), just like review cards do. **Learn ahead limit** Tells Anki how to behave when there is nothing left to study in the current deck diff --git a/src/profiles.md b/src/profiles.md index b6bb543..f0595d5 100644 --- a/src/profiles.md +++ b/src/profiles.md @@ -19,3 +19,13 @@ profile A, and then importing it into profile B, repeating for any other decks in profile A, until everything is in profile B. AnkiDroid does not support profiles. + +## Profiles window +From the Profiles window (accessible via File>Switch Profile from the main window), you can: +- Open / Add / Rename / Delete user profiles. +- Quit the program. +- Restore an [automatic backup.](./files.md#backups) +- Downgrade your collection, which is necessary if you want to open it with +an earlier Anki release. If you skip this step, you may get an error message +when opening your collection in an older Anki version, and you will need to +return to this version, downgrade, then try again. diff --git a/src/resources.md b/src/resources.md index 6b84683..f5124b3 100644 --- a/src/resources.md +++ b/src/resources.md @@ -10,3 +10,6 @@ as a series of tweets. Some medical students have banded together to make a paid-for guide focusing on the use of Anki in medical school: + +Soren Bjornstad has written [a series of extensive articles](https://controlaltbackspace.org/categories/memory/) +about memory, SRS and how to use Anki effectively. diff --git a/src/searching.md b/src/searching.md index 9e0545e..c3efc91 100644 --- a/src/searching.md +++ b/src/searching.md @@ -119,7 +119,7 @@ find notes in a field starting with "fr". Requires Anki 2.1.24+ or AnkiMobile 2. ## Tags, decks, cards and notes `tag:animal` -find notes with the tag "animal" +find notes with the tag "animal", or subtags like "animal::mammal" `tag:none` find notes with no tags @@ -252,6 +252,15 @@ cards with a green flag `flag:4` cards with a blue flag +`flag:5` +cards with a pink flag + +`flag:6` +cards with a turquoise flag + +`flag:7` +cards with a purple flag + ## Card properties `prop:ivl>=10` @@ -383,8 +392,8 @@ a minimum of escaping is required to prevent ambiguity: `nid:123` all cards of the note with note id 123 -`cid:123` -the card with card id 123 +`cid:123,456,789` +all cards with card ids 123, 456 or 789 Note and card IDs can be found in the [card info](stats.md) dialog in the browser. These searches may also be helpful when doing add-on diff --git a/src/stats.md b/src/stats.md index 6765c30..3ecccdd 100644 --- a/src/stats.md +++ b/src/stats.md @@ -5,7 +5,8 @@ ## Card Info You can display information about a card by using the Cards>Info menu item, -or by right-clicking on the card and then selecting **Info**. +by right-clicking on the card and then selecting **Info**, or by pressing +I on the review screen. Most of the displayed information should be self-explanatory. A few notes: **Position** @@ -25,26 +26,25 @@ card with the "Good" button. ## Statistics The statistics window is accessed by clicking on **Stats** button at the -top of the main window, or by pressing T. The statistics +top of the main window, or by pressing T. The statistics window will show statistics from the currently selected deck and any -subdecks. If you click on "collection" on the bottom left, statistics -will be shown for your entire collection instead. On 2.1.28+, additionally, -you can display graphs for arbitrary searches by adding filters in the -search box. +subdecks. If you select the checkbox "collection" at the top, statistics +will be shown for your entire collection instead. You can also display graphs +for arbitrary searches by adding filters in the search box at the top (2.1.28+). -Anki 2.1.28+ introduces redesigned graphs. The old graphs are currently still -accessible with a Shift-click on the Stats button. +(Anki 2.1.28+ introduced redesigned graphs. The old graphs are currently still +accessible with a Shift-click on the Stats button.) -For Anki 2.1.28+, by default Anki will show you statistics for the previous year. +By default, Anki 2.1.28+ will show you statistics for the last 12 months. You can change this to all history scope or deck life scope at the top. (The -"today" section at the top is of course unaffected by this selection.) +"today" section at the top remains of course unaffected by this selection.) -For older versions of Anki, by default Anki will show you statistics for +Older versions of Anki will by default show you statistics for the previous month. You can change this to a year scope or deck life scope -at the bottom. (The “today” section at the top is of course unaffected +at the bottom. (Again, the “today” section at the top is unaffected by this selection.) -Clicking on "Save PDF" will save an PDF document of the statistics to a file +Clicking on "Save PDF" at the bottom will save a PDF document of the statistics to a file on your desktop to make it easy to share your statistics with others. When you delete notes, their review history is maintained in Anki. It @@ -87,7 +87,7 @@ multiple reviews if it needed to be seen multiple times, and a learning card answered also counts as a “review.” A couple of the stats whose meaning may not be immediately obvious: -**Again count** +**Again Count** This is the number of reviews that you have failed (i.e., pressed Again on). The correct percentage listed afterwards is the number of cards you did 'not' fail divided by the total number of cards you studied. @@ -109,7 +109,7 @@ bottom of the window. ## The Graphs -**Forecast** +**Future Due** This graph shows an estimated number of reviews that will be due on a given day in the future if you learn no new cards and fail no cards. The bars and the left axis show the number of cards due on each day if you @@ -119,7 +119,7 @@ Note that the forecast graph does not count reviews that are currently overdue, so if you have a large backlog, the overdue cards will not be displayed. -**Review Count** +**Reviews** This graph counts the number of card reviews you have done. The bars may correspond to days, weeks, or months, depending on the time period you’ve selected at the bottom of the screen. The differently colored @@ -131,12 +131,19 @@ cumulative total for each type of review as time progresses across the graph (so at 0 days, it would display the number for the entire time period displayed on the graph). +**Card Counts** +This pie chart shows what percentage of your deck or collection consists +of mature, unseen, young/learn, and suspended cards. If you wish to +calculate a more precise percentage, the key shows the exact number of +cards in each section, and the total number of cards is displayed to the +side. + **Review Time** This graph works exactly like Review Count, except that it deals with the amount of time you spent on each card rather than the number of cards answered. -**Intervals** +**Review Intervals** This graph displays the number of cards that have a given interval (the delay between two reviews). The line and the right axis tell you what percentage of your cards have an interval of less than or equal to the @@ -158,13 +165,6 @@ Easy button while studying learning/new, young, and [mature](stats.md#types-of-cards) cards. Anki also displays the percentage of correct reviews for each type of card. -**Cards Types** -This pie chart shows what percentage of your deck or collection consists -of mature, unseen, young/learn, and suspended cards. If you wish to -calculate a more precise percentage, the key shows the exact number of -cards in each section, and the total number of cards is displayed to the -side. - ## Manual Analysis If you’re interested in getting information from your statistics other @@ -228,6 +228,6 @@ The amount of time (in milliseconds) you spent on the question and answer sides of the card before selecting an ease button. **type** -This is 0 for learning cards, 1 for review cards, 2 for relearn cards, +This is 0 for learning cards, 1 for review cards, 2 for relearning cards, and 3 for early "cram" cards (cards being studied in a filtered deck when they are not due). diff --git a/src/studying.md b/src/studying.md index 8319a44..9c046c4 100644 --- a/src/studying.md +++ b/src/studying.md @@ -10,26 +10,21 @@ Заучивание карточек в Anki осуществляется в пределах выбранной в настоящий момент колоды и любых подколод которые она содержит. -На экране колод ваши колоды представлены в виде списка. В нем присутствуют два -числовых столбца: 'К просмотру' и 'Новые'. 'К просмотру' — это количество -ожидающих повторения и уже разучиваемые карточки. 'Новые' — это количество -новых карточек, которые подготовлены к заучиванию в этот день. - -При нажатии на колоду она станет 'текущей колодой' и Anki переключится на экран -изучения. Вы можете вернуться к списку колод, чтобы изменить выбранную в данный -момент колоду в любое время, нажав на 'Колоды' в верхней части главного окна. -(Можно также использовать действие Учить колоду для выбора новой колоды с -клавиатуры или нажать клавишу 's' для изучения выбранной в данный момент -колоды.) - -Можно нажать кнопку шестерёнки справа от колоды, чтобы переименовать или удалить -колоду, изменить её параметры или [экспортировать](exporting.md) её. - -Со старым планировщиком, если в колоде имеются подколоды, карточки отобразятся из [каждой колоды по -очереди](studying.md#Порядок-отображения). - -С [новым планировщиком](https://faqs.ankiweb.net/the-anki-2.1-scheduler.html), -если в колоде имеются подколоды, карточки для повтора теперь берутся сразу со всех дочерних колод. Лимит показов дочерних колод игнорируется — применяется только лимит колоды, на которую вы щелкнули. +On the decks screen, your decks will be displayed in a list. There are +three columns. 'New' is the number of new +cards that are ready to be learnt that day. The second column shows +the number of cards currently in learning. 'Due' is the count of waiting +reviews. + +When you click on a deck, it will become the 'current deck', and Anki +will change to the study screen. You can return to the deck list to +change the currently selected deck at any time by clicking on “Decks” at +the top of the main window. (You can also use the Study +Deck action in the menu to select a new deck from the keyboard, or you +can press the s key to study the currently selected deck.) + +You can click the gears button to the right of a deck to rename or +delete a deck, change its [options](deck-options.md), or [export](exporting.md) it. ## Общие сведения об изучении @@ -49,7 +44,8 @@ Чтобы начать сеанс заучивания, нажмите кнопку **Учить**. Anki будет показывать вам карточки до тех пор, пока запланированные на сегодня карточки не закончатся. -В процессе изучения можно вернуться к обзору, нажав клавишу "s" на клавиатуре. +While studying, you can return to the overview by pressing the s key +on your keyboard. ## Вопросы @@ -64,47 +60,49 @@ сообщить Anki, на сколько точно вы запомнили. Если вы не уверены в точности сравнения ответов, вы можете указать Anki [предлагать вам набирать ответ с клавиатуры](templates/fields.md#Проверка-своего-ответа), а не просто показывать его вам. -Количество кнопок, доступных для оценки ответа, зависит от того, является ли -карточка 'изучаемой' или 'повторяемой'. +## Learning/Relearning Cards -## Обучение +When learning new cards, or when relearning cards that you have +forgotten, Anki will show you the cards one or more times to help you +memorize them. Each time is called a 'learning step'. By default there +are two steps: 1 minute and 10 minutes. You can change the number of +steps and the delays between them in the [deck options](deck-options.md#new-cards). -При изучении новых или переучивании забытых карточек, Anki будет показывать -карточки по одному или нескольку раз, чтобы помочь вам их запомнить. Каждый -такой показ называется 'обучающий шаг'. По умолчанию установлено два -шага: 1 минута и 10 минут. Количество и продолжительность таких шагов можно -изменить в [настройках колоды](deck-options.md). - -В процессе обучения доступны три кнопки оценки: +There are four rating buttons when learning: **Снова** — перемещает карточку обратно к первому шагу. -**Хорошо** — перемещает карточку на следующий шаг. Если карточка была на -последнем шаге, то она переводится [прим. перев. _из изучаемой_] в повторяемую -карточку (она 'выпускник' (англ. _graduate_)). По умолчанию, карточка достигнув -конца обучающих шагов, будет показана снова на следующий день, затем задержки -между показами будут увеличиваться (смотрите следующий раздел). +**Hard** repeats the current step after the first step, and is the average +of Again and Good on the first step. + +**Good** moves the card to the [next step](deck-options.md#learning-steps). If the card was on the final +step, the card is converted into a review card (it 'graduates'). By +default, once the card has reached the end of the learning steps, the +card will be shown again the next day, then at increasingly long delays +(see the next section). -**Легко** — немедленно переводит карточку в повторяемую, даже если остались -ещё шаги. По умолчанию, карточка будет показана повторно через 4 дня, затем -задержки между показами будут увеличиваться. В старом планировщике, кнопка -"лёгко" не будет показана, если вы в режиме переучивания, и это задаст тот же -интервал, что и "хорошо". С [новым планировщиком](https://faqs.ankiweb.net/the-anki-2.1-scheduler.html), когда карточки в режиме переучивания, кнопка "легко" увеличивает -интервал на 1 день. +**Easy** immediately converts the card into a review card, even if there +were steps remaining. [By default](deck-options.md#easy-interval), the card will be shown again 4 days +later, and then at increasingly long delays. In the v1 scheduler, the "Easy" button will not be +shown if you are in relearning mode as it would give the same interval +as “Good.” With the [v2 scheduler+](https://faqs.ankiweb.net/the-anki-2.1-scheduler.html), +when cards are in relearning, the "Easy" button boosts the interval by 1 day. Когда карточки показываются в первый раз, они начинают на первом шаге. Это означает, что ответив **Хорошо** на карточке с первого раза покажет её ещё раз через 10 минут, а первый шаг в 1 минуту будет пропущен. Если вы нажмёте Снова, карточка вернется через 1 минуту. -Вы можете использовать клавиши 1, 2 и 3 на клавиатуре, для выбора конкретной -кнопки, где 1 — это **Снова**. Нажатие клавиши пробела выбирает **Хорошо**. +You can use the 1, 2, 3 and 4 keys on your keyboard to select a particular +button, where 1 is **Again**. Pressing Space or Enter will select +**Good**. -Если нет других карточек для показа, Anki снова покажет изучаемые карточки, -даже если их задержка полностью не закончилась. Если вы предпочитаете ждать -всю обучающую задержку, вы можете изменить поведение в [настройках](preferences.md). +If there are no other cards to show you, Anki will show learning cards +again even if their delay has not elapsed completely. If you’d prefer to +wait the full learning delay, you can change this behaviour in +[Preferences>Scheduling>Learn Ahead Limit](preferences.md). -## Повторение +## Review Cards Когда карточка уже была изучена и готова к повторению, есть четыре кнопки для оценки ответа: @@ -114,49 +112,59 @@ раздел [забытые](deck-options.md#Забытые) для получения более подробной информации о том, как обрабатываются забытые повторения. -**Трудно** — показывает карточку с чуть большей задержкой, чем в прошлый раз -и указывает Anki чаще показывать карточку в будущем. +**Hard** by default, shows the card at a [slightly longer delay](deck-options.md#hard-interval) +than last time, and tells Anki to show the card more frequently in the future. + +**Good** tells Anki that the last delay was about right, and the card +easiness doesn’t need to be adjusted down or up. At the [default starting +easiness](deck-options.md#starting-ease), the card will be shown again approximately 2 1/2 times longer +than the previous time, so if you had waited 10 days to see the card +previously, the next delay would be about 25 days. -**Хорошо** — сообщает Anki, что последняя задержка была примерно правильной и -лёгкость карточки не нуждается в уменьшении или увеличении. При значении -лёгкости по умолчанию, задержка перед следующим показом карточки будет примерно -в 2,5 раза дольше чем в предыдущий раз, так что если бы вы в прошлый раз ждали -10 дней, чтобы увидеть карточку, то следующая задержка составит около 25 дней. +**Easy** tells Anki you found the delay too short. The card will be +scheduled [further into the future than 'Good'](deck-options.md#easy-bonus), and Anki will schedule +the card less frequently in the future. Because 'Easy' rapidly increases +the delay, it’s best used for only the easiest of cards. Usually you +should find yourself answering 'Good' instead. -**Легко** — сообщает Anki, что вы сочли задержку слишком короткой. Карточка -будет запланирована дальше, чем при ответе 'Хорошо' и в последствии Anki будет -включать её в расписание чуть реже. Поскольку 'Легко' быстро увеличивает -задержку, она лучше всего подходит для, действительно, самых простых карточек. -Обычно вместо этого ответа, стоит использовать ответ 'Хорошо'. +As with learning cards, you can use 1, 2, 3 and 4 on the keyboard to select an +answer. Pressing the spacebar or Enter will select **Good**. -Как и с изучаемыми карточками, вы можете использовать клавиши 1-4 на клавиатуре -для выбора ответа. Нажатие клавиши пробела выбирает **Хорошо**. +See [Deck Options](deck-options.md) and the [FAQ](https://faqs.ankiweb.net/what-spaced-repetition-algorithm.html) +to learn more about how the algorithm works. -## Due Counts +## Due Counts Когда показывается только вопрос, Anki показывает в нижней части экрана три числа вроде 12 + 34 + 56. Они обозначают новые карточки, изучаемые карточки и повторяемые карточки. Если вы предпочитаете не видеть этих цифр, вы можете отключить их в настройках Anki. -В старом планировщике, считается количество _просмотров_ необходимое для -завершения всех карточек в этой очереди, а не количество самих _карточек_. Если -задано несколько шагов для забытых карточек, то число увеличивается более чем -на один, если вы не справились с карточкой, так как она должна быть показана -несколько раз. +In the v1 scheduler, the numbers count _reviews_ needed to finish all the +cards in that queue, not the number of _cards_. If you have multiple +steps configured for lapsed cards, the number will increase by more than +one when you fail a card, since that card needs to be shown several times. -В новом планировщике, считается количество _карточек_, так что число всегда -увеличивается на один, независимо от оставшихся шагов. +From the v2 scheduler, the numbers count _cards_, so the number will always +increase by one regardless of the steps remaining. Когда отображается ответ, Anki выводит примерное время следующего показа карточки над каждой кнопкой. Если вы предпочитаете не видеть оценок, вы можете отключить их в [настройках](preferences.md) Anki. -Кроме того, Anki случайным образом не много изменяет время следующего показа, -чтобы предотвратить случаи, когда карточки добавленные вместе и всегда -получавшие одинаковые оценки продолжали бы и дальше показываться одна за -другой. Эти изменения не отражаются в оценках времени, а применяются после -выбора кнопки. +## Fuzz Factor + +When you select an ease button on a review card, Anki also applies a small amount of random “fuzz” +to prevent cards that were introduced at the same time and given the same ratings +from sticking together and always coming up for review on the same day. This fuzz +will appear on the answer buttons when the [v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html) is enabled, so if +you are using a previous version and you’re noticing a slight discrepancy between +what you select and the intervals your cards actually get, this is probably the +cause. + +Learning cards are also given up to 5 minutes of extra delay so that they +don’t always appear in the same order, but answer buttons won't reflect that. It +is not possible to turn this feature off. ## Правка и ещё @@ -168,11 +176,11 @@ предоставляет несколько других операций, которые можно выполнить с текущей карточкой или записью: -- **Поставить флаг**: Ставит цветную метку на карточку или убирает её. Метки -будут отображаться во время изучения, а в окне Обзора можно выполнять поиск -отмеченных карточек. Это полезно, когда вы хотите выполнить некоторое действие -над карточкой позднее, например, когда вернётесь домой, поискать какое-нибудь -слово. +- [**Flag Card**](editing.md#using-flags): Adds a colored marker to the card, or toggles it off. Flags will appear during +study, and you can search for flagged cards in the Browse screen. This is useful +when you want to take some action on the card at a later date, such as looking +up a word when you get home. If you're using Anki 2.1.45+, you can also rename flags +from the [browser](browsing.md). - **Отложить карточку / запись**: Прячет карточку или все карточки записи от показа до следующего дня. (Если вы хотите вернуть карточки раньше, нажмите @@ -204,11 +212,10 @@ - **Сведения о карточке**: Отображает [статистику](stats.md#card-info) по карточке. -- **Отметить запись**: Добавляет текущей записи метку "marked", что позволяет -легко найти её в обозревателе. Это схоже с отметкой отдельных карточек, только работает с метками (англ. _tag_), поэтому, если в записи есть несколько -карточек, все они появятся в поиске по метке marked. Большинству пользователей -лучше использовать флаги — отметки, в основном, оставлены для совместимости с -более старыми версиями Anki. +- [**Mark Note**](editing.md#the-marked-tag): Adds a “marked” tag to the current note, so it can be easily found in the +browser. This is similar to flagging individual cards, but works with a tag +instead, so if the note has multiple cards, all cards will appear in a search +for the marked tag. Most users will want to use flags instead. - **Удалить запись**: Удаляет запись и все её карточки. @@ -231,16 +238,29 @@ "Французский", подколоды "Французский::Словарь" и "Французский::Моя тетрадь::Урок 1" также будут показаны. -Новые и повторяемые карточки Anki выбирает из расположенных в алфавитном -порядке колод. Так в приведенном выше примере, сначала вы увидите карточки -из колоды "Моя тетрадь", затем "Словарь", и, наконец "Французский". Это можно -использовать для управления порядком отображения карточек, помещая карточки с -большим приоритетом в колоды, находящиеся выше по списку. При компьютерной -сортировке текста по алфавиту, символ "-" идёт перед буквами алфавита, а "\~" -— после них [прим. перев. *но перед русскими. В русских (кириллических) -названиях колод вместо "\~" можно использовать знак "№"*]. Значит, вы можете -назвать колоду "-Французский", чтобы она отображалась первой, а другую — -"№Словарь", чтобы отображать её после всего остального. +The way Anki fetches cards from the decks depends on the algorithm used: + +- With the v1 scheduler, when a deck has subdecks, the cards will appear from [each deck in +turn](studying.md#display-order). + +- With the [v2 scheduler](https://faqs.ankiweb.net/the-anki-2.1-scheduler.html), +when a deck has subdecks, reviews are taken from all children decks +at once. The review limit of the child decks is ignored - only the limit of the +deck you clicked on applies. + +- With the [v3 scheduler](https://faqs.ankiweb.net/the-2021-scheduler.html) +each child deck's limit is also enforced, and you do not need to see the cards +in deck order either. See the [deck options](deck-options.md#review-sort-order) section of the manual for more information. + +By default, for new cards, Anki fetches cards from the decks in +alphabetical order. So in the above example, you would get cards first +from “French”, then “My Textbook”, and finally “Vocab”. You can use this +to control the order cards appear in, placing high priority cards in +decks that appear higher in the list. When computers sort text +alphabetically, the “-” character comes before alphabetical characters, +and “\~” comes after them. So you could call the deck “-Vocab” to make +them appear first, and you could call the other deck “\~My Textbook” to +force it to appear after everything else. Новые и повторяемые карточки выбираются отдельно, и Anki не будет ждать, пока закончатся обе очереди, прежде чем перейти к следующей колоде, так что @@ -279,6 +299,10 @@ Anki будет откладывать связанные карточки, ко имеет существенное значение. С другой стороны, заучивая карточку которая является изучаемой, любые новые/повторяемые карточки будут отложены. +Note: A card cannot be buried and suspended at the same time. Suspending a +buried card will unbury it. Burying a suspended card does not work on Anki +2.1.49+, whereas on earlier versions, it will unsuspend the card. + ## Клавиатурные сокращения Для большинства общих действий в Anki имеются клавиатурные сокращения. Многие @@ -316,5 +340,5 @@ Anki будет откладывать связанные карточки, ко Отвечая на карточки, некоторое время находившиеся в ожидании, Anki учитывает эту задержку при определении времени следующего показа карточки. Дополнительную -информацию смотрите в разделе про [алгоритм](faqs.md) интервальных повторений +информацию смотрите в разделе про [алгоритм](https://faqs.ankiweb.net/due-times-after-a-break.html) интервальных повторений Anki. diff --git a/src/syncing.md b/src/syncing.md index 73ac60d..c3df90e 100644 --- a/src/syncing.md +++ b/src/syncing.md @@ -166,7 +166,7 @@ you with. ## Proxies If you need a proxy to access the internet, Anki should automatically -pick up your system proxy settings if you’re on Windows or OS X, and +pick up your system proxy settings if you’re on Windows or macOS, and will honour the HTTP_PROXY environment variable if you’re on another platform. diff --git a/src/templates/fields.md b/src/templates/fields.md index dc4c9bb..5660b7a 100644 --- a/src/templates/fields.md +++ b/src/templates/fields.md @@ -75,7 +75,7 @@ the following in your card template: {{tts en_US:Front}} -On Windows, MacOS, and iOS, Anki will use the OS’s built in voices. On +On Windows, macOS, and iOS, Anki will use the OS’s built in voices. On Linux, no voices are built in, but voices can be provided by add-ons, such as [this one](https://ankiweb.net/shared/info/391644525). diff --git a/src/templates/styling.md b/src/templates/styling.md index cc36b10..6bcd835 100644 --- a/src/templates/styling.md +++ b/src/templates/styling.md @@ -208,6 +208,24 @@ make them smaller and colored, you could use the following: } ``` +## Text Direction + +If you use a language that is written right-to-left, such as Arabic or Hebrew, +you can add the CSS `direction` property to the .card section for correct display during review: +```css +.card { + direction: rtl; +} +``` + +This will change the direction of the entire card. You can change the direction +of only certain fields by wrapping their references in some HTML: + +
{{Front}}
+ +To change the direction of fields in the editor, please see +the [editing](../editing.md#customizing-fields) section. + ## Other HTML Your templates can contain arbitrary HTML, which means that all the @@ -358,7 +376,9 @@ template: ## Javascript As Anki cards are treated like webpages, it is possible to embed some -Javascript on your cards via the card template. +Javascript on your cards via the card template. For a good reference +please read [this post](https://forums.ankiweb.net/t/card-templates-user-input-101-buttons-keyboard-shortcuts-etc-guide/13756) +in the forums. Because Javascript is an advanced feature and so many things can go wrong, **Javascript functionality is provided without any support or