Neko Kanji Quiz

Welcome to the Neko Kanji Quiz application! This is a web-based quiz designed to help users practice reading kanji characters for the Japanese Language Proficiency Test (JLPT) levels N5 to N1.

Demo

Neko Kanji

Features

• Quiz Levels: Choose from JLPT levels N5 to N1 to customize your quiz experience.
• Time Attack Mode: Test your speed and accuracy with the time attack mode.
• Hints: Optionally include hints to display the meaning of each kanji character.
• Score Tracking: Keep track of your quiz scores and history.
• Responsive Design: The application is designed to work seamlessly across different devices and screen sizes.

Getting Started

To use the Neko Kanji Quiz application, simply follow these steps:

1. Select Quiz Options: Choose your preferred JLPT level, number of questions, and enable/disable hints and time attack mode.
2. Start Quiz: Click on the "Start Quiz" button to begin your quiz session.
3. Answer Questions: Type your answer for each kanji character displayed and press enter to submit and receive instant feedback.
4. View Results: After completing the quiz, view your score, time spent, and any incorrect attempts.
5. Retry or Customize: Choose to retry the quiz with different options or customize your quiz settings.

Screenshots

Caption: Main menu of the Neko Kanji Quiz application.

Caption: Quiz interface with a kanji character displayed.

Development

The Neko Kanji Quiz application is developed using HTML, CSS, and JavaScript. The quiz data is fetched from JSON files containing kanji characters and their readings.

Setup

1. Clone the repository: git clone https://github.com/yorunohikari/Neko-Kanji-Quiz.git
2. Open index.html in your preferred web browser.

Contributing

Contributions are welcome! If you'd like to contribute to the project, please follow these steps:

1. Fork the repository.
2. Create a new branch: git checkout -b feature/new-feature
3. Make your changes and commit them: git commit -m 'Add new feature'
4. Push to the branch: git push origin feature/new-feature
5. Submit a pull request.

Credits

• Kanji data sourced from [https://github.com/jamsinclair/open-anki-jlpt-decks].

License

See the LICENSE file for details.