studium 0.16.9

data/lib/studium/curricula/handle_curricula/misc.rb

@@ -0,0 +1,798 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/curricula/handle_curricula/misc.rb'
+# =========================================================================== #
+module Studium
+
+module Curricula
+
+class HandleCurricula < Base # === Studium::Curricula::HandleCurricula
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+    reset_the_internal_hash
+    # ======================================================================= #
+    # === @dataset_from_the_file_lecture_information
+    # ======================================================================= #
+    @dataset_from_the_file_lecture_information =
+      return_dataset_from_the_file_lecture_information
+    # ======================================================================= #
+    # === :total_ECTS
+    # ======================================================================= #
+    @internal_hash[:total_ECTS] = 0
+    # ======================================================================= #
+    # === :title_of_the_curriculum
+    # ======================================================================= #
+    @internal_hash[:title_of_the_curriculum] = 0
+    # ======================================================================= #
+    # === :runmode_for_this_class
+    #
+    # The next variable determines the "runmode" for this class, e. g.
+    # whether we will generate a .html file.
+    #
+    # The valid modes are:
+    #
+    #   :generate_a_HTML_file
+    #   :raw_serve
+    #
+    # ======================================================================= #
+    @internal_hash[:runmode_for_this_class] = :generate_a_HTML_file
+    # ======================================================================= #
+    # === :original_input
+    # ======================================================================= #
+    @internal_hash[:original_input] = nil
+    # ======================================================================= #
+    # === :go_downwards_n_times
+    # ======================================================================= #
+    @internal_hash[:go_downwards_n_times] = 8
+    # ======================================================================= #
+    # === :include_course_descriptions
+    #
+    # If this variable is set to true then the course descriptions will
+    # be included as well, as part of the generated HTML code. Note that
+    # this leads to a more verbose, longer content, which may be a bit
+    # annoying to read compared to the shorter, more succint variant.
+    # Thus, this is set to false by default; in the .cgi file it can
+    # be set to true by the user, if the user decides to want to do
+    # so via a checkbox (on/off).
+    # ======================================================================= #
+    @internal_hash[:include_course_descriptions] = false
+    # ======================================================================= #
+    # === :hash_ects_per_university
+    # ======================================================================= #
+    @internal_hash[:hash_ects_per_university] = {}
+    @internal_hash[:hash_ects_per_university].default = 0
+    # ======================================================================= #
+    # === :hash_n_ECTS_per_curriculum
+    #
+    # The following Hash will keep track how many ECTS points are
+    # listed per curriculum.
+    # ======================================================================= #
+    reset_the_hash_n_ECTS_per_curriculum
+  end
+
+  # ========================================================================= #
+  # === include_course_descriptions?
+  # ========================================================================= #
+  def include_course_descriptions?
+    @internal_hash[:include_course_descriptions]
+  end
+
+  # ========================================================================= #
+  # === reset_the_hash_n_ECTS_per_curriculum
+  # ========================================================================= #
+  def reset_the_hash_n_ECTS_per_curriculum
+    @internal_hash[:hash_n_ECTS_per_curriculum] = {}
+    @internal_hash[:hash_n_ECTS_per_curriculum].default = 0.0
+  end
+
+  # ========================================================================= #
+  # === assume_bachelor_or_master_or_otherwise
+  # ========================================================================= #
+  def assume_bachelor_or_master_or_otherwise(
+      i = @internal_hash[:total_ECTS]
+    )
+    case i # case tag
+    when 90,
+         120,
+         122.5 # This one is just an ad-hoc "fix".
+      @internal_hash[:curriculum_type] = :master
+    when 180,
+         181,
+         165.0
+      @internal_hash[:curriculum_type] = :bachelor
+    else
+      etomato(
+        'Undefined as of yet. The number of ECTS points was: '+i.to_s
+      )
+    end
+  end
+
+  # ========================================================================= #
+  # === set_go_downwards_n_times
+  # ========================================================================= #
+  def set_go_downwards_n_times(i)
+    @internal_hash[:go_downwards_n_times] = i
+  end
+
+  # ========================================================================= #
+  # === determine_n_ECTS_from_this_dataset
+  # ========================================================================= #
+  def determine_n_ECTS_from_this_dataset(array)
+    sum = 0
+    array.each {|entry|
+      entry.strip! # Added in January 2023.
+      pointer = @dataset_from_the_file_lecture_information[entry]
+      if pointer.nil?
+        cliner
+        opne "There appears to be some incorrect entry for `#{entry}`."
+        opne tomato('No ECTS entry was found for ')+
+             steelblue(entry.to_s)+tomato('.')
+        opne "The local file was: #{sfile(local_file?)}"
+        e
+        opne "The caller stack trace was:"
+        e; pp caller; e
+        cliner
+        # exit
+      else
+        n_ECTS = pointer[:ects]
+        sum += n_ECTS
+      end
+    }
+    @internal_hash[:total_ECTS] = sum
+    assume_bachelor_or_master_or_otherwise
+  end
+
+  # ========================================================================= #
+  # === this_class_must_create_a_HTML_file
+  # ========================================================================= #
+  def this_class_must_create_a_HTML_file
+    set_runmode_for_this_class(:create_a_HTML_file)
+  end; alias this_must_generate_a_HTML_file this_class_must_create_a_HTML_file # === this_must_generate_a_HTML_file
+
+  # ========================================================================= #
+  # === runmode_for_this_class?
+  # ========================================================================= #
+  def runmode_for_this_class?
+    @internal_hash[:runmode_for_this_class]
+  end
+
+  # ========================================================================= #
+  # === set_runmode_for_this_class
+  # ========================================================================= #
+  def set_runmode_for_this_class(i)
+    i = i.to_sym
+    case i
+    # ======================================================================= #
+    # === :serve_as_is
+    # ======================================================================= #
+    when :serve_as_is
+      i = :raw_serve
+    # ======================================================================= #
+    # === :create_a_HTML_file
+    # ======================================================================= #
+    when :create_a_HTML_file
+      i = :generate_a_HTML_file
+    end
+    @internal_hash[:runmode_for_this_class] = i
+  end
+        
+  # ========================================================================= #
+  # === set_original_input
+  #
+  # This must retain the original input.
+  # ========================================================================= #
+  def set_original_input(i)
+    @internal_hash[:original_input] = i
+  end
+
+  # ========================================================================= #
+  # === generates_a_HTML_file?
+  # ========================================================================= #
+  def generates_a_HTML_file?
+    @internal_hash[:runmode_for_this_class] == :generate_a_HTML_file
+  end
+
+  # ========================================================================= #
+  # === set_path_to_the_curriculum_file
+  # ========================================================================= #
+  def set_path_to_the_curriculum_file(i)
+    @internal_hash[:path_to_the_curriculum_file] = i
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === Create a .html file
+      # ===================================================================== #
+      when /^-?-?create(-|_| )?a(-|_| )?html(-|_| )?file$/i,
+           /^-?-?HTML$/i
+        this_class_must_create_a_HTML_file
+      # ===================================================================== #
+      # === handle --show_help
+      # ===================================================================== #
+      when /^-?-?help$/i,
+           /^-?-?show(-|_)?help$/i
+        show_help
+        exit
+      else
+        # =================================================================== #
+        # === handle agrar
+        #
+        # Many other entries can be used as well such as "handle --indi1".
+        #
+        # All curricula should be handled by this entry point here. Right
+        # now we only handle individual curricula.
+        # =================================================================== #
+        set_original_input(i)
+        if i
+          possible_different_result = Studium.map_input_to_this_curriculum_filename(i)
+          unless possible_different_result == i
+            i = possible_different_result
+          end
+        end
+        if is_a_registered_curriculum?(i)
+          set_title_of_the_curriculum(
+            return_title_of_this_curriculum(i)
+          )
+          set_path_to_the_curriculum_file(
+            return_path_to_the_curriculum_file(i)
+          )
+          _ = obtain_lectures_from_this_curriculum(i)
+          @internal_hash[:courses] = _
+          determine_n_ECTS_from_this_dataset(_)
+        end
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === n_ECTS?
+  # ========================================================================= #
+  def n_ECTS?
+    @internal_hash[:total_ECTS]
+  end; alias n_ECTS_in_total? n_ECTS? # === n_ECTS_in_total?
+       alias total_ECTS?      n_ECTS? # === total_ECTS?
+
+  # ========================================================================= #
+  # === curriculum_type?
+  # ========================================================================= #
+  def curriculum_type?
+    @internal_hash[:curriculum_type]
+  end
+
+  # ========================================================================= #
+  # === courses?
+  # ========================================================================= #
+  def courses?
+    @internal_hash[:courses]
+  end
+
+  # ========================================================================= #
+  # === title?
+  # ========================================================================= #
+  def title?
+    @internal_hash[:title_of_the_curriculum]
+  end; alias curriculum_title? title? # === curriculum_title?
+
+  # ========================================================================= #
+  # === set_title_of_the_curriculum
+  # ========================================================================= #
+  def set_title_of_the_curriculum(i)
+    @internal_hash[:title_of_the_curriculum] = i
+  end
+
+  # ========================================================================= #
+  # === do_generate_a_HTML_file                          (HTML tag, html tag)
+  # ========================================================================= #
+  def do_generate_a_HTML_file(
+      i = courses?
+    )
+    this_file = "#{log_dir?}HTML/"\
+                "#{title?.to_s.tr(' ','_')}.html"
+    what = return_the_content_of_the_requested_curriculum
+    unless File.directory? File.dirname(this_file)
+      mkdir(File.dirname(this_file))
+    end
+    e 'Storing into `'+sfile(this_file)+'`.'
+    write_what_into(what, this_file)
+    if is_on_roebe? and File.exist?(this_file)
+      Open.in_browser(this_file)
+    end
+  end
+
+  # ========================================================================= #
+  # === original_input?
+  # ========================================================================= #
+  def original_input?
+    @internal_hash[:original_input]
+  end; alias original_input original_input? # === original_input
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  # ========================================================================= #
+  def show_help
+    e
+    e 'Help-options are currently not implemented.'
+    e
+  end
+
+  # ========================================================================= #
+  # === go_downwards_to_the_root_of_the_webserver
+  # ========================================================================= #
+  def go_downwards_to_the_root_of_the_webserver(
+      go_downwards_n_times = @internal_hash[:go_downwards_n_times]
+    )
+    return ('../' * go_downwards_n_times)
+  end
+
+  # ========================================================================= #
+  # === path_to_the_curriculum_file?
+  # ========================================================================= #
+  def path_to_the_curriculum_file?
+    @internal_hash[:path_to_the_curriculum_file]
+  end; alias path?       path_to_the_curriculum_file? # === path?
+       alias local_file? path_to_the_curriculum_file? # === local_file?
+
+  # ========================================================================= #
+  # === return_the_content_of_the_requested_curriculum
+  # ========================================================================= #
+  def return_the_content_of_the_requested_curriculum(
+      i = courses?
+    )
+    _ = ''.dup
+    # ======================================================================= #
+    # Build up our HTML String here, starting with the outer <div> tag:
+    # ======================================================================= #
+    title = title?
+    _ << '<div style=\"margin: 0px\">'
+    _ << "<h1 style=\"margin-top: 2px;\" class=\"darkblue\">#{title}</h1>\n"
+    path = path_to_the_curriculum_file?
+    if path.is_a? Array
+      _ << "<b class=\"mediumslateblue\" style=\"font-size: 1.5em\">"\
+           "The dataset was loaded from the following files:</b>"\
+           "<br>\n"
+      _ << "<p class=\"marl3em\"><b class=\"royalblue\">"
+      path.each {|entry|
+        _ << entry+'<br>'
+      }
+      _ << "</b></p></div>\n"
+    else
+      _ << "<b class=\"mediumslateblue\" style=\"font-size: 1.5em\">"\
+           "The dataset was loaded from the following file:</b>"\
+           "<br>\n"
+      _ << "<p class=\"marl3em\"><b class=\"royalblue\">"\
+           "#{path}"\
+           "</b></p></div>\n"
+    end
+    n_lectures_are_already_solved = 0
+    dataset = @dataset_from_the_file_lecture_information
+    passed_n_ECTS_in_total = 0
+    # ======================================================================= #
+    # Iterate over our designated lectures next:
+    # ======================================================================= #
+    if i.nil? or i.empty?
+      return '<div style="margin: 1em">No curriculum was found fitting to the given '\
+             'input name `<b>'+original_input?.to_s.strip+'</b>`.'+
+             'The assumed path was: '+path.to_s+
+             '</div>'
+    end
+    currently_displayed_module_is = nil
+    reset_the_hash_n_ECTS_per_curriculum
+    @internal_hash[:hash_ects_per_university].clear
+    # ======================================================================= #
+    # Big iteration time! We go over each registered course next.
+    # ======================================================================= #
+    i.each_with_index {|entry, index| index += 1
+      lva_number              = entry.split(' ').first.to_s
+      pointer                 = dataset[entry]
+      university_course       = Studium::UniversityCourse.new(pointer)
+      university_course.set_lecture_name(entry)
+      is_a_STEOP_lecture      = university_course.is_a_steop_lecture?
+      remote_URL              = university_course.remote_URL?
+      university              = university_course.university?
+      lecture_type            = university_course.lecture_type?
+      already_solved          = university_course.already_solved?
+      absolviert_am           = university_course.already_solved_at?
+      n_ECTS                  = university_course.ects?
+      course_description      = university_course.description_in_german?.to_s
+      @internal_hash[:hash_ects_per_university][university] += n_ECTS
+      curricula               = university_course.curricula?
+      # ===================================================================== #
+      # Next, store the number of ECTS per curriculum in a Hash:
+      # ===================================================================== #
+      if curricula
+        curricula.each {|this_curriculum|
+          @internal_hash[:hash_n_ECTS_per_curriculum][this_curriculum] += n_ECTS
+        }
+      end
+      individual_curriculum   = university_course.is_an_individual_curriculum?
+      if individual_curriculum
+        university_course.set_we_work_on_this_individual_curriculum(title)
+      end
+      is_this_course_outdated = university_course.is_this_course_outdated?
+      moodle_entry            = university_course.moodle?
+      moodle_entry            = moodle_entry.first if moodle_entry and moodle_entry.is_a?(Array)
+      if already_solved
+        n_lectures_are_already_solved += 1
+        passed_n_ECTS_in_total += n_ECTS
+      end
+      semester                = university_course.semester?.to_s.dup
+      case semester
+      when 'both'
+        semester = 'Sommer / Winter'
+      else
+        semester.capitalize!
+      end
+      if individual_curriculum
+        if (currently_displayed_module_is == university_course.individual_curriculum_module?.to_s) 
+          # pass through and don't display it in this case.
+        else
+          _ << '<h1>Module '+
+               '<span class="chocolate">'+
+               university_course.individual_curriculum_module?.to_s+
+               '</span> '+
+               university_course.name_of_the_curriculum_module?.to_s+
+               '</h1>'
+          currently_displayed_module_is = university_course.individual_curriculum_module?.to_s
+        end
+      end
+      case university.to_s
+      # ===================================================================== #
+      # === Uni Wien
+      # ===================================================================== #
+      when 'Uni Wien'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             Studium.path_to_the_university_of_vienna_logo_image?.sub(/\/home\/x/,'')+
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      # ===================================================================== #
+      # === Vetmed
+      # ===================================================================== #
+      when 'Vetmed'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             Studium.path_to_the_vetmed_logo_image?.sub(/\/home\/x/,'')+
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      # ===================================================================== #
+      # === TU Vienna
+      # ===================================================================== #
+      when 'TU Vienna'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             Studium.path_to_the_tu_vienna_logo_image?.sub(/\/home\/x/,'')+
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      # ===================================================================== #
+      # === :BOKU
+      # ===================================================================== #
+      when 'BOKU'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             Studium.path_to_the_boku_logo_image?.sub(/\/home\/x/,'')+
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      # ===================================================================== #
+      # === :Uni Graz
+      # ===================================================================== #
+      when 'Uni Graz'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'data/images/studium/UNIVERSITY_OF_GRAZ_LOGO_IMAGE.png'\
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      # ===================================================================== #
+      # === :Meduni
+      # ===================================================================== #
+      when 'Meduni'
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'data/images/studium/MEDUNI_LOGO_IMAGE.png'\
+             '" style="margin-right: 0.5em; border: 0px solid black;">'
+      else
+        e "Unknown symbol: #{university}"
+      end
+      _ << "<span>Lehrveranstaltung <b>##{index}</b>: </span>".dup
+      # ===================================================================== #
+      # Next add a link to the remote lecture's homepage:
+      # ===================================================================== #
+      _ << HtmlTags.a(
+        remote_URL,
+        "<span class=\"link BOLD\">→ #{entry}</span>"
+      )
+      append_this = german_yes_or_no(already_solved).to_s.capitalize.dup
+      case append_this
+      # ===================================================================== #
+      # === Ja
+      # ===================================================================== #
+      when 'Ja'
+        append_this = '<b class="forestgreen">'+
+                      append_this+', absolviert am '+
+                      absolviert_am+'.</b>'
+      # ===================================================================== #
+      # === Nein
+      # ===================================================================== #
+      when 'Nein'
+        append_this = '<b class="orangered">'+
+                      append_this+'.</b>'
+      end
+      _ << ', Bereits <b>absolviert</b>? '+append_this
+      # ===================================================================== #
+      # If it is outdated:
+      # ===================================================================== #
+      if is_this_course_outdated
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'programming/ruby/src/studium/lib/studium/images/outdated.png" '\
+             'style="margin-left: 0.5em; border: 2px solid black;">'
+      end
+      # ===================================================================== #
+      # Consider showing the STEOP lecture image next:
+      # ===================================================================== #
+      if is_a_STEOP_lecture
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'data/images/universities/STEOP.png" '\
+             'style="margin-left: 0.5em; width: 28px; height: 28px; border: 0px solid black;">'
+      end
+      # ===================================================================== #
+      # Consider showing the practical course next:
+      # ===================================================================== #
+      if is_it_a_practical_course?(entry, lecture_type)
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             Studium.path_to_the_practical_course_image?.sub(/\/home\/x/,'')+'" '\
+             'style="margin-left: 0.6em; border: 1px solid black;">'
+      end
+      # ===================================================================== #
+      # Show an image depending on whether we have a bachelor or a master
+      # course next. Some courses are available in both a bachelor and
+      # a master curriculum, so we will show this as well.
+      # ===================================================================== #
+      if is_a_bachelor_curriculum?(curricula)
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'data/images/studium/BACHELOR.png" '\
+             'style="margin-left: 0.6em; border: 1px solid black;">'
+      end
+      if is_a_master_curriculum?(curricula)
+        _ << '<img src="'+go_downwards_to_the_root_of_the_webserver+
+             'data/images/studium/MASTER.png" '\
+             'style="margin-left: 0.6em; border: 1px solid black;">'
+      end
+      if already_solved
+        _ << '<img class="marl0_5em" style="width: 100px" '\
+             'src="'+
+             go_downwards_to_the_root_of_the_webserver+
+             'programming/ruby/src/studium/lib/studium/images/small_logos/solved.png">'
+      end
+      # ===================================================================== #
+      # Next add some more details to this course:
+      # ===================================================================== #
+      which_year = '2022W'
+      which_year = ::Studium.infer_the_year_of_this_lecture(
+        entry,
+        @dataset_from_the_file_lecture_information
+      )
+      _ << "<br>\n<span class=\"marl6_8em\">"\
+           "(LVA Nummer: <b>#{lva_number}</b>; "\
+           "ECTS: <b>#{n_ECTS}</b>; "\
+           "Lecture Type: <b>#{lecture_type}</b>; "\
+           "Semester: <b>#{semester.to_s}, of #{which_year}</b>; "\
+           "University: <b>#{university}</b>"\
+           ")</span><br>\n"
+      # ===================================================================== #
+      # Next, show a moodle-entry if it exists.
+      # ===================================================================== #
+      if moodle_entry
+        moodle_entry_string = ::Studium.return_semester_for_this_moodle_entry(moodle_entry).to_s
+        if moodle_entry_string.empty? and is_on_roebe? # Only for my home system.
+          e 'Some outdated entry: '+steelblue(moodle_entry)
+        end
+        _ << '<img class="marl6_8em marr0_5em" src="'+
+             go_downwards_to_the_root_of_the_webserver+
+             'data/images/STD/PFEIL6_red.png">'+
+             '<a href="'+moodle_entry+'" class="BOLD">'+
+             '[Moodle entry at: '+moodle_entry+']</a> # <b>'+
+             moodle_entry_string+
+             '</b>'
+      else
+        _ << '<span class="marl6_8em darkblue BOLD">[No remote moodle-entry '\
+             'is known for this course.]</span>'
+      end
+      _ << "<br>\n"
+      unless already_solved
+        if university_course.next_exam? and !university_course.next_exam?.empty?
+          _ << '<span class="marl6_8em BOLD">'\
+               '^^^ <b class="teal">Next exam</b>: '+
+               university_course.next_exam?.to_s+'</span><br>'+"\n"
+        end
+      end
+      # ===================================================================== #
+      # Show the description of the course, if requested to do so:
+      # ===================================================================== #
+      if include_course_descriptions?
+        _ << '<pre style="margin-left: 8%">'
+        _ << course_description
+        _ << '</pre>'
+      end
+    }
+    _ << "<br>\n"
+    # ======================================================================= #
+    # Next show some statistics:
+    # ======================================================================= #
+    n_percent_finished = ((n_lectures_are_already_solved * 100.0) / i.size).round(2)
+    _ << "<div style=\"margin-top: 0.8em; padding: 15px; border: 3px dotted steelblue\">"\
+         "A total of <b>#{i.size}</b> lectures are part of this "\
+         "Curriculum. <b>#{n_lectures_are_already_solved}</b> of these "\
+         "are already solved. <b>(#{n_percent_finished}% finished)"\
+         "</b><br><br>"
+    n_percent_continuous_mandatory_assessment = Studium.percentage_mandatory_continuous_assessment(
+      title?.downcase.tr(' ','_'), 2
+    )
+    n_ECTS = (
+      (n_ECTS_in_total? * n_percent_continuous_mandatory_assessment) / 100.0
+    ).round(2) # Must round here to avoid rounding-up errors.
+    _ << "This curriculum has <b>#{n_ECTS_in_total?} ECTS</b> points "\
+         "in total, of which <b>#{n_ECTS} ECTS</b> "\
+         "(<b>#{n_percent_continuous_mandatory_assessment}%</b>) require "\
+         "<b>continuous mandatory assessment</b> "\
+         "(<i>prüfungsimmanent</i>).<br>\n<br>\n"
+    n_percentage_of_n_ECTS_were_passed_so_far = (
+      (passed_n_ECTS_in_total * 100) / n_ECTS_in_total?
+    ).round(2)
+    _ << "In total <b>#{passed_n_ECTS_in_total} ECTS points</b> "\
+         "(<b>#{n_percentage_of_n_ECTS_were_passed_so_far}%</b>) have been "\
+         "passed so far in the "\
+         "<b>#{title?}</b>.<br>\n<br>\n"
+    _ << "There are still "\
+         "<b>#{i.size - n_lectures_are_already_solved}</b> "\
+         "lectures missing before this curriculum has "\
+         "been completed successfully.<br>\n<br>\n"
+    _ << "The average grade of the passed courses is: "\
+         "<b>#{Studium.average_grade_of_this_curriculum(title?)}</b>"
+    # ======================================================================= #
+    # Display the universities in its own <div> tag:
+    # ======================================================================= #
+    total_ECTS = total_ECTS?
+    _ << '<div style="margin-left: 4%; padding: 0.25em; '\
+         'font-family: monospace; white-space: pre;">'
+    _ << h2('Attributed universities:', 
+         css_style: 'color: royalblue; font-weight: bold; margin-top: 2px;')
+    _ << '<table style="margin: 2px">'
+    @internal_hash[:hash_ects_per_university].each_pair {|this_university, n_ECTS|
+      percentage_value = ((n_ECTS.to_f * 100.0) / total_ECTS).round(2)
+      _ << '<tr><td><b style="font-family: monospace; white-space: pre">'+
+           (this_university.to_s+':'.ljust(15))+'</b></td><td> <b>'+
+           n_ECTS.to_f.to_s.rjust(10)+' ECTS</b> (<b>'+
+           percentage_value.to_s.rjust(5)+'%</b>)</td></tr>'
+    }
+    _ << '</table></div>'
+    # ======================================================================= #
+    # === Curricula IDs
+    #
+    # Next display the different curricula ID that are part of this
+    # curriculum:
+    # ======================================================================= #
+    _ << '<h3>Curricula IDs that are represented in this curriculum:<h3>'
+    sorted = Hash[@internal_hash[:hash_n_ECTS_per_curriculum].sort_by {|a, b| b }.reverse]
+    sorted.each_pair {|key, value|
+      key   = key.to_s.rjust(12,' ')
+      value = value.to_s.rjust(6,' ')
+      translated_name = Studium.map_curriculum_number_to_curriculum_name(key.to_s.strip).to_s
+      percentage_value = ((value.to_f * 100) / n_ECTS_in_total?).round(2)
+      percentage_value = percentage_value.to_s
+      percentage_value = '%.2f' % percentage_value
+      percentage_value = percentage_value.rjust(5, ' ')
+      _ << "<b style=\"margin-left: 4em; white-space: pre\">"\
+           "#{key} "+
+           ('('+translated_name+'):').ljust(66,' ')+
+           " <span style=\"midnightblue\">#{value} ECTS</span> "\
+           "(#{percentage_value}% of #{n_ECTS_in_total?} out of ECTS)</b><br>\n"
+    }
+    # ======================================================================= #
+    # Next add the upcoming exams, should they exist:
+    # ======================================================================= #
+    require 'studium/exams/upcoming_exams/upcoming_exams.rb'
+    upcoming_exams = Studium::Exams::UpcomingExams.in_this_curriculum(title)
+    _ << h2('The following exams are coming up next:', 
+         css_style: 'color: royalblue; font-weight: bold; '\
+                    'margin-top: 2px; margin-left: 3em;')
+    if upcoming_exams.nil?
+      _ << p('No upcoming exams are known for this curriculum.')
+    else
+      _ << '<pre>'
+      # ===================================================================== #
+      # We have to time-sort the dataset next:
+      # ===================================================================== #
+      regex_to_use = /(\d{2}\.\d{2}\.\d{4})/
+      sorted = upcoming_exams.sort_by {|a, b|
+        exams = b['exams']
+        exams = exams.first if exams.is_a? Array
+        exams =~ regex_to_use
+        raw_date = $1.to_s.dup
+        ::Time.parse(raw_date)
+      }
+      upcoming_exams = Hash[sorted]
+      upcoming_exams.each_pair {|name_of_the_course, inner_hash|
+        exams = inner_hash['exams']
+        if exams.is_a? Array
+          exams = exams.first
+        end
+        remote_URL = Studium.remote_URL_for_this_university_course(name_of_the_course).to_s
+        _ << '    <b><a href="'+remote_URL+'">'+
+             name_of_the_course+
+             '</b></a> (am <b>'+exams+'</b>)<br>'
+      }
+      _ << '</pre>'
+    end
+    # ======================================================================= #
+    # Delegate towards class HtmlTemplate next.                (template tag)
+    # ======================================================================= #
+    what = Cyberweb.rendered_template(
+      body:            _,
+      title:          curriculum_title?,
+      css_classes:    'royalblue darkblue mar1em mar0_5em BOLD pad8px bblack1 '\
+                      'pad5px mediumslateblue smaller forestgreen '\
+                      'pad14px tomato mediumaquamarine orangered teal '\
+                      'marl3em marl6em marl7em marl6_8em darkslateblue '\
+                      'marr1em marr2em marr0_5em marl0_5em '\
+                      's0_4em s0_5em s0_8em mar0em',
+      css_style:      '
+        a,
+        a:link,
+        a:visited {
+          text-decoration: none;
+          color: royalblue;
+        }
+        a:hover     {
+          text-decoration: none;
+          color: mediumaquamarine;
+        }
+        .link       {
+          color: darkblue;
+          text-decoration: none;
+        }
+        .link:hover {
+          color: darkslateblue;
+          text-decoration: none;
+        }
+        .leftwards_center {
+          margin: auto;
+          width:   85%;
+          padding:  8px;
+        }
+      ', # CSS tag
+      body_css_class: 'mar0em pad14px s0_5em bblack1',
+      body_css_style: 'font-size: 1.3em;
+                       font-family: monospace;'
+    )
+    return what.result?
+  end; alias content? return_the_content_of_the_requested_curriculum # === content?
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    menu
+    case runmode_for_this_class?
+    # ======================================================================= #
+    # === :generate_a_HTML_file
+    # ======================================================================= #
+    when :generate_a_HTML_file
+      set_go_downwards_n_times(3)
+      do_generate_a_HTML_file
+    # ======================================================================= #
+    # === :raw
+    # ======================================================================= #
+    when :raw,
+         :raw_serve
+      # Do nothing in this case.
+    else
+      e "Runmode not yet implemented: "\
+        "#{steelblue(runmode_for_this_class?)}"
+    end
+  end
+
+end; end; end