Geography flashcard deck for Anki
π To upgrade from v5.1, please follow the special upgrade instructions on the wiki, which include steps to remove one of the notes from the deck. To upgrade from an earlier version, please refer to the relevant instructions. If you run into issues, let us know in the v5.2 discussion thread.
viewBox to flag of Eswatini #578Long time no see! π Hope you're ready for a big release, with no fewer than four new translations! π
π To upgrade from v5.0, please follow the instructions in the README. If you're still on v4.1 or earlier, please follow the special upgrade instructions on the wiki instead.
β οΈ For inconsequential reasons, CrowdAnki will bring up the "Change Note Type" dialog, so be careful to select the Ultimate Geography note type in the drop-down menu. Apart from that, everything should go smoothly. If you run into issues, please let us know in the v5.1 discussion thread.
DARS acronym from country name of Sahrawi Arab Democratic Republic #547UG::European_Union from note of the United Kingdom #536If you use a translated version of the deck (i.e. any language other than English), please read the upgrade instructions carefully! You will need to check a few things to make sure that you can upgrade safely.
Additionally, the removal of the European Union's capital (see below) leads to the removal of two cards from the deck. After upgrading, open Anki, go to the Tools menu, and select Empty Cards.... The dialog that opens should indicate that two cards are now empty and can be removed. Click Delete to confirm their removal.
Following the introduction of the new inclusion rules for seas and straits in v4.1, this release brings no fewer than 9 new seas to the deck. Shout out to @aplaice for making the beautiful maps and upstreaming them to Wikimedia! π
After upgrading to this release, you will be able to install multiple translated versions of the deck within the same Anki profile.
This was already possible, except for a couple of language combinations: English+Norwegian and Spanish+French. These deck combinations were problematic because they shared the same sets of note identifiers (GUIDs), which meant that the decks would overwrite each other on import.
To avoid surprises, we decided to resolve this situation by making sure that every deck has its own set of unique note identifiers. We did this by regenerating the GUIDs of the French and Norwegian decks. If you use one of these decks and don't want to lose your progress, you will need to run a debug console script in Anki before upgrading to v5.0. This procedure is explained in details in the upgrade instructions on the wiki.
sources.csv #445 #468requirements.txt, use pipenv in CI, and add build script to Pipfile to allow building the deck with pipenv run build #413 #414Big thanks to all the awesome people who contributed to this release, notably @aplaice, @zserghei, @ohare93, @josealberto4444, @x51mon, @jamesnelmore, @lennardnl, @Vages, @emiham, @axelboc, as well as everyone who contributed through issues and discussions!
This release is a huge step for UG since we've finally migrated to a new deck manager, Brain Brew π§ :beer:, awesomely made by @ohare93! The old deck manager, Anki Deck Manager, served us well, but with so many requests for new translations, having a single, gigantic CSV file was no longer viable. (Note that this does not change anything to the upgrade process, which still relies on the CrowdAnki add-on.)
Following the migration, our contributors did not waste any time: in just two weeks, the deck welcomed no fewer than four new translations, bringing the total to nine! :tada: This release also brings seven new cards and maps, courtesy of @aplaice and the inclusion rules for political entities introduced in v4.0. Last but not least, we've also defined a new set of inclusion rules for seas and straits as explained below.
As part of issue #137, we have now defined and documented clear sources and inclusion rules for a few types of water bodies, namely: oceans, marginal seas, straits, channels and passages. You can find these rules in CONTRIBUTING.md and see them in action in the spreadsheet called physical-entities.xlsx, at the root of the repository.
The new rules will add 33 seas, 9 straits and 1 channel to the deck, and they'll remove only 2 seas. This will eventually result in a net increase of 41 cards with maps, but this may take a while.
It's time for a new MAJOR version! π
Why all the fuss? In short, we've removed some of the most obscure content from the deck by defining precise inclusion rules for political entities. We hope you'll find those rules to be sensible and the deck to be more enjoyable to learn as a result. Read on to learn more and to find out how to upgrade the deck (don't worry, we have a solution for everyone π).
Why was the British Indian Ocean Territory included but not Akrotiri and Dhekelia (cf. #221)? Why was Bali included with a capital and flag, while other provinces of Indonesia weren't included at all? What was Mount Athos doing in there!? These were all fair questions...
Until now, there were no rules guiding which political entities were or were not included in the deck. Content was being added from time to time without much opposition, and content was very rarely removed (because removing something without a clear reason seemed unwise). On top of that, the content of the deck had never really been audited since its first v2 release, which inherited most of its content from the original shared deck. As a result, the deck, which was already quite bloated with small territories originally, was becoming even more bloated release after release, and therefore more and more difficult to master.
Over the course of lengthy discussions, started in #137, continued in #306, and concluded in #312, we decided to do something about it by coming up with precise, documented rules and criteria for inclusion of political entities. You can now find these rules in CONTRIBUTING.md and see them in action in the spreadsheet called political-entities.xlsx, at the root of the repository.
The new rules lead to the removal of a significant number of capitals (41), flags (38) and maps (17), for a total of 137 cards in the standard deck, thus justifying a major release. 17 notes are fully removed and 28 have had their capital and/or flag removed. The new rules will also lead to the addition of 7 notes with maps only, which will happen in a future release (cf. #315).
Perhaps you've installed the deck recently, or you've been planning on learning the deck from scratch again? If so, the simplest way to upgrade to v4 is to perform a clean import, as described in the README.
We've made a special "legacy" deck for you that you can import in order to move the removed notes out of the main deck. Back up your deck if you want, and just follow these few steps:
Ultimate_Geography_Legacy.zip.We understand that the changes may not be to everyone's liking. If you don't want to lose any content, follow the steps in the previous section except for step 7 (don't delete the legacy deck). You'll then be able to rename the legacy deck and review it in parallel to the main deck. You progress will be kept on notes that were fully removed from the main deck, but not on those that were removed only partially -- those will appear as "new" cards in the legacy deck. We know it's not a perfect solution but we hope it's a reasonable compromise.
Note that it is safe to move the cards from the legacy deck back into the main deck -- they won't get removed or overridden on future upgrades. However, please beware that these notes will not be maintained by UG, so their content may become outdated.
UG::West_Africa and UG::East_Africa #244 #298 #304UG::America and UG::North+Central_America, and adding UG::North_America #244 #295 #300UG::Europe β UG::North_America #297Ug::North_America tag in Custom study section #300Another big release! Highlights include two new translations (French and Spanish), brand new maps for water bodies, and plenty of new supplementary information. :tada: :beers:
A whole lot happened in 6 months! Better maps, cloze-style templates, a Norwegian version, list of image sources and licences... The list goes on. Big shout-out to everyone who helped out, you rock π€ πΈ
UG:Mediterranean tag #92sources.csv #2TRANSLATION_SOURCES.md #139Thanks to the migration to Anki Deck Manager in v3.0, the long-awaited ability to create variations and translations of the original deck has become a reality. As of v3.1, the deck now officially has three alternative versions:
The deck is now managed with Anki Deck Manager. This clever tool brings a new build process that makes the deck a lot easier to maintain and extend. π It opens the door to some awesome projects that have been brewing for a while, like translating the deck into other languages, adding more fields, and publishing alternative versions of the deck with fewer or more cards. The Ultimate Geography deck has a bright future! βοΈ
Alas, great things don't come free, and that's why this release is branded v3.0. By upgrading from v2.x, you will lose all your progress and will have to start studying from scratch. π