kuhyx/testsAndMisc
1
0
Fork 0
mirror of https://github.com/kuhyx/testsAndMisc.git synced 2026-07-04 18:43:08 +02:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
2b07333b60
testsAndMisc/python_pkg/anki_decks/warsaw_districts/README.md
Krzysztof kuhy Rudnicki 93426490c4 Consolidate all Anki deck generators into python_pkg/anki_decks/ 
Move warsaw_bridges, warsaw_districts, warsaw_landmarks, warsaw_metro,
warsaw_osiedla, warsaw_streets, and car_brand_logos into the existing
python_pkg/anki_decks/ directory alongside the polish_* generators.

Also move preview_all.html into anki_decks/.

Update all import paths, filesystem references in geo_data.py,
docstrings, READMEs, test imports, and .gitignore accordingly.
2026-02-07 15:32:23 +01:00

2.4 KiB
Raw Blame History

Warsaw Districts Anki Generator

Generate Anki flashcards for learning the 18 districts (dzielnice) of Warsaw, Poland.

Features

  • Generates flashcards for all 18 Warsaw districts
  • Uses real district boundaries from OpenStreetMap data
  • Front of card: Map showing the full city with only the target district's border highlighted in bold
  • Back of card: District name in Polish
  • Self-contained .apkg file with embedded images
  • Compatible with AnkiWeb and AnkiDroid

Data Source

District boundaries are sourced from andilabs/warszawa-dzielnice-geojson, which provides accurate OpenStreetMap-based GeoJSON data for all Warsaw districts.

Installation

Install dependencies using your preferred method:

Using pyenv (recommended)

pyenv install 3.10  # or later
pyenv shell 3.10
pip install matplotlib genanki geopandas

Using pipx

pipx install --python python3.10 matplotlib genanki geopandas

Using system package manager (Arch Linux)

sudo pacman -S python-matplotlib python-geopandas
pip install genanki

Using pip directly

pip install matplotlib genanki geopandas

Usage

Generate flashcards

# From the repository root
python -m python_pkg.anki_decks.warsaw_districts.warsaw_districts_anki

This creates:

  • warsaw_districts.apkg - Self-contained Anki package with all images embedded

Custom options

# Custom output file
python -m python_pkg.anki_decks.warsaw_districts.warsaw_districts_anki --output my_cards.apkg

# Custom deck name
python -m python_pkg.anki_decks.warsaw_districts.warsaw_districts_anki --deck-name "Warszawa - Dzielnice"

Importing into Anki

  1. Open Anki
  2. File → Import
  3. Select the generated warsaw_districts.apkg file
  4. Click Import

That's it! All images are already embedded in the .apkg file.

Warsaw Districts

The generator includes all 18 official districts of Warsaw:

  1. Bemowo
  2. Białołęka
  3. Bielany
  4. Mokotów
  5. Ochota
  6. Praga-Południe
  7. Praga-Północ
  8. Rembertów
  9. Śródmieście
  10. Targówek
  11. Ursus
  12. Ursynów
  13. Wawer
  14. Wesoła
  15. Wilanów
  16. Włochy
  17. Wola
  18. Żoliborz

Development

Running tests

pytest python_pkg/warsaw_districts/tests/

Code quality

ruff check python_pkg/warsaw_districts/

License

Same as the parent repository.