j1-template 2024.1.5 → 2024.2.1

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

@@ -25,63 +25,174 @@ description:
 defaults:
 
   # ----------------------------------------------------------------------------
-  # Settings
+  # Settings|Descriptions
   #
   #   enabled
   #   --------------------------------------------------------------------------
-  #   Enables or disables the Ad services. If disabled, no ads services are
-  #   enabled and no unit container get initialized on any page.
+  #   Enables or disables the module. If disabled, the Gemini module is NOT
+  #   loaded and no SERVICES are available on ANY PAGE.
   #
   #   values:                           [true|false]
   #   default:                          false
   #
-  #   detectGeoLocation
-  #   --------------------------------------------------------------------------
-  #   Enable|Disable the detection of the current GeoLocation.
-  #
-  #   values:                           false|true
-  #   default:                          false
-  #
   #   xhr_data_path
   #   --------------------------------------------------------------------------
   #   Full path of the HTML data file loaded|processed for the Gemini UI.
   #
-  #   values:                           string
+  #   value:                            string
   #   default:                          /assets/data/gemini-ui/index.html
   #
   #   xhr_container_id
   #   --------------------------------------------------------------------------
   #   ID of the container element the UI is placed.
   #
-  #   values:                           string
+  #   value:                            string
   #   default:                          gemini_ui
   #
   #   xhr_data_element
   #   --------------------------------------------------------------------------
   #   ID of the container element the UI is being read.
   #
-  #   values:                           string
+  #   value:                            string
   #   default:                          gemini_ui_container
   #
-  #   xhr_container_id
+  #   detect_geo_location
   #   --------------------------------------------------------------------------
-  #   ID of the container element the UI is placed.
+  #   Enable|Disable the detection of the current GeoLocation.
+  #
+  #   values:                           [true|false]
+  #   default:                          false
+  #
+  #   prompt_id
+  #   --------------------------------------------------------------------------
+  #   ID of the input element (textarea)
   #
   #   values:                           string
-  #   default:                          gemini_ui
+  #   default:                          prompt
   #
-  #   apiKey
+  #   prompt_history_id
   #   --------------------------------------------------------------------------
-  #   API key to be used for the Google Gemini API.
+  #   ID of the prompt history SELECT element. The ID equals 'id' in
+  #   slim_select USER config (slim_select.yml) for the select requested.
   #
   #   values:                           string
-  #   default:                          <your-api-key> (placeholder)
+  #   default:                          prompt_history
+  #
+  #   prompt_history_wrapper_id
+  #   --------------------------------------------------------------------------
+  #   ID of the promot history CONTAINER element. The ID equals 'wrapper_id'
+  #   in slim_select USER config (slim_select.yml) for the select requested.
+  #
+  #   values:                           string
+  #   default:                          prompt_history_select_wrapper
+  #
+  #   prompt_history_max
+  #   --------------------------------------------------------------------------
+  #   Limit the NUMBER of history elements.
+  #
+  #   values:                           integer [1 .. 30]
+  #   default:                          30
+  #
+  #   prompt_history_enabled
+  #   --------------------------------------------------------------------------
+  #   Enable|Disable the usage of the prompt history. If set to false.
+  #   NO prompt histoty is used.
+  #
+  #   values:                           [true|false]
+  #   default:                          false
+  #
+  #   prompt_history_from_cookie
+  #   --------------------------------------------------------------------------
+  #   Enable|Disable to write|read the prompt history a cookie (j1.chat_prompt).
+  #
+  #   values:                           [true|false]
+  #   default:                          false
+  #
+  #   allow_prompt_history_updates_on_max
+  #   --------------------------------------------------------------------------
+  #   If set to 'true', duplicates allowed in the prompt history.
+  #   If set to 'false', duplicates are removed from the prompt history.
+  #
+  #   values:                           [true|false]
+  #   default:                          true
+  #
+  #   prompt
+  #   --------------------------------------------------------------------------
+  #   Configureste UI input element (textarea).
+  #
+  #   values:
+  #
+  #     size:
+  #     ------------------------------------------------------------------------
+  #     Sets the SIZE of the input element (textarea) measured in LINES.
+  #
+  #     value:                           integer
+  #     default:                         7
+  #
+  #     title:
+  #     ------------------------------------------------------------------------
+  #     Sets the TITLE placed above the input element.
+  #
+  #     value:                           string
+  #     default:                         Your request
+  #
+  #     default:
+  #     ------------------------------------------------------------------------
+  #     Sets the PROMPT for a request if the input element is EMPTY.
+  #
+  #     value:                           string
+  #     default:                         Please provide tips on how using the prompt
+  #                                      for a chat bot.
+  #     placeholder:
+  #     ------------------------------------------------------------------------
+  #     Sets the PLACEHOLDER for the input element.
+  #
+  #     value:                           string
+  #     default:                         Please enter a clear and concise text that conveys
+  #                                      the task or question you want the chatbot to perform.
+  #
+  #   buttons
+  #   --------------------------------------------------------------------------
+  #   Configures the UI BUTTON elements. Settingd should NOT changed.
+  #
+  #   titles
+  #   --------------------------------------------------------------------------
+  #   Configureste UI TITLE elements.
+  #
+  #   result:
+  #   ------------------------------------------------------------------------
+  #   Sets the TITLE of the RESPONSE container element.
+  #
+  #   value:                           string
+  #   default:                         Response
+  #
+  #   request_history:
+  #   ------------------------------------------------------------------------
+  #   Sets the TITLE of the REQUEST HISTORY container element.
+  #
+  #   value:                           string
+  #   default:                         Request history
+  #
+  #   errorInfo:
+  #   ------------------------------------------------------------------------
+  #   Sets the TITLE of the ERROR element (modal).
+  #
+  #   value:                           string
+  #   default:                         API request failure
+  #
+  #   buttons
+  #   --------------------------------------------------------------------------
+  #   Configures the UI BUTTON elements. Button settingd should NOT changed.
+  #
+  #   api_options
+  #   --------------------------------------------------------------------------
+  #   Configures avaialve options to control the Gemini API-
   #
   #   responseLengthMin
   #   --------------------------------------------------------------------------
   #   Minimum number of characters returned by the Google Gemini API.
   #
-  #   values:                           integer
+  #   value:                            integer
   #   default:                          10
   #
   #   enableCandidateFeedback
@@ -115,51 +226,98 @@ defaults:
   #
   # ----------------------------------------------------------------------------
   #
+  # ----------------------------------------------------------------------------
+  # GENERAL options
+  # ----------------------------------------------------------------------------
+  #
   enabled:                              false
 
-  detectGeoLocation:                    false
+  xhr_data_path:                        /assets/data/gemini-ui/index.html
+  xhr_container_id:                     gemini_ui
+  xhr_data_element:                     gemini_ui_container
 
+  detect_geo_location:                  false
+
+  prompt_id:                            prompt
+  prompt_history_id:                    prompt_history
+  prompt_history_wrapper_id:            prompt_history_select_wrapper
+
+  # ----------------------------------------------------------------------------
+  # MODULE options
+  # ----------------------------------------------------------------------------
+  #
+  prompt_history_max:                   30
+  prompt_history_enabled:               false
+  prompt_history_from_cookie:           true
+  allow_prompt_history_updates_on_max:  true
+
+  # UI prompt (input)
+  # ----------------------------------------------------------------------------
   prompt:
-    title:                              Your request
-    default:                            Please provide tips on how using the prompt for a chat bot.
-    placeholder:                        Please enter a clear and concise text that conveys the task or question you want the chatbot to perform.
     size:                               7
+    title:                              Prompt
+    default: >
+                                        Please provide tips on how to use a prompt
+                                        for the chatbot
+    placeholder: >
+                                        Please enter a text describing the task or question
+                                        for which the chatbot should process
 
+  # UI buttons
+  # ----------------------------------------------------------------------------
   buttons:
-    generate:                           Generate
-    reset:                              Reset
+    generate:
+      id:                               send
+      name:                             Process prompt
+    reset:
+      id:                               reset
+      name:                             Clear prompt
+    clear:
+      id:                               clear
+      name:                             Clear last prompts
 
+  # UI titles
+  # ----------------------------------------------------------------------------
   titles:
     result:                             Response
+    request_history:                    Last Prompts
     errorInfo:                          API request failure
 
+  # Gemini API errors
+  # ----------------------------------------------------------------------------
   errors:
     http400:                            Location is not supported
     http500:                            Service currently not available
 
-  xhr_data_path:                        /assets/data/gemini-ui/index.html
-  xhr_container_id:                     gemini_ui
-  xhr_data_element:                     gemini_ui_container
-
   # ----------------------------------------------------------------------------
   # Gemini API options
   # ----------------------------------------------------------------------------
-  apiKey:                               <your-api-key>
-
-  responseLengthMin:                    10
-  enableCandidateFeedback:              true
-
-  safetyRatings:
-    HARM_CATEGORY_DANGEROUS_CONTENT:    BLOCK_MEDIUM_AND_ABOVE
-    HARM_CATEGORY_HARASSMENT:           BLOCK_ONLY_HIGH
-    HARM_CATEGORY_HATE_SPEECH:          BLOCK_ONLY_HIGH
-    HARM_CATEGORY_SEXUALLY_EXPLICIT:    BLOCK_NONE
-
-  candidateRatings:
-    HARM_CATEGORY_DANGEROUS_CONTENT:    BLOCK_MEDIUM_AND_ABOVE
-    HARM_CATEGORY_HARASSMENT:           BLOCK_ONLY_HIGH
-    HARM_CATEGORY_HATE_SPEECH:          BLOCK_ONLY_HIGH
-    HARM_CATEGORY_SEXUALLY_EXPLICIT:    BLOCK_NONE
+  #
+  api_options:
+    model:                              gemini-pro                              # gemini-pro (text only) | gemini-pro-vision (requires text and images)
+    maxApiRetries:                      3
+
+    responseLengthMin:                  10
+    enableCandidateFeedback:            true
+
+    generationConfig:
+      candidateCount:                   1                                       # currentely fixed to 1
+      maxOutputTokens:                  65536                                   # 32k:32768
+      temperature:                      0.5
+      topK:                             40
+      topP:                             0.5
+
+    safetyRatings:
+      HARM_CATEGORY_DANGEROUS_CONTENT:  BLOCK_MEDIUM_AND_ABOVE
+      HARM_CATEGORY_HARASSMENT:         BLOCK_ONLY_HIGH
+      HARM_CATEGORY_HATE_SPEECH:        BLOCK_ONLY_HIGH
+      HARM_CATEGORY_SEXUALLY_EXPLICIT:  BLOCK_NONE
+
+    candidateRatings:
+      HARM_CATEGORY_DANGEROUS_CONTENT:  BLOCK_MEDIUM_AND_ABOVE
+      HARM_CATEGORY_HARASSMENT:         BLOCK_ONLY_HIGH
+      HARM_CATEGORY_HATE_SPEECH:        BLOCK_ONLY_HIGH
+      HARM_CATEGORY_SEXUALLY_EXPLICIT:  BLOCK_NONE
 
 # ------------------------------------------------------------------------------
 # END config

data/lib/starter_web/_data/modules/defaults/{iconPicker.yml → icon_picker.yml}

@@ -24,19 +24,13 @@ description:
 #
 defaults:
   enabled:                              false
-  picker_button_id:                     icon_picker
 
-  iconLibraries:                        [
-                                          mdi-icons-base.min.json,
-                                          mdi-icons-light.min.json,
-                                          font-awesome.min.json
-                                        ]
-
-  iconLibrariesCss:                     [
-                                          https://cdnjs.cloudflare.com/ajax/libs/MaterialDesign-Webfont/7.2.96/css/materialdesignicons.min.css,
-                                          https://cdn.jsdelivr.net/npm/@mdi/light-font@0.2.63/css/materialdesignicons-light.min.css,
-                                          https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css
-                                        ]
+  # ----------------------------------------------------------------------------
+  # API options
+  # ----------------------------------------------------------------------------
+  #
+  api_options:
+    allowEmpty:                         false
 
 # ------------------------------------------------------------------------------
 # END config

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

@@ -23,8 +23,17 @@ description:
 # Default settings
 #
 defaults:
+
+  # ----------------------------------------------------------------------------
+  # GENERAL options
+  # ----------------------------------------------------------------------------
+  #
   enabled:                              false
 
+  # ----------------------------------------------------------------------------
+  # MODULE options
+  # ----------------------------------------------------------------------------
+  #
   placement:                            navbar
   target:                               _blank
   rebuild:                              false
@@ -51,20 +60,26 @@ defaults:
   #
   emptyMsg:                                                                     # '<p style="margin-left: 3.5rem">No matches.</p>'
 
-
   # ----------------------------------------------------------------------------
-  # TopSearch
-  #
+  # Search options
+  # ----------------------------------------------------------------------------
   topsearch:
     enabled:                            false
 
+    search_history_max:                 30
+    search_history_enabled:             false
+    search_history_from_cookie:         true
+    allow_history_updates_on_max:       true
+
+    search_history_id:                  search_history
+    search_history_wrapper_id:          search_history_select_wrapper
+
     container_id:                       search_modal
     type:                               quicksearch                             # quicksearch | elasticsearch
     icon_family:                        mdib
-    icon_color:                         "#FFFFFF"                               # md-white
+    icon_color:                         var(--bs-white)
     icon_size:                          mdib-2x
     search_icon:                        magnify
-    close_icon:                         close
     clear_icon:                         format-clear
     input_color:                        rgba(0, 0, 0, 0.7)                      # rgba-darken-700
     background_color:                   transparent                             # md-grey-50

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

@@ -32,7 +32,7 @@ defaults:
 
   icon_family:                          mdib
   icon_class:                           false                                   # false | fas | fab (Fontawsesome only)
-  icon_color:                           '#1E88E5'                               # md-blue-600
+  icon_color:                           var(--bs-blue)
   icon_size:                            2x
 
   # ----------------------------------------------------------------------------
@@ -114,7 +114,7 @@ defaults:
       dir:                              h
       inset:                            false
       align:                            bottom
-      color:                            '#3D3D3D'
+      color:                            var(--md-gray-800)
       hideUnder:                        null
       margin:                           10
       width:                            4
@@ -123,7 +123,7 @@ defaults:
       enabled:                          false
       autohide:                         false
       overVideo:                        true
-      color:                            '#A2A2A2'
+      color:                            var(--md-gray-300)
       radius:                           4
       stroke:                           10
       hideUnder:                        null
@@ -132,7 +132,7 @@ defaults:
       enabled:                          false
       autohide:                         false
       overVideo:                        true
-      color:                            '#FFFFFF'
+      color:                            var(--bs-white)
       hideUnder:                        null
       align:                            bottom
       inset:                            false

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

@@ -65,7 +65,7 @@ defaults:
   icon_color:                           mdib-grey
   icon_size:                            mdib-sm
 
-  nav_primary_color:                    "#2196F3"                               # md-blue, general color for navbar and nav-menus
+  nav_primary_color:                    var(--md-blue)
 
   # ----------------------------------------------------------------------------
   # NavBar
@@ -84,14 +84,14 @@ defaults:
     fixed:                              true
     style:                              overlay
     color:                              light
-    nav_item_color:                     '#212121'                               # gray-900|rgba-lighten
-    nav_item_color_hover:               '#EEEEEE'                               # gray-200|rgba-lighten-400
-    nav_item_background_image:          'linear-gradient(#afabab, #1c1c1c 40%, #212121);'
+    nav_item_color:                     var(--md-gray-900)
+    nav_item_color_hover:               var(--md-gray-300)
+    nav_item_background_image:          "linear-gradient(var(--md-gray-500), var(--md-gray-900) 60%, var(--md-gray-900));"
     position:                           left
     bottom_line_height:                 1
-    bottom_line_color:                  "#EEEEEE"                               # md-grey-200
-    background_color_full:              'rgba(255, 255, 255, 0.8)'              # rgba(0, 0, 0, 0.8) lighten-800
-    background_color_scrolled:          'var(--bs-primary)'                     # default: theme|bs-primary
+    bottom_line_color:                  var(--md-gray-300)
+    background_color_full:              rgba(255, 255, 255, 0.8)                # darken-800
+    background_color_scrolled:          var(--md-blue)
 
   # ----------------------------------------------------------------------------
   # NavMenu (Mobile)
@@ -132,13 +132,13 @@ defaults:
     menu_font_size:                     larger
     megamenu_font_size:                 small
     icon_family:                        mdib
-    icon_style:                         mdib                                    # far regular icon
-    icon_color:                         "#9E9E9E"                               # md-grey
+    icon_style:                         mdib
+    icon_color:                         var(--md-gray-500)
     icon_size:                          mdib-sm
-    menu_item_color:                    '#212121'                               # gray-900 rgba-lighten
-    menu_item_color_hover:              '#EEEEEE'                               # gray-500 rgba-lighten-900
+    menu_item_color:                    var(--md-gray-900)
+    menu_item_color_hover:              var(--md-gray-300)
     dropdown_style:                     raised
-    dropdown_color:                     '#2196f3'
+    dropdown_color:                     var(--md-blue)
     dropdown_left:                      12                                      # px
     dropdown_item_style:                flat
     dropdown_animate:                   false
@@ -150,12 +150,12 @@ defaults:
     dropdown_font_size:                 small
     dropdown_padding_x:                 18                                      # rem
     dropdown_padding_y:                 10                                      # px
-    dropdown_item_color:                "#212121"                               # md-grey-900
-    dropdown_border_color:              "#2196f3"                               # BS bg-primary
-    dropdown_border_top:                0                                       # 3, px
+    dropdown_item_color:                var(--md-gray-900)
+    dropdown_border_color:              var(--md-blue)
+    dropdown_border_top:                0                                       # px
     dropdown_border_radius:             2                                       # px
-    dropdown_background_color_hover:    "#ECEFF1"                               # md-bluegrey-50
-    dropdown_background_color_active:   "#CFD8DC"                               # md-bluegrey-100
+    dropdown_background_color_hover:    var(--md-gray-300)
+    dropdown_background_color_active:   var(--md-gray-500)
 
   # ----------------------------------------------------------------------------
   # NavQuicklinks
@@ -168,14 +168,14 @@ defaults:
     xhr_data_path:                      /assets/data/quicklinks/index.html
 
     icon_family:                        mdib
-    icon_color:                         '#212121'                               # gray-900
-    icon_color_hover:                   '#757575'                               # gray-600
+    icon_color:                         var(--md-gray-900)
+    icon_color_hover:                   var(--md-gray-500)
     icon_size:                          mdib-2x
 
     # Link buttons
     # --------------------------------------------------------------------------
     home_icon:                          home-variant
-    home_url:                           /                                       # URL | none (disables the home button)
+    home_url:                           /                                       # URL|none (disables the home button)
     home_label:                         Home
 
     disqus_icon:                        disqus
@@ -228,10 +228,6 @@ defaults:
     theme_toggler_action:               themeToggler
     theme_toggler_label:                Theme Toggler
 
-#   notebooks_icon:                     notebook
-#   notebooks_action:                   nbi-notebooks
-#   notebooks_label:                    NBI Notebooks
-
     r_text_icon:                        false                                   # format-text
     r_text_action:                      rtext
     r_text_label:                       Text Resizer

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

@@ -44,13 +44,13 @@ defaults:
           value_area:                   800
 
       color:
-        value:                          '#ffffff'
+        value:                          var(--bs-white)
 
       shape:
         type:                           circle
         stroke:
           width:                        0
-          color:                        '#ff0000'
+          color:                        var(--bs-red)
         polygon:
           nb_sides:                     5
         image:
@@ -79,7 +79,7 @@ defaults:
       line_linked:
         enable:                         true
         distance:                       100
-        color:                          '#ffffff'
+        color:                          var(--bs-white)
         opacity:                        1
         width:                          1
       move:

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

@@ -0,0 +1,54 @@
+# ------------------------------------------------------------------------------
+# ~/_data/modules/defaults/slimSelect.yml
+# Default configuration settings for J1 slimSelect module
+#
+# Product/Info:
+# https://jekyll.one
+#
+# Copyright (C) 2023, 2024 Juergen Adams
+#
+# J1 Template is licensed under the MIT License.
+# See: https://github.com/jekyll-one/J1 Theme/blob/master/LICENSE
+# ------------------------------------------------------------------------------
+
+# ------------------------------------------------------------------------------
+# Description
+#
+description:
+  title:                                J1 slimSelect
+  scope:                                Default settings
+  location:                             _data/modules/defaults/slim_select.yml
+
+# ------------------------------------------------------------------------------
+# Default settings
+#
+defaults:
+  enabled:                              false
+
+  # ----------------------------------------------------------------------------
+  # API options
+  # See: https://slimselectjs.com/settings
+  # ----------------------------------------------------------------------------
+  #
+  api_options:
+    showSearch:                         true
+    searchPlaceholder:                  Enter your search expression
+    searchText:                         No results
+    searchingText:                      Searching ...
+    searchHighlight:                    false
+    closeOnSelect:                      true
+  # contentLocation:                    document.getElementById('body')         # document.body, currently NOT supported
+    contentPosition:                    absolute
+    openPosition:                       auto                                    # options: auto, up, down
+    placeholderText:                    Select an item
+    allowDeselect:                      false
+    hideSelected:                       false
+    showOptionTooltips:                 false
+    minSelected:                        0
+    maxSelected:                        1
+    timeoutDelay:                       200
+    maxValuesShown:                     20
+    maxValuesMessage:                   '{number} selected'
+
+# ------------------------------------------------------------------------------
+# END config

data/lib/starter_web/_data/modules/defaults/{themer.yml → themes.yml}

@@ -1,6 +1,6 @@
 # ------------------------------------------------------------------------------
-# ~/_data/modules/defaults/themer.yml
-# Default configuration settings for J1 Themer
+# ~/_data/modules/defaults/themes.yml
+# Default configuration settings for J1 themes
 #
 # Product/Info:
 # https://jekyll.one
@@ -15,9 +15,9 @@
 # Description
 #
 description:
-  title:                                Themer
+  title:                                Themes
   scope:                                Default settings
-  location:                             _data/modules/defaults/themer.yml
+  location:                             _data/modules/defaults/themes.yml
 
 # ------------------------------------------------------------------------------
 # Default configuration settings
@@ -25,12 +25,12 @@ description:
 defaults:
 
   # ----------------------------------------------------------------------------
-  # Themer options
+  # Themes options
   # ----------------------------------------------------------------------------
   #
   #   enabled
   #   --------------------------------------------------------------------------
-  #   Enables|Disables the use of J1 Themer
+  #   Enables|Disables the use of J1 Themes
   #
   #     values:                         boolean (true|false)
   #     default:                        false
@@ -48,7 +48,7 @@ defaults:
   saveToCookie:                         true
 
   # ----------------------------------------------------------------------------
-  # Themer settings
+  # Themes settings
   # ----------------------------------------------------------------------------
   #
   #   cssThemeLink
@@ -155,11 +155,11 @@ defaults:
   retries:                              30                                      # retry to load theme list from API
   preview_page:                         /pages/public/tools/previewer/current_theme/
   menu_icon_family:                     mdib
-  menu_icon_color:                      "#9E9E9E"
+  menu_icon_color:                      var(--md-gray-500)
   menu_icon_size:                       mdib-sm
   cssThemeLink:                         bootstrapTheme
-  defaultCssFile:                       https://cdn.jsdelivr.net/npm/bootstrap@4.6.0/dist/css/bootstrap.min.css
-  bootswatchApiUrl:                     https://bootswatch.com/api
+  defaultCssFile:                       "https://cdn.jsdelivr.net/npm/bootstrap@4.6.0/dist/css/bootstrap.min.css"
+  bootswatchApiUrl:                     "https://bootswatch.com/api"
   bootswatchApiVersion:                 5
   loadFromBootswatch:                   true
   localThemes:                          /assets/data/themes.json