studium 0.13.1

data/lib/studium/gui/gtk3/exam_question_widget/exam_question_widget.rb

@@ -0,0 +1,1887 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::GUI::Gtk::ExamQuestionWidget
+#
+# For SQL we could use this:
+#
+#   result = `sqlite3 #{SQLITE_DATABASE_FILE} "SELECT * FROM #{current_exam_topic?} ORDER BY RANDOM() LIMIT 1;"`
+#   e result
+#
+# =========================================================================== #
+# require 'studium/gui/gtk3/exam_question_widget/exam_question_widget.rb'
+# Studium::GUI::Gtk::ExamQuestionWidget.run
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Studium
+
+module GUI
+
+module Gtk
+
+class ExamQuestionWidget < ::Gtk::Box # === Studium::GUI::Gtk::ExamQuestionWidget 
+
+  require 'studium/project/project.rb'
+  require 'studium/constants/constants.rb'
+  require 'studium/exams/solved/solved.rb'
+  require 'studium/exams/exam_question/exam_question.rb'
+  require 'studium/toplevel_methods/available_topics.rb'
+  require 'studium/toplevel_methods/find_exam_topic_and_exam_title.rb'
+  require 'studium/toplevel_methods/return_question_answer_string_from_this_topic.rb'
+  require 'studium/toplevel_methods/return_n_questions_were_answered_for_this_topic.rb'
+  require 'studium/toplevel_methods/write_into_file_related_functionality.rb'
+
+  require 'studium/gui/shared_code/exam_question_widget/exam_question_widget_module.rb'
+  include Studium::GUI::ExamQuestionWidgetModule
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  begin
+    require 'roebe/toplevel_methods/rinstall2.rb'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '75%'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '85%'
+
+  # ========================================================================= #
+  # === USE_THIS_MARGIN
+  # ========================================================================= #
+  USE_THIS_MARGIN = 12
+
+  # ========================================================================= #
+  # === 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 = '18.0'
+
+  # ========================================================================= #
+  # === 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 = 
+    'virus' # stemcells' # chem1' #anatomy'
+
+  # ========================================================================= #
+  # === DEFAULT_PLACEHOLDER_TEXT
+  # ========================================================================= #
+  DEFAULT_PLACEHOLDER_TEXT =
+    'You can input your answer to the exam question here.'
+
+  # ========================================================================= #
+  # === WORD_WRAP_AT_N_CHARACTERS
+  # ========================================================================= #
+  WORD_WRAP_AT_N_CHARACTERS = 78
+
+  # ========================================================================= #
+  # === SQLITE_DATABASE_FILE
+  #
+  # This is experimental - one day we may want to query from a sqlite
+  # database rather than flat files.
+  # ========================================================================= # 
+  SQLITE_DATABASE_FILE = '/Depot/jjjj/exam_questions.db'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    super(:vertical)
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    reset_the_internal_variables
+    Studium.set_runmode :gui # Make it known that we use the gui-runmode in this case.
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === @title
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file 
+    infer_the_size_automatically
+    # ======================================================================= #
+    # === @question_is
+    # ======================================================================= #
+    @question_is = ''.dup
+    # ======================================================================= #
+    # === @answer_is
+    # ======================================================================= #
+    @answer_is   = ''.dup
+    # ======================================================================= #
+    # === @user_configuration
+    # ======================================================================= #
+    @user_configuration = {}
+    # ======================================================================= #
+    # === :available_exam_topics
+    #
+    # Keep a reference to the available exam topics.
+    # ======================================================================= #
+    @user_configuration[:available_exam_topics] = return_available_exam_topics.sort
+    # ======================================================================= #
+    # === :use_this_editor
+    #
+    # This may be :bluefish or :internal usually.
+    # ======================================================================= #
+    @user_configuration[:use_this_editor] = :bluefish
+    # ======================================================================= #
+    # === :show_ten_aliases
+    # ======================================================================= #
+    @user_configuration[:show_ten_aliases] = nil
+    # ======================================================================= #
+    # === :array_all_exam_questions
+    # ======================================================================= #
+    @user_configuration[:array_all_exam_questions] = []
+    # ======================================================================= #
+    # === @hash_dataset_of_all_lectures
+    # ======================================================================= #
+    @hash_dataset_of_all_lectures =
+      Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.internal_dataset
+    # ======================================================================= #
+    # The next if-clause must come after @user_configuration has been
+    # defined.
+    # ======================================================================= #
+    if Object.const_defined?(:Roebe)
+      begin
+        require 'roebe/gui/gtk3/show_ten_aliases/show_ten_aliases.rb'
+        @user_configuration[:show_ten_aliases] = ::Roebe::GUI::Gtk::ShowTenAliases.new
+      rescue LoadError; end
+    end
+    handle_CSS
+    enable_all_key_combinations
+    upon_delete_event_quit_the_application
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    8
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    4
+  end
+
+  # ========================================================================= #
+  # === the_current_exam_question_is_now_solved                  (solved tag)
+  # ========================================================================= #
+  def the_current_exam_question_is_now_solved
+    _ = Studium::Exams::Solved.new { :do_not_run_yet }
+    _.set_commandline
+    _.run
+    if is_on_roebe? and Object.const_defined?(:Roebe)
+      rinstall2
+    end
+  end
+
+  # ========================================================================= #
+  # === create_text_view_for_the_answer
+  # ========================================================================= #
+  def create_text_view_for_the_answer
+    @text_view_for_the_answer = return_text_view_for_the_answer(@text_buffer_for_the_answer)
+  end
+
+  # ========================================================================= #
+  # === create_text_buffer_for_the_answer
+  # ========================================================================= #
+  def create_text_buffer_for_the_answer
+    @text_buffer_for_the_answer = gtk_text_buffer
+  end
+
+  # ========================================================================= #
+  # === text_view_containing_the_current_question?
+  # ========================================================================= #
+  def text_view_containing_the_current_question?
+    @text_view_for_the_question
+  end
+
+  # ========================================================================= #
+  # === add_the_status_icon
+  # ========================================================================= #
+  def add_the_status_icon
+    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!'
+    menu = gtk_menu
+
+    button_hello_world = gtk_image_menu_item(stock: ::Gtk::Stock::FIND)
+    button_hello_world.signal_connect(:activate) {
+      e 'Hello world!'
+    }
+    menu << button_hello_world
+
+    quit_button = gtk_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)
+    }
+  end
+
+  # ========================================================================= #
+  # === return_button_solve_the_question
+  #
+  # .set_size_request() is not necessary as we use a separate method
+  # that controls the size of the widget at hand.
+  # ========================================================================= #
+  def return_button_solve_the_question
+    button_solve_the_question = bold_button(
+      mnemonic: '😁️ Mark the question as _solved ✓'
+    )
+    button_solve_the_question.lightblue
+    button_solve_the_question.hint = 'Use this button to <b>mark the '\
+      'question as solved</b> (that is, correctly answered).'
+    # button_solve_the_question.set_size_request(78, 30)
+    return button_solve_the_question
+  end
+
+  # ========================================================================= #
+  # === return_available_exam_topics
+  # ========================================================================= #
+  def return_available_exam_topics
+    ::Studium.return_available_exam_topics
+  end
+
+  # ========================================================================= #
+  # === deselect_the_entry_containing_the_exam_topic
+  # ========================================================================= #
+  def deselect_the_entry_containing_the_exam_topic
+    @entry_holding_all_exam_topics.deselect
+    text_view_containing_the_current_question?.set_focus(true)
+  end
+
+  # ========================================================================= #
+  # === create_the_main_grid                                       (grid tag)
+  # ========================================================================= #
+  def create_the_main_grid
+    # ======================================================================= #
+    # === @grid
+    # ======================================================================= #
+    @grid = default_grid
+    @grid.spacing1 = 8
+    @grid.spacing2 = 8
+    @grid.pad8px
+  end
+
+  # ========================================================================= #
+  # === do_jump_into_the_entry_containing_the_current_exam_topic
+  # ========================================================================= #
+  def do_jump_into_the_entry_containing_the_current_exam_topic
+    @entry_holding_all_exam_topics.do_focus_on_it
+  end
+
+  # ========================================================================= #
+  # === text_view_for_the_answer?
+  # ========================================================================= #
+  def text_view_for_the_answer?
+    @text_view_for_the_answer
+  end
+
+  # ========================================================================= #
+  # === return_text_view_for_the_question
+  # ========================================================================= #
+  def return_text_view_for_the_question(
+      text_buffer_for_the_question
+    )
+    text_view_for_the_question = gtk_text_view(text_buffer_for_the_question)
+    text_view_for_the_question.set_left_margin(USE_THIS_MARGIN)
+    text_view_for_the_question.set_right_margin(USE_THIS_MARGIN)
+    text_view_for_the_question.word_wrap
+    return text_view_for_the_question
+  end
+
+  # ========================================================================= #
+  # === show_ten_aliases?
+  # ========================================================================= #
+  def show_ten_aliases?
+    @user_configuration[:show_ten_aliases]
+  end
+
+  # ========================================================================= #
+  # === return_scrolled_window_for_the_text_view_for_the_question
+  # ========================================================================= #
+  def return_scrolled_window_for_the_text_view_for_the_question(text_view_for_the_question)
+    scrolled_window_containing_the_textarea1 = gtk_scrolled_window(
+      text_view_for_the_question
+    ) { :only_up_and_bottom }
+    scrolled_window_containing_the_textarea1.set_name('textview1') # Contains the question.
+    scrolled_window_containing_the_textarea1.set_size_request(1000, 150)
+    return scrolled_window_containing_the_textarea1
+  end
+
+  require 'studium/toplevel_methods/word_wrap.rb'
+  # ========================================================================= #
+  # === do_reveal_the_answer_after_timeout                        (revel tag)
+  #
+  # Note that the timeout will be in n ms (milliseconds).
+  # ========================================================================= #
+  def do_reveal_the_answer_after_timeout(
+      answer              = answer_is?,
+      use_this_as_timeout = @entry_delay_to_use.text
+    )
+    if use_this_as_timeout.is_a? String
+      use_this_as_timeout = use_this_as_timeout.to_f * 1000
+    end
+    if answer
+      case answer
+      # ===================================================================== #
+      # === :default
+      # ===================================================================== #
+      when :default
+        answer = answer_is?
+      end
+      answer.gsub!(/\<.+?\>/,'')
+      #answer = ::Studium.word_wrap(answer, 78).to_s
+      if use_this_as_timeout > 0 and @checkbox_shall_we_reveal_the_answer.is_it_active?
+        # =================================================================== #
+        # This clause here is only ever entered when we have a delay. We
+        # have to check whether the main checkbox is active, because the 
+        # user may have de-selected it in-between the delay time span. 
+        # =================================================================== #
+        GLib::Timeout.add(use_this_as_timeout) {
+          @text_view_for_the_answer.set_text(answer)
+          false
+        }
+      else
+        @text_view_for_the_answer.set_text(answer)
+      end
+    end
+  end
+
+  # ======================================================================= #
+  # === set_exam_topic
+  # ======================================================================= #
+  def set_exam_topic(i)
+    i = i.to_s.downcase
+    @entry_holding_all_exam_topics.set_text(i)
+  end
+
+  # ========================================================================= #
+  # === return_button_open_exam_topic_file
+  # ========================================================================= #
+  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?
+      _ = gtk_button(return_emoji(:open_box))
+    else
+      _ = gtk_button_with_this_image(image_open_file)
+    end
+    _.no_relief
+    _.lightblue
+    _.hint = 'Click this button to open the current exam-topic file.'
+    _.on_clicked {
+      do_open_the_current_exam_topic_file
+    }
+    return _
+  end
+
+  # ========================================================================= #
+  # === handle_CSS
+  # ========================================================================= #
+  def handle_CSS
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    apply_the_CSS_rules
+  end
+
+  # ========================================================================= #
+  # === return_checkbox_shall_we_reveal_the_answer
+  # ========================================================================= #
+  def return_checkbox_shall_we_reveal_the_answer
+    _ = gtk_checkbox(
+      "Automatically reveal the \nanswer 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_unchecked
+    _.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
+    return _
+  end
+
+  # ========================================================================= #
+  # === clear_reveal_the_answer
+  # ========================================================================= #
+  def clear_reveal_the_answer
+    @text_view_for_the_answer.set_text('')
+  end
+
+  # ========================================================================= #
+  # === do_clear_the_free_form_textarea
+  # ========================================================================= #
+  def do_clear_the_free_form_textarea
+    @textarea3.set_text('')
+  end
+
+  # ========================================================================= #
+  # === return_text_view_for_the_answer
+  # ========================================================================= #
+  def return_text_view_for_the_answer(
+      text_buffer_for_the_answer
+    )
+    _ = gtk_text_view(text_buffer_for_the_answer)
+    _.set_left_margin(USE_THIS_MARGIN)
+    _.set_right_margin(USE_THIS_MARGIN)
+    _.word_wrap
+    return _
+  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_label(' Exam topic')
+    # label_exam_topic.css_class('small_text_shadow')
+    label_emoji = right_arrow_emoji
+    label_emoji.set_size_request(30, 30)
+    label_emoji.align_right
+    tiny_hbox = gtk_hbox
+    tiny_hbox.minimal(label_exam_topic)
+    tiny_hbox.maximal(label_emoji)
+    tiny_hbox.minimal(text(' ')) # Just a "spacer".
+    frame_containing_the_label_exam_topic = gtk_frame(tiny_hbox)
+    frame_containing_the_label_exam_topic.modify_background(:normal, :oldlace)
+    frame_containing_the_label_exam_topic.css_class('bblack1')
+    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
+
+  # ========================================================================= #
+  # === do_style_all_buttons_uniformly
+  # ========================================================================= #
+  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.css_class('bblack2')
+      this_button.set_size_request(75, 28)
+      this_button.set_name('button_hover_transition')
+    }
+  end
+
+  # ========================================================================= #
+  # === return_textarea_number_three
+  # ========================================================================= #
+  def return_textarea_number_three
+    # ======================================================================= #
+    # Next comes the textarea for "free typing", where the user can
+    # simply write whatever he wants to.
+    # ======================================================================= #
+    textarea = gtk_textarea
+    textarea.set_left_margin(USE_THIS_MARGIN)
+    textarea.set_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.
+    # ======================================================================= #
+    textarea.buffer.set_placeholder_text(
+      DEFAULT_PLACEHOLDER_TEXT
+    )
+    textarea.buffer.sync_placeholder_text
+    textarea.focus_in_event {
+      if textarea.buffer.text? == DEFAULT_PLACEHOLDER_TEXT
+        textarea.buffer.clear # Remove that placeholder text in this case.
+      end
+    }
+    textarea.word_wrap
+    return textarea
+  end
+
+  # ========================================================================= #
+  # === return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
+  # ========================================================================= #
+  def return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
+    hbox_with_two_icons = gtk_hbox
+    first_eventbox = gtk_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 = gtk_label(
+             '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 = gtk_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
+
+  require 'studium/toplevel_methods/return_n_percent_solved_from_this_topic.rb'
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === use_emoji?
+  # ========================================================================= #
+  def use_emoji?
+    @prefer_emoji_or_images == :emoji
+  end
+
+  # ========================================================================= #
+  # === activate_the_third_textview
+  # ========================================================================= #
+  def activate_the_third_textview
+    @textarea3.do_focus_on_it
+  end
+
+  # ========================================================================= #
+  # === return_scrolled_window_containing_the_textarea3
+  # ========================================================================= #
+  def return_scrolled_window_containing_the_textarea3(textarea = @textarea3)
+    # ======================================================================= #
+    # === scrolled_window_containing_the_textarea3
+    #
+    # This is the scrolled-window containing the free-form text the user
+    # can type.
+    # ======================================================================= #
+    scrolled_window_containing_the_textarea3 = gtk_scrolled_window(textarea) { :only_top_to_bottom }
+    scrolled_window_containing_the_textarea3.set_name('textview3')
+    scrolled_window_containing_the_textarea3.css_class('pad4px')
+    scrolled_window_containing_the_textarea3.set_size_request(
+      1000, 180
+    )
+    scrolled_window_containing_the_textarea3.do_show_the_scrollbars
+    scrolled_window_containing_the_textarea3.min_content_width  = 100
+    scrolled_window_containing_the_textarea3.min_content_height = 150
+    # ======================================================================= #
+    # Next, enable select-all-on-click events:
+    # ======================================================================= #
+    scrolled_window_containing_the_textarea3.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)
+        textarea.select_everything(event)
+      end
+    }
+    return scrolled_window_containing_the_textarea3
+  end
+
+  # ========================================================================= #
+  # === rinstall2
+  # ========================================================================= #
+  def rinstall2
+    Roebe.rinstall2(
+      use_this_directory: Studium.ruby_src_dir_at_home?+
+                          'studium/'
+    )
+  end; alias r2 rinstall2 # === r2
+
+  # ========================================================================= #
+  # === use_the_internal_editor?
+  # ========================================================================= #
+  def use_the_internal_editor?
+    @user_configuration[:use_this_editor] == :internal
+  end
+
+  # ========================================================================= #
+  # === return_n_answers_from_the_currently_selected_topic
+  # ========================================================================= #
+  def return_n_answers_from_the_currently_selected_topic(
+      i = exam_topic?
+    )
+    ::Studium.n_answers_available_in_this_topic(i)
+  end
+
+  # ========================================================================= #
+  # === main_font?
+  # ========================================================================= #
+  def main_font?
+    USE_THIS_FONT
+  end
+
+  # ========================================================================= #
+  # === entry_percentage?
+  # ========================================================================= #
+  def entry_percentage?
+    @entry_percentage
+  end
+
+  # ========================================================================= #
+  # === return_scrolled_window_containing_the_text_view_for_the_answer
+  # ========================================================================= #
+  def return_scrolled_window_containing_the_text_view_for_the_answer(
+      text_view_for_the_answer
+    )
+    @scrolled_window_containing_the_textarea2 = gtk_scrolled_window(
+      text_view_for_the_answer
+    ) { :only_up_and_bottom }
+    @scrolled_window_containing_the_textarea2.set_name('textview2') # Contains the answer.
+    @scrolled_window_containing_the_textarea2.set_size_request(1000, 150)
+    @scrolled_window_containing_the_textarea2.min_content_width  = 100
+    @scrolled_window_containing_the_textarea2.min_content_height = 200
+    @scrolled_window_containing_the_textarea2.do_show_the_scrollbars
+  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.
+      # ===================================================================== #
+      control_panel?.browser?.assign_this_text(first_entry)
+      ::Studium.open_this_remote_url(first_entry)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_checkbox
+  #
+  # This has to be created after the entries are created.
+  # ========================================================================= #
+  def create_the_checkbox
+    # ======================================================================= #
+    # === @checkbox_shall_we_reveal_the_answer
+    # ======================================================================= #
+    @checkbox_shall_we_reveal_the_answer = return_checkbox_shall_we_reveal_the_answer
+  end
+
+  # ========================================================================= #
+  # === main_combo_box?
+  # ========================================================================= #
+  def main_combo_box?
+    @combo_box_available_exam_topics
+  end
+
+  # ========================================================================= #
+  # === return_eventbox_with_an_image_to_exit_the_application
+  # ========================================================================= #
+  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
+    _ = gtk_eventbox(application_exit_image)
+    _.hint = 'Click on this image to exit the program.'
+    _.on_clicked {
+      exit_application
+    }
+    return _
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    abort_on_exception
+    # ======================================================================= #
+    # Add the status icon and style it a little bit as well.
+    # ======================================================================= #
+    add_the_status_icon
+    @grid.left(return_frame_containing_the_label_exam_topic)
+    mini_hbox = gtk_hbox
+    mini_hbox.minimal(@entry_holding_all_exam_topics,   2)
+    mini_hbox.minimal(@combo_box_available_exam_topics, 2)
+    mini_hbox.minimal(return_event_box_with_face_glasses, 2)
+    mini_hbox.rpack(return_eventbox_with_an_image_to_exit_the_application, 2)
+    @grid.right(mini_hbox)
+    @grid.left(@button_ask_the_exam_question)
+    
+    # ======================================================================= #
+    # === @text_view_for_the_question
+    # ======================================================================= #
+    @text_buffer_for_the_question = gtk_text_buffer
+    @text_view_for_the_question = return_text_view_for_the_question(@text_buffer_for_the_question)
+    @scrolled_window_containing_the_textarea1 = return_scrolled_window_for_the_text_view_for_the_question(@text_view_for_the_question)
+
+    @grid.right(@scrolled_window_containing_the_textarea1)
+
+    @grid.left(@button_reveal_the_answer)
+    @scrolled_window_containing_the_textarea2 = return_scrolled_window_containing_the_text_view_for_the_answer(
+      @text_view_for_the_answer
+    )
+    @grid.right(@scrolled_window_containing_the_textarea2)
+
+    hbox_with_two_icons = return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
+    @grid.full_line(hbox_with_two_icons)
+
+    # ======================================================================= #
+    # === @textarea3
+    # ======================================================================= #
+    @textarea3 = return_textarea_number_three
+    @scrolled_window_containing_the_textarea3 = return_scrolled_window_containing_the_textarea3(@textarea3)
+    @grid.full_row(@scrolled_window_containing_the_textarea3)
+
+    lower_vbox = gtk_vbox
+    @hbox_containing_three_labels_and_three_entries = return_hbox_containing_three_labels_and_three_entries
+    middle_hbox = gtk_hbox
+    mini_hbox = gtk_hbox
+    # ======================================================================= #
+    # Add the checkbox for revealing the answer next:
+    # ======================================================================= #
+    mini_hbox.minimal(@checkbox_shall_we_reveal_the_answer,                2)
+    mini_hbox.minimal(@entry_delay_to_use,                                 2)
+    # ======================================================================= #
+    # The middle-hbox contains the other hboxes.
+    # ======================================================================= #
+    middle_hbox.minimal(mini_hbox,                                         1)
+    middle_hbox.minimal(@hbox_containing_three_labels_and_three_entries,   1)
+    middle_hbox.minimal(@button_use_random_entry_from_the_ten_aliases,     5)
+    middle_hbox.minimal(return_event_box_for_asking_a_random_exam_topic,  10)
+    lower_vbox.minimal(middle_hbox,                                        1)
+
+    small_hbox = gtk_hbox
+    small_hbox.minimal(@button_solve_the_question,                         2)
+    small_hbox.minimal(return_button_open_exam_topic_file,                 2)
+    small_hbox.minimal(return_wikipedia_entry,                             2)
+    small_hbox.minimal(gtk_hseparator)
+
+    lower_vbox.minimal(small_hbox,                                         2)
+    lower_vbox.minimal(@label_n_questions_were_answered,                   8)
+
+    draggable = draggable_up_and_down(
+      @grid,
+      lower_vbox
+    )
+    maximal(draggable)
+  end
+
+  # ========================================================================= #
+  # === 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
+
+  require 'studium/toplevel_methods/n_questions_available.rb'
+  # ========================================================================= #
+  # === return_n_questions_from_the_currently_selected_topic
+  # ========================================================================= #
+  def return_n_questions_from_the_currently_selected_topic(
+      i = exam_topic?
+    )
+    ::Studium.n_questions_available_in_this_topic(i)
+  end
+
+  # ========================================================================= #
+  # === reveal_the_answer_to_the_exam_question
+  # ========================================================================= #
+  def reveal_the_answer_to_the_exam_question
+    do_reveal_the_answer_after_timeout(:default, 0)
+  end
+
+  # ========================================================================= #
+  # === create_the_ask_the_exam_question_button
+  # ========================================================================= #
+  def create_the_ask_the_exam_question_button
+    # ======================================================================= #
+    # === @button_ask_the_exam_question
+    # ======================================================================= #
+    @button_ask_the_exam_question = return_button_ask_the_exam_question(use_emoji?)
+  end
+
+  # ========================================================================= #
+  # === 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?
+      button_ask_the_exam_question = gtk_bold_button(mnemonic: 'Ask a _Question ❓')
+    else
+      button_ask_the_exam_question = gtk_bold_button(mnemonic: 'Ask a _Question')
+    end
+    button_ask_the_exam_question.set_size_request(75, 28)
+    button_ask_the_exam_question.clear_background
+    button_ask_the_exam_question.pad2px
+    button_ask_the_exam_question.hint =
+      'Click on this button to ask an exam-question. '\
+      '(Or, use alt+q as shortcut)'
+    return button_ask_the_exam_question
+  end
+
+  # ========================================================================= #
+  # === button_ask_the_exam_question?
+  # ========================================================================= #
+  def button_ask_the_exam_question?
+    @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?
+
+  # ========================================================================= #
+  # === do_handle_the_click_event_for_the_ask_question_button   (clicked tag)
+  #
+  # This method requires the Studium.write_what_into() method.
+  # ========================================================================= #
+  def do_handle_the_click_event_for_the_ask_question_button
+    # ======================================================================= #
+    # Determine what happens next when the ask-question button is clicked.
+    # ======================================================================= #
+    button_ask_the_question?.on_clicked {
+      the_button_ask_the_question_was_clicked
+    }
+  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
+
+  # ========================================================================= #
+  # === create_the_buttons                          (buttons tag, button tag)
+  # ========================================================================= #
+  def create_the_buttons
+    create_the_ask_the_exam_question_button
+    create_the_button_use_random_entry_from_the_ten_aliases
+    create_the_reveal_button
+    # ======================================================================= #
+    # === @button_solve_the_question
+    # ======================================================================= #
+    @button_solve_the_question = return_button_solve_the_question
+    @button_solve_the_question.on_clicked {
+      the_current_exam_question_is_now_solved
+      update_three_important_widgets
+      do_update_this_gtk_entry_with_that_exam_topic_for_its_percentage_value(
+        @entry_percentage, current_exam_topic?
+      )
+    }
+  end
+
+  # ========================================================================= #
+  # === return_entry_percentage
+  # ========================================================================= #
+  def return_entry_percentage
+    _ = entry('')
+    _.hint = "This denotes how many questions have already\n"\
+             "been answered successfully, <b>in percent</b>.\n"\
+             "Note that this requires a specific exam topic to "\
+             "have been set, so no percentage value may be "\
+             "shown initially.\nSimply assign to an exam topic "\
+             "and it should work fine."
+    _.do_center
+    _.disable_user_input
+    _.set_name('BG_bisque')
+    _.bblack1
+    return _
+  end
+
+  # ========================================================================= #
+  # === create_the_reveal_button
+  # ========================================================================= #
+  def create_the_reveal_button
+    # ======================================================================= #
+    # === The reveal-button is created next, also known as the
+    #     "answer button". (answer tag)
+    #     The mnemonic-key is set to "A".
+    # ======================================================================= #
+    @button_reveal_the_answer = gtk_bold_button(
+      mnemonic: 'Reveal the _Answer' # This was the old emoji: ❗
+    )
+    @button_reveal_the_answer.set_size_request(78, 30)
+    @button_reveal_the_answer.lightblue
+    @button_reveal_the_answer.on_clicked {
+      if all_questions_have_been_answered_in_this_topic?
+        notify_the_user_that_all_questions_have_been_answered_in_this_topic(
+          current_topic?,
+          @button_reveal_the_answer
+        )
+      else
+        do_reveal_the_answer_after_timeout(answer_is?, 0)
+      end
+    }
+    @button_reveal_the_answer.hint = 'Click on this button in order to '\
+      'reveal the answer to the current exam question at hand.'
+  end
+
+  # ========================================================================= #
+  # === update_three_important_widgets
+  # ========================================================================= #
+  def update_three_important_widgets
+    update_the_label_n_questions_were_answered
+    update_the_entry_n_unanswered_questions
+    update_the_percentage_entry
+  end
+
+  require 'studium/toplevel_methods/return_n_percent_solved_from_this_topic.rb'
+  # ========================================================================= #
+  # === do_update_this_gtk_entry_with_that_exam_topic_for_its_percentage_value
+  # ========================================================================= #
+  def do_update_this_gtk_entry_with_that_exam_topic_for_its_percentage_value(
+      entry_percentage    = entry_percentage?,
+      use_this_exam_topic = current_exam_topic?.to_s
+    )
+    percentage_value = Studium.n_percent_questions_answered_of_this_topic?(
+      use_this_exam_topic.downcase
+    )
+    if percentage_value == false
+      percentage_value = -1
+    end
+    percentage_value = percentage_value.to_s.to_f.round(1)
+    percentage_value = percentage_value.to_s.dup
+    percentage_value << '%' unless percentage_value.end_with? '%'
+    entry_percentage.set_text(percentage_value) # And sync it onto the proper entry.
+  end; alias update_the_percentage_entry do_update_this_gtk_entry_with_that_exam_topic_for_its_percentage_value # === update_the_percentage_entry
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === enable_alt_w_key_combination
+  #
+  # This method will specifically enable the "alt+w" shortcut.
+  # ========================================================================= #
+  def enable_alt_w_key_combination
+    # ======================================================================= #
+    # Add alt+w key combination, to open the current exam topic file:
+    # ======================================================================= #
+    use_this_key = Gdk::Keyval::KEY_W
+    @accel_group.connect(use_this_key, :mod1_mask, :visible) { # alt+w
+      do_open_the_current_exam_topic_file
+    }
+  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
+
+  # ========================================================================= #
+  # === Studium::GUI::Gtk::ExamQuestionWidget.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = ::Studium::GUI::Gtk::ExamQuestionWidget.new(i)
+    r = ::Gtk.run
+    r << _
+    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.top_left_then_run
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::Gtk::AskExamQuestion.gtk_accel_group
+  # ========================================================================= #
+  def self.gtk_accel_group
+    ::Gtk::AccelGroup.new
+  end
+
+  # ========================================================================= #
+  # === popup_pick_a_new_font
+  # ========================================================================= #
+  def popup_pick_a_new_font
+    _ = gtk_hbox
+    _.minimal(text(' → '))
+    file_chooser_widget = gtk_button('Choose font here')
+    file_chooser_widget.set_size_request(1200, 960)
+    file_chooser_widget.css_class('bblack2')
+    file_chooser_widget.set_size_request(500, 300)
+    file_chooser_widget.disallow_resizing
+    _.minimal(file_chooser_widget)
+    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
+
+  # ========================================================================= #
+  # === text_view_for_the_question?
+  # ========================================================================= #
+  def text_view_for_the_question?
+    @text_view_for_the_question
+  end
+
+  # ========================================================================= #
+  # === top_textbuffer?
+  # ========================================================================= #
+  def top_textbuffer?
+    @text_view_for_the_question.buffer
+  end
+
+  # ========================================================================= #
+  # === current_exam_topic?
+  # ========================================================================= #
+  def current_exam_topic?
+    @entry_holding_all_exam_topics.text?.strip
+  end; alias main_exam_topic? current_exam_topic? # === main_exam_topic?
+       alias exam_topic?      current_exam_topic? # === exam_topic?
+       alias current_topic?   current_exam_topic? # === current_topic?
+
+  # ========================================================================= #
+  # === the_button_ask_the_question_was_clicked
+  # ========================================================================= #
+  def the_button_ask_the_question_was_clicked
+    # ======================================================================= #
+    # (1) First, clear the old question-buffer, just in case.
+    # ======================================================================= #
+    do_clear_the_question_buffer
+    # ======================================================================= #
+    # (2) Query the exam-topic that is part of the combo box
+    # ======================================================================= #
+    _ = @combo_box_available_exam_topics.text?.tr(' ','_').downcase
+    if _.empty?
+      bold_popover_message = bold_label(
+        'You have to provide an exam-topic - see the text above.'
+      )
+      popover_message(
+        bold_popover_message,
+        button_ask_the_exam_question?
+      ).popup
+    end
+    # ======================================================================= #
+    # (3) Check whether there is no exam-topic selected. We have to be
+    #     careful here, as an infinite loop may result.
+    # ======================================================================= #
+    unless entry_ask_questions_from_this_topic?.empty?
+      # This clause is entered when the user has a gtk-entry point.
+      _ = entry_ask_questions_from_this_topic?.text.to_s
+      use_this_index = ::Studium.find_corresponding_exam_title(_)
+      use_this_topic = available_exam_topics?.index(use_this_index)
+      # ===================================================================== #
+      # Next be careful - we don't want an infinite loop:
+      # ===================================================================== #
+      if use_this_topic
+        #@combo_box_available_exam_topics.set_active(use_this_topic)
+        #entry_ask_questions_from_this_topic?.set_text(_) # Need to sync it back again.
+        do_updated_the_entries_n_answered_and_n_unanswered
+      end
+    end
+    if @entry_percentage.text.to_f == 100.0
+      # ===================================================================== #
+      # Handle the case where the exam-topic at hand has been answered
+      # completely.
+      # ===================================================================== #
+      bold_popover_message = gtk_bold_label(
+        "All questions have been answered for the topic "\
+        "#{exam_topic?}.\n\n    Please choose another exam topic.\n"
+      )
+      popover_message(
+        bold_popover_message,
+        @button_ask_the_exam_question
+      ).popup
+    else
+      # ===================================================================== #
+      # Check whether the exam-topic is registered:
+      # ===================================================================== #
+      if ::Studium.is_this_exam_topic_available?(_)
+        @question_answer = Studium.ask_question(_) { :do_not_run_yet }
+        @question_answer.initial_steps
+        line = @question_answer.line?.to_s.tr("\n", ' ').rstrip
+        array_all_exam_questions? << line
+        # =================================================================== #
+        # Store it as well.
+        # =================================================================== #
+        into = ::Studium.file_last_question_asked?
+        Studium.write_what_into(line, into)
+        index = @question_answer.split_position? 
+        question = line[0 .. index]
+        question.tr!("\n", ' ')
+        question.rstrip!
+        if line
+          @answer_is = line[(index+1) .. -1].strip.dup
+          @answer_is = ::Gtk.replace_all_URL_entries_in_this_string(@answer_is)
+          @answer_is.lstrip!
+          if @answer_is.start_with? 'A: '
+            @answer_is.sub!(/A: /,'')
+          end
+          # ================================================================= #
+          # Replace all "(2) foo" entries with "(2) foo\n" entries.
+          # ================================================================= #
+          require 'studium/toplevel_methods/misc.rb'
+          @answer_is = ::Studium.add_newlines_to_numbered_exam_question(@answer_is)
+        end
+        # =================================================================== #
+        # Remove <one> and similar tags.
+        # =================================================================== #
+        question.gsub!(/\<.+?\>/,'')
+        # @question = ::Studium.word_wrap(question, WORD_WRAP_AT_N_CHARACTERS).to_s
+        @question = question.to_s.dup
+        if @question.start_with?('- ')
+          @question[0,2] = ''
+        end
+        # =================================================================== #
+        # Replace all URL entries with <a href> entries next:
+        # =================================================================== #
+        @question = ::Gtk.replace_all_URL_entries_in_this_string(@question)
+        @text_buffer_for_the_question.set_text(@question)
+        @text_view_for_the_answer.set_text('') # ← This is needed to clear old entries.
+        if @checkbox_shall_we_reveal_the_answer.active?
+          do_reveal_the_answer_after_timeout(answer_is?)
+        end
+        # =================================================================== #
+        # Reveal the exam-file onto the gtk-based editor as well.
+        # Unfortunately this has a bug, in February 2021 - x11
+        # crashes. I may have to re-evaluate this at a later time
+        # to determine WHY it crashes...
+        # =================================================================== #
+        # dataset = File.read(
+        #   ::Studium.directory_containing_the_exam_topics?+
+        #   ::Studium.find_corresponding_exam_topic(
+        #     current_exam_topic?
+        #   )
+        # )
+        # @gtk_editor.update_the_main_buffer(dataset)
+      else # else we can notify the user that this exam-topic is not registered.
+        popover = return_popover(
+          ' <b>⚠️</b> The exam topic `<b>'+
+          entry_ask_questions_from_this_topic?.text.to_s+
+          '</b>` could <b>not</b> be found. <b>⚠️</b>',
+          question_button?
+        )
+        popover.show_all
+        popover.popup # Display it at once.
+      end
+    end
+  end; alias do_ask_a_new_question    the_button_ask_the_question_was_clicked # === do_ask_a_new_question
+       alias do_ask_an_exam_question  the_button_ask_the_question_was_clicked # === do_ask_an_exam_question
+       alias do_ask_the_exam_question the_button_ask_the_question_was_clicked # === do_ask_the_exam_question
+       alias ask_an_exam_question     the_button_ask_the_question_was_clicked # === ask_an_exam_question
+       alias do_all_the_internal_actions_associated_with_the_button_ask_the_question_having_been_clicked the_button_ask_the_question_was_clicked # === do_all_the_internal_actions_associated_with_the_button_ask_the_question_having_been_clicked
+
+  # ========================================================================= #
+  # === handle_the_combo_box_available_exam_topics_on_changed_event
+  # ========================================================================= #
+  def handle_the_combo_box_available_exam_topics_on_changed_event(
+      combo_box = @combo_box_available_exam_topics
+    )
+    # ======================================================================= #
+    # The event where the combo-box is changed is handled next.
+    # ======================================================================= #
+    combo_box.on_changed {
+      entry_ask_questions_from_this_topic?.set_text(
+        combo_box.active_text.to_s.downcase.tr(' ','_')
+      )
+      # ===================================================================== #
+      # Get a reference to the current exam topic.
+      # ===================================================================== #
+      current_exam_topic = combo_box.active_text.to_s.strip.dup
+      current_exam_topic.strip! if current_exam_topic.end_with? '_'
+      do_update_this_gtk_entry_with_that_exam_topic_for_its_percentage_value(
+        @entry_percentage, current_exam_topic
+      )
+      @entry_containing_n_questions.set_text(
+        return_n_questions_from_the_currently_selected_topic(current_exam_topic).to_s
+      )
+      do_update_the_entry_n_answered(current_exam_topic)
+      do_ask_a_new_question
+    }
+  end
+
+  # ========================================================================= #
+  # === create_the_combobox
+  # ========================================================================= #
+  def create_the_combobox
+    # ======================================================================= #
+    # Next, create the combo-box that contains all exam-topics. It will be
+    # a bit truncated, largely for display-reasons rather than any other
+    # reason.
+    # ======================================================================= #
+    @combo_box_available_exam_topics = return_combo_box_available_exam_topics
+  end
+
+  # ========================================================================= #
+  # === return_combo_box_available_exam_topics
+  # ========================================================================= #
+  def return_combo_box_available_exam_topics
+    use_this_sorted_array = return_available_exam_topics.map {|entry|
+      if entry.size > 24 # Truncate it a bit in this case.
+        entry = entry[0 .. 24]
+      end
+      entry
+    }.sort
+
+    _ = combo_box(
+      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)
+    handle_the_combo_box_available_exam_topics_on_changed_event(_)
+    return _
+  end
+
+  # ========================================================================= #
+  # === return_wikipedia_entry
+  #
+  # 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_entry
+    begin
+      require 'roebe/classes/wikipedia.rb'
+    rescue LoadError; end
+
+    hbox = gtk_hbox
+    wikipedia_entry = gtk_entry
+    wikipedia_entry.clear_background
+    wikipedia_entry.bblack2
+    wikipedia_entry.center
+    wikipedia_entry.css_class('pad5px')
+    wikipedia_entry.lightgreen_background
+    wikipedia_entry.width_height(720, 32)
+    wikipedia_entry.hint =
+      'Click the "enter" 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?)
+      else
+        e 'You need to install the roebe gem for this functionality.'
+      end
+    }
+    hbox.minimal(wikipedia_entry, 1)
+    return hbox
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                                          (create tag)
+  # ========================================================================= #
+  def create_skeleton
+    create_text_buffer_for_the_answer
+    create_text_view_for_the_answer
+    create_the_buttons
+    create_the_labels
+    create_the_entries
+    create_the_checkbox # This must come after the entries.
+    create_the_combobox
+    create_the_main_grid
+    create_the_context_menu
+  end
+
+  # ========================================================================= #
+  # === context_menu?
+  # ========================================================================= #
+  def context_menu?
+    @context_menu
+  end
+
+  # ========================================================================= #
+  # === create_the_context_menu
+  #
+  # This is the context-menu which will appear on a right-mouse
+  # click event.
+  # ========================================================================= #
+  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
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === create_the_entries                           (entries tag, entry tag)
+  # ========================================================================= #
+  def create_the_entries
+    # ======================================================================= #
+    # === The entry keeping track as to how many answers have been
+    #     given for that particular exam-topic.
+    # ======================================================================= #
+    @entry_containing_n_answers = gtk_entry('')
+    @entry_containing_n_answers.center
+    @entry_containing_n_answers.set_font(:hack_15)
+    @entry_containing_n_answers.bblack1
+    # ======================================================================= #
+    # === @entry_containing_n_questions
+    #
+    # Next, the entry containing the questions
+    # ======================================================================= #
+    @entry_containing_n_questions = entry('')
+    @entry_containing_n_questions.center
+    @entry_containing_n_questions.set_font(:hack_15)
+    @entry_containing_n_questions.bblack1
+    # ======================================================================= #
+    # === @entry_containing_n_unanswered_questions
+    # ======================================================================= #
+    @entry_containing_n_unanswered_questions = entry('')
+    @entry_containing_n_unanswered_questions.center
+    @entry_containing_n_unanswered_questions.set_font(:hack_15)
+    @entry_containing_n_unanswered_questions.bblack1
+    # ======================================================================= #
+    # === The entry holding all exam topics.
+    #
+    # This is the entry that the user can modify at his or her own
+    # discretion. It is the most important entry, among the entries
+    # used in this GUI application.
+    #
+    # This entry is positioned very close on top, on the left hand side.
+    # The user can thus simply manipulate it by clicking on it.
+    #
+    # Another entry may depend on this entry, so it should come early
+    # in this method.
+    # ======================================================================= #
+    @entry_holding_all_exam_topics = gtk_entry(
+      USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC
+    )
+    # The next line of code was disabled as of September 2021.
+    # @entry_holding_all_exam_topics.on_click_select_everything
+    @entry_holding_all_exam_topics.set_font(SMALLER_FONT)
+    @entry_holding_all_exam_topics.bblack1
+    @entry_holding_all_exam_topics.very_light_yellowish_background
+    enhanced_gtk_entry = gtk_entry_completion
+    enhanced_gtk_entry.populate_with_this_array(
+      ::Studium.return_all_exam_topics
+    )
+    @entry_holding_all_exam_topics.completion = enhanced_gtk_entry
+    # ======================================================================= #
+    # We need this entry to be fairly wide, hence the following method call.
+    # ======================================================================= #
+    @entry_holding_all_exam_topics.set_size_request(500, 40)
+    @entry_holding_all_exam_topics.set_hexpand(false)
+    @entry_holding_all_exam_topics.set_vexpand(false)
+    # ======================================================================= #
+    # Allow for scroll-events.
+    # ======================================================================= #
+    @entry_holding_all_exam_topics.enable_scroll_events
+    @entry_holding_all_exam_topics.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.
+    # ======================================================================= #
+    @entry_holding_all_exam_topics.on_enter_key_pressed { |widget, event|
+      old_text = @entry_holding_all_exam_topics.text?
+      new_possible_text = Studium.expand_this_exam_topic(old_text)
+      unless old_text == new_possible_text
+        @entry_holding_all_exam_topics.set_text(new_possible_text)
+      end
+      do_update_the_entry_n_questions
+      question_button?.signal_emit(:clicked)
+      sync_entry_holding_all_exam_topics_onto_the_main_combo_box
+    }
+    # ======================================================================= #
+    # === @entry_delay_to_use
+    #
+    # 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_delay_to_use = gtk_entry(DEFAULT_DELAY)
+    @entry_delay_to_use.center
+    @entry_delay_to_use.hint = 'Provide the delay here, as <b>n seconds</b>. '\
+      'This will only work when the checkbox on the left-hand side is active.'
+    @entry_delay_to_use.set_size_request(45, 20)
+    @entry_delay_to_use.bblack1
+    # ======================================================================= #
+    # === Percentage entry
+    #
+    # This is the percentage-entry, situated right next to a combo-box
+    # entry.
+    # ======================================================================= #
+    @entry_percentage = return_entry_percentage
+  end
+
+  # ========================================================================= #
+  # === return_hbox_containing_three_labels_and_three_entries
+  #
+  # This should only be invoked after the entries were created.
+  # ========================================================================= #
+  def return_hbox_containing_three_labels_and_three_entries
+    _ = gtk_hbox
+
+    # ======================================================================= #
+    # === n questions
+    # ======================================================================= #
+    vbox1 = gtk_vbox
+    label_n_questions = text('n questions').set_font(:hack_15)
+    label_n_questions.center_and_make_bold
+    vbox1.minimal(label_n_questions,                               2)
+    vbox1.minimal(@entry_containing_n_questions,                   2)
+    _.minimal(vbox1,                                               2)
+
+    # ======================================================================= #
+    # === n unanswered
+    # ======================================================================= #
+    vbox2 = gtk_vbox
+    label_n_unanswered = text('n unanswered').set_font(:hack_15)
+    label_n_unanswered.make_bold
+    vbox2.minimal(label_n_unanswered,                              2)
+    vbox2.minimal(@entry_containing_n_unanswered_questions,        2)
+    _.minimal(vbox2,                                               2)
+
+    # ======================================================================= #
+    # === n answered
+    # ======================================================================= #
+    vbox3 = gtk_vbox
+    label_n_answered  = text('n answered').set_font(:hack_15)
+    label_n_answered.royalblue
+    label_n_answered.center_and_make_bold
+    vbox3.minimal(label_n_answered,                                2)
+    vbox3.minimal(@entry_containing_n_answers,                     2)
+    _.minimal(vbox3,                                               2)
+
+    # ======================================================================= #
+    # Last but not least, add the entry showing the percentage values.
+    # ======================================================================= #
+    _.minimal(@entry_percentage,                                   2)
+    return _
+  end
+
+  # ========================================================================= #
+  # === do_update_the_entry_n_questions
+  # ========================================================================= #
+  def do_update_the_entry_n_questions(
+      current_exam_topic = current_exam_topic?
+    )
+    @entry_containing_n_questions.set_text(
+      return_n_questions_from_the_currently_selected_topic(current_exam_topic).to_s
+    )
+  end; alias update_n_questions do_update_the_entry_n_questions # === update_n_questions
+
+  # ========================================================================= #
+  # === create_the_button_use_random_entry_from_the_ten_aliases
+  # ========================================================================= #
+  def create_the_button_use_random_entry_from_the_ten_aliases
+    # ======================================================================= #
+    # === @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 = gtk_label('🕵️')
+    else
+      label = image_avatar_default
+    end
+    # ======================================================================= #
+    # === @button_use_random_entry_from_the_ten_aliases
+    # ======================================================================= #
+    @button_use_random_entry_from_the_ten_aliases = gtk_eventbox(label)
+    @button_use_random_entry_from_the_ten_aliases.on_clicked {
+      if @user_configuration[:show_ten_aliases]
+        set_exam_topic(
+          @user_configuration[:show_ten_aliases].return_random_entry
+        )
+        update_n_questions
+        update_n_unanswered
+        do_ask_an_exam_question
+      end
+    }
+    @button_use_random_entry_from_the_ten_aliases.set_size_request(40, 40)
+    @button_use_random_entry_from_the_ten_aliases.lightblue
+    @button_use_random_entry_from_the_ten_aliases.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.'
+    return @button_use_random_entry_from_the_ten_aliases
+  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
+
+  # ========================================================================= #
+  # === 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; alias update_n_answered do_update_the_entry_n_answered # === update_n_answered
+
+  # ========================================================================= #
+  # === do_updated_the_entries_n_answered_and_n_unanswered
+  # ========================================================================= #
+  def do_updated_the_entries_n_answered_and_n_unanswered
+    do_update_the_entry_n_unanswered_questions
+    update_n_unanswered 
+  end
+
+  # ========================================================================= #
+  # === 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.
+  # ========================================================================= #
+  def do_open_the_current_exam_topic_file(
+      combo_box_available_exam_topics = @combo_box_available_exam_topics
+    )
+    _ = Studium.find_corresponding_exam_topic(
+          current_exam_topic?
+        )
+    if _.empty? and combo_box_available_exam_topics
+      _ = combo_box_available_exam_topics.active_text.to_s
+    end
+    _ = Studium.path_to_exam_topic?+_
+    if use_the_internal_editor?
+      set_save_into_this_local_file(_)
+      set_editor_buffer(File.read(_))
+      @notebook_tab.focus_on_this_tab(2)
+    else
+      # ===================================================================== #
+      # Or simply use bluefish or whatever else the editor is.
+      # ===================================================================== #
+      esystem "#{@user_configuration[:use_this_editor]} #{_}"
+    end
+  end
+
+  # ========================================================================= #
+  # === answer_is?
+  # ========================================================================= #
+  def answer_is?
+    @answer_is
+  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?
+    @user_configuration[:array_all_exam_questions]
+  end
+
+  # ========================================================================= #
+  # === debug
+  # ========================================================================= #
+  def debug
+    pp array_all_exam_questions?
+    pp array_all_exam_questions?.size
+  end
+
+  # ========================================================================= #
+  # === do_popup_the_array_of_all_exam_questions
+  # ========================================================================= #
+  def do_popup_the_array_of_all_exam_questions
+    content = array_all_exam_questions?.map.with_index {|line, index| index += 1
+      line = line.dup
+      line.prepend(
+        "(#{index}) "
+      )
+      line
+    }.join("\n")
+    text_buffer = gtk_text_buffer(content)
+    text_view   = gtk_text_view(text_buffer)
+    scrolled_window = gtk_scrolled_window(text_view)
+    scrolled_window.width_height(1400, 700)
+    scrolled_window.pad8px
+    popup_over_this_widget(
+      entry_exam_topic?,
+      scrolled_window
+    ).popup
+  end
+
+  # ========================================================================= #
+  # === return_event_box_with_face_glasses
+  # ========================================================================= #
+  def return_event_box_with_face_glasses
+    event_box = gtk_event_box
+    image = gtk_icon('face-glasses')
+    event_box.add(image)
+    event_box.on_clicked {
+      do_popup_the_array_of_all_exam_questions
+    }
+    return event_box
+  end
+
+  # ========================================================================= #
+  # === entry_holding_all_exam_topics?
+  # ========================================================================= #
+  def entry_holding_all_exam_topics?
+    @entry_holding_all_exam_topics
+  end; alias entry_ask_questions_from_this_topic? entry_holding_all_exam_topics? # === entry_ask_questions_from_this_topic?
+       alias entry_ask_questions?                 entry_holding_all_exam_topics? # === entry_ask_questions?
+       alias entry_exam_topic?                    entry_holding_all_exam_topics? # === exam_topic?
+
+  # ========================================================================= #
+  # === sync_entry_holding_all_exam_topics_onto_the_combo_box
+  #
+  # An alternative to the functionality in this method may be this:
+  #
+  #   Studium.find_corresponding_exam_topic "Festkörper Chemie und Geochemie" # => "geochemistry"
+  #
+  # ========================================================================= #
+  def sync_entry_holding_all_exam_topics_onto_the_combo_box(
+      value = @entry_holding_all_exam_topics.text?.
+              downcase.delete(' ').delete('_')
+    )
+    array = available_exam_topics?.map {|entry|
+      entry.delete(' ').downcase
+    }
+    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
+  # ========================================================================= #
+  def return_event_box_for_asking_a_random_exam_topic
+    event_box_for_image_view_refresh_symbolic_symbolic = gtk_event_box(
+      image_view_refresh_symbolic_symbolic
+    )
+    event_box_for_image_view_refresh_symbolic_symbolic.hint = 
+      "Click on this icon to <b>set a random exam topic</b>, "\
+      "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
+
+  # ========================================================================= #
+  # === 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_holding_all_exam_topics.set_text(this_topic.to_s)
+    sync_entry_holding_all_exam_topics_onto_the_combo_box
+    do_ask_an_exam_question
+    update_three_important_widgets
+  end
+
+  # ========================================================================= #
+  # === available_exam_topics?
+  # ========================================================================= #
+  def available_exam_topics?
+    @user_configuration[:available_exam_topics]
+  end
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    super()
+    do_style_all_buttons_uniformly
+    deselect_the_entry_containing_the_exam_topic
+    do_handle_the_click_event_for_the_ask_question_button
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::GUI::Gtk::ExamQuestionWidget.run
+end