#config

app practice-chinese

A tool to practice Chinese

3 unstable releases

new 0.2.0 Mar 30, 2025
0.1.1 Mar 23, 2025
0.1.0 Mar 23, 2025

#45 in Internationalization (i18n)

Download history 182/week @ 2025-03-19

182 downloads per month

MIT license

12KB
160 lines

Practice Chinese CLI

A command-line tool to help you practice Chinese vocabulary, focusing on Pinyin and Hanzi. Navigate through words using arrow keys, and toggle between Pinyin and Hanzi with the 'p'/'h' key.

Features

  • Displays Chinese words in Pinyin and Hanzi.
  • Navigate through words using left and right arrow keys.
  • Toggle between Pinyin and Hanzi display with the 'h' key.
  • Execute an external program with the '!' key.

Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone git@github.com:Chachi04/practice-chinese.git
    cd git@github.com:Chachi04/practice-chinese.git
    
  2. Build the project:

    cargo build --release
    

Usage

Run the executable from the target/release directory:

./target/release/<your_executable_name>
  • Use the left and right arrow keys (or j/k keys) to navigate through the words.
  • Press 'h' to switch to Hanzi.
  • Press 'p' to switch to Pinyin.
  • Press '!' to execute an external program (hskindex) if using 《行书常用 3000 字》book.
  • Press 'q' to quit the application.

Configuration

The word list is hardcoded in src/main.rs. Feel free to modify it to suit your learning needs.

Acknowledgments

This application utilizes word lists inspired by the excellent [HSK Study and Exam - SuperTest](no citations) app. Thank you for providing valuable resources for Chinese language learners!

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please feel free to submit a pull request.

Contact

[Jiaqi Wang] - [w.jiaqi.dev@gmail.com]

Dependencies

~6–16MB
~227K SLoC