mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-07-06 21:43:05 +02:00
112 lines
2.2 KiB
Markdown
112 lines
2.2 KiB
Markdown
|
# Warsaw Districts Anki Generator
|
||
|
|
|
||
|
|
Generate Anki flashcards for learning the 18 districts (dzielnice) of Warsaw, Poland.
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- Generates flashcards for all 18 Warsaw districts
|
||
|
|
- Front of card: Map showing only the district in question with its borders highlighted
|
||
|
|
- Back of card: District name in Polish
|
||
|
|
- Anki-compatible output format (semicolon-separated)
|
||
|
|
- Compatible with AnkiWeb and AnkiDroid
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
```bash
|
||
|
|
pip install matplotlib
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Generate flashcards
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# From the repository root
|
||
|
|
python -m python_pkg.warsaw_districts.warsaw_districts_anki
|
||
|
|
```
|
||
|
|
|
||
|
|
This creates:
|
||
|
|
- `warsaw_districts_anki.txt` - Anki import file
|
||
|
|
- `warsaw_districts_images/` - Directory with 18 PNG map images
|
||
|
|
|
||
|
|
### Custom options
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Custom output file and image directory
|
||
|
|
python -m python_pkg.warsaw_districts.warsaw_districts_anki \
|
||
|
|
--output my_cards.txt \
|
||
|
|
--image-dir my_maps
|
||
|
|
|
||
|
|
# Custom deck name
|
||
|
|
python -m python_pkg.warsaw_districts.warsaw_districts_anki \
|
||
|
|
--deck-name "Warszawa - Dzielnice"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Importing into Anki
|
||
|
|
|
||
|
|
1. Open Anki
|
||
|
|
2. File → Import
|
||
|
|
3. Select the generated `warsaw_districts_anki.txt` file
|
||
|
|
4. Copy all images from `warsaw_districts_images/` to your Anki profile's `collection.media` folder
|
||
|
|
- On Linux: `~/.local/share/Anki2/[Profile]/collection.media/`
|
||
|
|
- On Windows: `%APPDATA%\Anki2\[Profile]\collection.media\`
|
||
|
|
- On macOS: `~/Library/Application Support/Anki2/[Profile]/collection.media/`
|
||
|
|
5. Click Import
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
## Output Format
|
||
|
|
|
||
|
|
The generated file uses Anki's standard import format:
|
||
|
|
|
||
|
|
```
|
||
|
|
#separator:semicolon
|
||
|
|
#html:true
|
||
|
|
#deck:Warsaw Districts
|
||
|
|
#tags:geography warsaw poland
|
||
|
|
#columns:Front;Back
|
||
|
|
|
||
|
|
<img src="Bemowo.png">;Bemowo
|
||
|
|
<img src="Białołęka.png">;Białołęka
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
### Running tests
|
||
|
|
|
||
|
|
```bash
|
||
|
|
pytest python_pkg/warsaw_districts/tests/
|
||
|
|
```
|
||
|
|
|
||
|
|
### Code quality
|
||
|
|
|
||
|
|
```bash
|
||
|
|
ruff check python_pkg/warsaw_districts/
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
Same as the parent repository.
|