morsby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4ec402a96e99a1dd7a5bcf671343df1ef2cf896ac3a66e4fc0ec637f55e4c32a
+  data.tar.gz: '096b0719f4e3dc9359a1531fe59f6880e093f9db24697f7ece6066ff89c7ac93'
+SHA512:
+  metadata.gz: 8131fba53901c1b848201d5bed070542a931c32b57bd21712b6826f7eaed5c4673b175428b06ec71fe55701c438ca4e7c971cbe27656468aea15ad3db4c4ba70
+  data.tar.gz: 5085ce030f6b0aeae4c6aab3a4c39d16c4ed8a56dac85f0c1ecd98e7ba4335191852d9af5c9d420c3d2097067834c43911393737b9cd205b531cdf410000b5a6

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# CHANGELOG
+
+## 0.1.0
+---
+**初回リリース (First Release)**
+
+モールス信号の基礎から、アルファベット・数字・記号・Q符号・CW略語・和文モールスまで対応し、
+学習モード（対話型）と出力モードを実装しました。
+
+- `morsby -h`でヘルプ表示
+- `morsby -learn`で学習モードに入り、基礎知識や略語一覧、クイズを通じて練習可能
+- `morsby "HELLO"`で文字列をモールス信号へ変換して出力
+- `--lang en`で英語表示、`--pro`で高速なプロモード対応
+- 和文、濁音・半濁音、記号(?)にも対応
+
+This initial release introduces a comprehensive Morse code tool supporting alphabets (A-Z), digits (0-9), punctuation (?), Q-codes, CW abbreviations, and Wabun Morse.
+It offers both an interactive learning mode and a direct output mode.
+
+- Show help `morsby -h`
+- Enter learning mode with `morsby -learn` to study basics, Q-codes, CW abbreviations, and practice quizzes
+- Convert a given string to Morse code with `morsby "HELLO"`
+- `--lang en` for English interface, `--pro` for faster (professional) mode
+- Also supports Japanese Wabun Morse, including voiced and semi-voiced characters, as well as punctuation like `?`

data/README.md

@@ -0,0 +1,91 @@
+# README
+
+## Overview
+
+Morsbyは、モールス信号の学習・活用を支援するツールです。
+英字（A-Z）、数字（0-9）、記号（?）、Q符号、CW略語、和文モールスまで対応。
+
+学習モードで基礎を固めたり、クイズで理解度を確認したり、文字列を即座にモールス信号へ変換したりできます。
+また、英語表示(`--lang en`)やプロモード(`--pro`)による高速再生にも対応します。
+
+※筆者の勉強用でもあり、内容についての正確性は保証致しません。
+※雑なコード/機能が多々ありますのでIssueやPR発行いただければ嬉しいです。
+
+Morsby is a tool to learn and utilize Morse code.
+It supports alphabets (A-Z), digits (0-9), punctuation (?), Q-codes, CW abbreviations, and Japanese Wabun Morse.
+Use the learning mode to practice basics and test your skills with quizzes, or instantly convert input strings to Morse code.
+Features an English mode (`--lang en`) and a pro mode (`--pro`) for faster playback.
+
+Note: This content is also for the author’s own study, and its accuracy is not guaranteed.
+Note: There may be rough or imperfect code/functions in places, so issues and pull requests are welcome.
+
+## Install
+
+install morsby
+
+```
+gem install morsby
+```
+
+install sox for playing morse sound
+
+### For Mac
+
+```
+brew install sox
+```
+
+### For Linux(CentOS)
+
+```
+sudo yum install sox
+```
+
+### For Linux(Debian/Ubuntu)
+
+```
+sudo apt-get install sox
+```
+
+This tool does not support Windows yet.
+
+## Usage
+
+### Learning Mode
+
+```
+morsby -learn
+```
+
+Main menu: basics, Q-codes, CW abbreviations, quizzes.
+
+### Output Mode
+
+```
+morsby "HELLO"
+```
+
+Converts HELLO into Morse code.
+
+### オプション (Options)
+
+`--lang en`: English
+`--pro`: High speed mode
+
+### Example
+
+```
+morsby "Rubyist"
+morsby --pro "HELLO RUBYIST"
+morsby -learn
+morsby -learn --lang en
+morsby -learn --pro
+morsby -learn --pro --lang en
+```
+
+## Development & Test
+
+```
+bundle install
+bundle exec rspec
+```

data/bin/morsby

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "morsby"
+
+Morsby::CLI.new.run(ARGV)

data/lib/morsby/abbreviations.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Morsby
+  ABBREVIATIONS = {
+    essential: [
+      { name: "CQ", ja: "一般呼出", en: "General call" },
+      { name: "DE", ja: "こちらは", en: "From (this station)" },
+      { name: "K",  ja: "どうぞ送れ", en: "Over, go ahead" },
+      { name: "R",  ja: "了解", en: "Roger, received" },
+      { name: "AR", ja: "メッセージ終了", en: "End of message" },
+      { name: "AS", ja: "待て", en: "Wait" },
+      { name: "BT", ja: "区切り", en: "Break between sections" },
+      { name: "SK", ja: "通信終了", en: "End of contact" },
+      { name: "SOS",ja: "遭難信号", en: "Distress signal" },
+      { name: "TNX",ja: "感謝", en: "Thanks" }
+    ],
+
+    q_signs: [
+      { name: "QRM", ja: "他局混信", en: "Interference" },
+      { name: "QRN", ja: "雑音有",   en: "Atmospheric noise" },
+      { name: "QRP", ja: "出力下げ", en: "Reduce power" },
+      { name: "QRT", ja: "送信停止", en: "Stop transmitting" },
+      { name: "QRV", ja: "準備OK？", en: "Ready?" },
+      { name: "QRX", ja: "後で呼ぶ", en: "Call later" },
+      { name: "QSB", ja: "信号変動", en: "Signals fading" },
+      { name: "QSL", ja: "受領了解", en: "Acknowledgement" },
+      { name: "QSO", ja: "交信中",   en: "A contact" },
+      { name: "QSY", ja: "周波数変更", en: "Change frequency" }
+    ],
+
+    cw_signs: [
+      { name: "OM",  ja: "男性オペレーターに親しみを込めて呼ぶ呼称", en: "Male operator (OM)" },
+      { name: "YL",  ja: "女性オペレーターに親しみを込めて呼ぶ呼称", en: "Lady operator (YL)" },
+      { name: "XYL", ja: "妻",        en: "Wife (XYL)" },
+      { name: "FB",  ja: "良好",      en: "Fine Business" },
+      { name: "GM",  ja: "おはよう",  en: "Good Morning" },
+      { name: "GN",  ja: "おやすみ",  en: "Good Night" },
+      { name: "GA",  ja: "こんにちは(午後)", en: "Good Afternoon" },
+      { name: "GE",  ja: "こんばんは", en: "Good Evening" },
+      { name: "CU",  ja: "また会おう", en: "See you" },
+      { name: "CUL", ja: "また会いましょう", en: "See you later" },
+      { name: "PSE", ja: "お願いします",   en: "Please" }
+    ]
+  }.freeze
+end

data/lib/morsby/cli.rb

@@ -0,0 +1,337 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+require_relative 'morse_table'
+require_relative 'wabun_table'
+require_relative 'abbreviations'
+require_relative 'messages'
+require 'nkf'
+
+module Morsby
+  class CLI
+    PUNCTUATION_CODES = {
+      '?' => '..--..',
+      '.' => '.-.-.-',
+      ',' => '--..--',
+      '/' => '-..-.',
+      '-' => '-....-',
+      '(' => '-.--.',
+      ')' => '-.--.-'
+    }
+
+    # デフォルト(ビギナーモード)とプロモードの音長
+    DEFAULT_DOT_UNIT = 0.15
+    PRO_DOT_UNIT = 0.08
+
+    # モールス仕様:
+    # 短音=1拍、長音=3拍、文字内パーツ間=1拍、文字間=3拍、単語間=7拍
+    # だが、文字間は3だと短く感じたので4に修正した
+    # 単語間はスペースで分割し、その際7拍分空ける
+
+    def run(argv)
+      @language = :ja
+      if (lang_index = argv.index("--lang")) || (lang_index = argv.index("-lang"))
+        desired_lang = argv[lang_index + 1]
+        @language = :en if desired_lang && desired_lang.downcase == "en"
+        argv.delete_at(lang_index + 1)
+        argv.delete_at(lang_index)
+      end
+
+      # プロモード判定
+      @dot_unit = DEFAULT_DOT_UNIT
+      if (pro_index = argv.index("--pro"))
+        @dot_unit = PRO_DOT_UNIT
+        argv.delete_at(pro_index)
+      end
+
+      @dash_unit = @dot_unit * 3
+      @intra_char_gap = @dot_unit
+      @letter_gap = @dot_unit * 3
+      @word_gap = @dot_unit * 7
+
+      if argv.empty?
+        print_help
+        return
+      end
+
+      input_str = argv.join(" ")
+      if input_str.start_with?("-h") || input_str.start_with?("-help")
+        print_help
+        return
+      elsif input_str.start_with?("-learn")
+        @mode = :learn
+        learn_mode_interactive
+      else
+        @mode = :output
+        unless play_installed? && !on_windows?
+          show_audio_error_message
+          return
+        end
+        convert_and_sound(input_str)
+      end
+    end
+
+    private
+
+    def msg(key)
+      val = Morsby::MESSAGES[@language][key]
+      val.is_a?(Proc) ? val : val
+    end
+
+    def print_help
+      puts msg(:help)
+    end
+
+    def learn_mode_interactive
+      intro
+      loop do
+        print_main_menu
+        choice = STDIN.gets.strip
+        break if choice.downcase == 'q'
+
+        case choice
+        when "1"
+          show_basic_course
+        when "2"
+          show_q_cw_detail_course
+        when "3"
+          show_alphabets
+        when "4"
+          learn_all_digits
+        when "5"
+          show_punctuation
+        when "6"
+          show_wabun_course
+        when "7"
+          learn_abbrev(:essential, :abbrev_essential_title)
+        when "8"
+          learn_abbrev(:q_signs, :abbrev_q_signs_title)
+        when "9"
+          learn_abbrev(:cw_signs, :abbrev_cw_signs_title)
+        when "10"
+          quiz_characters
+        when "11"
+          quiz_sound
+        else
+          puts (@language == :ja ? "無効な選択です。もう一度お試しください。" : "Invalid choice. Please try again.")
+        end
+      end
+      puts msg(:learning_mode_end)
+    end
+
+    def intro
+      puts "=== Morse Code Learning Mode ==="
+      puts msg(:learning_intro)
+      puts
+      puts msg(:press_enter_main)
+      STDIN.gets
+    end
+
+    def print_main_menu
+      puts msg(:main_menu)
+    end
+
+    def show_basic_course
+      puts msg(:about_morse)
+      STDIN.gets
+    end
+
+    def show_q_cw_detail_course
+      puts msg(:q_cw_detail_course)
+      STDIN.gets
+    end
+
+    def show_alphabets
+      puts msg(:all_alphabets_title)
+      ('A'..'Z').each do |char|
+        code = Morsby::MORSE_TABLE[char]
+        puts "#{char}: #{code}"
+      end
+      puts msg(:press_enter_return)
+      STDIN.gets
+    end
+
+    def learn_all_digits
+      puts msg(:all_digits)
+      ('0'..'9').each do |d|
+        puts "#{d}: #{Morsby::MORSE_TABLE[d]}"
+      end
+      puts msg(:press_enter_return)
+      STDIN.gets
+    end
+
+    def show_punctuation
+      puts msg(:symbol_title)
+      PUNCTUATION_CODES.each do |sym, code|
+        puts "#{sym}: #{code}"
+      end
+      puts msg(:press_enter_return)
+      STDIN.gets
+    end
+
+    def show_wabun_course
+      puts msg(:wabun_title)
+      Morsby::WABUN_TABLE.each do |kana, code|
+        puts "#{kana}: #{code}"
+      end
+      puts
+      if @language == :ja
+        puts "濁音・半濁音もテーブルに直接定義済み。例: ガ、パなど"
+      else
+        puts "Dakuon and Handakuon are directly defined in the WABUN_TABLE."
+      end
+      puts msg(:press_enter_return)
+      STDIN.gets
+    end
+
+    def learn_abbrev(type, title_key)
+      puts msg(title_key)
+      Morsby::ABBREVIATIONS[type].each do |abbrev|
+        code = abbrev[:name].chars.map { |c| Morsby::MORSE_TABLE[c] }.compact.join(" ")
+        meaning_ja = abbrev[:ja]
+        meaning_en = abbrev[:en]
+        puts format(msg(:abbrev_format), name: abbrev[:name], morse_code: code, meaning_ja: meaning_ja, meaning_en: meaning_en)
+        puts
+      end
+      puts msg(:press_enter_return)
+      STDIN.gets
+    end
+
+    def quiz_characters
+      puts msg(:quiz_char_start)
+      all_chars = Morsby::MORSE_TABLE.keys
+      correct_count = 0
+      10.times do |i|
+        question = all_chars.sample
+        code = Morsby::MORSE_TABLE[question]
+        puts msg(:quiz_char_question).call(i)
+        puts "Morse: #{code}"
+        print (@language == :ja ? "文字は?: " : "Character?: ")
+        answer = STDIN.gets.strip.upcase
+        if answer == question
+          puts msg(:quiz_correct)
+          correct_count += 1
+        else
+          puts msg(:quiz_incorrect).call(question)
+        end
+        puts
+      end
+      puts msg(:quiz_result).call(correct_count)
+      STDIN.gets
+    end
+
+    def quiz_sound
+      unless play_installed? && !on_windows?
+        show_audio_error_message
+        return
+      end
+
+      puts msg(:quiz_sound_start)
+      all_chars = Morsby::MORSE_TABLE.keys
+      correct_count = 0
+      10.times do |i|
+        question = all_chars.sample
+        code = Morsby::MORSE_TABLE[question]
+        puts msg(:quiz_sound_question).call(i)
+        code.chars.each_with_index do |c, idx|
+          play_signal(sig:c)
+          # 同一文字内パーツ間=短音1単位
+          sleep(@dot_unit) if idx < code.size-1
+        end
+        # 文字間=3単位
+        sleep(@dot_unit*3)
+        print "> "
+        answer = STDIN.gets.strip.upcase
+        if answer == question
+          puts msg(:quiz_correct)
+          correct_count += 1
+        else
+          puts msg(:quiz_incorrect).call(question)
+        end
+        puts
+      end
+      puts msg(:quiz_result).call(correct_count)
+      STDIN.gets
+    end
+
+    def play_installed?
+      system("which play > /dev/null 2>&1")
+    end
+
+    def on_windows?
+      RUBY_PLATFORM.downcase.include?('mswin') || RUBY_PLATFORM.downcase.include?('mingw')
+    end
+
+    def short_beep
+      # 短音=1単位
+      system("play -n synth #{@dot_unit} sine 700 > /dev/null 2>&1")
+    end
+
+    def long_beep
+      # 長音=3単位
+      system("play -n synth #{@dot_unit*3} sine 700 > /dev/null 2>&1")
+    end
+
+    def play_signal(sig:, show: false)
+      if sig == '.'
+        short_beep
+        print "." if show
+      else
+        long_beep
+        print "-" if show
+      end
+    end
+
+    def convert_and_sound(str)
+      normalized = NKF.nkf('-w -h0 -Z4 --katakana', str)
+
+      words = normalized.split(' ')
+
+      words.each_with_index do |word, w_idx|
+        chars = word.chars
+        chars.each_with_index do |ch, c_idx|
+          code = morse_for_char(ch)
+          next unless code
+          code.chars.each_with_index do |c, i|
+            play_signal(sig: c, show: true)
+            # 同一文字内パーツ間=1拍
+            sleep(@dot_unit)
+          end
+          # 文字間=4拍 (3ではなく4にしている)
+          sleep(@dot_unit*4)
+          print " "
+        end
+        # 単語間=7拍
+        sleep(@dot_unit*7)
+        print "   "
+      end
+    end
+
+    def morse_for_char(ch)
+      upch = ch.upcase
+      if PUNCTUATION_CODES[upch]
+        return PUNCTUATION_CODES[upch]
+      end
+
+      if Morsby::MORSE_TABLE[upch]
+        return Morsby::MORSE_TABLE[upch]
+      end
+
+      code = Morsby::WABUN_TABLE[ch]
+      return code if code
+
+      nil
+    end
+
+    def show_audio_error_message
+      if @language == :ja
+        puts "\n音声を再生するには`sox`をインストールしてください。\n"
+        puts "また、現在Windowsにはまだ対応しておりません。\n"
+        puts "ラーニングモードは起動できます！" if @mode == :output
+      else
+        puts "\nPlease install 'sox' for sound. Currently not supported on Windows.\n"
+        puts "Learning mode is still available!!"
+      end
+    end
+  end
+end

data/lib/morsby/messages.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+module Morsby
+  MESSAGES = {
+    ja: {
+      help: <<~HELP,
+
+        使用方法:
+        -----------------------------------------------------------------
+          morsby -h / -help       : ヘルプ表示
+          morsby -learn           : 学習モード(対話)
+          morsby "char"  : 入力文字列をモールス信号で出力
+
+          オプション:
+          --lang en (英語モード。指定しない場合日本語モード。)
+          --pro (高速再生モード)
+        -----------------------------------------------------------------
+
+      HELP
+      learning_mode_end: "\n学習モードを終了します。",
+      learning_intro: "モールス信号は、短点と長点を組み合わせて文字・数字・記号を表す国際的な通信手段です。\n" \
+                      "かつて、まだ電話やインターネットが普及する前、電報(電気信号による文字送信)が主な長距離通信手段だった時代から利用されてきました。\n" \
+                      "この歴史的背景を持つモールス信号は、現在でも非常用や低帯域環境下で有効で、言語の壁を越えた情報伝達を可能にします。",
+      about_morse: "[1) モールス信号の基礎]\n" \
+                   "モールス信号の基礎とは、短い信号（短点）と長い信号（長点）の組み合わせで文字や数字、記号を表現する仕組みを深く理解することにあります。\n" \
+                   "A〜Zのアルファベットや0〜9の数字は、それぞれ固有のパターンを持ち、例えば“A”は「．−」、" \
+                   "“B”は「−...」といった具合です。最初は符号表を参照しながら確認しますが、徐々に暗記し、聴いただけで文字が浮かぶようになります。\n\n" \
+                   "また、記号（句読点や疑問符、スラッシュなど）もモールス信号で表せるため、単なる文字通信を超え、" \
+                   "ある程度複雑なメッセージを送受できるようになります。これにより、長い文を高速に打電する必要はなく、" \
+                   "短点と長点の組み合わせで十分な情報量を伝えることが可能です。\n\n" \
+                   "モールス信号の特徴は、電力や設備が最小限で済む点にもあります。" \
+                   "シンプルなトランシーバーや発信器、受信器があれば運用でき、" \
+                   "電波状況が悪くても強弱ある信号を判別しやすく、極限的な環境でも通信が成立しやすいのです。" \
+                   "また、音で伝えるだけでなく、光の点滅や振動など、視覚・触覚的な手段で伝達することも可能で、" \
+                   "多様な場面で利用できます。\n\n" \
+                   "学習の初期段階では、符号表を手元に置き、" \
+                   "特定の文字のパターンを声に出したり、リズムで覚えたりする方法が有効です。" \
+                   "慣れると、符号を見た瞬間に文字が浮かび、" \
+                   "やがては音（ピッ・ピー）を聞くだけで瞬時に理解できるようになります。" \
+                   "この過程は、まるで新しい言語を学ぶような感覚を伴い、" \
+                   "習得によって得られる達成感も大きいものです。\n\n" \
+                   "さらに、モールス信号は歴史的、文化的意義も持ち、" \
+                   "かつては世界中で電報を送り合うための共通基盤でした。" \
+                   "現代ではデジタル通信が主流ですが、モールスは緊急用のバックアップや、" \
+                   "アマチュア無線でのチャレンジ精神、技術的スキルの証明手段として尊ばれています。" \
+                   "これらの背景を知ることで、単なる通信手段としてだけでなく、" \
+                   "モールス信号習得は世界的なコミュニティへの参加や歴史への接点ともなり得ます。\n\n" \
+                   "こうした基礎を固めることで、必要最低限の符号で" \
+                   "多様なメッセージを正確・迅速に伝える術を身につけることができ、" \
+                   "非常用通信や特殊条件下での通信確保、国際的な趣味仲間との交流など、" \
+                   "幅広い場面でその力が発揮できるようになります。",
+      press_enter_main: "Enterキーでメインメニューへ進んでください。",
+      main_menu: <<~MENU,
+
+        === メインメニュー ===
+        1) モールス信号の基礎
+        2) Q符号・CW符号とは
+        3) アルファベット一覧 (A〜Z)
+        4) 数字一覧 (0〜9)
+        5) 記号一覧(?など)
+        6) 和文一覧(ア〜ン、濁音・半濁音)
+        7) これだけは覚えておきたいCW符号(10語)
+        8) Q符号 一部紹介(Qコード)
+        9) CW符号 一部紹介(一般的略号)
+        10) ランダムクイズ(文字)
+        11) ランダムクイズ(音声)
+        q) 終了
+        選択(1-11, q):
+      MENU
+      q_cw_detail_course: <<~NODTL,
+
+        Q符号は、無線通信を円滑に行うために国際的に標準化された三文字の略号群で、すべて“Q”から始まります。
+        例えば、QRMは他局の混信があることを示し、QRNは大気雑音の存在、QRPは送信出力を下げるよう要請する符号です。
+        これらQ符号を用いることで、詳細な文脈や長い文章なしに、短く明確な意図を伝達できます。
+        言語や文化が異なるオペレーター間でも、Q符号を共有していれば、共通の“通信言語”として機能し、瞬時に状況を理解し合えるのです。
+
+        一方、CW略号はアマチュア無線や国際通信で慣用的に用いられる短縮表現で、定型的な挨拶や状態報告を簡潔に行います。
+        たとえば、OMは男性オペレーターを親しみを込めて呼ぶ表現、YLは女性オペレーターを示す略称で、国籍や言語を超えて“仲間”として呼びかけやすくなります。
+        FBは“Fine Business”の略で“とても良い”という肯定的評価を素早く伝え、TNXは“Thanks”を短くして感謝を即座に示せます。
+        これらの略語を活用すれば、長いフレーズを何度も打つ必要がなくなり、交信時間を短縮して効率的なコミュニケーションを可能にします。
+
+        Q符号とCW略号を併せて使うことで、単なる符号の受け渡しを超え、互いの意図や状況を短時間で的確に伝え合えるようになります。
+        電波状況が悪い、使用言語が異なる、緊急性が高いなど、多様な条件下でも、これらの略号は共通の合図として機能します。
+        その結果、オペレーター同士は必要最小限の符号で的確な応答が可能になり、国際的なネットワーク形成や相互理解を促進します。
+
+        Q符号はよりシステマティックな質問・指令的要素を担い、CW略号はより人間味や友好度を高める柔らかいコミュニケーション手段と言えます。
+        両者を習熟すれば、無線通信における多言語・多文化の壁を薄め、効率性と親密さを両立させた、国際的で実用的な交信が実現します。
+
+        Enterキーでメインメニューへ戻ります。
+      NODTL
+      all_alphabets_title: "=== アルファベット一覧 (A〜Z) ===",
+      all_digits: "=== 数字一覧 (0〜9) ===",
+      symbol_title: "=== 記号一覧(?など) ===",
+      wabun_title: "=== 和文一覧(ア〜ン、濁音・半濁音) ===",
+      abbrev_essential_title: "=== これだけは覚えておきたいCW符号(10語) ===",
+      abbrev_q_signs_title: "=== Q符号 一部紹介(Qコード) ===",
+      abbrev_cw_signs_title: "=== CW符号 一部紹介(一般的略号) ===",
+      abbrev_format: "%<name>s: %<morse_code>s\n  日本語: %<meaning_ja>s\n  English: %<meaning_en>s",
+      quiz_char_start: <<~QSTART,
+
+        === ランダムクイズ(文字) ===
+        A-Z,0-9から10問出題します。
+        モールス符号を表示するので、対応する文字を答えてください。
+      QSTART
+      quiz_sound_start: <<~QSTART,
+
+        === ランダムクイズ(音声) ===
+        A-Z,0-9から10問出題します。
+        音で提示する符号から文字を判別してください。
+      QSTART
+      quiz_char_question: ->(i){ "問題#{i+1}: このモールス符号は何の文字？" },
+      quiz_sound_question: ->(i){ "問題#{i+1}: 音声再生。何の文字？" },
+      quiz_correct: "正解です！",
+      quiz_incorrect: ->(answer){ "惜しい！正解は #{answer} でした。" },
+      quiz_result: ->(count){ "クイズ終了！ #{count}/10問正解。\nEnterキーでメインメニューに戻ります。" },
+      press_enter_return: "Enterキーでメインメニューに戻ります。"
+    },
+    en: {
+      help: <<~HELP,
+
+        Usage:
+        -----------------------------------------------------------------
+          morsby -h / -help       : Show help
+          morsby -learn           : Enter learning mode
+          morsby "char"  : Convert input to Morse
+
+          Option:
+          --lang en (English mode. The Default is Japanese mode without this option.)
+          --pro (High speed mode)
+        -----------------------------------------------------------------
+
+      HELP
+      learning_mode_end: "\nExiting learning mode...",
+      learning_intro: "Morse code uses short and long signals to represent letters, digits, and symbols. " \
+                      "It originated when telegraphs (sending text via electrical signals) were the primary long-distance communication method, long before telephones or the internet. " \
+                      "This historical foundation makes Morse still valuable today in emergencies and low-bandwidth conditions, enabling meaningful exchange across language barriers.",
+      about_morse: "[1) Morse code basics]\n" \
+                   "In Morse code basics, you learn how each letter (A-Z), digit (0-9), and punctuation mark corresponds to unique patterns of short and long signals. " \
+                   "Initially, you consult a code chart, but with practice, you’ll recognize characters by sound alone. " \
+                   "Morse’s low resource requirements make it reliable under poor conditions, and it can be conveyed via audio, light, or tactile means.\n\n" \
+                   "This skill transforms simple tones into meaningful text, allowing seamless communication across language barriers and technical constraints. " \
+                   "As you become proficient, the code feels like a new language—one where short/long tones become words in your mind without conscious translation. " \
+                   "Historically central to telegraphy, Morse code still endures in amateur radio, emergency communications, and international friendships, " \
+                   "offering a time-tested method to exchange information quickly and accurately.\n\n" \
+                   "Mastering these basics empowers you to communicate in challenging scenarios, tap into a rich global tradition, and appreciate a technique " \
+                   "that remains both practically valuable and culturally significant.",
+      press_enter_main: "Press Enter to proceed to the main menu.",
+      main_menu: <<~MENU,
+
+        === Main Menu ===
+        1) Morse code basics
+        2) About Q-codes & CW
+        3) Alphabets (A-Z)
+        4) Digits (0-9)
+        5) Punctuation (?, ., etc.)
+        6) Wabun (Japanese)
+        7) Important abbreviations (10 words)
+        8) Q-codes
+        9) CW abbreviations
+        10) Random Quiz (Characters)
+        11) Random Quiz (Sound)
+        q) Quit
+        Select (1-11, q):
+      MENU
+      q_cw_detail_course: <<~NODTL,
+
+        Q-codes are internationally standardized three-letter codes (all starting with 'Q') designed to convey specific questions and instructions concisely.
+        For instance, QRM indicates interference from other stations, QRN signifies atmospheric noise, and QRP requests reduced transmitter power.
+        By using Q-codes, operators communicate critical information quickly and universally, without lengthy explanations or shared spoken language.
+        They serve as a common “lingua franca” in radio communication, allowing instant comprehension of operational conditions.
+
+        CW abbreviations, on the other hand, simplify common greetings and status reports into short forms.
+        For example, OM (for a male operator) and YL (for a female operator) enable friendly, direct addresses that transcend nationalities.
+        FB (Fine Business) quickly expresses approval or good conditions, and TNX (Thanks) efficiently conveys gratitude without typing full words.
+        Employing these abbreviations reduces message length, saves time, and creates a more personable, welcoming atmosphere during communication.
+
+        Together, Q-codes and CW abbreviations transform Morse exchanges into efficient and humanized interactions.
+        Regardless of language barriers, poor signal conditions, or urgency, these sets of shorthand ensure that essential meanings and camaraderie are conveyed promptly and accurately.  
+        Mastering them empowers operators to forge international understanding, streamline their operations, and maintain a friendly rapport across borders.
+
+        Press Enter to return.
+      NODTL
+      all_alphabets_title: "=== Alphabets (A-Z) ===",
+      all_digits: "=== Digits (0-9) ===",
+      symbol_title: "=== Punctuation ===",
+      wabun_title: "=== Wabun (Japanese) ===",
+      abbrev_essential_title: "=== 10 Important Abbreviations ===",
+      abbrev_q_signs_title: "=== Q-codes ===",
+      abbrev_cw_signs_title: "=== CW Abbreviations ===",
+      abbrev_format: "%<name>s: %<morse_code>s\n  Japanese: %<meaning_ja>s\n  English: %<meaning_en>s",
+      quiz_char_start: <<~QSTART,
+
+        === Random Quiz (Characters) ===
+        10 questions from A-Z,0-9.
+        We'll show Morse code; guess the character.
+      QSTART
+      quiz_sound_start: <<~QSTART,
+
+        === Random Quiz (Sound) ===
+        10 questions from A-Z,0-9.
+        Identify the character from the tone.
+      QSTART
+      quiz_char_question: ->(i){ "Question #{i+1}: Which character is this Morse code?" },
+      quiz_sound_question: ->(i){ "Question #{i+1}: Listen to the tone. Which character?" },
+      quiz_correct: "Correct!",
+      quiz_incorrect: ->(answer){ "Wrong. The correct answer was #{answer}." },
+      quiz_result: ->(count){ "Quiz finished! You got #{count}/10 correct.\nPress Enter to return." },
+      press_enter_return: "Press Enter to return to the main menu."
+    }
+  }.freeze
+end

data/lib/morsby/morse_table.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Morsby
+  MORSE_TABLE = {
+    'A' => '.-',    'B' => '-...',  'C' => '-.-.',  'D' => '-..',
+    'E' => '.',     'F' => '..-.',  'G' => '--.',   'H' => '....',
+    'I' => '..',    'J' => '.---',  'K' => '-.-',   'L' => '.-..',
+    'M' => '--',    'N' => '-.',    'O' => '---',   'P' => '.--.',
+    'Q' => '--.-',  'R' => '.-.',   'S' => '...',   'T' => '-',
+    'U' => '..-',   'V' => '...-',  'W' => '.--',   'X' => '-..-',
+    'Y' => '-.--',  'Z' => '--..',
+    '0' => '-----', '1' => '.----', '2' => '..---', '3' => '...--',
+    '4' => '....-', '5' => '.....', '6' => '-....', '7' => '--...',
+    '8' => '---..', '9' => '----.'
+  }.freeze
+end

data/lib/morsby/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Morsby
+  VERSION = "0.1.0"
+end

data/lib/morsby/wabun_table.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+# 和文モールス符号
+# 基本清音に加え、濁音・半濁音付きの仮名も定義
+# 濁音は".." + 清音符号
+# 半濁音は"..-" + 清音符号
+
+module Morsby
+  WABUN_TABLE = {
+    # 清音
+    'ア' => '--.--',
+    'イ' => '.-',
+    'ウ' => '..-',
+    'エ' => '-.-..',
+    'オ' => '.---.',
+
+    'カ' => '-.-',
+    'キ' => '-.-.-',
+    'ク' => '---.-',
+    'ケ' => '-.-.',
+    'コ' => '----',
+
+    'サ' => '-...',
+    'シ' => '--.-.',
+    'ス' => '-.-.-.',
+    'セ' => '--.-..',
+    'ソ' => '-.-.--',
+
+    'タ' => '-',
+    'チ' => '.-.-',
+    'ツ' => '..-..',
+    'テ' => '.-.---',
+    'ト' => '..--.',
+
+    'ナ' => '.-.',
+    'ニ' => '-.-.--',
+    'ヌ' => '....',
+    'ネ' => '--.-',
+    'ノ' => '..---',
+
+    'ハ' => '-...-',
+    'ヒ' => '--..-',
+    'フ' => '----.',
+    'ヘ' => '-...',
+    'ホ' => '-..',
+
+    'マ' => '-..-',
+    'ミ' => '..-.-',
+    'ム' => '-.',
+    'メ' => '-...-.',
+    'モ' => '-..--',
+
+    'ヤ' => '.-...',
+    'ユ' => '..--..',
+    'ヨ' => '.--..',
+
+    'ラ' => '...',
+    'リ' => '--.--',
+    'ル' => '-....',
+    'レ' => '---',
+    'ロ' => '.-.-.',
+
+    'ワ' => '.-..',
+    'ヰ' => '.--.-',
+    'ヱ' => '.-..-',
+    'ヲ' => '.---',
+    'ン' => '.-.-',
+
+    # 濁音(清音に".."を前置)
+    'ガ' => '..' + '-.-', # ガ(カに濁点)
+    'ギ' => '..' + '-.-.-',
+    'グ' => '..' + '---.-',
+    'ゲ' => '..' + '-.-.',
+    'ゴ' => '..' + '----',
+
+    'ザ' => '..' + '-...',
+    'ジ' => '..' + '--.-.',
+    'ズ' => '..' + '-.-.-.',
+    'ゼ' => '..' + '--.-..',
+    'ゾ' => '..' + '-.-.--',
+
+    'ダ' => '..' + '-',
+    'ヂ' => '..' + '.-.-',
+    'ヅ' => '..' + '..-..',
+    'デ' => '..' + '.-.---',
+    'ド' => '..' + '..--.',
+
+    'バ' => '..' + '-...-',
+    'ビ' => '..' + '--..-',
+    'ブ' => '..' + '----.',
+    'ベ' => '..' + '-...',
+    'ボ' => '..' + '-..',
+
+    # 半濁音(清音に"..-"を前置)
+    'パ' => '..-' + '-...-',
+    'ピ' => '..-' + '--..-',
+    'プ' => '..-' + '----.',
+    'ペ' => '..-' + '-...',
+    'ポ' => '..-' + '-..'
+  }
+end

data/lib/morsby.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "morsby/version"
+require_relative "morsby/cli"
+
+module Morsby
+  def self.version
+    Morsby::VERSION
+  end
+
+  def self.run(argv)
+    CLI.new.run(argv)
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: morsby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- oguressive
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-12-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nkf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A tool to learn Morse code, including alphabets, digits, punctuation,
+  Q-codes, CW abbreviations, and Wabun Morse. Provides quizzes and bilingual messages.
+email:
+- oguressive.dev@gmail.com
+executables:
+- morsby
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- bin/morsby
+- lib/morsby.rb
+- lib/morsby/abbreviations.rb
+- lib/morsby/cli.rb
+- lib/morsby/messages.rb
+- lib/morsby/morse_table.rb
+- lib/morsby/version.rb
+- lib/morsby/wabun_table.rb
+homepage: https://github.com/oguressive/morsby
+licenses:
+- MIT
+metadata:
+  changelog_uri: https://github.com/oguressive/morsby/blob/master/CHANGELOG.md
+  source_code_uri: https://github.com/oguressive/morsby/
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Morse code learning and practice tool
+test_files: []