j1-template 2022.0.14 → 2022.0.18

data/lib/j1/utils.rb

@@ -1,11 +1,39 @@
+require "singleton"
+
 module J1
   module Utils
     extend self
     autoload :Ansi, "j1/utils/ansi"
-    autoload :Exec, "j1/utils/exec"
+    autoload :Exec1, "j1/utils/exec1"
+    autoload :Exec2, "j1/utils/exec2"
     autoload :Platforms, "j1/utils/platforms"
     autoload :WinTZ, "j1/utils/win_tz"
 
+    class GracefulQuit
+      include Singleton
+
+      attr_accessor :breaker
+
+      def initialize
+        self.breaker = false
+      end
+
+      def self.enable
+        trap('INT') {
+          yield if block_given?
+          self.instance.breaker = true
+        }
+      end
+
+      def self.check(message = "Quitting")
+        if self.instance.breaker
+          yield if block_given?
+          puts message
+          exit
+        end
+      end
+    end
+
     # Constants for use in #slugify
     SLUGIFY_MODES = %w(raw default pretty ascii).freeze
     SLUGIFY_RAW_REGEXP = Regexp.new('\\s+').freeze
@@ -13,6 +41,32 @@ module J1
     SLUGIFY_PRETTY_REGEXP = Regexp.new("[^[:alnum:]._~!$&'()+,;=@]+").freeze
     SLUGIFY_ASCII_REGEXP = Regexp.new("[^[A-Za-z0-9]]+").freeze
 
+    def is_project?
+      path = File.expand_path(Dir.pwd)
+      puts "Check consistency of the J1 project ..."
+      if File.exist?(path + '/package.json') && File.exist?(path + '/_config.yml')
+        return true
+      else
+        puts "\e[31m" + "FATAL: Path #{path} seems not a J1 project folder" + "\e[0m"
+      end
+    end
+
+    def is_project_setup?
+      path = File.expand_path(Dir.pwd)
+      puts "Check setup state of the J1 project ..."
+      if File.exist?(path + '/package-lock.json') && File.exist?(path + '/Gemfile.lock')
+        return true
+      else
+        puts "\e[31m" + "FATAL: Project in path #{path} seems not initialized" + "\e[0m"
+        puts "INFO: Consider to run 'j1 setup' in order to prepare the project for first use"
+      end
+    end
+
+    def is_windows?
+      #noinspection RubyResolve
+      RbConfig::CONFIG["host_os"] =~ %r!mswin|mingw|cygwin!i
+    end
+
     # Takes an indented string and removes the preceding spaces on each line
 
     def strip_heredoc(str)

data/lib/j1/version.rb

@@ -1,3 +1,3 @@
 module J1
-  VERSION = '2022.0.14'
+  VERSION = '2022.0.18'
 end

data/lib/starter_web/Gemfile

@@ -53,7 +53,7 @@ gem 'jekyll', '~> 4.2'
 
 # Theme Rubies, default: J1 Template (NOT used for the development system)
 #
-gem 'j1-template', '~> 2022.0.14'
+gem 'j1-template', '~> 2022.0.18'
 
 # ------------------------------------------------------------------------------
 # PRODUCTION: Gem needed for the Jekyll and J1 prod environment

data/lib/starter_web/_config.yml

@@ -53,7 +53,7 @@ environment:                            development
 # ------------------------------------------------------------------------------
 #   Sets the build version of J1 Template Gem
 #
-version:                                2022.0.14
+version:                                2022.0.18
 
 # version
 # ------------------------------------------------------------------------------

data/lib/starter_web/_data/apps/carousel.yml

@@ -47,148 +47,146 @@ settings:
   enabled:                              true
 
   # ----------------------------------------------------------------------------
-  # CAROUSEL configurations
+  # CAROUSEL options
   # ----------------------------------------------------------------------------
-
-    # ----------------------------------------------------------------------------
-    # CAROUSEL options
-    # ----------------------------------------------------------------------------
-    #
-    # enabled
-    # ----------------------------------------------------------------------------
-    #   Enables|Disables the use of the OwlCarousel
-    #
-    #   values:                           boolean (true|false)
-    #   default:                          false
-    #
-    # carousel
-    # ----------------------------------------------------------------------------
-    #  All shows are configured as elements of the carousel
-    #  array
-    #
-    #   enabled:
-    # ----------------------------------------------------------------------------
-    #   If enabled, show data (JSON) is generated
-    #
-    #       values:                       boolean (false|true)
-    #       default:                      no default
-    #
-    #   lightbox:
-    #   ---------------------------------------------------
-    #   If set to true, J1 Lightbox is enabled for all images
-    #   of that carousel|show
-    #
-    #   NOTE:
-    #   To use Lightbox with Owl Carousel, lazyLoad needs to
-    #   be enabled for the show to delay the load of images.
-    #   If lightbox is detected as ENABLED, lazyLoad is
-    #   automatically ENABLED as well.
-    #
-    #       values:                       boolean (false|true)
-    #       default:                      false
-    #
-    #   id
-    #   --------------------------------------------------------------------------
-    #   A unique id used to create and initialize a
-    #   (specific) carousel|show.
-    #
-    #       values:                       string
-    #       default:                      no defaults
-    #
-    #
-    #   item_type
-    #   --------------------------------------------------------------------------
-    #   For a slide show, images or text (HTML code) can be
-    #   used as items.
-    #
-    #       values:                       image|text
-    #       default:                      image
-    #
-    #   images
-    #   --------------------------------------------------------------------------
-    #   The images array specifies all images used by a
-    #   carousel as items. All images are to be configured
-    #   as a comma separated list (of image names with NO path).
-    #
-    #   NOTE:
-    #   Because NO individual path for images can be configured,
-    #   all image files are to be located in the SAME directory.
-    #
-    #       values:                       array|string (image names)
-    #       default:                      no defaults
-    #
-    #   slide_height
-    #   --------------------------------------------------------------------------
-    #   The images are scaled to 100 percent of height per
-    #   default. To reduce the height of the images of a
-    #   show, slide_height reduce the (viewport) height of
-    #   a show down to 10vh (vh, view height).
-    #
-    #   IMPORTANT:
-    #   This option can be used ONLY for SINGLE image shows
-    #   with option "singleItem" set to "true".
-    #
-    #   NOTE:
-    #   The view port units VH and VW are supported for
-    #   browsers supporting CSS3, only. The view port units
-    #   scale the view port of an HTML element (e.g DIV)
-    #   in relation to the current (window) size of the
-    #   browser.
-    #
-    #       values:                       integer [10 .. 100] (vh)
-    #       default:                      100
-    #
-    #   lb_caption
-    #   --------------------------------------------------------------------------
-    #   The lb_caption array specifies all CAPTION TEXT
-    #   used by the LIGHTBOX configured (if a lightbox is
-    #   enabled).
-    #
-    #   Caption text elements are to be configured as a
-    #   comma separated list of the SAME number as IMAGES
-    #   configured for a show.
-    #
-    #       values:                       array|string (caption text)
-    #       default:                      no defaults
-    #
-    #   images_path
-    #   --------------------------------------------------------------------------
-    #   Path to the IMAGES configured with the 'images'
-    #   sequence (array ).
-    #
-    #       values:                       string (path)
-    #       default:                      no defaults
-    #
-    #   text
-    #   --------------------------------------------------------------------------
-    #   If the slide show items are of type TEXT (item_type),
-    #   the text array specifies all text blocks (plain text
-    #   of HTML code) used by a carousel as show items. Text
-    #   items are configured as a comma separated list of
-    #   strings.
-    #
-    #       values:                       array|string (plain text OR HTML code)
-    #       default:                      no defaults
-    #
-    #   links
-    #   --------------------------------------------------------------------------
-    #   On all carousel items, links (URLs) can be specified.
-    #
-    #   NOTE:
-    #   The number of elements of the 'links' array has to be
-    #   the same as the images or text array. The links are
-    #   bound to the items the same order. The first link is
-    #   bound to the first image|text block, the second link
-    #   to the second image|text etc.
-    #
-    #       values:                       array|string (url)
-    #       default:                      no defaults
-    #
-    #
-    # ----------------------------------------------------------------------------
-
+  #
+  # enabled
+  # ----------------------------------------------------------------------------
+  #   Enables|Disables the use of the OwlCarousel
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          false
+  #
+  # carousel
+  # ----------------------------------------------------------------------------
+  #  All shows are configured as elements of the carousel
+  #  array
+  #
+  #   enabled:
+  # ----------------------------------------------------------------------------
+  #   If enabled, show data (JSON) is generated
+  #
+  #       values:                       boolean (false|true)
+  #       default:                      no default
+  #
+  #   lightbox:
+  #   ---------------------------------------------------
+  #   If set to true, J1 Lightbox is enabled for all images
+  #   of that carousel|show
+  #
+  #   NOTE:
+  #   To use Lightbox with Owl Carousel, lazyLoad needs to
+  #   be enabled for the show to delay the load of images.
+  #   If lightbox is detected as ENABLED, lazyLoad is
+  #   automatically ENABLED as well.
+  #
+  #       values:                       boolean (false|true)
+  #       default:                      false
+  #
+  #   id
+  #   --------------------------------------------------------------------------
+  #   A unique id used to create and initialize a
+  #   (specific) carousel|show.
+  #
+  #       values:                       string
+  #       default:                      no defaults
+  #
+  #
+  #   item_type
+  #   --------------------------------------------------------------------------
+  #   For a slide show, images or text (HTML code) can be
+  #   used as items.
+  #
+  #       values:                       image|text
+  #       default:                      image
+  #
+  #   images
+  #   --------------------------------------------------------------------------
+  #   The images array specifies all images used by a
+  #   carousel as items. All images are to be configured
+  #   as a comma separated list (of image names with NO path).
+  #
+  #   NOTE:
+  #   Because NO individual path for images can be configured,
+  #   all image files are to be located in the SAME directory.
+  #
+  #       values:                       array|string (image names)
+  #       default:                      no defaults
+  #
+  #   slide_height
+  #   --------------------------------------------------------------------------
+  #   The images are scaled to 100 percent of height per
+  #   default. To reduce the height of the images of a
+  #   show, slide_height reduce the (viewport) height of
+  #   a show down to 10vh (vh, view height).
+  #
+  #   IMPORTANT:
+  #   This option can be used ONLY for SINGLE image shows
+  #   with option "singleItem" set to "true".
+  #
+  #   NOTE:
+  #   The view port units VH and VW are supported for
+  #   browsers supporting CSS3, only. The view port units
+  #   scale the view port of an HTML element (e.g DIV)
+  #   in relation to the current (window) size of the
+  #   browser.
+  #
+  #       values:                       integer [10 .. 100] (vh)
+  #       default:                      100
+  #
+  #   lb_caption
+  #   --------------------------------------------------------------------------
+  #   The lb_caption array specifies all CAPTION TEXT
+  #   used by the LIGHTBOX configured (if a lightbox is
+  #   enabled).
+  #
+  #   Caption text elements are to be configured as a
+  #   comma separated list of the SAME number as IMAGES
+  #   configured for a show.
+  #
+  #       values:                       array|string (caption text)
+  #       default:                      no defaults
+  #
+  #   images_path
+  #   --------------------------------------------------------------------------
+  #   Path to the IMAGES configured with the 'images'
+  #   sequence (array ).
+  #
+  #       values:                       string (path)
+  #       default:                      no defaults
+  #
+  #   text
+  #   --------------------------------------------------------------------------
+  #   If the slide show items are of type TEXT (item_type),
+  #   the text array specifies all text blocks (plain text
+  #   of HTML code) used by a carousel as show items. Text
+  #   items are configured as a comma separated list of
+  #   strings.
+  #
+  #       values:                       array|string (plain text OR HTML code)
+  #       default:                      no defaults
+  #
+  #   links
+  #   --------------------------------------------------------------------------
+  #   On all carousel items, links (URLs) can be specified.
+  #
+  #   NOTE:
+  #   The number of elements of the 'links' array has to be
+  #   the same as the images or text array. The links are
+  #   bound to the items the same order. The first link is
+  #   bound to the first image|text block, the second link
+  #   to the second image|text etc.
+  #
+  #       values:                       array|string (url)
+  #       default:                      no defaults
+  #
+  #
+  # ----------------------------------------------------------------------------
+  #
   carousel:
-
+    # --------------------------------------------------------------------------
+    # CAROUSEL configurations
+    # --------------------------------------------------------------------------
 
     # --------------------------------------------------------------------------
     # demo_text_carousel

data/lib/starter_web/_data/blocks/banner.yml

@@ -197,17 +197,17 @@ settings:
                     href:               "https://rubygems.org/gems/j1-template"
                     target:             blank
 
-                - name:                 Quickstart
+                - name:                 Rocketstart
                   button:
-                    id:                 quickstart
-                    title:              Quickstart
-                    tagline:            finished in 15 minutes
-                    class:              btn btn-xl btn-primary text-uppercase text-left mr-2 mb-2
+                    id:                 rocketstart
+                    title:              Rocketstart
+                    tagline:            finished in minutes
+                    class:              btn btn-raised btn-xl btn-primary text-uppercase text-left mr-2 mb-2
                     style:              "min-width: 250px"
-                    icon:               briefcase-check-outline
+                    icon:               rocket-launch
                     icon_color:
                     icon_size:          3x
-                    href:               "https://jekyll.one/pages/public/learn/quickstart/"
+                    href:               "https://jekyll.one/pages/public/learn/rocketstart/"
                     target:             blank
 
     # --------------------------------------------------------------------------

data/lib/starter_web/_data/modules/defaults/dropdowns.yml

@@ -0,0 +1,164 @@
+# ------------------------------------------------------------------------------
+# ~/_data/modules/defaults/dropdowns.yml
+# Default Configuration of the Dropdowns Module
+#
+# Product/Info:
+# https://jekyll.one
+# https://materializecss.com/dropdown.html
+#
+# Copyright (C) 2021 Juergen Adams
+#
+# Materialize is licensed under the MIT License.
+# See: https://github.com/Dogfalo/materialize/blob/v1-dev/LICENSE
+# J1 Template is licensed under the MIT License.
+# See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
+#
+# ------------------------------------------------------------------------------
+# NOTE:
+#
+# ------------------------------------------------------------------------------
+
+# ------------------------------------------------------------------------------
+# Description (used for J1 CC only)
+#
+description:
+
+  title:                                Dropdowns Module
+  scope:                                Default settings
+  location:                             _data/modules/defaults/dropdowns.yml
+
+# ------------------------------------------------------------------------------
+# Default settings
+#
+defaults:
+  enabled:                              false
+
+  # ----------------------------------------------------------------------------
+  # DROPDOWN options
+  # ----------------------------------------------------------------------------
+  #
+  # enabled
+  # ----------------------------------------------------------------------------
+  #   Enables|Disables the use of the Dropdowns
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          false
+  #
+  # alignment
+  # ----------------------------------------------------------------------------
+  #  Defines the edge the menu is aligned to.
+  #
+  #   values:                           String (top|right|bottom|left)
+  #   default:                          left
+  #
+  # autoTrigger
+  # ----------------------------------------------------------------------------
+  #  If true, automatically focus dropdown el for keyboard.
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          true
+  #
+  # constrainWidth
+  # ----------------------------------------------------------------------------
+  #  If true, constrainWidth to the size of the dropdown activator.
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          true
+  #
+  # container
+  # ----------------------------------------------------------------------------
+  #  Defines the edge the menu is aligned to.
+  #
+  #   values:                           Element (HTML element|false)
+  #   default:                          false
+  #
+  # coverTrigger
+  # ----------------------------------------------------------------------------
+  #  If false, the dropdown will show below the trigger.
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          true
+  #
+  # closeOnClick
+  # ----------------------------------------------------------------------------
+  #  If true, close dropdown on item click.
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          true
+  #
+  # hover
+  # ----------------------------------------------------------------------------
+  #  If true, the dropdown will open on hover.
+  #
+  #   values:                           boolean (true|false)
+  #   default:                          false
+  #
+  # inDuration
+  # ----------------------------------------------------------------------------
+  #  The duration of the transition enter in milliseconds.
+  #
+  #   values:                           Number
+  #   default:                          150
+  #
+  # maxLenght
+  # ----------------------------------------------------------------------------
+  #  The max length of the dropdown menu in pixels. If the menu exeeds
+  #  the limit, scrollbars are shown to browse the menu.
+  #
+  #   values:                           Number
+  #   default:                          350
+  #
+  # outDuration
+  # ----------------------------------------------------------------------------
+  #  The duration of the transition out in milliseconds.
+  #
+  #   values:                           Number
+  #   default:                          250
+  #
+  # cbOnOpen
+  # ----------------------------------------------------------------------------
+  #  Function called when dropdown starts entering.
+  #
+  #   values:                           Function|false
+  #   default:                          false
+  #
+  # cbOnOpenEnd
+  # ----------------------------------------------------------------------------
+  #  Function called when dropdown finishes entering.
+  #
+  #   values:                           Function|false
+  #   default:                          false
+  #
+  # cbOnClose
+  # ----------------------------------------------------------------------------
+  #  Function called when dropdown starts exiting.
+  #
+  #   values:                           Function|false
+  #   default:                          false
+  #
+  # cbOnCloseEnd
+  # ----------------------------------------------------------------------------
+  #  Function called when dropdown finishes exiting.
+  #
+  #   values:                           Function|false
+  #   default:                          false
+  #
+  # ----------------------------------------------------------------------------
+  #
+  options:
+    alignment:                          left
+    autoTrigger:                        true
+    constrainWidth:                     true
+    container:                          false
+    coverTrigger:                       true
+    closeOnClick:                       true
+    hover:                              false
+    inDuration:                         150
+    outDuration:                        250
+    maxLenght:                          350
+    cbOnOpen:                           j1.adapter.dropdowns.cbOnOpen
+    cbOnClose:                          j1.adapter.dropdowns.cbOnClose
+    cbOnItemClick:                      false                                   # j1.adapter.dropdowns.cbOnItemClick
+
+# ------------------------------------------------------------------------------
+# END config

data/lib/starter_web/_data/modules/defaults/themer.yml

@@ -145,10 +145,11 @@ defaults:
   #
   enabled:                              false
 
+  debug:                                false
+  saveToCookie:                         true
+
   reloadPageOnChange:                   false                                   # reload current page, if theme has been changed
   retries:                              30                                      # retry to load theme list from API
-  saveToCookie:                         true
-  debug:                                false
   preview_page:                         /pages/public/previewer/theme/
   menu_icon_family:                     MDI
   menu_icon_color:                      "#9E9E9E"