Skip to content

An educational app that will help you learn JLPT N5 vocabulary

License

Notifications You must be signed in to change notification settings

xPerSki/N5-Quizzler

Repository files navigation

N5-Quizzler

N5-Quizzler

With the use of N5 Quizzler, you can learn the language in a fun and simple way
Learn with flashcards, quizzes, and practice with automated exercises!

V2

How to Run

  • Launch server by running app.py
  • Open server at 127.0.0.1:5000
  • To close the server, simply stop app.py

Features

Features


Flashcards

Flashcards

  • Card will reveal the translation after you click it
  • If the word can be written with Kanji, it will be displayed below

Quizzes / Short Tests

Quizzes

  • Quiz will be generated based on your selected options
  • After clicking Create, it will save your quiz (& the answer key) in the exports/html folder

Practice

Practice

  • Translate the word and automatically get feedback if you were correct
  • (Recommended) Install a Japanese keyboard on your PC, as of version v2.0.1 there isn't any other option to type in Japanese

V1

Use Python/CLI to run the script: python N5_CLI.py
To display the options use python N5_CLI.py -h or python N5_CLI.py --help

Options

  • -n, --number                     Number of questions to generate (1-100)
  • -m, --mode                       Set generation mode (0-3)
    • 0 - Kana -> English  
    • 1 - English -> Kana  
    • 2 - Kanji -> Kana      
    • 3 - Kanji -> English  
  • -e, --export                       Export result in html file
  • -oh, --only-hiragana         Generate only hiragana words
  • -d, --dark                          Result is customized with black background and white text (dark-mode)

Example

python N5_CLI.py -n 5 -m 0 -oh
python N5_CLI.py --number 5 --mode 0 --only-hiragana

Export

python N5_CLI.py -n 10 -m 1 -e
python N5_CLI.py -n 10 --mode 1 --export

Save Location

[./N5-Quizzler]/exports/html
Results are saved in unique htmlexport_[file_id].html files
To see the answers, find your document id and its htmlexport_[file_id]_AnswerKey.html

Troubleshooting

CLI [?]/[X]/invisible characters

  • Open CLI
  • Go to Properties > Font
  • Select a font that supports Japanese characters

Now it should be fixed: