studium 0.18.7

data/lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb

@@ -0,0 +1,3266 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::GUI::UniversalWidgets::ExamTrainer
+#
+# This widget can be used to ask exam questions.
+#
+# For SQL we could use this:
+#
+#   result = `sqlite3 #{SQLITE_DATABASE_FILE} "SELECT * FROM #{current_exam_topic?} ORDER BY RANDOM() LIMIT 1;"`
+#   e result
+#
+# Usage example:
+#
+#   Studium::GUI::UniversalWidgets::ExamTrainer.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/gui/universal_widgets/exam_trainer/exam_trainer.rb'
+# =========================================================================== #
+require 'universal_widgets/base/base.rb'
+
+module Studium
+
+module GUI
+
+module UniversalWidgets
+
+class ExamTrainer < ::UniversalWidgets::Base # === Studium::GUI::UniversalWidgets::ExamTrainer
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+
+  require 'studium/exams/question_answer/question_answer.rb'
+
+  begin
+    require 'roebe/toplevel_methods/rinstall2.rb'
+  rescue LoadError; end
+
+  require 'studium/toplevel_methods/toplevel_methods.rb'
+  require 'studium/toplevel_methods/find_exam_topic_and_exam_title.rb'
+  require 'studium/statistics/report_how_many_exam_questions_were_answered.rb'
+  require 'studium/requires/require_class_exams_solved.rb'
+  require 'studium/exams/exam_question/exam_question.rb'
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Simple Exam Trainer'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '95% or minimum 2250px'
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExamTrainer::HEIGHT
+  #
+  # 1080px is the highest for my large monitor, so I set this below.
+  # ========================================================================= #
+  HEIGHT = '90% or minimum 1060px'
+
+  # ========================================================================= #
+  # === DEFAULT_DELAY
+  #
+  # This constant specifies how long to wait before the answer is
+  # revealed, if the user has set the checkbutton to "automatically
+  # answer the question".
+  # ========================================================================= #
+  DEFAULT_DELAY = '15.0' # This is currently hardcoded.
+  
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExamTrainer::N_EXAM_QUESTIONS_IN_TOTAL
+  # ========================================================================= #
+  N_EXAM_QUESTIONS_IN_TOTAL = 'n exam-questions in total'
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::N_ANSWERED_EXAM_QUESTIONS
+  # ========================================================================= #
+  N_ANSWERED_EXAM_QUESTIONS = 'n answered exam-questions'
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::N_UNANSWERED_EXAM_QUESTIONS
+  # ========================================================================= #
+  N_UNANSWERED_EXAM_QUESTIONS = 'n unanswered exam-questions'
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::N_PERCENT_SOLVED
+  #
+  # An alternative name would be 'percentage solved'.
+  # ========================================================================= #
+  N_PERCENT_SOLVED = 'n % solved'
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::SLEEP_N_SECONDS
+  # ========================================================================= #
+  SLEEP_N_SECONDS = 'sleep n seconds'
+
+  # ========================================================================= #
+  # === PANEL_TOOLTIP_TEXT
+  # ========================================================================= #
+  PANEL_TOOLTIP_TEXT = 'Exam Trainer Widget'
+
+  # ========================================================================= #
+  # === SQLITE_DATABASE_FILE
+  #
+  # This is experimental - one day we may want to query from a sqlite
+  # database rather than flat files. Or, at the least, offer this as
+  # a possibility.
+  # ========================================================================= # 
+  SQLITE_DATABASE_FILE = '/Depot/jjjj/exam_questions.db'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  #
+  # The older font was :dejavu_condensed_20 and the oldest font
+  # was :deja_vu_sans_25. Before December 2023 the font was :hack_20,
+  # but now it is :hack_22.
+  #
+  # It is recommended to use the method main_font? rather than this
+  # constant directly.
+  # ========================================================================= #
+  USE_THIS_FONT = :hack_22
+
+  # ========================================================================= #
+  # === LARGER_FONT
+  # ========================================================================= #
+  LARGER_FONT   = :hack_26
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  #
+  # This one should be matched onto the larger font defined above.
+  # ========================================================================= #
+  SMALLER_FONT  = :hack_20
+
+  # ========================================================================= #
+  # === SMALLEST_FONT
+  # ========================================================================= #
+  SMALLEST_FONT = :hack_15
+
+  # ========================================================================= #
+  # === WORD_WRAP_AT_N_CHARACTERS
+  #
+  # Specify after n characters a given text has to be wrapped via
+  # newlines, e. g. "\n".
+  # ========================================================================= #
+  WORD_WRAP_AT_N_CHARACTERS = 76
+
+  # ========================================================================= #
+  # === DEFAULT_PLACEHOLDER_TEXT
+  # ========================================================================= #
+  DEFAULT_PLACEHOLDER_TEXT =
+    'You can input your answer to the exam question here.'
+
+  # ========================================================================= #
+  # === USE_THIS_MARGIN
+  # ========================================================================= #
+  USE_THIS_MARGIN = 12
+
+  # ========================================================================= #
+  # === USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC
+  #
+  # This constant can be used to specify the default exam topic to be
+  # used on startup of this application.
+  # ========================================================================= #
+  USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC = 
+    'toxikologie' # bioinformatics' # 'virus' # stemcells' # chem1' #anatomy'
+
+  # ========================================================================= #
+  # === HASH_DESIGNATED_KEY_COMBINATIONS
+  # ========================================================================= #
+  HASH_DESIGNATED_KEY_COMBINATIONS = {
+    'strg+s': 'save_the_buffer',
+    'alt+y':  'activate_the_third_textview'
+  }
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    # ======================================================================= #
+    # We first have to determine the GUI that is to be used, even before
+    # calling reset(). The reason is that this will also require some
+    # files, such as the Gdk namespace, which may be used by the GUI
+    # related parts for ruby-gtk3, for instance.
+    # ======================================================================= #
+    determine_the_GUI_to_be_used(commandline_arguments)
+    # super(:vertical) This should be for ruby-gtk3, for a BaseModuleBox.
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() if respond_to?(:super)
+    reset_the_internal_variables
+    reset_the_base_module # This must come after reset_the_internal_variables().
+    reset_the_shared_module
+    infer_the_namespace
+    reset_the_shared_variables
+    Studium.set_runmode :gui # Make it known that we use the gui-runmode in this case.
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title; this must come after we delegate to the
+    #     @configuration object
+    # ======================================================================= #
+    set_title(
+      return_the_title_from_the_config_file(true, @configuration)
+    )
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(title?, WIDTH, HEIGHT, USE_THIS_FONT)
+    handle_CSS if use_gtk3?
+    enable_all_key_combinations # This should come after CSS was handled.
+    infer_the_size_automatically
+    # ======================================================================= #
+    # === @delay_to_use
+    # ======================================================================= #
+    set_delay_to_use(DEFAULT_DELAY)
+    # ======================================================================= #
+    # === @internal_hash[:may_we_reveal_the_answer]
+    # ======================================================================= #
+    @internal_hash[:may_we_reveal_the_answer] = true
+    # ======================================================================= #
+    # === :prefer_emoji_or_images
+    #
+    # This variable can have two different states:
+    #
+    #   :emoji
+    #   :images
+    #
+    # If :emoji is active then we will use emojis to enhance the
+    # user interface. If :images is active then we will use different
+    # images from the main icon theme in use instead.
+    #
+    # The reason why this was added in May 2021 was because the host
+    # system may not support this or that emoji. If the emoji is
+    # not supported then the user will see only garbage, which isn't
+    # great. Thus, the default is now for :images since as of May
+    # 2021, but with the intended goal to retain support for emojis
+    # as well, should a user ever want to change this.
+    # ======================================================================= #
+    @internal_hash[:prefer_emoji_or_images] = :images
+    # ======================================================================= #
+    # === :use_this_editor
+    #
+    # The value of this variable may be :bluefish or :internal usually.
+    # ======================================================================= #
+    @internal_hash[:use_this_editor] = :bluefish # :internal
+    # ======================================================================= #
+    # === :show_ten_aliases
+    #
+    # This is only in use if the roebe-gem is available. Many users of this
+    # class won't need it though.
+    # ======================================================================= #
+    @internal_hash[:show_ten_aliases] = nil
+    # ======================================================================= #
+    # === @internal_hash[:colour_to_use_for_the_notebook_labels]
+    # ======================================================================= #
+    @internal_hash[:colour_to_use_for_the_notebook_labels] = 'darkblue'
+    # ======================================================================= #
+    # === @internal_hash[:smaller_font]
+    # ======================================================================= #
+    @internal_hash[:smaller_font] = SMALLER_FONT
+    consider_making_available_the_show_ten_aliases_widget
+    upon_delete_event_quit_the_application
+  end
+
+  # ========================================================================= #
+  # === reset_the_shared_variables
+  # ========================================================================= #
+  def reset_the_shared_variables
+    # ======================================================================= #
+    # === :hash_dataset_of_all_lectures
+    #
+    # This is the Hash that looks like this:
+    #
+    #   :biopolymers => {:n_total_questions=>4,  :n_questions_answered=>0,  :percentage_of_questions_answered=>0.0},
+    #   :biophysik   => {:n_total_questions=>28, :n_questions_answered=>0,  :percentage_of_questions_answered=>0.0},
+    #
+    # In other words: it will keep track of how many exam questions and
+    # exam answers are in that Hash.
+    # ======================================================================= #
+    @internal_hash[:hash_dataset_of_all_lectures] =
+      Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.internal_dataset
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    0
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    8
+  end
+
+  # ========================================================================= #
+  # === update_hash_dataset_of_all_lectures
+  # ========================================================================= #
+  def update_hash_dataset_of_all_lectures
+    @internal_hash[:hash_dataset_of_all_lectures] =
+      Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.internal_dataset
+  end
+
+  # ========================================================================= #
+  # === find_completion_for_the_entry_for_the_current_exam_topic
+  # ========================================================================= #
+  def find_completion_for_the_entry_for_the_current_exam_topic
+    _ = entry_for_the_current_exam_topic?
+    current_text = _.text?
+    new_text     = Studium.exam_topic_completion(current_text) { :be_quiet } # Expand it here.
+    if new_text
+      unless new_text == current_text
+        set_exam_topic(new_text)
+      end
+      one_two_three # The old call was: do_update_the_entry_n_questions
+    end
+  end
+
+  # ========================================================================= #
+  # === do_update_the_entry_n_questions
+  # ========================================================================= #
+  def do_update_the_entry_n_questions(
+      current_exam_topic =
+        current_exam_topic?
+    )
+    set_n_exam_questions(
+      return_n_questions_from_the_currently_selected_topic(current_exam_topic).to_s
+    )
+  end
+
+  # ========================================================================= #
+  # === let_the_scrolled_window_for_the_answer_parse_URLs
+  # ========================================================================= #
+  def let_the_scrolled_window_for_the_answer_parse_URLs(
+      scrolled_window_for_the_answer = scrolled_window_for_the_answer?
+    )
+    # ======================================================================= #
+    # The scrolled-window for the answer allows the user to click on 
+    # hyperlinks - or at the least this is the idea. It does not
+    # work 100% yet because we need to get the selection first
+    # rather than select the whole entry.
+    # ======================================================================= #
+    scrolled_window_for_the_answer.on_button_release_event {
+      parse_for_URL(text_view_for_the_answer?.text?)
+    } if scrolled_window_for_the_answer
+  end
+
+  # ========================================================================= #
+  # === scrolled_window2?
+  # ========================================================================= #
+  def scrolled_window2?
+    @scrolled_window_containing_the_textarea2
+  end; alias return_scrolled_window_containing_the_text_view_for_the_answer scrolled_window2? # === return_scrolled_window_containing_the_text_view_for_the_answer
+       alias scrolled_window_for_the_answer?                                scrolled_window2? # === scrolled_window_for_the_answer?
+       alias scrolled_window_containing_the_textarea2?                      scrolled_window2? # === scrolled_window_containing_the_textarea2?
+
+  # ========================================================================= #
+  # === return_wikipedia_widget                               (wikipedia tag)
+  #
+  # This method will return the widget that, upon user-mouse-button-click
+  # event, will open the corresponding wikipedia entry. This defaults
+  # to the german wikipedia entry right now; if others want to change
+  # the default then this could be changed easily.
+  # ========================================================================= #
+  def return_wikipedia_widget
+    begin
+      require 'roebe/classes/wikipedia.rb'
+    rescue LoadError; end
+
+    hbox = create_hbox
+    wikipedia_entry = entry
+    wikipedia_entry.clear_background
+    wikipedia_entry.bblack1
+    wikipedia_entry.center
+    wikipedia_entry.pad3px
+    wikipedia_entry.lightgreen_background
+    wikipedia_entry.width_height(650, 30)
+    wikipedia_entry.hint =
+      'Click the "<b>enter</b>" key to open the assorted keyword in the '\
+      'german-wikipedia. Simply replace <b>de</b> with <b>en</b> in '\
+      'the URL to have the english wikipedia.'
+    wikipedia_entry.on_enter {
+      if Object.const_defined?(:Roebe) and
+        Roebe.const_defined?(:Wikipedia)
+        Roebe::Wikipedia.new(wikipedia_entry.text?) # Instantiate a new wrapper.
+      else
+        e 'You need to install the '+steelblue('roebe')+
+          ' gem for this functionality.'
+      end
+    }
+    hbox.minimal(wikipedia_entry, 2)
+    return hbox
+  end
+
+  # ========================================================================= #
+  # === larger_font?
+  # ========================================================================= #
+  def larger_font?
+    LARGER_FONT
+  end
+
+  # ========================================================================= #
+  # === do_jump_into_the_entry_containing_the_current_exam_topic
+  # ========================================================================= #
+  def do_jump_into_the_entry_containing_the_current_exam_topic
+    entry_for_the_current_exam_topic?.do_focus_on_it
+  end
+
+  # ========================================================================= #
+  # === debug
+  # ========================================================================= #
+  def debug
+    pp array_all_exam_questions?
+    pp array_all_exam_questions?.size
+  end
+
+  # ========================================================================= #
+  # === rinstall2
+  # ========================================================================= #
+  def rinstall2
+    Roebe.rinstall2(
+      use_this_directory: Studium.ruby_src_dir_at_home?+
+                          'studium/'
+    )
+  end; alias r2 rinstall2 # === r2
+
+  # ========================================================================= #
+  # === main_font?
+  # ========================================================================= #
+  def main_font?
+    USE_THIS_FONT
+  end
+
+  # ========================================================================= #
+  # === default_exam_topic?
+  # ========================================================================= #
+  def default_exam_topic?
+    USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC
+  end
+
+  # ========================================================================= #
+  # === clear_the_exam_answer                                     (clear tag)
+  #
+  # This method may only ever call set_exam_answer() - no other method
+  # is allowed to be called here.
+  # ========================================================================= #
+  def clear_the_exam_answer
+    set_exam_answer('') # Simply set the answer to an empty String here.
+  end; alias clear_reveal_the_answer clear_the_exam_answer # === clear_reveal_the_answer
+       alias clear_answers           clear_the_exam_answer # === clear_answers
+       alias clear_answers_buffer    clear_the_exam_answer # === clear_answers_buffer
+       alias clear_answer_buffer     clear_the_exam_answer # === clear_answer_buffer
+       alias clear_the_answer_buffer clear_the_exam_answer # === clear_the_answer_buffer
+
+  # ========================================================================= #
+  # === use_the_internal_editor?
+  # ========================================================================= #
+  def use_the_internal_editor?
+    @internal_hash[:use_this_editor] == :internal
+  end
+
+  # ========================================================================= #
+  # === use_this_editor?
+  # ========================================================================= #
+  def use_this_editor?
+    @internal_hash[:use_this_editor]
+  end
+
+  # ========================================================================= #
+  # === all_textviews?
+  # ========================================================================= #
+  def all_textviews?
+    [
+      textview1?,
+      textview2?,
+      textview3?
+    ]
+  end
+
+  # ========================================================================= #
+  # === set_editor_buffer
+  # ========================================================================= #
+  def set_editor_buffer(i)
+    editor?.set_buffer(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === handle_CSS                                                  (CSS tag)
+  # ========================================================================= #
+  def handle_CSS
+    use_gtk_paradise_project_css_file
+    append_project_css_file(
+      Studium.project_base_directory?+'css/project.css'
+    )
+    apply_the_CSS_rules
+  end
+
+  # ========================================================================= #
+  # === do_interactively_change_the_font
+  #
+  # This does not work. :(
+  # ========================================================================= #
+  def do_interactively_change_the_font
+    require 'gtk_paradise/widgets/gtk3/text_entry_widget/text_entry_widget.rb'
+    require 'gtk_paradise/examples/gtk3/gtk_dialog_sample.rb'
+    _ = ::Gtk::TextEntryWidget.run
+    ::Gtk::DialogSample.new(_)
+    ::Gtk.main
+    e 'The selection was:'
+    e
+    pp _.selection?
+    e
+  end
+
+  # ========================================================================= #
+  # === context_menu?
+  # ========================================================================= #
+  def context_menu?
+    @context_menu
+  end
+
+  # ========================================================================= #
+  # === button_reveal_the_answer?
+  # ========================================================================= #
+  def button_reveal_the_answer?
+    @internal_hash[:button_reveal_the_answer]
+  end
+
+  # ========================================================================= #
+  # === create_text_buffer_for_the_answer
+  # ========================================================================= #
+  def create_text_buffer_for_the_answer
+    # ======================================================================= #
+    # === @text_buffer_for_the_answer
+    # ======================================================================= #
+    @text_buffer_for_the_answer = create_text_buffer
+  end
+
+  # ========================================================================= #
+  # === sanitize_the_answer
+  #
+  # This is called from within set_exam_answer().
+  # ========================================================================= #
+  def sanitize_the_answer(
+      i,
+      apply_these_filters = []
+    )
+    i = i.to_s
+    if apply_these_filters.is_a? Symbol
+      apply_these_filters = [apply_these_filters]
+    end
+    if apply_these_filters and !apply_these_filters.empty?
+      apply_these_filters.each {|this_filter|
+        case this_filter
+        # =================================================================== #
+        # === :remove_tags
+        # =================================================================== #
+        when :remove_tags,
+             :filter_away_tags
+          i = Studium.remove_tags_from_this_input(i)
+        end
+      }
+    end
+    if i.include? 'URL: '
+      i.gsub!(/URL: /,"\nURL: ")
+    end
+    if i.include?('(2)')
+      i.gsub!(/\(1\)/, "\n  (1)")
+      i.gsub!(/\(2\)/, "\n  (2)")
+      i.gsub!(/\(3\)/, "\n  (3)")
+      i.gsub!(/\(4\)/, "\n  (4)")
+      i.gsub!(/\(5\)/, "\n  (5)")
+      i.gsub!(/\(6\)/, "\n  (6)")
+      i.gsub!(/\(7\)/, "\n  (7)")
+      i.gsub!(/\(8\)/, "\n  (8)")
+    end
+    i = Studium.remove_html(i)
+    i = word_wrap(i, threshold: WORD_WRAP_AT_N_CHARACTERS)
+    return i.rstrip
+  end; alias sanitize_this_answer sanitize_the_answer # === sanitize_this_answer
+
+  # ========================================================================= #
+  # === consider_running_rinstall2
+  # ========================================================================= #
+  def consider_running_rinstall2
+    if is_on_roebe? and Object.const_defined?(:Roebe)
+      rinstall2 # Run rinstall2 here, to update the local copy.
+    end
+  end
+
+  # ========================================================================= #
+  # === top_textbuffer?
+  # ========================================================================= #
+  def top_textbuffer?
+    text_view_for_the_question?.buffer
+  end
+
+  # ========================================================================= #
+  # === smallest_font?
+  # ========================================================================= #
+  def smallest_font?
+    SMALLEST_FONT
+  end
+
+  # ========================================================================= #
+  # === original_return_available_exam_topics
+  #
+  # This variant is probably no longer necessary, but it is retained for now.
+  # ========================================================================= #
+  def original_return_available_exam_topics
+    Studium.return_available_exam_topics
+  end
+
+  # ========================================================================= #
+  # === create_the_context_menu
+  #
+  # This is the context-menu which will appear on a right-mouse
+  # click event. It currently only works on ruby-gtk3.
+  # ========================================================================= #
+  def create_the_context_menu
+    # ======================================================================= #
+    # === @context_menu
+    # ======================================================================= #
+    @context_menu = create_context_menu(self) {{
+      numbered_actions: {
+        'Ask an exam question':                   :ask_an_exam_question,
+        'Reveal the answer to the exam question': :reveal_the_answer_to_the_exam_question,
+        'Mark the exam question as solved':       :mark_the_exam_question_as_solved,
+        'Pick a new font (show the widget)':      :popup_pick_a_new_font,
+        'Debug':                                  :debug
+        #'Change the font in use':                :do_interactively_change_the_font,
+      }
+    }}
+    @context_menu.make_bold
+    @context_menu.set_font(:hack_18)
+  end
+
+  # ========================================================================= #
+  # === instantiate_the_control_panel
+  #
+  # This only works for ruby-gtk3.
+  # ========================================================================= #
+  def instantiate_the_control_panel
+    require 'studium/gui/gtk3/control_panel/control_panel.rb'
+    # ======================================================================= #
+    # === @control_panel
+    # ======================================================================= #
+    @control_panel = ::Studium::GUI::Gtk::ControlPanel.new(self)
+    @control_panel.use_this_font(main_font?)
+  end
+
+  # ========================================================================= #
+  # === use_emoji?
+  # ========================================================================= #
+  def use_emoji?
+    @internal_hash[:prefer_emoji_or_images] == :emoji
+  end
+
+  # ========================================================================= #
+  # === set_save_into_this_local_file
+  #
+  # This method will only be in use if the internal editor is used.
+  # ========================================================================= #
+  def set_save_into_this_local_file(i)
+    editor?.set_save_into_this_local_file(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === create_the_button_use_random_entry_from_the_ten_aliases
+  # ========================================================================= #
+  def create_the_button_use_random_entry_from_the_ten_aliases
+    # ======================================================================= #
+    # === @internal_hash[:button_use_random_entry_from_the_ten_aliases]
+    #
+    # This is an eventbox rather than a button, but I think this is still
+    # fine. The unicode character "🕵" (U+1F575) is the spy character.
+    # ======================================================================= #
+    if use_emoji?
+      label = create_label('🕵️')
+    else
+      # label = image_avatar_default # This will be a gtk-image for ruby-gtk3.
+      # In December 2023, the above was changed to an image.
+      label = create_image(
+        Gtk.project_base_directory?+'images/misc/investigate.png'
+      )
+    end
+    # ======================================================================= #
+    # === @internal_hash[:button_use_random_entry_from_the_ten_aliases]
+    # ======================================================================= #
+    _ = create_eventbox(label)
+    _.on_clicked {
+      if show_ten_aliases?
+        set_exam_topic(
+          show_ten_aliases?.return_random_entry
+        )
+        one_two_three
+      end
+    }
+    _.set_size_request(40, 40)
+    _.on_hover_lightblue
+    # Provide some helpful message to help the user make use of this
+    # button.
+    _.hint = 
+      'Click on this small widget to randomly assign one of '\
+      'the 10 exam-topics currently being studied as the '\
+      'new main exam-topic in use.'
+    # This is actually an event box rather than a button.
+    @internal_hash[:button_use_random_entry_from_the_ten_aliases] = _ # And assign it here too.
+    return _
+  end
+
+  # ========================================================================= #
+  # === button_use_random_entry_from_the_ten_aliases?
+  # ========================================================================= #
+  def button_use_random_entry_from_the_ten_aliases?
+    @internal_hash[:button_use_random_entry_from_the_ten_aliases]
+  end
+
+  # ========================================================================= #
+  # === do_update_the_entries_n_answered_and_n_unanswered
+  # ========================================================================= #
+  def do_update_the_entries_n_answered_and_n_unanswered
+    do_update_the_entry_n_unanswered_questions
+    update_n_unanswered 
+  end
+
+  # ========================================================================= #
+  # === set_delay_to_use
+  # ========================================================================= #
+  def set_delay_to_use(
+      i = DEFAULT_DELAY
+    )
+    @internal_hash[:delay_to_use] = i.to_f
+  end
+
+  # ========================================================================= #
+  # === reset_the_shared_module
+  # ========================================================================= #
+  def reset_the_shared_module
+    # ======================================================================= #
+    # === :array_all_exam_questions
+    # ======================================================================= #
+    @internal_hash[:array_all_exam_questions] = []
+  end
+
+  # ========================================================================= #
+  # === enable_alt_1_key_combination
+  # ========================================================================= #
+  def enable_alt_1_key_combination
+    # ======================================================================= #
+    # Add alt+1 key combination:
+    # ======================================================================= #
+    use_this_key = Gdk::Keyval::KEY_1
+    @accel_group.connect(use_this_key, :mod1_mask, :visible) { # alt+1
+      entry_ask_questions?.set_focus(true)
+    }
+  end
+
+  # ========================================================================= #
+  # === enable_alt_y_key_combination
+  # ========================================================================= #
+  def enable_alt_y_key_combination
+    # ======================================================================= #
+    # Add alt+y key combination, to assign a new exam topic:
+    # ======================================================================= #
+    use_this_key = Gdk::Keyval::KEY_Y
+    @accel_group.connect(use_this_key, :mod1_mask, :visible) { # alt+y
+      do_assign_a_new_exam_topic
+    }
+  end
+
+  # ========================================================================= #
+  # === popup_pick_a_new_font
+  # ========================================================================= #
+  def popup_pick_a_new_font
+    _ = create_hbox
+    _.minimal(text(' → '))
+    file_chooser_widget = button('Choose font here')
+    file_chooser_widget.set_size_request(800, 660)
+    file_chooser_widget.bblack2
+    file_chooser_widget.disallow_resizing
+    _.minimal(file_chooser_widget) # Add the file-chooser widget here.
+    file_chooser_widget.on_click {
+      result = gtk_font_chooser_dialog
+      set_use_this_font(::Gtk.main_file?)
+      result.destroy
+    }
+    # ======================================================================= #
+    # Next create the popup for the font-choosing.
+    # ======================================================================= #
+    popup_widget = popup_over_this_widget(
+      text_view_for_the_question?,
+      '',
+      _
+    )
+    # popup_widget.no_arrow # ← This will only work on gtk4, I think.
+    popup_widget.popup
+  end
+
+  # ========================================================================= #
+  # === textview3?
+  # ========================================================================= #
+  def textview3?
+    @internal_hash[:textview3]
+  end; alias text_view_for_the_freeform_input?       textview3? # === free_form_textarea?
+       alias text_view_for_the_freeform_input        textview3? # === text_view_for_the_freeform_input
+       alias return_widget_for_the_freeform_textview textview3? # === return_widget_for_the_freeform_textview
+       alias free_form_textarea?                     textview3? # === free_form_textarea?
+       alias return_textarea_number_three            textview3? # === return_textarea_number_three
+
+  # ========================================================================= #
+  # === create_the_entry_percentage
+  # ========================================================================= #
+  def create_the_entry_percentage(
+      use_this_font = smaller_font?
+    )
+    # ======================================================================= #
+    # === Next create the percentage-entry
+    # ======================================================================= #
+    _ = entry('', 12)
+    @internal_hash[:entry_percentage] = _
+    enhance_the_entry_percentage(use_this_font) # This has to happen after the ^^^ above.
+    return _
+  end
+
+  # ========================================================================= #
+  # === save_the_buffer
+  # ========================================================================= #
+  def save_the_buffer
+    editor?.save_the_buffer
+    # ======================================================================= #
+    # Check whether we use the internal editor or not.
+    # ======================================================================= #
+    if use_the_internal_editor? and is_on_roebe?
+      # ===================================================================== #
+      # In this case jump to the first tab.
+      # ===================================================================== #
+      @notebook_tab.focus_on_this_tab(0)
+      rinstall2
+    end
+  end
+
+  # ========================================================================= #
+  # === control_panel?
+  # ========================================================================= #
+  def control_panel?
+    @control_panel
+  end
+
+  # ========================================================================= #
+  # === create_the_entries                           (entries tag, entry tag)
+  # ========================================================================= #
+  def create_the_entries(
+      use_this_font = :default_font
+    )
+    # ======================================================================= #
+    # The entry "n percentage" will be created first:
+    # ======================================================================= #
+    create_the_entry_percentage
+    # ======================================================================= #
+    # === The entry for n exam questions in total comes next
+    # ======================================================================= #
+    create_the_entry_containing_n_questions
+    create_the_entry_for_the_current_exam_topic
+    create_the_entry_n_unanswered_questions
+    # ======================================================================= #
+    # === :entry_for_sleeping_n_seconds
+    # ======================================================================= #
+    create_the_entry_for_sleeping_n_seconds
+    create_the_entry_n_answered_exam_questions(use_this_font)
+  end
+
+  # ========================================================================= #
+  # === textview2?
+  # ========================================================================= #
+  def textview2?
+    @internal_hash[:textview2]
+  end; alias return_widget_for_the_answers textview2? # === return_widget_for_the_answers
+       alias text_view_for_the_answer      textview2? # === text_view_for_the_answer
+       alias text_view_for_the_answer?     textview2? # === text_view_for_the_answer?
+       alias textarea2?                    textview2? # === textarea2?
+       alias answer_buffer?                textview2? # === answer_buffer?
+       alias answer_buffer                 textview2? # === answer_buffer
+
+  # ========================================================================= #
+  # === do_clear_the_question_buffer
+  #
+  # Clear the question-buffer via this method.
+  # ========================================================================= #
+  def do_clear_the_question_buffer
+    text_buffer_for_the_question?.set_text('')
+  end; alias clear_question_buffer  do_clear_the_question_buffer # === clear_question_buffer
+       alias clear_questions_buffer do_clear_the_question_buffer # === clear_questions_buffer
+
+  # ========================================================================= #
+  # === update_n_answered
+  # ========================================================================= #
+  def update_n_answered(
+      i = :infer
+    )
+    case i
+    # ======================================================================= #
+    # === :infer
+    # ======================================================================= #
+    when :infer
+      current_exam_topic = current_exam_topic_from_the_entry?
+      hash = hash_dataset_of_all_lectures? # Always update it here in this case.
+      _ = hash[current_exam_topic.tr(' ','_').to_sym]
+      i = _[:n_questions_answered]
+    end
+    set_n_exam_questions_were_already_answered(i)
+  end; alias do_update_the_entry_n_answered update_n_answered # === update_n_answered
+
+  # ========================================================================= #
+  # === return_event_box_with_face_glasses
+  #
+  # This one belongs close to the top of the widget.
+  # ========================================================================= #
+  def return_event_box_with_face_glasses
+    event_box = create_event_box
+    image = create_icon('face-glasses')
+    event_box.add(image)
+    event_box.on_clicked {
+      do_popup_the_array_of_all_exam_questions
+    }
+    return event_box
+  end
+
+  # ========================================================================= #
+  # === do_assign_a_new_exam_topic
+  # ========================================================================= #
+  def do_assign_a_new_exam_topic
+    clear_reveal_the_answer
+    this_topic = select_not_yet_completed_exam_topics(
+      available_exam_topics?
+    ).sample # Obtain a random exam topic here.
+    entry_for_the_current_exam_topic?.set_text(this_topic.to_s)
+    sync_entry_holding_all_exam_topics_onto_the_combo_box
+    do_ask_an_exam_question
+  end
+
+  # ========================================================================= #
+  # === sync_entry_holding_all_exam_topics_onto_the_combo_box
+  # ========================================================================= #
+  def sync_entry_holding_all_exam_topics_onto_the_combo_box(
+      value = Studium.find_corresponding_exam_topic(
+                entry_for_the_current_exam_topic?.text?
+              )
+    )
+    # ======================================================================= #
+    # Next find the correct index:
+    # ======================================================================= #
+    # index = array.find_index {|entry| entry.delete('_').include?(value) }
+    # if index
+    #   combo_box_available_exam_topics?.set_active(index)
+    # else
+    #   e 'The index was not found. Input was '+steelblue(value)+'.'
+    # end
+  end; alias sync_entry_holding_all_exam_topics_onto_the_main_combo_box sync_entry_holding_all_exam_topics_onto_the_combo_box # === sync_entry_holding_all_exam_topics_onto_the_main_combo_box
+
+  # ========================================================================= #
+  # === return_event_box_for_asking_a_random_exam_topic
+  #
+  # This event-box can be used for asking a question from a random exam
+  # topic.
+  # ========================================================================= #
+  def return_event_box_for_asking_a_random_exam_topic
+    # ======================================================================= #
+    # Next create the actual event box:
+    # ======================================================================= #
+    event_box_for_image_view_refresh_symbolic_symbolic = create_event_box(
+      image_view_refresh_symbolic_symbolic
+    )
+    # ======================================================================= #
+    # Provide useful hints how to use this event-box:
+    # ======================================================================= #
+    event_box_for_image_view_refresh_symbolic_symbolic.hint =
+      'Click on this icon to <span weight="bold" foreground="lightgreen">set a random exam topic</span>, '\
+      "and then ask an exam question from this topic.\n\n"\
+      'Note that since as of <b>August 2022</b> this will ignore '\
+      'exam topics that were already solved.'
+    # ======================================================================= #
+    # Let the event-box respond to an on-click event.
+    # ======================================================================= #
+    event_box_for_image_view_refresh_symbolic_symbolic.on_clicked {
+      do_assign_a_new_exam_topic
+    }
+    return event_box_for_image_view_refresh_symbolic_symbolic
+  end
+
+  # ========================================================================= #
+  # === create_the_thumbs_up_emoji
+  # ========================================================================= #
+  def create_the_thumbs_up_emoji
+    # ======================================================================= #
+    # Add the thumbs-up emoji, but only if we use emojis.
+    # ======================================================================= #
+    if use_emoji?
+      event_box_for_the_thumbs_up_emoji = create_event_box(label(' 👍'))
+    else
+      event_box_for_the_thumbs_up_emoji = create_event_box(image_trophy_gold)
+    end
+    @thumbs_up_emoji = event_box_for_the_thumbs_up_emoji.on_clicked {
+      do_ask_a_new_exam_question
+    }
+  end
+
+  # ========================================================================= #
+  # === parse_for_URL
+  #
+  # This method can be used to return all URLs in a given text.
+  # ========================================================================= #
+  def parse_for_URL(
+      i = text_view_for_the_answer?.buffer.text
+    )
+    array = ::Studium.return_all_URLs_from(i)
+    if array.size > 0
+      first_entry = array.first
+      # ===================================================================== #
+      # We first have to assign it to the GUI part. Note that the "browser"
+      # is part of the control-panel since the rewrite in January 2021.
+      # ===================================================================== #
+      if respond_to?(:control_panel?) and control_panel?.respond_to?(:browser?)
+        control_panel?.browser?.assign_this_text(first_entry)
+      end
+      ::Studium.open_this_remote_url(first_entry)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_widget_for_the_freeform_textview
+  # ========================================================================= #
+  def create_the_widget_for_the_freeform_textview
+    # ======================================================================= #
+    # === @internal_hash[:textview3]
+    # ======================================================================= #
+    _ = create_textview
+    _.bblack1
+    _.set_left_right_margin(USE_THIS_MARGIN)
+    # ======================================================================= #
+    # The next code sets up a default placeholder text. Upon a focus-in-event
+    # that default placeholder text is removed.
+    # ======================================================================= #
+    _.buffer.set_placeholder_text(
+      DEFAULT_PLACEHOLDER_TEXT
+    )
+    _.buffer.sync_placeholder_text
+    _.word_wrap
+    _.focus_in_event {
+      if _.buffer.text? == DEFAULT_PLACEHOLDER_TEXT
+        _.buffer.clear # Remove that placeholder text in this case.
+      end
+    }
+    @internal_hash[:textview3] = _
+    return _
+  end
+
+  # ========================================================================= #
+  # === create_scrolled_window3
+  #
+  # This method will return the textarea-widget that can be used for
+  # "free typing" by the user - in other words, where the user can
+  # simply write whatever he/she wants to.
+  # ========================================================================= #
+  def create_scrolled_window3(
+      i = textview3?
+    )
+    # ======================================================================= #
+    # The next scrolled-window is called "textview3", as it is the third
+    # textarea to be seen in the main widget. The rationale for this
+    # method was briefly mentioned above.
+    # ======================================================================= #
+    _ = create_scrolled_window(i) { :only_top_to_bottom }
+    _.set_name('textview3')
+    _.width_height(900, 180)
+    _.pad4px
+    _.do_show_the_scrollbars
+    _.min_content_width  =  80
+    _.min_content_height = 120
+    # ======================================================================= #
+    # Next, enable select-all-on-click events:
+    # ======================================================================= #
+    _.signal_connect(:event) {|widget, event|
+      case event.event_type.name.to_s
+      when 'GDK_BUTTON_PRESS'
+        # e 'The left mouse-button was clicked! Selecting everything next.'
+        # @text_view_for_simply_typing_anything.signal_emit(:select_all, event)
+        i.select_everything(event)
+      end
+    }
+    @scrolled_window3 = _
+    return _ # And return it here as well, just in case.
+  end
+
+  # ========================================================================= #
+  # === scrolled_window3?
+  # ========================================================================= #
+  def scrolled_window3?
+    @scrolled_window3
+  end; alias scrolled_window_containing_the_textarea3        scrolled_window3? # === scrolled_window_containing_the_textarea3        
+       alias return_scrolled_window3                         scrolled_window3? # === scrolled_window_containing_the_textarea3
+       alias return_scrolled_window_containing_the_textarea3 scrolled_window3? # === return_scrolled_window_containing_the_textarea3
+       alias return_widget_for_the_freeform_textview         scrolled_window3? # === return_widget_for_the_freeform_textview
+
+  # ========================================================================= #
+  # === button_clear_was_clicked
+  # ========================================================================= #
+  def button_clear_was_clicked
+    all_textviews?.each {|entry|
+      entry.clear
+    }
+    @internal_hash[:may_we_reveal_the_answer_after_a_delay] = false
+  end
+
+  # ========================================================================= #
+  # === notify_the_user_that_all_questions_have_been_answered_in_this_topic
+  # ========================================================================= #
+  def notify_the_user_that_all_questions_have_been_answered_in_this_topic(
+      this_topic  = current_exam_topic?,
+      this_widget = button_reveal_the_answer?
+    )
+    bold_popover_message = create_bold_label(
+      'All questions have been answered for '+this_topic+'. \o/'
+    )
+    popover_message(
+      bold_popover_message,
+      this_widget
+    ).popup
+  end
+
+  # ========================================================================= #
+  # === create_the_entry_n_unanswered_questions
+  # ========================================================================= #
+  def create_the_entry_n_unanswered_questions
+    # ======================================================================= #
+    # === @entry_n_unanswered_questions
+    # ======================================================================= #
+    @entry_n_unanswered_questions = create_entry
+    enhance_entry_containing_n_unanswered_questions(
+      :default_font,
+      @entry_n_unanswered_questions
+    )
+  end; alias create_the_entry_containing_n_unanswered_questions      create_the_entry_n_unanswered_questions # === create_the_entry_containing_n_unanswered_questions
+       alias create_the_entry_containing_n_unanswered_exam_questions create_the_entry_n_unanswered_questions # === create_the_entry_containing_n_unanswered_exam_questions
+
+  # ========================================================================= #
+  # === entry_n_answered_exam_questions?
+  # ========================================================================= #
+  def entry_n_answered_exam_questions?
+    @internal_hash[:entry_n_answered_exam_questions]
+  end; alias entry_containing_n_answers? entry_n_answered_exam_questions? # === entry_containing_n_answers?
+
+  # ========================================================================= #
+  # === create_the_entry_for_sleeping_n_seconds
+  # ========================================================================= #
+  def create_the_entry_for_sleeping_n_seconds
+    # ======================================================================= #
+    # === :entry_for_sleeping_n_seconds
+    #
+    # Next create the delay-entry that keeps track how many seconds to wait,
+    # before revealing the answer (IF the user has decided to make use of
+    # that functionality).
+    # ======================================================================= #
+    _ = entry('', 5) # entry('', 5) is primarily for jruby.
+    _ << default_delay?.to_s.dup # Default delay.
+    @internal_hash[:entry_for_sleeping_n_seconds] = _
+    enhance_the_entry_for_sleeping_n_seconds
+    return @internal_hash[:entry_for_sleeping_n_seconds]
+  end
+
+  # ========================================================================= #
+  # === entry_percentage?
+  # ========================================================================= #
+  def entry_percentage?
+    @internal_hash[:entry_percentage]
+  end; alias return_entry_percentage entry_percentage? # === return_entry_percentage
+
+  # ========================================================================= #
+  # === return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
+  #
+  # This widget returned by this method here, should come before the
+  # free-form widget is added.
+  # ========================================================================= #
+  def return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
+    hbox_with_two_icons = create_hbox
+    first_eventbox = create_event_box(image_accessories_text_editor)
+    first_eventbox.on_clicked {
+      do_clear_the_free_form_textarea
+    }
+    hbox_with_two_icons.minimal(first_eventbox, 2)
+    text = text(
+             'Below this text you can input your assumed '\
+             'answer to the exam question at hand.'
+           )
+    text.left_align
+    text.make_selectable
+    text.set_font(:hack_18)
+    hbox_with_two_icons.maximal(text, 4)
+    event_box_for_image_accessories_text_editor = create_event_box(image_accessories_text_editor)
+    event_box_for_image_accessories_text_editor.hint =
+      'Click here to empty the free-form textarea below this icon.'
+    event_box_for_image_accessories_text_editor.on_clicked {
+      do_clear_the_free_form_textarea
+    }
+    hbox_with_two_icons.minimal(event_box_for_image_accessories_text_editor, 2)
+    return hbox_with_two_icons
+  end
+
+  # ========================================================================= #
+  # === create_entry_n_total_exam_questions
+  # ========================================================================= #
+  def create_entry_n_total_exam_questions
+    # ======================================================================= #
+    # === @entry_n_total_exam_questions
+    # ======================================================================= #
+    @internal_hash[:entry_n_total_exam_questions] = entry('', 12) # The 12 is for jruby specifically.
+    enhance_the_entry_containing_n_questions
+    return @internal_hash[:entry_n_total_exam_questions]
+  end; alias create_the_entry_containing_n_questions create_entry_n_total_exam_questions # === create_the_entry_containing_n_questions
+
+  # ========================================================================= #
+  # === do_style_all_buttons_uniformly                            (style tag)
+  # ========================================================================= #
+  def do_style_all_buttons_uniformly(
+      i = return_all_buttons
+    )
+    # ======================================================================= #
+    # Style all buttons uniformly next, via CSS.
+    # ======================================================================= #
+    i.each {|this_button|
+      # ===================================================================== #
+      # Use the same CSS rule for each button.
+      # ===================================================================== #
+      this_button.clear_background
+      this_button.bblack2
+      this_button.set_size_request(75, 28)
+      this_button.set_name('button_hover_transition')
+    }
+  end
+
+  # ========================================================================= #
+  # === all_questions_have_been_answered_in_this_topic?
+  #
+  # This method has to determine how many questions have been answered
+  # in the current exam topic.
+  # ========================================================================= #
+  def all_questions_have_been_answered_in_this_topic?(
+      this_topic = current_exam_topic?
+    )
+    (Studium.return_n_percent_solved_from_this_topic(this_topic).to_i == 100)
+  end
+
+  # ========================================================================= #
+  # === textview1?
+  # ========================================================================= #
+  def textview1?
+    @internal_hash[:textview1]
+  end; alias widget_for_the_questions?                                 textview1? # === widget_for_the_questions?
+       alias text_view_for_the_question?                               textview1? # === text_view_for_the_question?
+       alias return_widget_for_the_questions                           textview1? # === return_widget_for_the_questions
+       alias return_text_view_for_the_question                         textview1? # === return_text_view_for_the_question
+       alias return_scrolled_window_for_the_text_view_for_the_question textview1? # === return_scrolled_window_for_the_text_view_for_the_question
+       alias text_view_containing_the_current_question?                textview1? # === text_view_containing_the_current_question?
+       alias text_buffer_for_the_question?                             textview1? # === text_buffer_for_the_question?
+       alias textarea1?                                                textview1? # === textare1?
+       alias question_buffer                                           textview1? # === question_buffer
+       alias question_buffer?                                          textview1? # === question_buffer?
+
+  # ========================================================================= #
+  # === create_the_textview_that_will_contain_the_exam_question
+  # ========================================================================= #
+  def create_the_textview_that_will_contain_the_exam_question(
+      text_buffer_for_the_question = :default_buffer
+    )
+    # ======================================================================= #
+    # === @internal_hash[:textview1]
+    # ======================================================================= #
+    _ = create_textview(text_buffer_for_the_question)
+    _.set_left_right_margin(USE_THIS_MARGIN)
+    _.word_wrap
+    scrolled_window_containing_the_textarea1 = create_scrolled_window(
+      _
+    ) { :only_up_and_bottom }
+    scrolled_window_containing_the_textarea1.set_name('textview1_for_the_studium_gem') # Contains the question.
+    scrolled_window_containing_the_textarea1.set_size_request(920, 180)
+    @internal_hash[:textview1] = _
+    @internal_hash[:scrolled_window_containing_the_textarea1] = scrolled_window_containing_the_textarea1
+  end
+
+  # ========================================================================= #
+  # === hash_dataset_of_all_lectures?
+  # ========================================================================= #
+  def hash_dataset_of_all_lectures?
+    @internal_hash[:hash_dataset_of_all_lectures]
+  end
+
+  # ======================================================================= #
+  # === do_assign_the_default_exam_topic_to_the_correct_entry
+  # ======================================================================= #
+  def do_assign_the_default_exam_topic_to_the_correct_entry
+    set_exam_topic(USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC)
+  end
+
+  # ========================================================================= #
+  # === deselect_the_entry_containing_the_exam_topic
+  # ========================================================================= #
+  def deselect_the_entry_containing_the_exam_topic(
+      i = entry_for_the_current_exam_topic?
+    )
+    i.deselect
+    text_view_containing_the_current_question?.set_focus(true)
+  end
+
+  # ========================================================================= #
+  # === scrolled_window1?
+  # ========================================================================= #
+  def scrolled_window1?
+    @internal_hash[:scrolled_window_containing_the_textarea1]
+  end
+
+  # ========================================================================= #
+  # === create_the_textviews
+  # ========================================================================= #
+  def create_the_textviews
+    create_the_textview_that_will_contain_the_exam_question
+    # ======================================================================= #
+    # === @internal_hash[:textview2]
+    # ======================================================================= #
+    create_the_widget_for_the_exam_answer
+    # ======================================================================= #
+    # === @internal_hash[:textview3]
+    # ======================================================================= #
+    create_the_widget_for_the_freeform_textview
+    create_scrolled_window3 # And create the scrolled-window3 here as well.
+  end
+
+  # ========================================================================= #
+  # === create_the_widget_for_the_exam_answer      (answer tag, answers tags)
+  # ========================================================================= #
+  def create_the_widget_for_the_exam_answer(
+      use_this_text_buffer = @text_buffer_for_the_answer
+    )
+    _ = create_textview(use_this_text_buffer)
+    _.set_left_right_margin(USE_THIS_MARGIN)
+    _.word_wrap
+    @internal_hash[:textview2] = _
+    scrolled_window = create_scrolled_window(
+      _
+    ) { :only_up_and_bottom }
+    scrolled_window.set_name('textview2_for_the_studium_gem') # Contains the answer.
+    scrolled_window.set_size_request(1000, 150)
+    scrolled_window.min_content_width  = 100
+    scrolled_window.min_content_height = 200
+    scrolled_window.do_show_the_scrollbars
+    @scrolled_window_containing_the_textarea2 = scrolled_window
+    return _ # And return it too, just in case.
+  end; alias create_text_view_for_the_answer create_the_widget_for_the_exam_answer # === create_text_view_for_the_answer
+    
+  # ========================================================================= #
+  # === create_the_button_solve_the_question
+  # ========================================================================= #
+  def create_the_button_solve_the_question
+    # ======================================================================= #
+    # === @button_solve_the_question
+    # ======================================================================= #
+    @button_solve_the_exam_question = return_button_solve_the_question
+  end
+
+  # ========================================================================= #
+  # === button_ask_the_exam_question?
+  # ========================================================================= #
+  def button_ask_the_exam_question?
+    @internal_hash[:button_ask_the_exam_question]
+  end; alias question_button?         button_ask_the_exam_question? # === question_button?
+       alias button_ask_the_question? button_ask_the_exam_question? # === button_ask_the_question?
+
+  # ========================================================================= #
+  # === create_the_button_ask_the_exam_question
+  # ========================================================================= #
+  def create_the_button_ask_the_exam_question
+    # ======================================================================= #
+    # === @internal_hash[:button_ask_the_exam_question]
+    # ======================================================================= #
+    @internal_hash[:button_ask_the_exam_question] = return_button_ask_the_exam_question(use_emoji?)
+  end; alias create_the_ask_the_exam_question_button create_the_button_ask_the_exam_question # === create_the_ask_the_exam_question_button
+
+  # ========================================================================= #
+  # === set_exam_question
+  #
+  # The second argument can be a filter. For instance, if the Symbol
+  # :remove_tags is passed, then all HTML tags will be removed from
+  # the given input at hand. This is actually the default behaviour.
+  # ========================================================================= #
+  def set_exam_question(
+      i                   = exam_question_object?.question?,
+      apply_these_filters = [:remove_tags]
+    )
+    i = i.to_s.dup
+    i[0,2] = '' if i.start_with?('- ') # We don't ever want leading '-' here.
+    if apply_these_filters.is_a? Symbol
+      apply_these_filters = [apply_these_filters]
+    end
+    # ======================================================================= #
+    # Replace all URL entries with <a href> entries next:
+    # ======================================================================= #
+    if i
+      i = ::Gtk.replace_all_URL_entries_in_this_string(i)
+    end
+    # ======================================================================= #
+    # The following line may have to be re-evaluated again in the future -
+    # in the past, in 2021, this had a bug and things crashed, but this
+    # may no longer be the case - let's see, eventually.
+    #
+    #   editor?.update_the_main_buffer(dataset)
+    #
+    # ======================================================================= #
+    if apply_these_filters and !apply_these_filters.empty?
+      apply_these_filters.each {|this_filter|
+        case this_filter
+        # =================================================================== #
+        # === :remove_tags
+        # =================================================================== #
+        when :remove_tags,
+             :no_tags,
+             :default
+          i = Studium.remove_tags_from_this_input(i)
+        end
+      }
+    end
+    @internal_hash[:exam_question] = i
+    textview1?.set_text(i) # This is the widget for the exam-questions.
+  end; alias set_question set_exam_question # === set_question
+
+  # ========================================================================= #
+  # === create_the_emoji_toggle_widget
+  #
+  # Note that in order to use EmojiToggleWidget, we have to pull in the
+  # right file, either ruby-gtk3 or ruby-gtk2.
+  # ========================================================================= #
+  def create_the_emoji_toggle_widget
+    require 'gtk_paradise/widgets/gtk3/emoji_toggle_widget/emoji_toggle_widget.rb'
+    @a_thinking_smiley_emoji = ::Gtk::EmojiToggleWidget.new(
+      :use_two_smileys
+    )
+    @a_thinking_smiley_emoji.make_selectable
+  end
+
+  # ========================================================================= #
+  # === return_n_questions_from_the_currently_selected_topic
+  #
+  # This method will return how many exam questions exist in the
+  # selected exam topic.
+  #
+  # This method is no longer that important as of December 2023. 
+  # ========================================================================= #
+  def return_n_questions_from_the_currently_selected_topic(
+      i = current_exam_topic?
+    )
+    ::Studium.n_questions_available_in_this_topic(i)
+  end
+
+  # ========================================================================= #
+  # === do_clear_the_free_form_textarea
+  # ========================================================================= #
+  def do_clear_the_free_form_textarea
+    free_form_textarea?.set_text('')
+  end
+
+  # ========================================================================= #
+  # === create_the_buttons                          (buttons tag, button tag)
+  # ========================================================================= #
+  def create_the_buttons
+    create_the_button_ask_the_exam_question
+    # ======================================================================= #
+    # === @button_solve_the_exam_question
+    # ======================================================================= #
+    create_the_button_solve_the_question
+    # ======================================================================= #
+    # === @button_clear
+    # ======================================================================= #
+    @button_clear = bold_button('_Clear all entries', self, :use_mnemonic) {
+      :button_clear_was_clicked
+    }
+    create_the_button_update_n_questions_were_answered
+    create_the_reveal_the_answer_button
+    # ======================================================================= #
+    # Next style these four buttons uniformly
+    # ======================================================================= #
+    [
+      button_ask_the_exam_question?,
+      button_reveal_the_answer?,
+      button_solve_the_exam_question?,
+      @button_clear,
+      button_update_n_questions_were_answered?
+    ].each {|this_button|
+      this_button.clear_background
+      this_button.bblack2
+      this_button.on_hover(:lightgreen)
+    }
+    create_the_button_use_random_entry_from_the_ten_aliases # This one should come last here.
+  end
+
+  # ========================================================================= #
+  # === create_the_editor                                        (editor tag)
+  #
+  # This method only makes sense for ruby-gtk3.
+  # ========================================================================= #
+  def create_the_editor
+    if shall_we_create_the_gtk_editor?
+      require 'gtk_paradise/widgets/gtk3/editor/editor.rb'
+      # ===================================================================== #
+      # === @editor
+      # ===================================================================== #
+      @editor = ::Gtk::Editor.new { :do_not_use_the_colour_box_widget }
+    else
+      @editor = nil
+    end
+  end
+
+  # ========================================================================= #
+  # === add_the_status_icon
+  # ========================================================================= #
+  def add_the_status_icon
+    if use_gtk3?
+      status_icon = return_status_icon
+      status_icon.favicon = Studium.project_base_directory?+
+                            'images/studies_favicon.png'
+      status_icon.hint = 'Exam-question widget: train your brain!'
+      begin # Need to fix this later.
+        menu = create_menu
+        button_hello_world = create_image_menu_item(stock: ::Gtk::Stock::FIND)
+        button_hello_world.signal_connect(:activate) {
+          e 'A click-event has been detected.'
+        }
+        menu << button_hello_world
+        quit_button = create_image_menu_item(stock: ::Gtk::Stock::QUIT)
+        quit_button.signal_connect(:activate) { ::Gtk.main_quit }
+        menu.append(quit_button)
+        menu.show_all
+        status_icon.signal_connect(:popup_menu) { |icon, button, time|
+          menu.popup(nil, nil, button, time)
+        }
+      rescue Exception => error
+        pp error
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === allow_external_applications?
+  #
+  # This is mostly useful when the main application allows add-ons, such
+  # as the TenAliases widget. It is not so important for standalone
+  # widgets.
+  # ========================================================================= #
+  def allow_external_applications?
+    true
+  end
+
+  # ========================================================================= #
+  # === available_exam_topics_in_short_form?
+  # ========================================================================= #
+  def available_exam_topics_in_short_form?
+    array = Studium.available_exam_topics_in_short_form?
+    array = array.sort_by {|entry| entry.downcase }
+    return array
+  end; alias return_available_exam_topics available_exam_topics_in_short_form? # === return_available_exam_topics
+       alias available_exam_topics?       available_exam_topics_in_short_form? # === available_exam_topics?
+       alias exam_topics_short_form?      available_exam_topics_in_short_form? # === exam_topics_short_form?
+
+  # ========================================================================= #
+  # === enable_all_key_combinations
+  # ========================================================================= #
+  def enable_all_key_combinations
+    # ======================================================================= #
+    # === @accel_group
+    # ======================================================================= #
+    @accel_group = create_and_add_gtk_accel_group
+    enable_alt_w_key_combination
+    enable_alt_y_key_combination
+    enable_alt_1_key_combination
+  end
+
+  # ========================================================================= #
+  # === return_frame_containing_the_label_exam_topic
+  # ========================================================================= #
+  def return_frame_containing_the_label_exam_topic
+    # ======================================================================= #
+    # Create the exam-topic label next, showing a watermelon emoji on the
+    # left-hand side. The watermelon emoji used to be 🍉️; but it was
+    # replaced with the electric light bulb emoji in January 2021, which
+    # is 💡️. Unfortunately this does not work on every system, so it
+    # was decided to replace this with an image that is determined by
+    # the icon theme at hand.
+    # ======================================================================= #
+    label_exam_topic = bold_text(' Exam topic ')
+    label_emoji = right_arrow_emoji
+    label_emoji.set_size_request(22, 22)
+    label_emoji.align_right
+    event_box_for_the_label_emoji = create_event_box(label_emoji)
+    event_box_for_the_label_emoji.on_clicked {
+      do_jump_into_the_entry_containing_the_current_exam_topic
+    }
+    tiny_hbox = create_hbox
+    tiny_hbox.minimal(label_exam_topic)
+    tiny_hbox.maximal(event_box_for_the_label_emoji)
+    tiny_hbox.minimal(text(' ')) # Just a "spacer".
+    frame_containing_the_label_exam_topic = create_frame(tiny_hbox)
+    frame_containing_the_label_exam_topic.modify_background(:normal, :oldlace)
+    frame_containing_the_label_exam_topic.bblack1
+    # frame_containing_the_label_exam_topic.set_font(smaller_font?)
+    label_exam_topic.hint = 'Denote <b>the current exam </b> topic '\
+                            'to the <b>right</b> of this text.'
+    return frame_containing_the_label_exam_topic
+  end
+
+  # ========================================================================= #
+  # === entry_n_total_exam_questions?
+  # ========================================================================= #
+  def entry_n_total_exam_questions?
+    @internal_hash[:entry_n_total_exam_questions]
+  end; alias entry_containing_n_questions? entry_n_total_exam_questions? # === entry_containing_n_questions?
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExamTrainer.gtk_accel_group
+  # ========================================================================= #
+  def self.gtk_accel_group
+    ::Gtk::AccelGroup.new
+  end
+
+  # ========================================================================= #
+  # === button_clear?
+  # ========================================================================= #
+  def button_clear?
+    @button_clear
+  end
+
+  # ========================================================================= #
+  # === parse_the_commandline_arguments
+  # ========================================================================= #
+  def parse_the_commandline_arguments
+    _ = commandline_arguments?
+    unless _.empty?
+      new_topic = _.first
+      # ===================================================================== #
+      # === Handle numbers given as input here:
+      #
+      # Example:
+      #
+      #   ruby misc.rb 5
+      #
+      # ===================================================================== #
+      if new_topic =~ /^\d+$/ # A number - and only a number - was given to this class here.
+        new_topic = new_topic.to_i
+        new_topic = Studium.exam_topic_number?(new_topic).to_s
+      end
+      new_topic = Studium.find_corresponding_exam_topic(new_topic)
+      entry_for_the_current_exam_topic?.set_text(new_topic)
+      # ===================================================================== #
+      # Next, we must also update the combo-box.
+      # This is currently not enabled:
+      # _.find_and_try_to_select_this_entry(new_topic)
+      # simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(new_topic)
+      # ===================================================================== #
+      one_two_three
+    end
+  end
+
+  # ========================================================================= #
+  # === entry_n_unanswered_questions?
+  # ========================================================================= #
+  def entry_n_unanswered_questions?
+    @entry_n_unanswered_questions
+  end; alias entry_containing_n_unanswered_questions? entry_n_unanswered_questions? # === entry_containing_n_unanswered_questions?
+       alias entry_containing_n_unanswered_questions  entry_n_unanswered_questions? # === entry_containing_n_unanswered_questions
+
+  # ========================================================================= #
+  # === button_solve_the_exam_question?
+  # ========================================================================= #
+  def button_solve_the_exam_question?
+    @button_solve_the_exam_question
+  end
+
+  # ========================================================================= #
+  # === button_solve_the_exam_question_was_clicked    (solved tag, solve tag)
+  # ========================================================================= #
+  def button_solve_the_exam_question_was_clicked
+    # the_current_exam_question_is_now_solved
+    # update_three_important_widgets
+    _ = Studium::Exams::Solved.new(ARGV) { :do_not_run_yet }
+    _.set_commandline
+    _.run
+    consider_running_rinstall2
+    # ======================================================================= #
+    # Also update the appropriate label next, whenever the solve-exam
+    # question was clicked.
+    # ======================================================================= #
+    update_the_label_n_questions_were_answered
+  end; alias mark_the_exam_question_as_solved        button_solve_the_exam_question_was_clicked # === mark_the_exam_question_as_solved 
+       alias do_solve_the_exam_question              button_solve_the_exam_question_was_clicked # === do_solve_the_exam_question
+       alias the_current_exam_question_is_now_solved button_solve_the_exam_question_was_clicked # === the_current_exam_question_is_now_solved
+
+  # ========================================================================= #
+  # === activate_the_third_textview
+  # ========================================================================= #
+  def activate_the_third_textview
+    free_form_textarea?.do_focus_on_it
+  end
+
+  # ========================================================================= #
+  # === change_to_a_happy_smiley_before_reverting_to_the_prior_default_again
+  #
+  # This method is used to turn the thinking-smiley to a happy-smiley,
+  # before reverting again to the prior default.
+  # ========================================================================= #
+  def change_to_a_happy_smiley_before_reverting_to_the_prior_default_again(
+      delay_to_use = 5_000 # This refers to 5 seconds.
+    )
+    @a_thinking_smiley_emoji.toggle
+    GLib::Timeout.add(delay_to_use) {
+      @a_thinking_smiley_emoji.revert_to_the_initial_state # This reverts to the initial state again.
+      false # Must end it.
+    }
+  end
+
+  # ======================================================================= #
+  # === create_the_combobox
+  #
+  # This method will create the combo-box that contains all exam-topics.
+  # It will be a bit truncated, largely for display-reasons rather
+  # than any other reason.
+  # ======================================================================= #
+  def create_the_combobox(
+      use_these_exam_topics = :default_exam_topics
+    )
+    case use_these_exam_topics
+    # ===================================================================== #
+    # === :default_exam_topics
+    # ===================================================================== #
+    when :default_exam_topics
+      use_these_exam_topics = available_exam_topics_in_short_form?.
+                              map(&:downcase).sort
+    end
+    # ===================================================================== #
+    # Next truncate these exam-topics a bit:
+    # ===================================================================== #
+    use_this_sorted_array = use_these_exam_topics.uniq.map {|entry|
+      if entry.size > 25 # Truncate it a bit in this case here.
+        entry = entry[0 .. 25]
+      end
+      entry
+    }.sort
+    _ = create_combobox_text # Create the combo-box here.
+    # use_this_sorted_array.each {|entry|
+    #   entry = entry.to_s
+    #   _.append_text(entry) if entry and !entry.empty?
+    # }
+    _.fill_up(use_this_sorted_array)
+    _.first_entry_is_active
+    _.bblack1
+    _.set_size_request(100, 28)
+    # ======================================================================= #
+    # Wrap-width determines how many entries per row are shown when the
+    # combo-box is expanded. We stick to the default of 1 here.
+    # ======================================================================= #
+    _.set_wrap_width(1)
+    # ======================================================================= #
+    # The event where the combo-box is changed is handled next.
+    # ======================================================================= #
+    _.on_changed {
+      handle_the_combo_box_available_exam_topics_on_changed_event
+    }
+    @internal_hash[:combobox_available_exam_topics] = _ # And assign it here.
+    return _
+  end
+
+  # ======================================================================= #
+  # === set_exam_topic
+  #
+  # This will set towards the entry that holds the current exam topic.
+  # ======================================================================= #
+  def set_exam_topic(
+      i = :default
+    )
+    case i
+    # ===================================================================== #
+    # === :default
+    # ===================================================================== #
+    when :default
+      i = default_exam_topic?.to_s
+    end
+    i = i.to_s # .downcase # Studium.expand_exam_topic(use_this_topic.to_s)
+    if i and !i.empty?
+      entry_for_the_current_exam_topic?.set_text(i)
+    end
+  end; alias set_current_exam_topic set_exam_topic # === set_current_exam_topic
+
+  # ========================================================================= #
+  # === create_the_entry_for_the_current_exam_topic
+  # ========================================================================= #
+  def create_the_entry_for_the_current_exam_topic
+    # ======================================================================= #
+    # === @internal_hash[:entry_exam_topic_in_use]
+    #
+    # This is the entry that contains the current exam topics. The user can
+    # modify the content of this entry at his or her own  discretion. It
+    # is the most important entry for this widget, among all entries
+    # used in this GUI application.
+    #
+    # This entry is positioned rather close to the top of the main widget,
+    # on the left hand side. The user can thus simply manipulate it by
+    # clicking on it; most users will look at the top left (or middle)
+    # first.
+    #
+    # Another entry of this widget may depend on this entry here, so it
+    # should come early in the create-entries method - aka on top of
+    # this method.
+    #
+    # We use a completionable-entry here, but only for ruby-gtk3.
+    # ======================================================================= #
+    _ = entry_with_this_completion(
+      available_exam_topics_in_short_form?
+    )
+    _.clear_background
+    _.bblack1
+    _.very_light_yellow_background
+    _.width_height(400, 20)
+    _.set_font(smaller_font?)
+    _.hint = 'This is the entry that keeps '\
+             'track of the current exam topic.'
+    # ======================================================================= #
+    # We need this entry to be fairly wide, hence the following method call.
+    # ======================================================================= #
+    _.set_size_request(500, 40)
+    _.set_hexpand(false)
+    _.set_vexpand(false)
+    # ======================================================================= #
+    # Allow for scroll-events.
+    # ======================================================================= #
+    _.enable_scroll_events
+    _.on_enter {
+      find_completion_for_the_entry_for_the_current_exam_topic
+      the_button_ask_the_exam_question_was_clicked
+    }
+    _.on_scroll_event {|widget, event|
+      # ===================================================================== #
+      # For now this simply sets a new, random topic.
+      # ===================================================================== #
+      if scroll_up?(event)
+        set_exam_topic(
+          available_exam_topics?.sample.downcase
+        )
+        sync_entry_holding_all_exam_topics_onto_the_combo_box # Sync towards the combo-box.
+      elsif scroll_down?(event)
+        set_exam_topic(
+          available_exam_topics?.sample.downcase
+        )
+        sync_entry_holding_all_exam_topics_onto_the_combo_box # Sync towards the combo-box.
+      end
+    }
+    # ======================================================================= #
+    # Respond to the enter-key pressed next.
+    # ======================================================================= #
+    # _.on_enter_key_pressed { |widget, event|
+    #   sync_entry_holding_all_exam_topics_onto_the_main_combo_box
+    # }
+    # ======================================================================= #
+    # Assign the entry-widget finally:
+    # ======================================================================= #
+    @internal_hash[:entry_exam_topic_in_use] = _ # And assign it here as well.
+  end
+
+  # ========================================================================= #
+  # === do_update_the_entry_n_answered
+  # ========================================================================= #
+  def do_update_the_entry_n_answered(
+      current_exam_topic = combo_box_available_exam_topics?.active_text.to_s.strip.dup,
+      entry              = entry_containing_n_answers? # The entry that is to be updated.
+    )
+    current_exam_topic.strip! if current_exam_topic.end_with? '_'
+    entry.set_text(
+      return_n_answers_from_the_currently_selected_topic(current_exam_topic).to_s
+    ) 
+  end
+
+  # ========================================================================= #
+  # === set_n_exam_questions_are_unanswered
+  # ========================================================================= #
+  def set_n_exam_questions_are_unanswered(i)
+    entry_containing_n_unanswered_questions?.set_text(i.to_s)
+  end; alias set_n_unanswered_questions set_n_exam_questions_are_unanswered # === set_n_unanswered_questions
+
+  # ========================================================================= #
+  # === select_not_yet_completed_exam_topics
+  # ========================================================================= #
+  def select_not_yet_completed_exam_topics(i)
+    if i and i.is_a?(Array)
+      return ::Studium.reject_already_completed_exam_topics(i, hash_dataset_of_all_lectures?)
+    end
+    return i # else return the original input unmodified.
+  end
+
+  # ========================================================================= #
+  # === return_string_how_many_exam_questions_are_already_answered
+  # ========================================================================= #
+  def return_string_how_many_exam_questions_are_already_answered
+    ::Studium.return_string_how_many_exam_questions_are_already_answered
+  end
+
+  # ========================================================================= #
+  # === question_is?
+  # ========================================================================= #
+  def question_is?
+    @internal_hash[:exam_question_object].question?
+  end
+
+  # ========================================================================= #
+  # === answer_is?
+  # ========================================================================= #
+  def answer_is?
+    @internal_hash[:exam_question_object].answer?
+  end
+
+  # ========================================================================= #
+  # === default_delay?
+  # ========================================================================= #
+  def delay_to_use?
+    @internal_hash[:delay_to_use]
+  end; alias default_delay? delay_to_use? # === default_delay?
+
+  # ========================================================================= #
+  # === create_the_button_update_n_questions_were_answered       (update tag)
+  # ========================================================================= #
+  def create_the_button_update_n_questions_were_answered
+    # ======================================================================= #
+    # === The update-button is created next. It had the cat emoji in the
+    #     past, aka 🐈️, but not every computer system has access to such
+    #     an emoji, so this was replaced via an image.
+    #
+    #     The old text was: '🐈️ Update ➡️ '
+    #
+    # ======================================================================= #
+    _ = bold_button('Update ➡️ ')
+    _.on_hover(:lightblue)
+    _.hint =
+      'Click this button to update the entry to the right side.'
+    _.on_clicked {
+      update_the_label_n_questions_were_answered
+    }
+    # ======================================================================= #
+    # Last but not least, assign it:
+    # ======================================================================= #
+    @internal_hash[:button_update_n_questions_were_answered] = _
+  end
+
+  # ========================================================================= #
+  # === return_eventbox_with_an_image_to_exit_the_application
+  #
+  # This method bundles together a quit-the-application functionality.
+  # ========================================================================= #
+  def return_eventbox_with_an_image_to_exit_the_application
+    application_exit_image = return_this_image_based_on_the_default_icon_theme(
+      'system-log-out-symbolic.symbolic'
+    ) # Or: :application_exit
+    _ = create_eventbox(application_exit_image)
+    _.hint = 'Click on this image to exit the program.'
+    _.on_clicked {
+      exit_application
+    }
+    return _
+  end
+
+  # ========================================================================= #
+  # === enable_the_main_key_combinations
+  # ========================================================================= #
+  def enable_the_main_key_combinations(
+      use_this_hash = HASH_DESIGNATED_KEY_COMBINATIONS
+    )
+    enable_these_key_combinations(
+      use_this_hash
+    )
+  end
+
+  # ========================================================================= #
+  # === populate_the_main_grid                       (grid tag, populate tag)
+  #
+  # In order to populate the grid, all widgets have to be designated.
+  # ========================================================================= #
+  def populate_the_main_grid(
+      grid = main_grid?
+    )
+    reset_the_grid_counter # Just to be safe.
+    ::Gtk::Grid.full_width = 3 # 3 entries per row.
+    grid.left(
+      return_frame_containing_the_label_exam_topic
+    )
+    grid.middle(
+      entry_exam_topic_in_use?
+    )
+    mini_hbox = create_hbox
+    mini_hbox.maximal(combobox_available_exam_topics?,    2)
+    mini_hbox.minimal(return_event_box_with_face_glasses, 2)
+    # ======================================================================= #
+    # The event-box comes next to the box with face-glasses:
+    # ======================================================================= #
+    mini_hbox.minimal(return_eventbox_with_an_image_to_exit_the_application, 2)
+
+    grid.right(mini_hbox) # One row has been completed here.
+
+    grid.full_line(scrolled_window1?)
+    grid.full_line(scrolled_window_containing_the_textarea2?)
+    # ========================================================================= #
+    # Show a little helpful text how to use the textview3:
+    # ========================================================================= # 
+    grid.full_line(return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea)
+    # ======================================================================= #
+    # Next add the free-form widget:
+    # ======================================================================= #
+    grid.full_line(return_scrolled_window3)
+    # ======================================================================= #
+    # Next synchronize the design layout of the three scrolled windows:
+    # ======================================================================= #
+    [
+      scrolled_window1?,
+      scrolled_window2?,
+      scrolled_window3?
+    ].each {|this_widget|
+      this_widget.pad8px
+    }
+
+    # ======================================================================= #
+    # Next comes the middle-part of the GUI                      (middle tag)
+    # ======================================================================= #
+
+    # ======================================================================= #
+    # === n questions in total
+    #
+    # This will show the "n questions in total" text.
+    # ======================================================================= #
+    text = selectable_text(N_EXAM_QUESTIONS_IN_TOTAL)
+    text.set_font(smaller_font?)
+    text.pad6px
+    mini_hbox = create_hbox(text, entry_n_total_exam_questions?)
+    grid.left(mini_hbox)
+
+    # ======================================================================= #
+    # === n unanswered questions
+    # ======================================================================= #
+    text = selectable_text(N_UNANSWERED_EXAM_QUESTIONS)
+    text.set_font(smaller_font?)
+    text.pad6px
+    mini_hbox = create_hbox(text, entry_n_unanswered_questions?)
+    grid.middle(mini_hbox)
+
+    # ======================================================================= #
+    # === n answered exam questions
+    #
+    # This is the text that goes along the lines of
+    # "n answered exam questions".
+    # ======================================================================= #
+    text = selectable_text(N_ANSWERED_EXAM_QUESTIONS)
+    text.set_font(smaller_font?)
+    text.pad6px
+    text.royalblue
+    text.make_bold
+    mini_hbox = create_hbox(text, entry_n_answered_exam_questions?)
+    grid.right(mini_hbox)
+
+    # ======================================================================= #
+    # === The entry "percentage solved" comes next
+    # ======================================================================= #
+    text = selectable_text(N_PERCENT_SOLVED)
+    text.set_font(smaller_font?)
+    text.pad6px
+    mini_hbox = create_hbox
+    mini_hbox.minimal(text, 1)
+    mini_hbox.maximal(entry_percentage?, 1)
+    grid.left(mini_hbox)
+
+    # ======================================================================= #
+    # === sleep n seconds solved
+    #
+    # Next we add the delay-n-seconds entry.
+    # ======================================================================= #
+    text = selectable_text(SLEEP_N_SECONDS)
+    text.set_font(smaller_font?)
+    text.pad6px
+    mini_hbox = create_hbox
+    mini_hbox.minimal(text, 1)
+    mini_hbox.maximal(entry_for_sleeping_n_seconds?, 1)
+    grid.middle(mini_hbox)
+    grid.right(checkbox?)
+
+    # ======================================================================= #
+    # Add three buttons next:
+    # ======================================================================= #
+    grid.left(button_ask_the_exam_question?)
+    grid.middle(button_reveal_the_answer?)
+    grid.right(button_solve_the_exam_question?)
+
+    # ======================================================================= #
+    # And two more buttons:
+    # ======================================================================= #
+    grid.left(button_clear?)
+    mini_hbox.set_hexpand(true)
+
+    mini_hbox = create_hbox
+    mini_hbox.minimal(return_wikipedia_widget,                         2)
+    mini_hbox.minimal(return_event_box_for_asking_a_random_exam_topic, 2)
+    mini_hbox.minimal(button_use_random_entry_from_the_ten_aliases?,   2)
+    mini_hbox.minimal(return_button_open_exam_topic_file,              2)
+    # ======================================================================= #
+    # We could also add smiley-emojis next:
+    #
+    #   mini_hbox.minimal(@a_thinking_smiley_emoji,                    2)
+    #   mini_hbox.minimal(@thumbs_up_emoji,                            2)
+    #
+    # ======================================================================= #
+    grid.two_width(mini_hbox)
+    grid.new_line
+    # ======================================================================= #
+    # Next add the label that the ^^^ button can update:
+    # ======================================================================= #
+    grid.left(button_update_n_questions_were_answered?)
+    grid.two_width(label_n_questions_were_answered?)
+    grid.new_line
+    mini_hbox = create_hbox
+    return grid
+  end
+
+  # ========================================================================= #
+  # === enhance_the_entry_for_sleeping_n_seconds
+  # ========================================================================= #
+  def enhance_the_entry_for_sleeping_n_seconds(
+      i = entry_for_sleeping_n_seconds?
+    )
+    i.width_height(45, 20)
+    i.center
+    i.bblack1
+    i.set_name('BG_bisque')
+    i.hint =
+      'Provide the delay here, as <b>n seconds</b>. This will only work '\
+      'if the checkbox to the right side <b>active</b>.'
+  end
+
+  # ========================================================================= #
+  # === enhance_the_entry_percentage
+  # ========================================================================= #
+  def enhance_the_entry_percentage(
+      use_this_font = nil
+    )
+    _ = entry_percentage?
+    _.hint =
+      "This field denotes how many questions have already\n"\
+      "been answered successfully, <b>in percent</b>.\n\n"\
+      "Note that this requires a specific exam topic to "\
+      "have been set, so no percentage value may be "\
+      "shown initially.\n\nSimply assign to an exam topic "\
+      "and it should work fine."
+    _.do_center
+    _.disable_user_input # The user can not change this entry.
+    _.set_font(use_this_font) if use_this_font
+    _.set_name('BG_bisque')
+    _.bblack1
+  end
+
+  # ========================================================================= #
+  # === enhance_the_entry_containing_n_questions
+  # ========================================================================= #
+  def enhance_the_entry_containing_n_questions(
+      use_this_font = smaller_font?,
+      entry         = @internal_hash[:entry_n_total_exam_questions]
+    )
+    entry.set_font(use_this_font) if use_this_font
+    entry.clear_background
+    entry.width_height(350, 22)
+    entry.bblack1
+    entry.center
+    entry.readonly
+    entry.very_light_yellow_background
+  end
+
+  # ========================================================================= #
+  # === enhance_entry_n_answered_exam_questions
+  #
+  # This method can be used to enhance the entry "n answered exam questions".
+  # ========================================================================= #
+  def enhance_entry_n_answered_exam_questions(
+      use_this_font = :default_font,
+      entry         = entry_n_answered_exam_questions?
+    )
+    case use_this_font
+    # ======================================================================= #
+    # === :default_font
+    # ======================================================================= #
+    when :default_font, nil
+      use_this_font = smaller_font?
+    end
+    # ======================================================================= #
+    # === @internal_hash[:entry_n_answered_exam_questions]
+    # ======================================================================= #
+    entry.set_font(use_this_font) if use_this_font
+    entry.width_height(320, 22)
+    entry.bblack1
+    entry.very_light_yellow_background
+    entry.center
+    entry.readonly
+  end
+
+  # ========================================================================= #
+  # === create_the_entry_n_answered_exam_questions
+  # ========================================================================= #
+  def create_the_entry_n_answered_exam_questions(
+      use_this_font = :default_font
+    )
+    # ======================================================================= #
+    # === The entry keeping track as to how many answers have been
+    #     given for that particular exam-topic.
+    # ======================================================================= #
+    @internal_hash[:entry_n_answered_exam_questions] = entry('', 12)
+    enhance_entry_n_answered_exam_questions(use_this_font)
+    return entry_n_answered_exam_questions? # And return it here.
+  end; alias create_the_entry_containing_n_answered_exam_questions create_the_entry_n_answered_exam_questions # === create_the_entry_containing_n_answered_exam_questions
+
+  # ========================================================================= #
+  # === enhance_entry_containing_n_unanswered_questions
+  # ========================================================================= #
+  def enhance_entry_containing_n_unanswered_questions(
+      use_this_font = smaller_font?,
+      entry         = entry_n_unanswered_questions?
+    )
+    case use_this_font
+    # ======================================================================= #
+    # === :default_font
+    # ======================================================================= #
+    when :default_font, nil
+      use_this_font = smaller_font?
+    end
+    entry.clear_background
+    entry.set_font(use_this_font) if use_this_font
+    entry.width_height(50, 20)
+    entry.bblack1
+    entry.very_light_yellow_background
+    entry.center
+    entry.readonly
+  end; alias enhance_entry_containing_n_unanswered_questions enhance_entry_containing_n_unanswered_questions # === enhance_entry_containing_n_unanswered_questions
+
+  # ========================================================================= #
+  # === set_n_exam_questions_were_already_answered
+  # ========================================================================= #
+  def set_n_exam_questions_were_already_answered(i)
+    entry_n_answered_exam_questions?.set_text(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === enable_alt_w_key_combination
+  #
+  # This method will specifically enable the "alt+w" shortcut.
+  # ========================================================================= #
+  def enable_alt_w_key_combination(
+      i = @accel_group
+    )
+    # ======================================================================= #
+    # Add alt+w key combination, to open the current exam topic file:
+    # ======================================================================= #
+    use_this_key = ::Gdk::Keyval::KEY_W
+    i.connect(use_this_key, :mod1_mask, :visible) { # alt+w
+      do_open_the_current_exam_topic_file
+    }
+  end
+
+  # ========================================================================= #
+  # === current_exam_topic_from_the_entry?
+  # ========================================================================= #
+  def current_exam_topic_from_the_entry?
+    entry_for_the_current_exam_topic?.text?.to_s
+  end; alias current_exam_topic_as_a_string? current_exam_topic_from_the_entry? # === current_exam_topic_as_a_string?
+
+  # ========================================================================= #
+  # === do_open_the_current_exam_topic_file
+  #
+  # This method can either open the exam-file in the bluefish editor,
+  # or in the integrated ruby-gtk editor. Since as of July 2021 we
+  # will try the integrated variant. Unfortunately ruby-gtk is somehow
+  # buggy - reading a large file leads to a BadAlloc error, so this
+  # was changed to open an external editor instead.
+  # ========================================================================= #
+  def do_open_the_current_exam_topic_file(
+      use_this_as_exam_topic = current_exam_topic_from_the_entry?
+    )
+    use_this_as_exam_topic = Studium.find_corresponding_exam_topic(use_this_as_exam_topic)
+    if use_this_as_exam_topic.empty?
+      do_popup_the_you_have_to_provide_an_exam_topic
+    end
+    # ======================================================================= #
+    # We must obtain the correct path next, to then send into the editor:
+    # ======================================================================= #
+    use_this_as_exam_topic = Studium.path_to_exam_topic?+
+                             File.basename(use_this_as_exam_topic)
+    if use_the_internal_editor? # This here is when we use the internal editor.
+      set_save_into_this_local_file(use_this_as_exam_topic)
+      set_editor_buffer(File.read(use_this_as_exam_topic))
+      @notebook_tab.focus_on_this_tab(2)
+    else
+      # ======================================================================= #
+      # Or simply use bluefish or whatever else the editor is.
+      # ======================================================================= #
+      _ = "#{use_this_editor?} #{use_this_as_exam_topic}"
+      esystem(_)
+    end
+  end
+
+  # ========================================================================= #
+  # === return_button_open_exam_topic_file
+  #
+  # This button should be next to the event box that will ask a random
+  # exam topic.
+  # ========================================================================= #
+  def return_button_open_exam_topic_file
+    # ======================================================================= #
+    # This button will have the symbol for :open_file, an emoji - if
+    # emojis are used. Otherwise an image will be used instead.
+    # ======================================================================= #
+    if use_emoji?
+      _ = button(return_emoji(:open_box))
+    else
+      _ = button_with_this_image(image_open_file)
+    end
+    _.no_relief
+    _.on_hover_lightblue
+    _.hint = 'Click on this button to <b>open the current exam-topic file</b>.'
+    _.on_clicked {
+      do_open_the_current_exam_topic_file
+    }
+    return _
+  end
+
+  # ========================================================================= #
+  # === return_n_answers_from_the_currently_selected_topic
+  # ========================================================================= #
+  def return_n_answers_from_the_currently_selected_topic(
+      i = current_exam_topic_as_a_string?
+    )
+    ::Studium.n_answers_available_in_this_topic(i)
+  end
+
+  # ========================================================================= #
+  # === shall_we_create_the_gtk_editor?
+  # ========================================================================= #
+  def shall_we_create_the_gtk_editor?
+    @internal_hash[:use_this_editor] == :internal
+  end
+
+  # ========================================================================= #
+  # === create_the_labels
+  # ========================================================================= #
+  def create_the_labels
+    # ======================================================================= #
+    # === @label_n_questions_were_answered
+    # ======================================================================= #
+    @label_n_questions_were_answered = selectable_label
+    update_the_label_n_questions_were_answered(@label_n_questions_were_answered)
+  end
+
+  # ========================================================================= #
+  # === label_n_questions_were_answered?
+  # ========================================================================= #
+  def label_n_questions_were_answered?
+    @label_n_questions_were_answered
+  end
+
+  # ========================================================================= #
+  # === set_n_exam_questions_exist_in_total
+  #
+  # This method exists to set the value of the proper entry, containing
+  # how many exam-questions are still unanswered.
+  # ========================================================================= #
+  def set_n_exam_questions_exist_in_total(i)
+    entry_n_total_exam_questions?.set_text(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === combobox_available_exam_topics?
+  #
+  # This combo box will contain all available (registered) exam topics.
+  # ========================================================================= #
+  def combobox_available_exam_topics?
+    @internal_hash[:combobox_available_exam_topics]
+  end; alias return_the_combobox                         combobox_available_exam_topics? # === return_the_combobox
+       alias combo_box_available_exam_topics?            combobox_available_exam_topics? # === combo_box_available_exam_topics?
+       alias main_combo_box?                             combobox_available_exam_topics? # === main_combo_box?
+       alias combo_box?                                  combobox_available_exam_topics? # === combo_box?
+       alias return_combo_box_showing_all_exam_questions combobox_available_exam_topics? # === return_combo_box_showing_all_exam_questions
+       alias return_combo_box_available_exam_topics      combobox_available_exam_topics? # === return_combo_box_available_exam_topics
+
+  # ========================================================================= #
+  # === button_update_n_questions_were_answered?
+  # ========================================================================= #
+  def button_update_n_questions_were_answered?
+    @internal_hash[:button_update_n_questions_were_answered]
+  end
+
+  # ========================================================================= #
+  # === update_the_label_n_questions_were_answered
+  # ========================================================================= #
+  def update_the_label_n_questions_were_answered(
+      i = @label_n_questions_were_answered
+    )
+    i.set_text(
+      return_string_how_many_exam_questions_are_already_answered
+    )
+  end; alias update_the_label_containing_the_last_exam_question update_the_label_n_questions_were_answered # === update_the_label_containing_the_last_exam_question
+
+  # ========================================================================= #
+  # === return_checkbox_shall_we_reveal_the_answer
+  #
+  # This will only return the checkbox; creation must happen before
+  # this method is called.
+  # ========================================================================= #
+  def return_checkbox_shall_we_reveal_the_answer
+    @internal_hash[:checkbox_shall_we_reveal_the_answer]
+  end; alias checkbox?                            return_checkbox_shall_we_reveal_the_answer # === checkbox?
+       alias checkbox_shall_we_reveal_the_answer? return_checkbox_shall_we_reveal_the_answer # === checkbox_shall_we_reveal_the_answer?
+
+  # ========================================================================= #
+  # === simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox
+  #
+  # This method does not work currently.
+  # ========================================================================= #
+  def simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(
+      i
+    )
+    combobox_available_exam_topics?.append_text(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === main_grid?
+  # ========================================================================= #
+  def main_grid?
+    @internal_hash[:main_grid]
+  end
+
+  # ======================================================================= #
+  # === entry_exam_topic_in_use?
+  # ======================================================================= #
+  def entry_exam_topic_in_use?
+    @internal_hash[:entry_exam_topic_in_use]
+  end; alias entry_for_the_current_exam_topic?    entry_exam_topic_in_use? # === entry_for_the_current_exam_topic?
+       alias entry_ask_questions_from_this_topic? entry_exam_topic_in_use? # === entry_ask_questions_from_this_topic?
+       alias entry_for_the_exam_topic?            entry_exam_topic_in_use? # === entry_for_the_exam_topic?
+       alias entry_holding_all_exam_topics?       entry_exam_topic_in_use? # === entry_ask_questions_from_this_topic?
+       alias entry_current_exam_topic?            entry_exam_topic_in_use? # === entry_current_exam_topic?
+
+  # ========================================================================= #
+  # === create_then_return_the_default_grid
+  # ========================================================================= #
+  def create_then_return_the_default_grid
+    grid = default_grid # main_grid?
+    grid.pad2px
+    grid.default_spacing(8)
+    grid.width_height(width?,     height?)
+    grid.set_size_request(width?, height?)
+    @internal_hash[:main_grid] = grid
+    return grid
+  end; alias create_the_main_grid create_then_return_the_default_grid # === create_the_main_grid
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    create_the_entries # Should come fairly early - definitely before the grid is created.
+    create_the_checkbox_shall_we_reveal_the_answer # ← Must come after the entries were created.
+    create_text_buffer_for_the_answer # Must come before create_the_textviews().
+    create_the_textviews
+    create_the_combobox
+    create_the_buttons
+    create_the_editor
+    create_the_labels # Should come after the editor was created.
+    # create_the_emoji_toggle_widget # This currently does not work.
+    create_the_thumbs_up_emoji
+    create_the_context_menu # The context-menu can come last.
+    # instantiate_the_control_panel # This one must come before the notebook tab is populated.
+    create_the_main_grid
+    create_the_notebook_tab  # This must come late.
+  end; alias create_skeleton create_the_skeleton # === create_skeleton
+
+  # ========================================================================= #
+  # === connect_the_notebook_tab
+  #
+  # This method will connect the notebook with the main Gtk::Window in use.
+  # ========================================================================= #
+  def connect_the_notebook_tab(
+      window         = main_window?,
+      padding_to_use = 2
+    )
+    # @notebook_tab.halign = 0.5
+    scrolled_window = create_scrolled_window(@notebook_tab)
+    scrolled_window.show_all
+    window.add(scrolled_window) # , padding_to_use)
+    window.show_all
+  end
+
+  # ========================================================================= #
+  # === create_the_notebook_tab                                (notebook tag)
+  # ========================================================================= #
+  def create_the_notebook_tab
+    # ======================================================================= #
+    # === @notebook_tab
+    # ======================================================================= #
+    @notebook_tab = create_notebook { :make_it_scrollable }
+    @notebook_tab.css_class('notebook_for_the_exam_trainer')
+    @notebook_tab.the_tabs_appear_on_top
+    @notebook_tab.can_be_rearranged
+    @notebook_tab.do_show_the_tabs
+    @notebook_tab.do_show_the_border
+  end
+
+  # ========================================================================= #
+  # === the_first_notebook_tab_is_active
+  # ========================================================================= #
+  def the_first_notebook_tab_is_active
+    @notebook_tab.the_first_notebook_tab_is_active
+  end
+
+  # ========================================================================= #
+  # === populate_the_notebook_tab
+  # ========================================================================= #
+  def populate_the_notebook_tab
+    # ======================================================================= #
+    # We could display a Curriculum in a notebook-tab. Unfortunately, in
+    # 2021, this is a bit wide, and makes the whole notebook appear too
+    # large, so it was disabled again, until we improve on it. We probably
+    # have to decrease its size from the get go, and manage it at all
+    # times via scrolled-widgets.
+    #
+    # The old code is shown next:
+    #
+    #   label4 = modify_bold_label('Curriculum Viewer', @internal_hash[:colour_to_use_for_the_notebook_labels])
+    #   @notebook_tab.add_tab(::Studium::GUI::Gtk::CurriculumViewer.new, label4)
+    #
+    # ======================================================================= #
+    show_ten_aliases = show_ten_aliases?
+    # ======================================================================= #
+    # === Add the first tab, containing the "Exam Trainer" widget next
+    #
+    # This will be contained in @first_vbox, which in turn contains
+    # the @horizontal_pane variable.
+    # ======================================================================= #
+    @notebook_tab.append_page(
+      main_grid?,
+      modify_bold_label('Exam trainer', @internal_hash[:colour_to_use_for_the_notebook_labels])
+    )
+    if use_the_internal_editor?
+      # ===================================================================== #
+      # Append the editor in this event:
+      # ===================================================================== #
+      @notebook_tab.append_page(@editor, bold_text('editor'))
+    end
+    if Object.const_defined?(:Roebe) and show_ten_aliases
+      # ===================================================================== #
+      # Designate the parent widget next:
+      # ===================================================================== #
+      show_ten_aliases.set_parent_widget(self)
+      # ===================================================================== #
+      # And append the show-ten-aliases widget next:
+      # ===================================================================== #
+      @notebook_tab.append_page(
+        show_ten_aliases,
+        modify_bold_label(
+          'Current top-ten exams', @internal_hash[:colour_to_use_for_the_notebook_labels]
+        )
+      )
+    end
+    @notebook_tab.the_first_tab_is_active
+    # ======================================================================= #
+    # === Add the tab that includes the Control Panel
+    # ======================================================================= #
+    # label2 = modify_bold_label('Control Panel', @internal_hash[:colour_to_use_for_the_notebook_labels])
+    # @notebook_tab.append_page(
+    #   @control_panel,
+    #   label2
+    # )
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExamTrainer.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::Studium::GUI::UniversalWidgets::ExamTrainer.new(i)
+    r = ::Gtk.run
+    r << _
+    _.set_parent_widget(r) # Designate it as the parent widget.
+    _.enable_the_main_key_combinations
+    r.add_context_menu_with_the_default_accel_group
+    r.on_button_press_event { |widget, event|
+      if ::Gtk.right_mouse_click?(event) # right mouse click event.
+        _.context_menu?.popup_based_on_this_event(event)
+      end
+    }
+    r.automatic_size_then_automatic_title
+    r.enable_quick_exit
+    r.move_to(x: 15, y: 0)
+    r.run
+  end
+
+  # ========================================================================= #
+  # === resize_the_notebook_tab_towards_the_primary_width_and_height
+  # ========================================================================= #
+  def resize_the_notebook_tab_towards_the_primary_width_and_height
+    _ = @notebook_tab
+    _.set_size_request(width?, height?)
+  end
+ 
+  # ========================================================================= #
+  # === return_button_solve_the_question
+  #
+  # The old String was:
+  #
+  #   '_Solve the exam question'
+  #
+  # ========================================================================= #
+  def return_button_solve_the_question
+    _ = bold_button('😁️ Mark the question as _solved ✓', self, :use_a_mnemonic) {
+      :button_solve_the_exam_question_was_clicked
+    }
+    # ======================================================================= #
+    # .set_size_request() is not necessary as we use a separate method
+    # that controls the size of the widget at hand.
+    # ======================================================================= #
+    _.hint =
+      'Use this button to <span weight="bold" foreground="lightgreen">mark '\
+      'the question as solved</span> - that is, it is now '\
+      '<b>correctly answered</b>).'
+    # button_solve_the_question.set_size_request(78, 30)
+    return _
+  end
+
+  # ========================================================================= #
+  # === array_all_exam_questions?
+  #
+  # Query-method to keep track of all exam-questions that were asked in
+  # the current run.
+  # ========================================================================= #
+  def array_all_exam_questions?
+    @internal_hash[:array_all_exam_questions]
+  end; alias all_exam_questions array_all_exam_questions? # === all_exam_questions
+
+  # ========================================================================= #
+  # === update_array_all_exam_questions
+  # ========================================================================= #
+  def update_array_all_exam_questions
+    @internal_hash[:array_all_exam_questions] = []
+  end
+
+  # ========================================================================= #
+  # === do_popup_the_array_of_all_exam_questions
+  #
+  # This method will be called then whe icon-with-glasses is clicked.
+  # ========================================================================= #
+  def do_popup_the_array_of_all_exam_questions(
+      array = :infer
+    )
+    case array
+    # ======================================================================= #
+    # === :infer
+    # ======================================================================= #
+    when :infer
+      array = Studium.return_all_exam_questions_from_this_topic(
+        entry_exam_topic_as_string?
+      )
+    end
+    content = array.map.with_index {|line, index| index += 1
+      line = line.dup
+      line.prepend(
+        "(#{index}) "
+      )
+      line
+    }.join("\n")
+    text_buffer = create_text_buffer(content)
+    text_view   = create_text_view(text_buffer)
+    scrolled_window = create_scrolled_window(text_view)
+    scrolled_window.width_height(1200, 700)
+    scrolled_window.pad8px
+    # scrolled_window.add(text_view)
+    scrolled_window.show_all
+    popup_over_this_widget(
+      scrolled_window,
+      text_view,
+      entry_for_the_exam_topic?
+    ).popup
+  end
+
+  # ========================================================================= #
+  # === do_popup_the_you_have_to_provide_an_exam_topic
+  # ========================================================================= #
+  def do_popup_the_you_have_to_provide_an_exam_topic
+    bold_popover_message = bold_label(
+      "You have to provide an exam-topic, in the exam-topic entry.\n\n"\
+      "The arrow should indicate the proper entry."
+    )
+    popover_message( # Nudge the user here.
+      bold_popover_message,
+      entry_for_the_exam_topic?
+    ).popup
+  end
+
+  # ========================================================================= #
+  # === exam_topic_from_the_correct_entry?
+  #
+  # This method must always return a string, hence the .to_s call.
+  # ========================================================================= #
+  def exam_topic_from_the_correct_entry?
+    entry_exam_topic_in_use?.text?.to_s.strip # This must always be a String.
+  end; alias current_exam_topic?                  exam_topic_from_the_correct_entry? # === current_exam_topic?
+       alias main_exam_topic?                     exam_topic_from_the_correct_entry? # === main_exam_topic?
+       alias exam_topic?                          exam_topic_from_the_correct_entry? # === exam_topic?
+       alias current_topic?                       exam_topic_from_the_correct_entry? # === current_topic?
+       alias entry_exam_topic?                    exam_topic_from_the_correct_entry? # === exam_topic?
+       alias entry_ask_questions?                 exam_topic_from_the_correct_entry? # === entry_ask_questions?
+       alias entry_ask_questions_from_this_topic? exam_topic_from_the_correct_entry? # === entry_ask_questions_from_this_topic?
+       alias entry_exam_topic_as_string?          exam_topic_from_the_correct_entry? # === entry_exam_topic_as_string?
+
+  # ======================================================================= #
+  # === sync_combo_box_entry_onto_the_current_exam_entry
+  # ======================================================================= #
+  def sync_combo_box_entry_onto_the_current_exam_entry(
+      i = combo_box?.entry?
+    )
+    _ = ::Studium.find_corresponding_exam_title(i)
+    set_current_exam_topic(_)
+  end
+
+  # ========================================================================= #
+  # === do_update_the_entry_n_unanswered_questions
+  #
+  # This method depends on two entries being set correctly.
+  # ========================================================================= #
+  def do_update_the_entry_n_unanswered_questions
+    _ = entry_containing_n_questions?.text?.to_i -
+        entry_containing_n_answers?.text?.to_i 
+    entry_containing_n_unanswered_questions?.set_text(_.to_s)
+  end; alias update_the_entry_n_unanswered_questions do_update_the_entry_n_unanswered_questions # === update_the_entry_n_unanswered_questions
+       alias update_n_unanswered                     do_update_the_entry_n_unanswered_questions # === update_n_unanswered
+
+  # ========================================================================= #
+  # === set_n_percentage_of_questions_answered
+  #
+  # An alternative would be:
+  #
+  #   percentage_value = Studium.n_percent_questions_answered_of_this_topic?(
+  #     use_this_exam_topic.downcase
+  #   )
+  #
+  # ========================================================================= #
+  def set_n_percentage_of_questions_answered(i)
+    percentage_value = -1 if percentage_value == false # Weak "safeguard".
+    i = i.to_f.round(1)
+    entry_percentage?.set_text("#{i}%") # Sync it onto the proper entry.
+  end; alias set_n_percentage                                                   set_n_percentage_of_questions_answered # === set_n_percentage
+       alias update_the_percentage_entry                                        set_n_percentage_of_questions_answered # === update_the_percentage_entry
+       alias do_update_this_entry_with_that_exam_topic_for_its_percentage_value set_n_percentage_of_questions_answered # === do_update_this_entry_with_that_exam_topic_for_its_percentage_value
+
+  # ======================================================================= #
+  # === handle_the_combo_box_available_exam_topics_on_changed_event
+  # ======================================================================= #
+  def handle_the_combo_box_available_exam_topics_on_changed_event
+    clear_question_buffer
+    # ===================================================================== #
+    # Now we need to sync from the combo-box towards the current
+    # exam-entry.
+    # ===================================================================== #
+    sync_combo_box_entry_onto_the_current_exam_entry
+    one_two_three
+  end; alias do_handle_the_combobox_available_exam_topics_on_changed_event handle_the_combo_box_available_exam_topics_on_changed_event # === do_handle_the_combobox_available_exam_topics_on_changed_event
+       alias sync_the_current_exam_topic_onto_the_exam_topic_entry         handle_the_combo_box_available_exam_topics_on_changed_event # === sync_the_current_exam_topic_onto_the_exam_topic_entry
+
+  # ========================================================================= #
+  # === create_the_checkbox_shall_we_reveal_the_answer
+  # ========================================================================= #
+  def create_the_checkbox_shall_we_reveal_the_answer(
+      entry_delay_to_use = entry_delay_to_use?
+    )
+    _ = create_checkbox(
+      " Automatically reveal the \n answer after a delay"
+    )
+    _.set_font(smallest_font?)
+    # ======================================================================= #
+    # Next determine whether the checkbox is active, on startup, or whether
+    # it is not active when the GUI starts up.
+    # ======================================================================= #
+    _.mark_as_checked # Should be checked as-is.
+    _.hint =
+      'Deselect this if you do not want to automatically reveal the answer. '\
+      'In that case you have to manually click on the Answer button.'
+    _.on_toggled { |widget|
+      if _.active?
+        entry_delay_to_use.grey_in
+      elsif not _.active?
+        entry_delay_to_use.grey_out
+      end
+    }
+    if _.is_it_active?
+      entry_delay_to_use.grey_in
+    else
+      entry_delay_to_use.grey_out
+    end
+    # ======================================================================= #
+    # === @internal_hash[:checkbox_shall_we_reveal_the_answer]
+    # ======================================================================= #
+    @internal_hash[:checkbox_shall_we_reveal_the_answer] = _
+  end
+
+  # ========================================================================= #
+  # === button_ask_the_exam_question_was_clicked                (clicked tag)
+  #
+  # This is the most important button of this GUI.
+  # ========================================================================= #
+  def button_ask_the_exam_question_was_clicked(
+      use_this_topic = 
+        :obtain_the_exam_topic_from_the_relevant_entry
+    )
+    case use_this_topic
+    # ======================================================================= #
+    # === :obtain_the_exam_topic_from_the_relevant_entry
+    # ======================================================================= #
+    when :obtain_the_exam_topic_from_the_relevant_entry
+      use_this_topic = entry_exam_topic_in_use?.text?.to_s
+    end
+    we_may_reveal_the_exam_answer
+    one_two_three(use_this_topic)
+  end; alias do_handle_the_click_event_for_the_ask_question_button           button_ask_the_exam_question_was_clicked # === do_handle_the_click_event_for_the_ask_question_button
+       alias ask_an_exam_question                                            button_ask_the_exam_question_was_clicked # === ask_an_exam_question
+       alias do_ask_the_exam_question                                        button_ask_the_exam_question_was_clicked # === do_ask_the_exam_question
+       alias do_ask_a_new_question                                           button_ask_the_exam_question_was_clicked # === do_ask_a_new_question
+       alias trigger_the_event_when_the_ask_exam_question_button_was_clicked button_ask_the_exam_question_was_clicked # === trigger_the_event_when_the_ask_exam_question_button_was_clicked
+       alias ask_an_exam_question                                            button_ask_the_exam_question_was_clicked # === ask_an_exam_question
+       alias do_ask_an_exam_question                                         button_ask_the_exam_question_was_clicked # === do_ask_an_exam_question
+       alias do_ask_a_new_exam_question                                      button_ask_the_exam_question_was_clicked # === do_ask_a_new_exam_question
+       alias the_button_ask_the_question_was_clicked                         button_ask_the_exam_question_was_clicked # === the_button_ask_the_question_was_clicked
+       alias the_button_ask_the_exam_question_was_clicked                    button_ask_the_exam_question_was_clicked # === the_button_ask_the_exam_question_was_clicked
+
+  # ========================================================================= #
+  # === entry_for_sleeping_n_seconds?
+  # ========================================================================= #
+  def entry_for_sleeping_n_seconds?
+    @internal_hash[:entry_for_sleeping_n_seconds]
+  end; alias entry_delay_to_use?                 entry_for_sleeping_n_seconds? # === entry_delay_to_use
+       alias entry_sleep_n_seconds?              entry_for_sleeping_n_seconds? # === entry_sleep_n_seconds?
+       alias entry_delay?                        entry_for_sleeping_n_seconds? # === entry_delay?
+       alias return_entry_for_sleeping_n_seconds entry_for_sleeping_n_seconds? # === return_entry_for_sleeping_n_seconds
+       alias return_the_entry_sleep_n_seconds    entry_for_sleeping_n_seconds? # === return_the_entry_sleep_n_seconds
+
+  # ========================================================================= #
+  # === entry_delay_value?
+  # ========================================================================= #
+  def entry_delay_value?
+    entry_for_sleeping_n_seconds?.text?.to_f
+  end
+
+  # ========================================================================= #
+  # === exam_question_object?
+  # ========================================================================= #
+  def exam_question_object?
+    @internal_hash[:exam_question_object]
+  end
+
+  # ========================================================================= #
+  # === create_the_reveal_the_answer_button
+  #
+  # This is the so-called "reveal button".
+  # ========================================================================= #
+  def create_the_reveal_the_answer_button
+    # ======================================================================= #
+    # === @internal_hash[:button_reveal_the_answer]              (answer tag)
+    #
+    # The reveal-button is created next, also known as the "answer button".
+    # The mnemonic-key is set to "A", so that we can toggle between
+    # "Q" and "A" for "Question" and "Answer" respectively.
+    # ======================================================================= #
+    _ = bold_button('Reveal the _Answer', self, true) { # This was the old emoji: ❗
+      :the_button_reveal_the_answer_was_clicked
+    }
+    _.set_size_request(78, 30)
+    #_.on_hover_lightblue
+    _.hint = 'Click on this button in order to '\
+      'reveal the answer to the current exam question at hand.'
+    @internal_hash[:button_reveal_the_answer] = _
+  end; alias create_the_reveal_button create_the_reveal_the_answer_button # === create_the_reveal_button
+
+  # ========================================================================= #
+  # === set_exam_answer                                          (answer tag)
+  # ========================================================================= #
+  def set_exam_answer(
+      i                   = answer_is?,
+      apply_these_filters = [:filter_away_tags]
+    )
+    i = sanitize_the_answer(i.to_s, apply_these_filters)
+    i = ::Gtk.replace_all_URL_entries_in_this_string(i)
+    i.lstrip!
+    i.sub!(/A: /,'') if i.start_with? 'A: '
+    # ================================================================= #
+    # Replace all "(2) foo" entries with "(2) foo\n" entries.
+    # ================================================================= #
+    i = ::Studium.add_newlines_to_numbered_exam_question(i)
+    @internal_hash[:exam_answer] = i
+    textview2?.set_text(i)
+  end; alias set_answer set_exam_answer # === set_answer
+
+  # ========================================================================= #
+  # === exam_answer?
+  # ========================================================================= #
+  def exam_answer?
+    @internal_hash[:exam_answer]
+  end
+
+  # ========================================================================= #
+  # === always_reveal_the_exam_answer_via_this_method
+  #
+  # This method will ALWAYS reveal the exam-answer.
+  # ========================================================================= #
+  def always_reveal_the_exam_answer_via_this_method
+    set_exam_answer
+    always_reset_the_delay_before_using_another_delay
+  end
+
+  # ========================================================================= #
+  # === may_we_reveal_the_answer_after_a_delay?
+  # ========================================================================= #
+  def may_we_reveal_the_answer_after_a_delay?
+    @internal_hash[:may_we_reveal_the_answer_after_a_delay]
+  end; alias may_we_reveal_the_answer? may_we_reveal_the_answer_after_a_delay? # === may_we_reveal_the_answer?
+
+  # ========================================================================= #
+  # === do_sleep_now                                              (sleep tag)
+  # ========================================================================= #
+  def do_sleep_now(
+      i                   = :default,
+      use_this_as_timeout = 0
+    )
+    case i
+    # ======================================================================= #
+    # === :default
+    #
+    # This will always obtain the value from the proper entry.
+    # ======================================================================= #
+    when :default,
+         :use_the_correct_entry_for_the_delay
+      i = entry_sleep_n_seconds?.text?
+    end
+    i = i.to_f # Always use a float here.
+    # ======================================================================= #
+    # An alternative to sleep() would be this:
+    #
+    #   GLib::Timeout.add(use_this_as_timeout) {
+    #     @text_view_for_the_answer.set_text(answer)
+    #     false
+    #   }
+    #
+    # ======================================================================= #
+    if use_this_as_timeout >= 0 and
+       checkbox_shall_we_reveal_the_answer?.is_it_active?
+      sleep(i)
+    end
+  end
+
+  # ========================================================================= #
+  # === one_two_three                                     (one_two_three tag)
+  # ========================================================================= #
+  def one_two_three(
+      use_this_topic =
+        exam_topic_from_the_correct_entry?
+    )
+    update_array_all_exam_questions
+    if use_this_topic.empty?
+      # ===================================================================== #
+      # First protect against empty exam topics, with a helpful message to
+      # the user.
+      # ===================================================================== #
+      do_popup_the_you_have_to_provide_an_exam_topic
+    end
+    unless ::Studium.is_this_exam_topic_available?(use_this_topic)
+      # ===================================================================== #
+      # Here we must notify the user that this exam-topic is not registered
+      # aka not available.
+      # ===================================================================== #
+      popover_message( # Nudge the user here.
+        text(
+          ' <b>⚠️</b> No exam-entry called <b>'+use_this_topic.to_s+
+          '</b> is available. <b>⚠️</b>'
+        ),
+        entry_for_the_exam_topic?
+      ).popup
+      return
+    end
+    local_file = Studium.local_exam_file(use_this_topic)
+    if File.exist?(local_file)
+      update_hash_dataset_of_all_lectures
+      # ===================================================================== #
+      # (1) Pass the current exam topic into a method that will return
+      #     an Array.
+      # ===================================================================== #
+      # array = Studium.return_an_array_for_this_exam_topic(use_this_topic)
+      dataset = Studium.read_in_unanswered_exam_questions_from_this_file(local_file)
+      sample = dataset.sample
+      n_exam_questions_in_total   = Studium.n_exam_questions_in_this_topic?(File.basename(local_file))
+      n_unanswered_exam_questions = dataset.size
+      n_answered_exam_questions   = n_exam_questions_in_total - n_unanswered_exam_questions 
+      # ===================================================================== #
+      # (3) Next we must update various entries:
+      # ===================================================================== #
+      set_n_exam_questions_exist_in_total(n_exam_questions_in_total)
+      set_n_unanswered_questions(n_unanswered_exam_questions)
+      set_n_exam_questions_were_already_answered(n_answered_exam_questions)
+      set_n_percentage(
+        n_answered_exam_questions.to_f * 100.0 / n_exam_questions_in_total
+      )
+      if entry_percentage?.text?.to_f == 100.0
+        # =================================================================== #
+        # Handle the case where the exam-topic at hand has been answered
+        # completely.
+        # =================================================================== #
+        bold_popover_message = label(
+          "All questions have been answered for the topic <b>"\
+          "#{current_exam_topic?}</b>.\n\n       <b>Please choose another exam topic</b>.\n"
+        )
+        popover_message(
+          bold_popover_message,
+          button_ask_the_exam_question?
+        ).popup
+      else
+        # =================================================================== #
+        # Next keep a backup-reference
+        # =================================================================== #
+        ::Studium.set_last_exam_question_line(sample)
+        # =================================================================== #
+        # Keep a reference to the exam-question object:
+        # =================================================================== #
+        @internal_hash[:exam_question_object] = Studium::Exams::ExamQuestion.new(sample)
+        @internal_hash[:may_we_reveal_the_answer_after_a_delay] = true
+        clear_the_exam_answer
+        last_exam_question_asked = current_exam_question?
+        set_exam_question(
+          @internal_hash[:exam_question_object].question?,
+          :remove_tags
+        )
+        Thread.new {
+          if may_we_reveal_the_answer_after_a_delay?
+            do_sleep_now(:use_the_correct_entry_for_the_delay)
+            unless last_exam_question_asked == current_exam_question?
+              reveal_the_exam_answer(:but_only_if_we_may)
+            end
+          end
+        }
+      end
+    else
+      e "No file exists at `#{local_file}`."
+    end
+  end; alias update_n_questions             one_two_three # === update_n_questions
+       alias update_three_important_widgets one_two_three # === update_three_important_widgets
+
+  # ========================================================================= #
+  # === reveal_the_exam_answer
+  # ========================================================================= #
+  def reveal_the_exam_answer(
+      may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay?
+    )
+    case may_we_reveal_the_exam_answer
+    # ========================================================================= #
+    # === true
+    # ========================================================================= #
+    when true
+      set_exam_answer
+    # ========================================================================= #
+    # === :but_only_if_we_may
+    # ========================================================================= #
+    when :but_only_if_we_may
+      may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay?
+      set_exam_answer if may_we_reveal_the_exam_answer
+    end
+  end; alias reveal_the_answer_to_the_exam_question set_exam_answer # === reveal_the_answer_to_the_exam_question
+
+  # ========================================================================= #
+  # === exam_question?
+  # ========================================================================= #
+  def exam_question?
+    @internal_hash[:exam_question]
+  end; alias current_exam_question? exam_question? # === current_exam_question?
+
+  # ========================================================================= #
+  # === button_reveal_the_answer_was_clicked
+  # ========================================================================= #
+  def button_reveal_the_answer_was_clicked
+    if all_questions_have_been_answered_in_this_topic?
+      notify_the_user_that_all_questions_have_been_answered_in_this_topic(
+        current_topic?,
+        _
+      )
+    else
+      always_reveal_the_exam_answer_via_this_method
+      we_may_not_reveal_the_exam_answer_anymore
+    end
+  end; alias the_button_reveal_the_answer_was_clicked button_reveal_the_answer_was_clicked # === the_button_reveal_the_answer_was_clicked
+
+  # ========================================================================= #
+  # === return_button_ask_the_exam_question                         (ask tag)
+  # ========================================================================= #
+  def return_button_ask_the_exam_question(
+      use_emoji = false
+    )
+    # ======================================================================= #
+    # Add the ask-exam-question button next. Note that its click-event
+    # is handled separately via a method call.
+    #
+    # The question mark emoji is Unicode Character "❓" (U+2753).
+    # ======================================================================= #
+    if use_emoji?
+      _ = bold_button(mnemonic: 'Ask an exam _Question ❓')
+    else
+      _ = bold_button(mnemonic: 'Ask an exam _Question')
+    end
+    _.clear_background
+    _.width_height(780, 38)
+    _.pad2px
+    _.hint =
+      'Click on this button to ask an exam-question. '\
+      '(Or, use alt+q as shortcut)'
+    _.on_clicked {
+      # ===================================================================== #
+      # Determine what happens next when the ask-question button is clicked.
+      # ===================================================================== #
+      trigger_the_event_when_the_ask_exam_question_button_was_clicked
+    }
+    return _
+  end; alias return_button_ask_an_exam_question return_button_ask_the_exam_question # === return_button_ask_an_exam_question
+
+  # ========================================================================= #
+  # === we_may_reveal_the_exam_answer
+  # ========================================================================= #
+  def we_may_reveal_the_exam_answer
+    @internal_hash[:may_we_reveal_the_answer_after_a_delay] = true
+  end
+
+  # ========================================================================= #
+  # === always_reset_the_delay_before_using_another_delay
+  # ========================================================================= #
+  def always_reset_the_delay_before_using_another_delay
+    we_may_not_reveal_the_exam_answer_anymore
+  end
+
+  # ========================================================================= #
+  # === we_may_not_reveal_the_exam_answer_anymore
+  # ========================================================================= #
+  def we_may_not_reveal_the_exam_answer_anymore
+    # ======================================================================= #
+    # === @internal_hash[:may_we_reveal_the_answer_after_a_delay]
+    # ======================================================================= #
+    @internal_hash[:may_we_reveal_the_answer_after_a_delay] = false
+  end
+
+  # ========================================================================= #
+  # === consider_making_available_the_show_ten_aliases_widget
+  # ========================================================================= #
+  def consider_making_available_the_show_ten_aliases_widget
+    # ======================================================================= #
+    # The next if-clause must come after @internal_hash has been
+    # defined.
+    # ======================================================================= #
+    if Object.const_defined?(:Roebe)
+      begin
+        require 'roebe/gui/gtk3/show_ten_aliases/show_ten_aliases.rb'
+        @internal_hash[:show_ten_aliases] = ::Roebe::GUI::Gtk::ShowTenAliases.new
+      rescue LoadError; end
+    end
+  end
+
+  # ========================================================================= #
+  # === show_ten_aliases?
+  # ========================================================================= #
+  def show_ten_aliases?
+    @internal_hash[:show_ten_aliases]
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+    add_the_status_icon
+    r = create_window_or_runner(nil, width?, height?, title?)
+    properly_prepare_this_window(
+      r,
+      return_the_default_hash_for_properly_preparing_this_window
+    )
+    do_style_all_buttons_uniformly
+    do_assign_the_default_exam_topic_to_the_correct_entry
+    let_the_scrolled_window_for_the_answer_parse_URLs
+    deselect_the_entry_containing_the_exam_topic
+    do_jump_into_the_entry_containing_the_current_exam_topic
+    parse_the_commandline_arguments
+    populate_the_main_grid(main_grid?) # Populate the main grid here next.
+    populate_the_notebook_tab
+    connect_the_notebook_tab(r)
+    r.top_left
+    set_parent_widget(r) # Designate it as the parent widget.
+    enable_the_main_key_combinations
+    r.add_context_menu_with_the_default_accel_group
+    r.on_button_press_event { |widget, event|
+      if ::Gtk.right_mouse_click?(event) # right mouse click event.
+        _.context_menu?.popup_based_on_this_event(event)
+      end
+    }
+    # r.automatic_size_then_automatic_title
+    r.show_all
+    the_first_notebook_tab_is_active
+    r.enable_quick_exit
+    r.set_default_size(width?, height?)
+    # resize_the_notebook_tab_towards_the_primary_width_and_height
+    run_main
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExamTrainer[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+  # ========================================================================= #
+  # Last but not least, add two "compatibility constants":
+  # ========================================================================= #
+  AskExamQuestion   = ExamTrainer
+  SimpleExamTrainer = ExamTrainer # And add a helper "alias" here.
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::GUI::UniversalWidgets::ExamTrainer.new(ARGV)
+end # gtkexamtrainer 2