dictionaries 0.2.191

data/lib/dictionaries/gui/shared_code/dictionaries/dictionary_module.rb

@@ -0,0 +1,362 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::GUI::Gtk::DictionaryModule
+# =========================================================================== #
+# require 'dictionaries/gui/shared_code/dictionaries/dictionary_module.rb'
+# include ::Dictionaries::GUI::Gtk::DictionaryModule
+# =========================================================================== #
+module Dictionaries
+
+module GUI
+
+module Gtk
+
+module DictionaryModule
+
+  require 'dictionaries/toplevel_methods/e.rb'
+  require 'dictionaries/toplevel_methods/misc.rb'
+
+  require 'dictionaries/class/ask_word_from_dictionary.rb'
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  include ::Colours
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 1080
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 800
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Dictionary'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    super(:vertical)
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    set_use_this_font(:dejavu_condensed_25)
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, NAMESPACE]
+    # ======================================================================= #
+    # === @title
+    # ======================================================================= #
+    @title  = TITLE
+    # ======================================================================= #
+    # === @width
+    # ======================================================================= #
+    @width  = WIDTH
+    # ======================================================================= #
+    # === @height
+    # ======================================================================= #
+    @height = HEIGHT
+    # ======================================================================= #
+    # === @dictionaries
+    # ======================================================================= #
+    @dictionaries = Dictionaries.new(:do_not_run_yet)
+    Dictionaries.set_main_file(:default)
+    @dictionaries.load_the_english_file
+    set_gtk_font_size :default
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    2
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === e
+  # ========================================================================= #
+  def e(i = '')
+    ::Dictionaries.e(i)
+  end
+
+  # ========================================================================= #
+  # === add_ask_the_question_button
+  # ========================================================================= #
+  def add_ask_the_question_button
+    button = gtk_bold_button('Translate into german')
+    button.fancy_tooltip =
+      'Click this button in order to <b>translate the english '\
+      'word into the german equivalent word</b>.'
+    button.on_clicked {
+      button_pressed_so_try_to_convert_the_input
+    }
+    button.modify_background(:normal,   :khaki)    # ← default colour
+    button.modify_background(:prelight, :paleturquoise) # ← mouse-on-over events
+    button.modify_background(:active,   :slategray)     # ← colour on mouse-press-event
+    minimal(button, 0)
+  end
+
+  # ========================================================================= #
+  # === create_input_field_on_top
+  #
+  # This is the main widget for user input. The user types in some
+  # words, and then hits the main button on the bottom, in order
+  # to translate the (english) word to german.
+  # ========================================================================= #
+  def create_input_field_on_top
+    text_for_the_label = 'Input an english word in the field below'
+    text = gtk_label(text_for_the_label)
+
+    if use_gtk2?
+      text.set_markup(
+        '<span size="x-large" weight="bold">'+text_for_the_label+'</span>',
+        true
+      )
+    else
+      text.set_markup(
+        '<span size="x-large" weight="bold">'+text_for_the_label+'</span>',
+        use_underline: true
+      )
+    end
+
+    # ======================================================================= #
+    # Add the "input field" next for the english word that is to
+    # be translated.
+    # ======================================================================= #
+    @input_field = gtk_input_field
+    completion = gtk_entry_completion
+    @input_field.completion = completion # Assign the completion.
+    completion_model = ::Gtk::ListStore.new(String)
+    @dictionaries.array.each { |word|
+      iter = completion_model.append
+      iter[0] = word
+    }
+    completion.model = completion_model
+    # ======================================================================= #
+    # Use model column 0 as the text column
+    # ======================================================================= #
+    completion.text_column = 0
+    @input_field.center
+    @input_field.on_key_press_event { |widget, event|
+      case Gdk::Keyval.to_name(event.keyval) 
+      when 'Return', 'KP_Enter'
+        button_pressed_so_try_to_convert_the_input
+      end
+    }
+    hbox_holding_label_and_input_field = gtk_vbox(
+      text, @input_field
+    )
+    minimal(hbox_holding_label_and_input_field, 4)
+  end
+
+  # ========================================================================= #
+  # === create_answer_field
+  #
+  # This method builds up the "answer-widget".
+  # ========================================================================= #
+  def create_answer_field
+    @answer_field = gtk_input_field
+    @answer_field.center
+  end
+
+  # ========================================================================= #
+  # === button_pressed_so_try_to_convert_the_input                (click tag)
+  #
+  # This action is called when the user clicks on the button.
+  # ========================================================================= #
+  def button_pressed_so_try_to_convert_the_input
+    user_input = @input_field.return_input
+    unless user_input.empty? # We check whether the user did input something.
+      translated_word = @dictionaries.translate(user_input)
+      e "#{sfancy(user_input)} → #{simp(translated_word)}"
+      @answer_field.set_text(translated_word)
+    end
+  end
+
+  # ========================================================================= #
+  # === add_the_widget_for_remote_query_of_the_dictionary_at_leo (bottom tag)
+  #
+  # This is the bottom widget.
+  # ========================================================================= #
+  def add_the_widget_for_remote_query_of_the_dictionary_at_leo
+    bottom_vbox = gtk_vbox
+    bold_label = gtk_bold_label(
+      'Query from a remote website instead (more entries available)'
+    ) 
+    bottom_vbox.minimal(
+      bold_label
+    )
+    # This is the user-input entry at the bottom.
+    @entry_for_the_remote_query = gtk_entry
+    @entry_for_the_remote_query.center
+    @entry_for_the_remote_query.on_key_press_event { |widget, event|
+      case Gdk::Keyval.to_name(event.keyval) 
+      when 'Return', 'KP_Enter'
+        do_perform_a_remote_query_to_the_leo_dictionary
+      end
+    }
+    bottom_vbox.minimal(
+      @entry_for_the_remote_query
+    )
+    button_for_the_remote_query = gtk_button(
+      'Query from a remote dictionary'
+    )
+    button_for_the_remote_query.fancy_tooltips = 
+      'This will <b>query the remote dictionary</b> at leo instead. '\
+      'The <b>advantage</b> here is that the dataset at leo will '\
+      'contain many more entries than does the knowledgebase '\
+      'distributed with the <b>dictionaries gem</b>.'
+    button_for_the_remote_query.on_clicked {
+      do_perform_a_remote_query_to_the_leo_dictionary
+    }
+    @entry_at_the_bottom_showing_the_result_from_online_leo = gtk_entry
+    @entry_at_the_bottom_showing_the_result_from_online_leo.center
+    bottom_vbox.minimal(
+      @entry_at_the_bottom_showing_the_result_from_online_leo
+    )
+    bottom_vbox.minimal(
+      button_for_the_remote_query
+    )
+    maximal(bottom_vbox)
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                          (skeleton tag, connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    minimal(@answer_field) # ← Translation appears here.
+    add_ask_the_question_button
+    add_the_widget_for_remote_query_of_the_dictionary_at_leo
+    add_the_statistics_frame
+  end
+
+  # ========================================================================= #
+  # === add_the_statistics_frame
+  # ========================================================================= #
+  def add_the_statistics_frame
+    maximal(@frame_statistics, 2)
+  end
+
+  # ========================================================================= #
+  # === update_the_statistics_frame                              (update tag)
+  # ========================================================================= #
+  def update_the_statistics_frame(i = return_currently_selected_file)
+    @label_currently_selected_file.set_text(i)
+  end
+
+  # ========================================================================= #
+  # === do_perform_a_remote_query_to_the_leo_dictionary
+  # ========================================================================= #
+  def do_perform_a_remote_query_to_the_leo_dictionary(
+      i = @entry_for_the_remote_query.text.to_s
+    )
+    if i and !i.empty?
+      array = ::Dictionaries.return_array_of_translated_words_from_online_leo(i)
+      result = array.first
+      @entry_at_the_bottom_showing_the_result_from_online_leo.set_text(result)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_statistics_frame
+  # ========================================================================= #    
+  def create_the_statistics_frame
+    @frame_statistics = gtk_frame(' Statistics ')
+    @frame_statistics.make_bold
+    vbox = gtk_vbox
+    @label_currently_selected_file = gtk_label(return_currently_selected_file)
+    vbox.minimal(
+      @label_currently_selected_file, 0
+    )
+    @frame_statistics.add(vbox)
+  end
+
+  # ========================================================================= #
+  # === return_currently_selected_file
+  # ========================================================================= #
+  def return_currently_selected_file
+    'Currently selected file: '+
+    File.basename(
+      @dictionaries.currently_selected_file?.to_s
+    )
+  end
+
+  # ========================================================================= #
+  # === create_skeleton
+  # ========================================================================= #
+  def create_skeleton
+    create_input_field_on_top
+    create_answer_field
+    create_the_statistics_frame
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    create_skeleton
+    connect_skeleton
+    update_the_statistics_frame
+    show_all
+  end
+
+  # ========================================================================= #
+  # === Dictionaries::GUI::Gtk::Dictionary.run
+  #
+  # Use this method if you wish to start a new gtk-application window.
+  # ========================================================================= #
+  def self.run
+    require 'gtk_paradise/run'
+    _ = Dictionaries::GUI::Gtk::Dictionary.new
+    r = ::Gtk.run
+    r << _
+    r.set_size_request(
+      _.width?,
+      _.height?
+    )
+    r.border_width = 12
+    r.top_left_then_run
+  end
+
+end; end; end
+
+# =========================================================================== #
+# === Dictionaries.gtk_widget
+#
+# This toplevel-method can be used to return the gtk-widget, which
+# can then be embedded by other ruby-gtk applications, in particular
+# admin_panel.rb of the gtk_paradise project.
+# =========================================================================== #
+def self.gtk_widget
+  Dictionaries::GUI::Gtk::Dictionary.new
+end
+
+end

data/lib/dictionaries/gui/tk/README.md

@@ -0,0 +1,2 @@
+This directory includes experimental tk code. The main GUI is
+ruby-gtk, so this is just a fallback.

data/lib/dictionaries/gui/tk/dictionary.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::GUI::Tk::Dictionary
+#
+# This is a small TK-wrapper.
+# =========================================================================== #
+# require 'dictionaries/gui/tk/dictionary.rb'
+# =========================================================================== #
+begin
+  require 'tk'
+rescue LoadError; end
+require 'dictionaries/class/ask_word_from_dictionary.rb'
+require 'dictionaries/toplevel_methods/e.rb'
+
+module Dictionaries
+
+module GUI
+
+module Tk
+
+class Dictionary < ::TkFrame # < Base === Dictionaries::GUI::Tk::Dictionary.new
+
+  include Colours::E
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    super()
+    reset
+    set_input(i)
+    title "TK wrapper for the Dictionaries project"
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    TkLabel.new(root) do
+     text 'Hello, World!'
+     pack { padx 15 ; pady 15; side 'left' }
+    end
+  end
+ 
+  # ========================================================================= #
+  # === Dictionaries::GUI:Tk::Dictionary[]
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Dictionaries::GUI:Tk::Dictionary.new(ARGV)
+  ::Tk.mainloop
+end # dictionary.rb

data/lib/dictionaries/project/project_base_directory.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/project/project_base_directory.rb'
+# =========================================================================== #
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries::PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY =
+    File.absolute_path("#{__dir__}/..")+'/'
+
+  # ========================================================================= #
+  # === Dictionaries.project_base_dir?
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end
+
+end

data/lib/dictionaries/project/project_yaml_directory.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will point to the yaml directory of the Dictionaries project.
+# =========================================================================== #
+# require 'dictionaries/project/project_yaml_directory.rb'
+# =========================================================================== #
+require 'dictionaries/project/project_base_directory.rb'
+
+module Dictionaries
+
+  # ========================================================================= #
+  # === PROJECT_YAML_DIRECTORY
+  # ========================================================================= #
+  PROJECT_YAML_DIRECTORY = "#{PROJECT_BASE_DIRECTORY}yaml/"
+
+  # ========================================================================= #
+  # === Dictionaries.project_yaml_dir?
+  # ========================================================================= #
+  def self.project_yaml_dir?
+    PROJECT_YAML_DIRECTORY
+  end; self.instance_eval { alias dictionary_directory? project_yaml_dir? } # === Dictionaries.dictionary_directory?
+
+end

data/lib/dictionaries/require_project/require_project.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/require_project/require_project.rb'
+# =========================================================================== #
+require 'dictionaries/ask_italian_word.rb'
+require 'dictionaries/toplevel_methods/has_key.rb' # This file requires the files above.
+require 'dictionaries/toplevel_methods/module_methods.rb'
+require 'dictionaries/toplevel_methods/english_to_german.rb'
+require 'dictionaries/toplevel_methods/is_on_roebe.rb'

data/lib/dictionaries/sinatra/app.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::Sinatra
+# =========================================================================== #
+# require 'dictionaries/sinatra/app.rb'
+# =========================================================================== #
+require 'sinatra/base.rb'
+
+module Dictionaries
+
+class Sinatra < ::Sinatra::Base
+
+  require 'dictionaries/class/ask_word_from_dictionary.rb'
+  require 'dictionaries/toplevel_methods/is_on_roebe.rb'
+  require 'dictionaries/sinatra/english_to_german.rb'
+
+  include Colours
+  include Colours::E
+  begin
+    require 'html_tags'
+    include HtmlTags::BaseModule
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === USE_THIS_PORT
+  # ========================================================================= #
+  USE_THIS_PORT = '5252'
+
+  set :port, USE_THIS_PORT
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    reset
+    consider_opening_the_page_in_the_browser
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === consider_opening_the_page_in_the_browser
+  # ========================================================================= #
+  def consider_opening_the_page_in_the_browser
+    if ::Dictionaries.is_on_roebe?
+      begin
+        require 'open'
+      rescue LoadError; end
+      # ===================================================================== #
+      # Tell us which port will be used:
+      # ===================================================================== #
+      target = "http://localhost:#{USE_THIS_PORT}/"
+      e sfancy(target)
+      Thread.new {
+        sleep 1.0
+        Open.in_browser(target)
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === / Entry point
+  #
+  # This is the root of our web-application.
+  # ========================================================================= #
+  get('/'){
+    html_header_default_title_and_start_of_the_body_tag+
+    p('Available translations:')+
+    a('/english_to_german')+
+    br+
+    a('/german_to_english')+
+    br
+  }
+
+  # ========================================================================= #
+  # === not_found
+  # ========================================================================= #
+  not_found {
+    p('This particular <b>API</b> was not found.')
+  }
+
+end
+
+# =========================================================================== #
+# === Dictionaries.start_sinatra_interface
+#
+# This method can be used to start the sinatra interface.
+# =========================================================================== #
+def self.start_sinatra_interface
+  e 'Trying to start the sinatra-interface of the Dictionaries project.'
+  ::Dictionaries::Sinatra.run!
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Dictionaries.start_sinatra_interface
+end # dictionaries --sinatra