Awesome
<p align="center"><img src="screenshots/demo1.gif"></p> <h2 align="center">Cloze Overlapper for Anki</h2> <p align="center"> <a title="Latest (pre-)release" href="https://github.com/glutanimate/cloze-overlapper/releases"><img src ="https://img.shields.io/github/release-pre/glutanimate/cloze-overlapper.svg?colorB=brightgreen"></a> <a title="License: GNU AGPLv3" href="https://github.com/glutanimate/cloze-overlapper/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GNU AGPLv3-green.svg"></a> <a title="Rate on AnkiWeb" href="https://ankiweb.net/shared/info/969733775"><img src="https://glutanimate.com/logos/ankiweb-rate.svg"></a> <br> <a title="Buy me a coffee :)" href="https://ko-fi.com/X8X0L4YV"><img src="https://img.shields.io/badge/ko--fi-contribute-%23579ebd.svg"></a> <a title="Support me on Patreon :D" href="https://www.patreon.com/bePatron?u=7522179"><img src="https://img.shields.io/badge/patreon-support-%23f96854.svg"></a> <a title="Follow me on Twitter" href="https://twitter.com/intent/user?screen_name=glutanimate"><img src="https://img.shields.io/twitter/follow/glutanimate.svg"></a> </p>List memorization made easy!
This is an add-on for the spaced-repetition flashcard app Anki. It facilitates memorizing enumerations, lists, or any other type of sequential information by breaking the sequence up into cards where each item serves as the context cue for the next.
Table of Contents <!-- omit in toc -->
<!-- MarkdownTOC levels="1,2,3" --> <!-- /MarkdownTOC -->Background
Memorizing lists and enumerations has always been a particularly difficult part of studying flashcards. Good flashcards follow the minimum information principle, where each card is kept as short as possible. Sequential information has unfortunately always somewhat eluded that basic principle because it is hard to break down into smaller chunks. Normally you would employ methods like grouping or categorizing to consolidate information, but with each item building upon the next, that does usually not work for sequences or enumerations.
One of the common recommendations in cases like this has always been to create overlapping flashcards, where each card's answer serves as the question prompt for next card in line. For an array of three list items A, B, C you would end up with three cards of the form A → B, B → C, and C → D. What results is chain of overlapping associations between each sequence node that can potentially improve the storage and retrieval strength of the entire sequence.
While this method is generally assumed to be quite effective, following it requires a significant time investment up-front that only few students are able or willing to make.
The Add-on
This is where Cloze Overlapper comes in. It takes care of all the arduous steps required to create these flashcards manually and provides you with a dead-simple workflow: You paste in the sequence or list, adjust the cloze generation settings, and let the add-on generate the cards for you.
More generally speaking, Cloze Overlaper provides Anki with a completely novel cloze system that can cover almost every use case you can think of, be it revealing each taxon of a classification system individually, or even gradually building up to an entire poem:
Due to working with the formatting tools that Anki provides itself, the cards generated by this add-on are fully compatible with all Anki platforms, smartphone apps included:
Installation
AnkiWeb <!-- omit in toc -->
The easiest way to install Cloze Overlapper is through AnkiWeb.
Manual installation <!-- omit in toc -->
Please click on the entry corresponding to your Anki version:
Note: Pre-compiled test builds for Anki 2.1 are now available on my Patreon. These will become public once testing is complete.
<details> <summary><i>Anki 2.1</i></summary>- Make sure you have the latest version of Anki 2.1 installed. Earlier releases (e.g. found in various Linux distros) do not support
.ankiaddon
packages. - Download the latest
.ankiaddon
package from my Patreon - From Anki's main window, head to Tools → Add-ons
- Drag-and-drop the
.ankiaddon
package onto the add-ons list - Restart Anki
- Go to Tools → Add-ons → Open add-ons folder
- Find and delete the
Cloze Overlapper.py
file if it already exists. - See if you can find a
cloze_overlapper
folder. If so:- If the folder contains a
meta.json
file, copy the file to a safe location. This will allow you to preserve your current settings. - Proceed to delete the
cloze_overlapper
folder
- If the folder contains a
- Download and extract the latest Anki 2.0 add-on release from my Patreon
- Move the extracted
Cloze Overlapper.py
andcloze_overlapper
into the add-ons folder - Optional: Place the
meta.json
file back into the directory if you created a copy beforehand. - Restart Anki
Documentation
The use of the add-on is documented in the Wiki section and a series of video tutorials on YouTube. More information may also be found in the AnkiWeb description.
Building
With Anki add-on builder installed:
git clone https://github.com/glutanimate/cloze-overlapper.git
cd cloze-overlapper
aab build
For more information on the build process please refer to aab
's documentation.
Contributing
Contributions are welcome! Please review the contribution guidelines on how to:
- Report issues
- File pull requests
- Support the project as a non-developer
License and Credits
Cloze Overlapper is Copyright © 2019 Aristotelis P. (Glutanimate)
With code contributions from: zjosua, (Thank you!)
I would like to extend my heartfelt thanks to everyone who has helped with testing, provided suggestions, or contributed in any other way!
I'd also like to thank:
- Piotr Wozniak for laying the theoretical groundwork for overlapping cloze deletions with his 20 rules of formulating knowledge
- Soren Bjornstad for giving me the inspiration for this add-on with his project AnkiLPCG, back when it was still a standalone module
Cloze Overlapper is free and open-source software. The add-on code that runs within Anki is released under the GNU AGPLv3 license, extended by a number of additional terms. For more information please see the LICENSE file that accompanied this program.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.
<b> <div align="center">The continued development of this add-on is made possible <br>thanks to my <a href="https://www.patreon.com/glutanimate">Patreon</a> and <a href="https://ko-fi.com/X8X0L4YV">Ko-Fi</a> supporters. <br>You guys rock ❤️ !</div> </b>