studium 0.18.7

data/lib/studium/colours/colours.rb

@@ -0,0 +1,1711 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This governs colour-related code for the Studium project.
+#
+# It resides in the subnamespace Colours, a module.
+# =========================================================================== #
+# require 'studium/colours/colours.rb'
+# include ::Studium::Colours
+# =========================================================================== #
+module Studium
+
+module Colours # === Studium::Colours
+
+  require 'studium/project/project.rb'
+  require 'studium/constants/constants.rb'
+
+  # ========================================================================= #
+  # === @use_colours
+  #
+  # If @use_colours is set to true then we will use colours in a
+  # project-wide manner, for the whole Studium namespace. This
+  # defaults to true. However had, if a file called "use_colours.yml"
+  # exists and if it can be found, then we will instead use the content
+  # of that file for the @use_colours variable.
+  # ========================================================================= #
+  _ = "#{::Studium.yaml_directory?}use_colours.yml"
+  if File.exist? _
+    require 'yaml'
+    @use_colours = YAML.load_file(_)
+  else
+    @use_colours = true # This is the default.
+  end
+
+  if @use_colours
+
+    begin
+      require 'colours/html_colours'
+    rescue LoadError; end
+
+    begin
+      require 'colours/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink.rb'
+    rescue LoadError
+    end
+
+    begin
+      require 'colours/replace_tokens_with_colour_code/replace_tokens_with_colour_code.rb'
+    rescue LoadError
+    end
+
+    begin
+      require 'colours/autogenerated/html_colours_methods.rb'
+      COLOURS = ::Colours::HtmlColoursMethods
+    rescue LoadError
+      COLOURS = nil
+    end
+  else
+    COLOURS = nil
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.use_colours?
+  #
+  # Query whether we will use colours or whether we will not.
+  # ========================================================================= #
+  def self.use_colours?
+    @use_colours
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.enable_colours
+  # ========================================================================= #
+  def self.enable_colours
+    @use_colours = true
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.disable_colours
+  #
+  # Disable the colours through this method here. Should happen when we
+  # are running in :www mode (as in .cgi scripts).
+  # ========================================================================= #
+  def self.disable_colours
+    @use_colours = false
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.e                                            (e tag)
+  # ========================================================================= #
+  def self.e(
+      i           = '',
+      use_colours = use_colours?
+    )
+    if use_colours?
+      Colours::E.e(i)
+    else
+      puts i
+    end
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.default_colour
+  # ========================================================================= #
+  def self.default_colour
+    ::Colours::GREEN if COLOURS
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.rev
+  # ========================================================================= #
+  def self.rev
+    return ::Colours.rev if COLOURS and use_colours?
+    return ''
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.palevioletred
+  # ========================================================================= #
+  def self.palevioletred(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.palevioletred(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.grey
+  # ========================================================================= #
+  def self.grey(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.grey(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightslategray
+  # ========================================================================= #
+  def self.lightslategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightslategray(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lightslategray
+  # ========================================================================= #
+  def lightslategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.lightslategray(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lawngreen
+  # ========================================================================= #
+  def self.lawngreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lawngreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lawngreen
+  # ========================================================================= #
+  def lawngreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.lawngreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.indianred
+  # ========================================================================= #
+  def self.indianred(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.indianred(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === indianred
+  # ========================================================================= #
+  def indianred(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.indianred(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.tomato
+  # ========================================================================= #
+  def self.tomato(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.tomato(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === tomato
+  # ========================================================================= #
+  def tomato(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.tomato(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.cadetblue
+  # ========================================================================= #
+  def self.cadetblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.cadetblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === cadetblue
+  # ========================================================================= #
+  def cadetblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.cadetblue(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightskyblue
+  # ========================================================================= #
+  def self.lightskyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightskyblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lightskyblue
+  # ========================================================================= #
+  def lightskyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.lightskyblue(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.cornflowerblue
+  # ========================================================================= #
+  def self.cornflowerblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.cornflowerblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === cornflowerblue
+  # ========================================================================= #
+  def cornflowerblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.cornflowerblue(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lime
+  # ========================================================================= #
+  def self.lime(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lime(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lime
+  # ========================================================================= #
+  def lime(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.lime(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.orchid
+  # ========================================================================= #
+  def self.orchid(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.orchid(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === orchid
+  # ========================================================================= #
+  def orchid(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.orchid(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.plum
+  # ========================================================================= #
+  def self.plum(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.plum(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === plum
+  # ========================================================================= #
+  def plum(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.plum(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.teal
+  # ========================================================================= #
+  def self.teal(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.teal(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === teal
+  # ========================================================================= #
+  def teal(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.teal(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.cyan
+  # ========================================================================= #
+  def self.cyan(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.cyan(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === cyan
+  # ========================================================================= #
+  def cyan(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.cyan(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkturquoise
+  # ========================================================================= #
+  def self.darkturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkturquoise(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === darkturquoise
+  # ========================================================================= #
+  def darkturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.darkturquoise(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumpurple
+  # ========================================================================= #
+  def self.mediumpurple(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumpurple(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumpurple
+  # ========================================================================= #
+  def mediumpurple(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.mediumpurple(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.powderblue
+  # ========================================================================= #
+  def self.powderblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.powderblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === powderblue
+  # ========================================================================= #
+  def powderblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.powderblue(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkslategray
+  # ========================================================================= #
+  def self.darkslategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkslategray(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === darkslategray
+  # ========================================================================= #
+  def darkslategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.darkslategray(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.limegreen
+  # ========================================================================= #
+  def self.limegreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.limegreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === limegreen
+  # ========================================================================= #
+  def limegreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.limegreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.yellowgreen
+  # ========================================================================= #
+  def self.yellowgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.yellowgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === yellowgreen
+  # ========================================================================= #
+  def yellowgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.yellowgreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.paleturquoise
+  # ========================================================================= #
+  def self.paleturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.paleturquoise(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === paleturquoise
+  # ========================================================================= #
+  def paleturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.paleturquoise(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.sandybrown
+  # ========================================================================= #
+  def self.sandybrown(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.sandybrown(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sandybrown
+  # ========================================================================= #
+  def sandybrown(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.sandybrown(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightseagreen
+  # ========================================================================= #
+  def self.lightseagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightseagreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lightseagreen
+  # ========================================================================= #
+  def lightseagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.lightseagreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.skyblue
+  # ========================================================================= #
+  def self.skyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.skyblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === skyblue
+  # ========================================================================= #
+  def skyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.skyblue(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.steelblue
+  # ========================================================================= #
+  def self.steelblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.steelblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === steelblue
+  # ========================================================================= #
+  def steelblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return Studium::Colours.steelblue(i)
+  end
+
+  # ========================================================================= #
+  # === grey
+  # ========================================================================= #
+  def grey(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.grey(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumslateblue
+  # ========================================================================= #
+  def self.mediumslateblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumslateblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumslateblue
+  # ========================================================================= #
+  def mediumslateblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.mediumslateblue(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.coral
+  # ========================================================================= #
+  def self.coral(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.coral(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === coral
+  # ========================================================================= #
+  def coral(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.coral(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.peru
+  # ========================================================================= #
+  def self.peru(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.peru(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === peru
+  # ========================================================================= #
+  def peru(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.peru(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.tan
+  # ========================================================================= #
+  def self.tan(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.tan(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === tan
+  # ========================================================================= #
+  def tan(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.tan(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.khaki
+  # ========================================================================= #
+  def self.khaki(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.khaki(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === khaki
+  # ========================================================================= #
+  def khaki(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.khaki(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumspringgreen
+  # ========================================================================= #
+  def self.mediumspringgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumspringgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumspringgreen
+  # ========================================================================= #
+  def mediumspringgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.mediumspringgreen(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkslateblue
+  # ========================================================================= #
+  def self.darkslateblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkslateblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === darkslateblue
+  # ========================================================================= #
+  def darkslateblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.darkslateblue(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.forestgreen
+  # ========================================================================= #
+  def self.forestgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.forestgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === forestgreen
+  # ========================================================================= #
+  def forestgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.forestgreen(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.slategray
+  # ========================================================================= #
+  def self.slategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.slategray(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === slategray
+  # ========================================================================= #
+  def slategray(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.slategray(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.olive
+  # ========================================================================= #
+  def self.olive(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.olive(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === olive
+  # ========================================================================= #
+  def olive(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.olive(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumaquamarine
+  # ========================================================================= #
+  def self.mediumaquamarine(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumaquamarine(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumaquamarine
+  # ========================================================================= #
+  def mediumaquamarine(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.mediumaquamarine(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.goldenrod
+  # ========================================================================= #
+  def self.goldenrod(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.goldenrod(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === goldenrod
+  # ========================================================================= #
+  def goldenrod(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.goldenrod(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.seagreen
+  # ========================================================================= #
+  def self.seagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.seagreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === seagreen
+  # ========================================================================= #
+  def seagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.seagreen(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.sfancy(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkseagreen
+  # ========================================================================= #
+  def self.darkseagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkseagreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkgreen
+  # ========================================================================= #
+  def self.darkgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightgreen
+  # ========================================================================= #
+  def self.lightgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightsalmon
+  # ========================================================================= #
+  def self.lightsalmon(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightsalmon(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.orange
+  # ========================================================================= #
+  def self.orange(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.orange(i) if COLOURS and use_colours 
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.slateblue
+  # ========================================================================= #
+  def self.slateblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.slateblue(i) if COLOURS and use_colours 
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.lightblue
+  # ========================================================================= #
+  def self.lightblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.lightblue(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.gold
+  # ========================================================================= #
+  def self.gold(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.gold(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.sfancy
+  #
+  # To test this method e. g. in IRB, do:
+  #
+  #   puts Studium::Colours.sfancy("yo there")
+  #
+  # ========================================================================= #
+  def self.sfancy(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Colours.sfancy(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === yellow
+  # ========================================================================= #
+  def yellow(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.yellow(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === bold_yellow
+  # ========================================================================= # 
+  def bold_yellow(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.bold_yellow(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === bold_blue
+  # ========================================================================= #
+  def bold_blue(i = '')
+    return COLOURS.bold_blue(i.to_s.dup) if Colours.use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === bold_red
+  # ========================================================================= #
+  def bold_red(i = '')
+    return COLOURS.beautify('bold red')+i.to_s+Colours.rev if Colours.use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === rev?
+  # ========================================================================= #
+  def rev?
+    Studium::Colours.rev
+  end; alias rev rev? # === rev
+
+  # ========================================================================= #
+  # === erev
+  # ========================================================================= #
+  def erev(i = '')
+    e "#{rev}#{i}"
+  end
+
+  # ========================================================================= #
+  # === papayawhip
+  # ========================================================================= #
+  def papayawhip(i = '')
+    return COLOURS.papayawhip(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === oldlace
+  # ========================================================================= #
+  def oldlace(i = '')
+    return COLOURS.oldlace(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === darkgray
+  # ========================================================================= #
+  def darkgray(i = '')
+    return COLOURS.darkgray(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkgoldenrod
+  # ========================================================================= #
+  def self.darkgoldenrod(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkgoldenrod(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === darkgoldenrod
+  # ========================================================================= #
+  def darkgoldenrod(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.darkgoldenrod(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumturquoise
+  # ========================================================================= #
+  def self.mediumturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumturquoise(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumturquoise
+  # ========================================================================= #
+  def mediumturquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.mediumturquoise(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.springgreen
+  # ========================================================================= #
+  def self.springgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.springgreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === springgreen
+  # ========================================================================= #
+  def springgreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.springgreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.palegreen
+  # ========================================================================= #
+  def self.palegreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.palegreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === palegreen
+  # ========================================================================= #
+  def palegreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.palegreen(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.saddlebrown
+  # ========================================================================= #
+  def self.saddlebrown(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.saddlebrown(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === saddlebrown
+  # ========================================================================= #
+  def saddlebrown(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.saddlebrown(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.mediumseagreen
+  # ========================================================================= #
+  def self.mediumseagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumseagreen(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumseagreen
+  # ========================================================================= #
+  def mediumseagreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.mediumseagreen(i)
+  end
+
+  # ========================================================================= #
+  # === lightsteelblue
+  # ========================================================================= #
+  def lightsteelblue(i = '')
+    return COLOURS.lightsteelblue(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === dodgerblue
+  # ========================================================================= #
+  def dodgerblue(i = '')
+    return COLOURS.dodgerblue(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === chartreuse
+  # ========================================================================= #
+  def chartreuse(i = '')
+    return COLOURS.chartreuse(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.crimson
+  # ========================================================================= #
+  def self.crimson(i = '')
+    return COLOURS.crimson(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === dimgray
+  # ========================================================================= #
+  def dimgray(i = '')
+    return COLOURS.dimgray(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumorchid
+  # ========================================================================= #
+  def mediumorchid(i = '')
+    return COLOURS.mediumorchid(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.olivedrab
+  # ========================================================================= #
+  def self.olivedrab(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.olivedrab(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === olivedrab
+  # ========================================================================= #
+  def olivedrab(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.olivedrab(i)
+  end
+
+  # ========================================================================= #
+  # === efancy
+  # ========================================================================= #
+  def efancy(
+      i           = '',
+      use_colours = use_colours?
+    )
+    e sfancy(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.swarn
+  # ========================================================================= #
+  def self.swarn(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Colours.swarn(i) if Colours.use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === swarn
+  # ========================================================================= #
+  def swarn(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.swarn(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === ewarn
+  # ========================================================================= #
+  def ewarn(i = '')
+    e swarn(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.turquoise
+  # ========================================================================= #
+  def self.turquoise(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.turquoise(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.sdir
+  # ========================================================================= #
+  def self.sdir(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Colours.sdir(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.sdir(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.orangered
+  # ========================================================================= #
+  def self.orangered(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.orangered(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.darkolivegreen
+  # ========================================================================= #
+  def self.darkolivegreen(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.darkolivegreen(i) if COLOURS and use_colours 
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.deepskyblue
+  # ========================================================================= #
+  def self.deepskyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.deepskyblue(i) if COLOURS and use_colours 
+    return i
+  end
+
+  # ========================================================================= #
+  # === deepskyblue
+  # ========================================================================= #
+  def deepskyblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.deepskyblue(i) if COLOURS and use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.simp
+  #
+  # To test this method e. g. in IRB, do:
+  #
+  #   puts Studium::Colours.simp("yo there")
+  #
+  # ========================================================================= #
+  def self.simp(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Colours.simp(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.simp(i, use_colours)
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.royalblue
+  # ========================================================================= #
+  def self.royalblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.royalblue(i) if COLOURS and use_colours 
+    return i
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.use_this_colour_for_exam_answers
+  #
+  # This method can be used to modify the colours for exam-answers. It
+  # will write into the respective .yml file.
+  #
+  # Invocation example from the commandline:
+  #
+  #   studium --use-this-colour-for-exam-answers=slateblue
+  #
+  # ========================================================================= #
+  def self.use_this_colour_for_exam_answers(
+      i,
+      into = FILE_CUSTOM_COLOURS
+    )
+    if File.exist? into
+      use_this_regex = /(colour_for_answers: )(.+)$/
+      dataset = ::Studium.file_read_with_proper_encoding(into)
+      dataset.sub!(use_this_regex, '\1'+i)
+      e "Now writing into the file `#{sfile(into)}`."
+      ::Studium.save_what_into(dataset, into)
+      if ::Studium.is_on_roebe?
+        into = "#{RUBY_SRC_STUDIUM_LIB}studium/yaml/"\
+               "#{File.basename(into)}"
+        e "Now also writing into the file `#{sfile(into)}`."
+        ::Studium.save_what_into(dataset, into)
+      end
+    else
+      e "No file called #{into} exists."
+    end
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.use_this_colour_for_exam_questions
+  #
+  # This method can be used to modify the colours for exam-questions. It
+  # will write into the respective .yml file.
+  #
+  # Invocation example from the commandline:
+  #
+  #   studium --use-this-colour-for-exam-questions=slateblue
+  #
+  # ========================================================================= #
+  def self.use_this_colour_for_exam_questions(
+      i,
+      into = FILE_CUSTOM_COLOURS
+    )
+    if File.exist? into
+      use_this_regex = /(colour_for_questions: )(.+)$/
+      dataset = ::Studium.file_read_with_proper_encoding(into)
+      dataset.sub!(use_this_regex, '\1'+i)
+      e 'Now writing into the file `'+sfile(into)+'`.'
+      ::Studium.save_what_into(dataset, into)
+      if ::Studium.is_on_roebe?
+        into = "#{RUBY_SRC_STUDIUM_LIB}studium/yaml/"\
+               "#{File.basename(into)}"
+        e 'Now also writing into the file `'+sfile(into)+'`.'
+        ::Studium.save_what_into(dataset, into)
+      end
+    else
+      e "No file called #{into} exists."
+    end
+  end
+
+  # ========================================================================= #
+  # === Studium::Colours.sfile
+  # ========================================================================= #
+  def self.sfile(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Colours.sfile(i) if COLOURS and use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return ::Studium::Colours.sfile(i, use_colours)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.colour_for_ects_points
+#
+# Currently this will use mediumseagreen as the main colour.
+# =========================================================================== #
+def self.colour_for_ects_points(i = '')
+  ::Studium::Colours.mediumseagreen(i)
+end; self.instance_eval { alias colourize_ects colour_for_ects_points } # === Studium.colourize_ects
+     self.instance_eval { alias colour_ects    colour_for_ects_points } # === Studium.colour_ects
+
+# =========================================================================== #
+# === Studium.disable_colours
+# =========================================================================== #
+def self.disable_colours
+  ::Studium::Colours.disable_colours
+end
+
+# =========================================================================== #
+# === Studium.enable_colours
+# =========================================================================== #
+def self.enable_colours
+  ::Studium::Colours.enable_colours
+end
+
+# =========================================================================== #
+# === Studium.available_html_colours?
+# =========================================================================== #
+def self.available_html_colours?
+  ::Colours.available_html_colours?
+end
+
+# =========================================================================== #
+# === Studium.is_this_a_valid_html_colour?
+#
+# This method will delegate towards the Colours project, in order to
+# determine whether something is a valid HTML colour or not.
+# =========================================================================== #
+def self.is_this_a_valid_html_colour?(i)
+  return ::Colours.is_this_a_valid_html_colour?(i)
+end; self.instance_eval { alias is_a_valid_html_colour? is_this_a_valid_html_colour? } # === Studium.is_a_valid_html_colour?
+
+# =========================================================================== #
+# === Studium.use_colours?
+#
+# Simple query method over as to whether the Studium project makes use
+# of colours or whether it does not.
+# =========================================================================== #
+def self.use_colours?
+  ::Studium::Colours.use_colours?
+end
+
+# =========================================================================== #
+# === Studium.konsole_support?
+#
+# Whether we have "konsole support" - which for now is just a check
+# for colour-support.
+# =========================================================================== #
+def self.konsole_support?
+  Object.const_defined? :Colours
+end
+# =========================================================================== #
+# === Studium.crimson
+# =========================================================================== #
+def self.crimson(
+    i = '', use_colours = Colours.use_colours?
+  )
+  return ::Studium::Colours.crimson(i) if use_colours
+  return i
+end
+
+# =========================================================================== #
+# === Studium.slateblue
+# =========================================================================== #
+def self.slateblue(i = '')
+  return ::Studium::Colours.slateblue(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.lightgreen
+# =========================================================================== #
+def self.lightgreen(i = '')
+  return ::Studium::Colours.lightgreen(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.darkgreen
+# =========================================================================== #
+def self.darkgreen(i = '')
+  return ::Studium::Colours.darkgreen(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.turquoise
+# =========================================================================== #
+def self.turquoise(i = '')
+  return ::Studium::Colours.turquoise(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.orangered
+# =========================================================================== #
+def self.orangered(i = '')
+  return ::Studium::Colours.orangered(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.royalblue
+# =========================================================================== #
+def self.royalblue(i = '')
+  return ::Studium::Colours.royalblue(i) if Colours.use_colours?
+  return i
+end
+
+# =========================================================================== #
+# === Studium.sdir
+# =========================================================================== #
+def self.sdir(
+    i = '', use_colours = Colours.use_colours?
+  )
+  return ::Studium::Colours.sdir(i, use_colours)
+end
+
+# =========================================================================== #
+# === Studium.steelblue
+# =========================================================================== #
+def self.steelblue(
+    i = '', use_colours = Colours.use_colours?
+  )
+  return ::Studium::Colours.steelblue(i, use_colours)
+end
+
+# =========================================================================== #
+# === Studium.lightsalmon
+# =========================================================================== #
+def self.lightsalmon(i = '')
+  return ::Studium::Colours.lightsalmon(i)
+end
+
+# =========================================================================== #
+# === Studium.sfancy
+# =========================================================================== #
+def self.sfancy(
+    i = '', use_colours = Colours.use_colours?
+  )
+  return ::Studium::Colours.sfancy(i, use_colours)
+end
+
+# =========================================================================== #
+# === Studium.sfile
+# =========================================================================== #
+def self.sfile(i = '')
+  return ::Studium::Colours.sfile(i)
+end
+
+# =========================================================================== #
+# === Studium.simp
+# =========================================================================== #
+def self.simp(i = '')
+  return ::Studium::Colours.simp(i)
+end
+
+# =========================================================================== #
+# === Studium.rev
+# =========================================================================== #
+def self.rev
+  ::Studium::Colours.rev
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e 'Will we use colours? '+Studium.use_colours?.to_s
+  Studium.disable_colours
+  e 'Will we use colours? '+Studium.use_colours?.to_s
+  e
+  e Studium.sfancy('Hello world!')
+  e
+end