language_cards 0.3.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 409fa54cd14dc132b49083d8e4a26cd768803b13aff44e822da5c23cd5898e9a
-  data.tar.gz: ba9fcbcf3df0a95c6b7984772c90a21560beefa4790058b277dbce27515b6924
+  metadata.gz: 4d8aba7c872a8252b484266a52226593689ac898ff759546fccdb51e077806a9
+  data.tar.gz: c8011eaa91c6c0b4e15ae4778b0733c5572ce5ae0f8475a3863e577ab02cb7e3
 SHA512:
-  metadata.gz: 83285da9cb6ac703432739dc0f20ed8155bc84e73891f171b8aab07d9744b41da30ba997b5e6a8266cba55186216e31a417718ea84d45dcf9b7a8e7793568d93
-  data.tar.gz: b310a242bb5e3299bedbc306829becbab0f82bb602a4884bde516ad52356b833670ac9542c8433347dcdc43c7845b8403b2729bf345cc162c403debfd616cae4
+  metadata.gz: 41f84b0b3727afe99a78c775c9912dc64d5d45a72dca9b6683a357b20fe24d31dad09dd756bc5315c81d9d36667d52f5a46c59538cf0065537d539d7ec1d75a6
+  data.tar.gz: 2cc12cf74e0358d46c2bd0cd66a1504b008cd2876b9cbf3f403b6ea954bef74430f98cd2b3da9a6e21305a4edb3e084ee2ea63757f2aff33e0afbf96c50e0ae1

data/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.7', '3.0', '3.1', '3.2', '3.3', '3.4']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rake test

data/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## 1.0.0
+
+### Card data
+* Japanese, now fully covered:
+  * Hiragana and Katakana split into basic, diacritics (dakuten/handakuten), combinations (yōon) and "All"
+    sets, plus Extended Katakana for foreign sounds.  Romaji answers accept both Hepburn and Kunrei-shiki.
+  * Hiragana keyboard mappings added next to the existing Katakana keyboard mappings.
+  * Kanji for every JLPT level N5 through N1 (2,211 kanji), with readings in hiragana and English meanings.
+  * Vocabulary for every JLPT level N5 through N1 (7,800+ words).
+* Chinese: HSK 1–4 (1,193 words), answered in pinyin with tone marks, tone numbers or in English.
+  Fixes several wrong pinyin in the old HSK 1 set, and the language is now named "Chinese".
+* New languages: Arabic, Armenian, Bengali, Georgian, Greek, Hebrew, Hindi, Korean, Persian, Punjabi,
+  Russian, Tamil, Thai, Ukrainian and Urdu, each with writing-system sets plus numbers, common words
+  and phrases.
+
+### Game
+* Two-level menu: pick a language first, then one of its card sets.  Menus are paginated (10 per page,
+  `n`/`p` to page, `b` to go back, `q` to quit) and show how many sets/cards each entry has.
+* Translate answers are case-insensitive, ignore extra whitespace and Unicode composition differences, and
+  treat a leading "to " as optional.
+* Numeric answers in card files (e.g. `1`) now match what is typed.
+* The score and timer reset for each game, and the same card is never shown twice in a row.
+* CTRL-C in a game returns to the card set menu; end of input exits cleanly.
+* New `--version` and `--help` command line flags.
+
+### Maintenance
+* Runs on modern Ruby: updated to HighLine 2/3 and i18n 1.x.
+* Card files are validated by the test suite (duplicate keys, empty answers, values YAML would misread).
+* GitHub Actions CI replaces Travis CI.

data/README.md

@@ -1,45 +1,84 @@
 # LanguageCards
 [![Gem Version](https://badge.fury.io/rb/language_cards.svg)](https://badge.fury.io/rb/language_cards)
-[![Build Status](https://travis-ci.org/danielpclark/language_cards.svg?branch=master)](https://travis-ci.org/danielpclark/language_cards)
+[![CI](https://github.com/danielpclark/language_cards/actions/workflows/ci.yml/badge.svg)](https://github.com/danielpclark/language_cards/actions/workflows/ci.yml)
 [![Build status](https://ci.appveyor.com/api/projects/status/y6jadvlhk50ncbrh?svg=true)](https://ci.appveyor.com/project/danielpclark/language-cards)
 
 
-This is a flash card game for guessing translations or keyboard learning.  Currently implemented is
-English Romaji to Japanese Hirigana/Katakana and typing exercises for each.  Game experience will be improved upon!
-
-Also if your interested in adding other flash cards for language learning, pull requests are welcome.  Please
-keep some sort of organized collection for sets of cards (for instance the Japanese-Language Proficiency Test
-has different levels to complete, N1 through N5, which would each count as a collection).
+A terminal flash card game for learning languages that use foreign scripts.  Every language comes with
+card sets for its writing system plus vocabulary, and each card set can be played in two modes:
+
+* **Translate**: a card is shown in the foreign script and you type its romanization, reading or English meaning.
+* **Typing**: you type the card itself, which is great practice for a foreign-language keyboard or IME.
+
+Japanese is covered from the kana all the way through JLPT N1: every hiragana and katakana (including
+combinations, extended katakana and IME keyboard mappings), all 2,211 JLPT N5–N1 kanji and more than 7,800
+JLPT N5–N1 vocabulary words.
+
+Included languages (17 languages, 103 card sets, ~17,900 cards):
+
+| Language | Card sets (cards) |
+| --- | --- |
+| Arabic | Alphabet (31), Numbers (23), Numerals (10), Common Words (245), Phrases (48) |
+| Armenian | Alphabet (77), Numbers (23), Common Words (249), Phrases (46) |
+| Bengali | Vowels (11), Consonants (39), Numbers (23), Numerals (10), Common Words (249), Phrases (48) |
+| Chinese | HSK 1 (150), HSK 2 (147), HSK 3 (298), HSK 4 (598) |
+| Georgian | Alphabet (33), Numbers (23), Common Words (250), Phrases (45) |
+| Greek | Alphabet (49), Numbers (23), Common Words (247), Phrases (49) |
+| Hebrew | Alphabet (22), Final Forms (5), Numbers (23), Common Words (243), Phrases (49) |
+| Hindi | Vowels (13), Consonants (44), Vowel Signs (11), Numbers (23), Numerals (10), Common Words (245), Phrases (49) |
+| Japanese | Hiragana (46), Hiragana Diacritics (25), Hiragana Combinations (36), Hiragana (All) (108), Katakana (46), Katakana Diacritics (25), Katakana Combinations (36), Katakana Extended (34), Katakana (All) (141), Hiragana Keyboard Mappings (173), Katakana Keyboard Mappings (176), Kanji (JLPT N5) (79), Kanji (JLPT N4) (166), Kanji (JLPT N3) (367), Kanji (JLPT N2) (367), Kanji (JLPT N1) (1232), Vocabulary (JLPT N5) (702), Vocabulary (JLPT N4) (662), Vocabulary (JLPT N3) (2102), Vocabulary (JLPT N2) (1732), Vocabulary (JLPT N1) (2683) |
+| Korean | Hangul Consonants (19), Hangul Vowels (21), Hangul Syllables (140), Numbers (45), Common Words (244), Phrases (50) |
+| Persian | Alphabet (32), Numbers (23), Numerals (10), Common Words (246), Phrases (46) |
+| Punjabi | Letters (41), Vowels (10), Numbers (23), Numerals (10), Common Words (246), Phrases (48) |
+| Russian | Alphabet (66), Numbers (23), Common Words (250), Phrases (48) |
+| Tamil | Vowels (13), Consonants (23), Syllables (23), Numbers (23), Numerals (10), Common Words (249), Phrases (47) |
+| Thai | Consonants (44), Vowels (30), Numbers (23), Numerals (10), Common Words (243), Phrases (43) |
+| Ukrainian | Alphabet (66), Numbers (23), Common Words (250), Phrases (48) |
+| Urdu | Alphabet (39), Numbers (23), Numerals (10), Common Words (248), Phrases (41) |
 
 Internationalization support is built in!  Translators are welcome to make this game available in other languages.
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'language_cards'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
+Install it yourself as:
 
     $ gem install language_cards
+    
+Or try out the latest master by downloading it: [[master.zip](https://github.com/danielpclark/language_cards/archive/master.zip)]
 
 ## Usage
 
 After installing the gem you can run the executable `language_cards`.  If you clone the repo then use
 `bundle exec bin/language_cards`.
 
+    $ language_cards --help
+    usage: language_cards [options]
+        -l, --language  language (default: en)
+        -v, --version   print the version
+        -h, --help      print this help
+
+Pick a language, then a card set, by typing its number.  Long menus are split into pages of ten.
+
+| Key | Action |
+| --- | --- |
+| `1`, `2`, ... | Select the numbered language or card set (any number works, not just those on the current page) |
+| `n` / `p` | Next / previous page |
+| `b` | Back to the language menu |
+| `m` | Change game mode (Translate / Typing) |
+| `q` | Quit |
+| `CTRL-C` | Leave a game and return to the menu (quits from a menu) |
+
+Answers are forgiving: case and extra spaces don't matter, a leading "to " is optional for English verbs
+("to eat" and "eat" are both fine), and pinyin can be typed with tone marks (`nǐhǎo`) or tone numbers (`ni3hao3`).
+
 # Card Format
 
-The cards are stored in YAML format.  You can look in the `cards` directory for existing examples to follow.
-The first entry is a language name and it's okay if that already exists in another file.  The entries below that
-must be unique for that language (eg: you can't have two Hiragana sub entries on Japanese).  The next step in
+The cards are stored in YAML format in `cards/<interface language>/` (e.g. `cards/en`).  You can look in the
+`cards` directory for existing examples to follow.  The first entry is a language name and it's okay if that
+already exists in another file; card sets from every file are merged under it.  The entries below that must be
+unique for that language (eg: you can't have two Hiragana sub entries on Japanese).  The next step in
 will have a mapping hash on how the language is being mapped in the form of key to value (eg "Hiragana" => "Romaji").
+Every other entry is a card: the key is what is shown and the value is the answer, or a list of accepted answers.
 Just follow the below outline for a working example.
 
 ```yaml
@@ -52,11 +91,30 @@ Japanese:
     う: u
     え: e
     お: o
+    し: [shi, si]
 ```
 
+Languages are listed alphabetically and card sets in the order they are loaded, with files read in filename
+order (which is why the bundled files have numeric prefixes like `japanese-10-kanji-jlpt-n5.yml`).  Quote
+answers YAML would otherwise turn into something else, such as `'no'`, `'yes'`, `'on'` or numbers like `'1'`.
+
+You can add your own cards without touching the gem by putting YAML files in `~/.language_cards/cards/en/`.
+
+## Data sources
+
+* JLPT kanji and vocabulary level lists: [Jonathan Waller's JLPT Resources](http://www.tanos.co.uk/jlpt/) (CC BY).
+  JLPT levels have been unofficial since 2010, so these lists are a well established approximation.
+* Kanji readings were checked against [KANJIDIC](http://www.edrdg.org/wiki/index.php/KANJIDIC_Project) (EDRDG).
+* Chinese word lists: the HSK 2.0 official vocabulary lists (levels 1–4).
+* Kana: [Wikibooks Japanese kana chart](https://en.wikibooks.org/wiki/Japanese/Kana_chart).
+
+Corrections to any card are very welcome!
+
 ## Development
 
-*Tests required moving forward with this project unless it's translation files.*
+*Tests required moving forward with this project unless it's translation files.*  `test/cards_test.rb`
+validates every card file (duplicate keys, empty answers, values YAML would misread), so run the tests after
+editing cards too.
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 

data/bin/language_cards

@@ -4,5 +4,11 @@ $: << File.expand_path(File.join('..', '..', 'lib'), __FILE__)
 
 require 'language_cards'
 
-LanguageCards.start
+if LanguageCards::OPTS[:version]
+  puts LanguageCards::VERSION
+elsif LanguageCards::OPTS[:help]
+  puts LanguageCards::OPTS
+else
+  LanguageCards.start
+end
 

data/cards/en/arabic.yml

@@ -0,0 +1,370 @@
+---
+# Arabic: Alphabet (31), Numbers (23), Numerals (10), Common Words (245), Phrases (48)
+Arabic:
+  Alphabet:
+    mapping: { Arabic script: [Latin, Letter name] }
+    ا: [a, aa, alif]
+    ب: [b, baa, ba]
+    ت: [t, taa, ta]
+    ث: [th, thaa, tha]
+    ج: [j, jiim, jim]
+    ح: [h, '7', haa, ha]
+    خ: [kh, khaa]
+    د: [d, daal, dal]
+    ذ: [dh, dhaal, dhal]
+    ر: [r, raa, ra]
+    ز: [z, zaay, zay]
+    س: [s, siin, sin]
+    ش: [sh, shiin, shin]
+    ص: [s, saad, sad]
+    ض: [d, daad, dad]
+    ط: [t, taa, ta]
+    ظ: [z, dh, zaa, dhaa]
+    ع: [ayn, ain, '3']
+    غ: [gh, ghayn, ghain]
+    ف: [f, faa, fa]
+    ق: [q, qaaf, qaf]
+    ك: [k, kaaf, kaf]
+    ل: [l, laam, lam]
+    م: [m, miim, mim]
+    ن: ['n', nuun, nun]
+    ه: [h, haa, ha]
+    و: [w, u, waaw, waw]
+    ي: ['y', i, yaa, ya]
+    ء: [hamza, hamzah, '''']
+    ة: [a, at, taa marbuta, ta marbuta]
+    ى: [a, alif maqsura, alif maqsurah]
+  Numbers:
+    mapping: { Arabic: [Latin, English] }
+    صفر: [sifr, zero, '0']
+    واحد: [wahid, waahid, one, '1']
+    اثنان: [ithnan, ithnaan, two, '2']
+    ثلاثة: [thalatha, thalaatha, three, '3']
+    أربعة: [arbaa, arba'a, four, '4']
+    خمسة: [khamsa, five, '5']
+    ستة: [sitta, six, '6']
+    سبعة: [sabaa, sab'a, seven, '7']
+    ثمانية: [thamaniya, thamaaniya, eight, '8']
+    تسعة: [tisaa, tis'a, nine, '9']
+    عشرة: [ashara, ten, '10']
+    أحد عشر: [ahad ashar, eleven, '11']
+    اثنا عشر: [ithna ashar, twelve, '12']
+    عشرون: [ishrun, ishruun, twenty, '20']
+    ثلاثون: [thalathun, thalaathuun, thirty, '30']
+    أربعون: [arbaun, arba'uun, forty, '40']
+    خمسون: [khamsun, khamsuun, fifty, '50']
+    ستون: [sittun, sittuun, sixty, '60']
+    سبعون: [sabun, sab'uun, seventy, '70']
+    ثمانون: [thamanun, thamaanuun, eighty, '80']
+    تسعون: [tisun, tis'uun, ninety, '90']
+    مئة: [mia, mi'a, hundred, one hundred, '100']
+    ألف: [alf, thousand, one thousand, '1000']
+  Numerals:
+    mapping: { Arabic-Indic digits: [Digit, English] }
+    '٠': ['0', zero]
+    '١': ['1', one]
+    '٢': ['2', two]
+    '٣': ['3', three]
+    '٤': ['4', four]
+    '٥': ['5', five]
+    '٦': ['6', six]
+    '٧': ['7', seven]
+    '٨': ['8', eight]
+    '٩': ['9', nine]
+  Common Words:
+    mapping: { Arabic: [Latin, English] }
+    أنا: [ana, I]
+    أنت: [anta, anti, you]
+    هو: [huwa, he, it]
+    هي: [hiya, she, it]
+    نحن: [nahnu, we]
+    أنتم: [antum, you all, you]
+    هم: [hum, they]
+    هذا: [hadha, this]
+    هذه: [hadhihi, this]
+    ذلك: [dhalik, that]
+    أب: [ab, father]
+    أم: [umm, mother]
+    أخ: [akh, brother]
+    أخت: [ukht, sister]
+    ابن: [ibn, son]
+    بنت: [bint, daughter, girl]
+    زوج: [zawj, husband]
+    زوجة: [zawja, wife]
+    جد: [jadd, grandfather]
+    جدة: [jadda, grandmother]
+    عائلة: [aila, a'ila, family]
+    طفل: [tifl, child, baby]
+    ولد: [walad, boy, child]
+    رجل: [rajul, man]
+    امرأة: [imraa, imra'a, woman]
+    صديق: [sadiq, friend]
+    ناس: [nas, people]
+    معلم: [muallim, mu'allim, teacher]
+    طالب: [talib, student]
+    طبيب: [tabib, doctor]
+    رأس: [ras, ra's, head]
+    عين: [ayn, eye]
+    أذن: [udhun, ear]
+    أنف: [anf, nose]
+    فم: [fam, mouth]
+    يد: [yad, hand]
+    قدم: [qadam, foot]
+    شعر: [shaar, sha'r, hair]
+    قلب: [qalb, heart]
+    وجه: [wajh, face]
+    سن: [sinn, tooth]
+    ماء: [maa, ma', water]
+    طعام: [taam, ta'am, food]
+    خبز: [khubz, bread]
+    أرز: [aruzz, ruzz, rice]
+    لحم: [lahm, meat]
+    دجاج: [dajaj, chicken]
+    سمك: [samak, fish]
+    حليب: [halib, milk]
+    قهوة: [qahwa, coffee]
+    شاي: [shay, tea]
+    بيض: [bayd, eggs, egg]
+    فاكهة: [fakiha, fruit]
+    موز: [mawz, banana, bananas]
+    ملح: [milh, salt]
+    سكر: [sukkar, sugar]
+    برتقال: [burtuqal, orange, oranges]
+    كلب: [kalb, dog]
+    قطة: [qitta, cat]
+    طائر: [tair, ta'ir, bird]
+    حيوان: [hayawan, animal]
+    أحمر: [ahmar, red]
+    أزرق: [azraq, blue]
+    أخضر: [akhdar, green]
+    أصفر: [asfar, yellow]
+    أبيض: [abyad, white]
+    أسود: [aswad, black]
+    بني: [bunni, brown]
+    لون: [lawn, color, colour]
+    يوم: [yawm, day]
+    ليل: [layl, night]
+    صباح: [sabah, morning]
+    مساء: [masaa, masa', evening]
+    اليوم: [al-yawm, alyawm, today]
+    غدا: [ghadan, tomorrow]
+    أمس: [ams, yesterday]
+    الآن: [al-an, alan, now]
+    ساعة: [saa, sa'a, hour, clock, watch]
+    دقيقة: [daqiqa, minute]
+    أسبوع: [usbu, usbu', week]
+    شهر: [shahr, month]
+    سنة: [sana, year]
+    وقت: [waqt, time]
+    الأحد: [al-ahad, alahad, Sunday]
+    الاثنين: [al-ithnayn, alithnayn, Monday]
+    الثلاثاء: [ath-thulatha, aththulatha, Tuesday]
+    الأربعاء: [al-arbia, al-arbi'a, Wednesday]
+    الخميس: [al-khamis, alkhamis, Thursday]
+    الجمعة: [al-jumua, al-jum'a, Friday]
+    السبت: [as-sabt, assabt, Saturday]
+    بيت: [bayt, house, home]
+    مدرسة: [madrasa, school]
+    مستشفى: [mustashfa, hospital]
+    سوق: [suq, souq, market]
+    مطعم: [matam, mat'am, restaurant]
+    مدينة: [madina, city]
+    شارع: [shari, shari', street]
+    مسجد: [masjid, mosque]
+    مكتب: [maktab, office, desk]
+    مطار: [matar, airport]
+    فندق: [funduq, hotel]
+    جامعة: [jamia, jami'a, university]
+    غرفة: [ghurfa, room]
+    مطبخ: [matbakh, kitchen]
+    حمام: [hammam, bathroom, bath]
+    محطة: [mahatta, station]
+    بلد: [balad, country]
+    باب: [bab, door]
+    نافذة: [nafidha, window]
+    طاولة: [tawila, table]
+    كرسي: [kursi, chair]
+    سرير: [sarir, bed]
+    كتاب: [kitab, book]
+    قلم: [qalam, pen, pencil]
+    هاتف: [hatif, phone, telephone]
+    سيارة: [sayyara, car]
+    مفتاح: [miftah, key]
+    كوب: [kub, cup, glass]
+    ملابس: [malabis, clothes]
+    نقود: [nuqud, money]
+    حاسوب: [hasub, computer]
+    أكل: [akala, eat]
+    شرب: [shariba, drink]
+    ذهب: [dhahaba, go]
+    جاء: [jaa, ja'a, come]
+    كتب: [kataba, write]
+    قرأ: [qaraa, qara'a, read]
+    تكلم: [takallama, speak, talk]
+    قال: [qala, say]
+    رأى: [raa, ra'a, see]
+    سمع: [samia, sami'a, hear]
+    عرف: [arafa, know]
+    فهم: [fahima, understand]
+    أحب: [ahabba, love, like]
+    أراد: [arada, want]
+    عمل: [amal, work, job]
+    نام: [nama, sleep]
+    جلس: [jalasa, sit]
+    وقف: [waqafa, stand, stop]
+    مشى: [masha, walk]
+    ركض: [rakada, run]
+    فتح: [fataha, open]
+    أغلق: [aghlaqa, close, shut]
+    أعطى: [aata, a'ta, give]
+    أخذ: [akhadha, take]
+    اشترى: [ishtara, buy]
+    باع: [baa, ba'a, sell]
+    درس: [darasa, study]
+    تعلم: [taallama, ta'allama, learn]
+    ساعد: [saada, sa'ada, help]
+    لعب: [laiba, la'iba, play]
+    سأل: [saala, sa'ala, ask]
+    أجاب: [ajaba, answer, reply]
+    انتظر: [intazara, intadhara, wait]
+    بحث: [bahatha, search, look for]
+    وجد: [wajada, find]
+    دخل: [dakhala, enter, go in]
+    خرج: [kharaja, go out, exit, leave]
+    رجع: [rajaa, raja'a, return, come back]
+    سافر: [safara, travel]
+    فكر: [fakkara, think]
+    بدأ: [badaa, bada'a, begin, start]
+    انتهى: [intaha, end, finish]
+    دفع: [dafaa, dafa'a, pay, push]
+    كان: [kana, be, was]
+    اتصل: [ittasala, call, phone]
+    كبير: [kabir, big, large, old]
+    صغير: [saghir, small, little, young]
+    جديد: [jadid, new]
+    قديم: [qadim, old, ancient]
+    جيد: [jayyid, good]
+    سيء: [sayyi, sayyi', bad]
+    جميل: [jamil, beautiful, pretty, nice]
+    طويل: [tawil, long, tall]
+    قصير: [qasir, short]
+    حار: [harr, hot]
+    بارد: [barid, cold]
+    سهل: [sahl, easy]
+    صعب: [saab, sa'b, difficult, hard]
+    سريع: [sari, sari', fast, quick]
+    كثير: [kathir, many, much, a lot]
+    قليل: [qalil, few, little]
+    غني: [ghani, rich]
+    فقير: [faqir, poor]
+    سعيد: [said, sa'id, happy]
+    حزين: [hazin, sad]
+    جائع: [jai, ja'i', hungry]
+    عطشان: [atshan, thirsty]
+    متعب: [mutab, mut'ab, tired]
+    مريض: [marid, sick, ill]
+    نظيف: [nazif, nadhif, clean]
+    قريب: [qarib, near, close, relative]
+    بعيد: [baid, ba'id, far]
+    مفتوح: [maftuh, open]
+    مغلق: [mughlaq, closed, shut]
+    رخيص: [rakhis, cheap]
+    غالي: [ghali, expensive]
+    صحيح: [sahih, correct, right, 'true']
+    مهم: [muhimm, important]
+    كل: [kull, all, every, each]
+    ماذا: [madha, what]
+    من: [man, min, who, from]
+    أين: [ayna, where]
+    متى: [mata, when]
+    لماذا: [limadha, why]
+    كيف: [kayfa, how]
+    كم: [kam, how many, how much]
+    أي: [ayy, which]
+    نعم: [naam, na'am, 'yes']
+    لا: [la, 'no', not]
+    و: [wa, and]
+    أو: [aw, or]
+    لكن: [lakin, but]
+    في: [fi, in, at]
+    على: [ala, 'on']
+    مع: [maa, ma'a, with]
+    هنا: [huna, here]
+    هناك: [hunak, there]
+    جدا: [jiddan, very]
+    أيضا: [aydan, also, too]
+    يمين: [yamin, right]
+    يسار: [yasar, left]
+    فوق: [fawq, above, over, up]
+    تحت: [taht, under, below]
+    قبل: [qabla, before]
+    بعد: [bada, ba'da, after]
+    شمس: [shams, sun]
+    أرض: [ard, earth, land, ground]
+    مطر: [matar, rain]
+    شجرة: [shajara, tree]
+    نار: [nar, fire]
+    جبل: [jabal, mountain]
+    طريق: [tariq, road, way]
+    اسم: [ism, name]
+    لغة: [lugha, language]
+    كلمة: [kalima, word]
+    سؤال: [sual, su'al, question]
+    جواب: [jawab, answer, reply]
+    عربي: [arabi, Arabic, Arab]
+    إنجليزي: [injlizi, English]
+    شيء: [shay, shay', thing, something]
+    حياة: [hayat, life]
+    حافلة: [hafila, bus]
+    قطار: [qitar, train]
+    طائرة: [taira, ta'ira, airplane, plane]
+  Phrases:
+    mapping: { Arabic: [Latin, English] }
+    مرحبا: [marhaban, hello, hi]
+    أهلا: [ahlan, hi, hello]
+    أهلا وسهلا: [ahlan wa sahlan, welcome]
+    السلام عليكم: [as-salamu alaykum, assalamu alaykum, peace be upon you, hello]
+    وعليكم السلام: [wa alaykum as-salam, wa alaykum assalam, and peace be upon you, and upon you peace]
+    صباح الخير: [sabah al-khayr, sabah alkhayr, good morning]
+    صباح النور: [sabah an-nur, sabah annur, good morning]
+    مساء الخير: [masa al-khayr, masa alkhayr, good evening]
+    مساء النور: [masa an-nur, masa annur, good evening]
+    تصبح على خير: [tusbih ala khayr, good night]
+    مع السلامة: [maa as-salama, ma'a assalama, goodbye, bye]
+    إلى اللقاء: [ila al-liqa, ila alliqa, goodbye, see you]
+    أراك لاحقا: [araka lahiqan, see you later]
+    شكرا: [shukran, thank you, thanks]
+    شكرا جزيلا: [shukran jazilan, thank you very much, thanks a lot]
+    عفوا: [afwan, you're welcome, excuse me, pardon]
+    من فضلك: [min fadlak, min fadlik, please]
+    آسف: [asif, sorry, I'm sorry]
+    نعم: [naam, na'am, 'yes']
+    لا: [la, 'no']
+    كيف حالك: [kayfa haluk, kayfa halak, how are you]
+    أنا بخير: [ana bikhayr, I'm fine, I'm well]
+    الحمد لله: [al-hamdu lillah, alhamdulillah, praise be to God, thank God]
+    ما اسمك: [ma ismuk, ma ismak, what's your name, what is your name]
+    اسمي أحمد: [ismi ahmad, my name is Ahmad]
+    تشرفنا: [tasharrafna, nice to meet you, pleased to meet you]
+    أنا لا أفهم: [ana la afham, I don't understand]
+    لا أعرف: [la aarif, la a'rif, I don't know]
+    هل تتكلم الإنجليزية: [hal tatakallam al-injliziya, hal tatakallam alinjliziya, do you speak English]
+    أتكلم العربية قليلا: [atakallam al-arabiya qalilan, atakallam alarabiya qalilan, I speak a little Arabic]
+    تكلم ببطء من فضلك: [takallam bibut min fadlak, speak slowly please, please speak slowly]
+    أين الحمام: [ayna al-hammam, ayna alhammam, where is the bathroom, where is the toilet]
+    أين المحطة: [ayna al-mahatta, ayna almahatta, where is the station]
+    أين الفندق: [ayna al-funduq, ayna alfunduq, where is the hotel]
+    كم الثمن: [kam ath-thaman, kam aththaman, how much is it, how much]
+    بكم هذا: [bikam hadha, how much is this]
+    من أين أنت: [min ayna anta, min ayna anti, where are you from]
+    أنا من أمريكا: [ana min amrika, I'm from America, I am from America]
+    أريد ماء: [urid maa, urid ma', I want water]
+    الحساب من فضلك: [al-hisab min fadlak, alhisab min fadlak, the bill please, check please]
+    هل يمكن أن تساعدني: [hal yumkin an tusaidani, hal yumkin an tusa'idani, can you help me]
+    كم الساعة: [kam as-saa, kam assa'a, what time is it]
+    لا بأس: [la bas, la ba's, it's okay, no problem, never mind]
+    لا مشكلة: [la mushkila, no problem]
+    تفضل: [tafaddal, please go ahead, here you are, come in]
+    إن شاء الله: [in sha allah, inshallah, God willing, hopefully]
+    أنا أحبك: [ana uhibbuk, I love you]
+    بالتوفيق: [bit-tawfiq, bittawfiq, good luck]