Skip to content

Commit 7fe646a

Browse files
committed
New big release
1 parent 613b80c commit 7fe646a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+2545
-1509
lines changed

README.md

Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ Welcome to the **World Geography Challenge** — an interactive and educational
1010
- 🤝 **Open Source**: Encourage contribution, learning, and community development.
1111
- 🔧 **Extensible**: Easily add your own questions or difficulty levels.
1212
- 🌐 **Accessible**: All code, comments, and UI text are in English for global reach.
13+
- 🌍 **Multilingual**: Supports English, Greek, and French for both UI and quiz content.
14+
- 🎵 **Customizable Music**: Choose from built-in tracks or play your own music file.
1315

1416
---
1517

@@ -20,23 +22,29 @@ Welcome to the **World Geography Challenge** — an interactive and educational
2022
- 📈 **Score Tracking**: Real-time updates to your score.
2123
- 🏆 **Leaderboard**: Compete with yourself or friends for high scores!
2224
- 🎵 **Background Music**: Choose from built-in tracks or add your own.
23-
- ⚙️ **Settings Menu**: Customize your experience.
25+
- ⚙️ **Settings Menu**: Customize your experience, including language and music selection.
2426
- 🧱 **Modular Code**: Clean file structure for easy maintenance and contributions.
27+
- 🌐 **Multilingual Support**: All quiz questions and UI elements are available in English, Greek, and French.
28+
- 🗂️ **Settings & Data in JSON**: User preferences and leaderboard data are stored in JSON for easy editing and portability.
2529

2630
---
2731

2832
## 🗂️ Project Structure
2933

3034
```
31-
📁 GeographyQuizApp/
32-
├── geograph_with_buttons_3.py # Main launcher
33-
├── easy.py, easy2.py ... easy10.py # Easy questions
34-
├── normal.py, ... normal10.py # Normal questions
35-
├── hard.py, ... hard10.py # Hard questions
36-
├── marks.py # Results screen & leaderboard
37-
├── settings.txt # Settings save
38-
├── data.json # Leaderboard data
39-
├── Project Overview.pdf # Full project documentation
35+
📁 World Geography Challenge/
36+
├── World_Geography_Challenge.py # Main launcher and UI logic
37+
├── easy.py, easy2.py ... easy10.py # Easy questions (multilingual)
38+
├── normal.py, ... normal10.py # Normal questions (multilingual)
39+
├── hard.py, ... hard10.py # Hard questions (multilingual)
40+
├── marks.py # Results screen & leaderboard
41+
├── extra_files/
42+
│ ├── settings.json # Settings (music, language)
43+
│ ├── language.txt # Current language selection
44+
│ ├── *.mp3 # Built-in music tracks
45+
│ └── *.ico # App icon
46+
├── data.json # Leaderboard data
47+
├── Project Overview.pdf # Full project documentation
4048
```
4149

4250
---
@@ -63,7 +71,7 @@ You can always download the latest version of the application without needing to
6371

6472
- [Python 3.x](https://www.python.org/)
6573
- [PyQt5](https://pypi.org/project/PyQt5/)`pip install PyQt5`
66-
- (Optional) [python-vlc](https://pypi.org/project/python-vlc/) for background music → `pip install python-vlc`
74+
- [python-vlc](https://pypi.org/project/python-vlc/) for background music → `pip install python-vlc`
6775

6876
#### Run the Application
6977

@@ -81,7 +89,7 @@ python World_Geography_Challenge.py
8189
## 🧪 Example Flow
8290

8391
- Choose your difficulty (Easy / Normal / Hard)
84-
- Answer the 10 multiple-choice questions
92+
- Answer the 10 multiple-choice questions (in your selected language)
8593
- See your score, correct/wrong answers
8694
- Check your position on the leaderboard
8795
- Play again or switch levels 🎮
@@ -94,9 +102,9 @@ Contributions are welcome — and beginners are encouraged!
94102

95103
### 🛠️ What You Can Do
96104

97-
- Add new quiz questions or difficulty levels
105+
- Add new quiz questions or difficulty levels (in all supported languages)
98106
- Improve UI/UX (themes, animations, layout)
99-
- Translate to other languages
107+
- Translate to other languages (add to the translation dictionaries)
100108
- Implement new game modes (e.g., timed mode, multiplayer)
101109
- Add accessibility features (keyboard support, colorblind mode)
102110
- Write unit tests for core logic
@@ -113,8 +121,8 @@ Contributions are welcome — and beginners are encouraged!
113121

114122
## 🧰 Files That Store Data
115123

116-
- `settings.txt`: Stores user preferences like music settings.
117-
- `skore.txt`: Keeps your most recent game score.
124+
- `extra_files/settings.json`: Stores user preferences like music and language settings.
125+
- `extra_files/language.txt`: Stores the currently selected language.
118126
- `data.json`: Tracks and stores leaderboard information.
119127

120128
---

0 commit comments

Comments
 (0)