Skip to content

KaiOhno/LearnJapanese

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Japanese Hiragana & Katakana Learning Tool

This project is an interactive web-based tool designed to help users learn Japanese Hiragana and Katakana characters. It presents a simple, user-friendly interface where learners can test their knowledge of these Japanese scripts by selecting the correct Romanized translations of displayed characters.

Features

  • Interactive Quiz Format: Users are presented with a Japanese character and must choose the correct Romanized translation from three options.
  • Progress Tracking: A progress bar decreases over time, adding a sense of urgency and gamifying the learning experience.
  • Responsive Design: The tool is designed to be responsive, ensuring a seamless experience across various devices and screen sizes.
  • Dark Mode: Users can switch to a dark mode to reduce eye strain, especially in low-light conditions.

How It Works

  • Displaying Characters: The application randomly selects a Hiragana or Katakana character and displays it to the user.
  • Choosing Answers: Users click on one of the three buttons below the character to choose their answer.
  • Feedback on Selection: The chosen button changes color based on the correctness of the answer - green for correct and red for incorrect. A shake animation is played for an incorrect answer.
  • Progress Bar: A timer bar at the top of the quiz container adds time pressure, decreasing over a set time frame.
  • Dark Mode Toggle: A switch is provided in the top right corner for users to toggle dark mode on or off.

Technologies Used

  • HTML
  • CSS
  • JavaScript

Setup and Installation

  1. Clone the repository from GitHub.
  2. Open the index.html file in a modern web browser to start using the application.

Future Enhancements

  • Add a larger pool of characters.
  • Implement a scoring system.
  • Save user progress across sessions.

Contributing

Contributions to enhance this learning tool are welcome. Please follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch for your feature (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a pull request.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Your Name - Your Email

Project Link: https://github.com/KaiOhno/LearnJapanese

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors