j1-template 2022.1.0 → 2022.1.1

data/lib/starter_web/_data/apps/defaults/justifiedGalleryCustomizer.yml

@@ -25,13 +25,181 @@ description:
 #
 defaults:
 
+  # ----------------------------------------------------------------------------
+  # GENERAL gallery settings
+  #
+  # enabled
+  # ----------------------------------------------------------------------------
+  #   Enables|Disables the use of a gallery.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          false
+  #
+  # xhr_container_id
+  # ----------------------------------------------------------------------------
+  #   All data items displayed by a gallery are being read from a
+  #   JSON file automatically generated from that configuration.
+  #   AJAX get method is used to supply the gallery with respective
+  #   the HTML code at the time the gallery is initialized (by the
+  #   J1 Adapter for J1 Justified Gallery).
+  #
+  #   values:                           string
+  #   default:                          /assets/data/galleries.json
+  #
+  # xhr_data_element
+  # ----------------------------------------------------------------------------
+  #   All data items ...
+  #
+  #   values:                           string
+  #   default:                          galleryCustomizer
+  #
+  # xhr_data_path
+  # ----------------------------------------------------------------------------
+  #   All data items ...
+  #
+  #   values:                           string
+  #   default:                          /assets/data/galleries.json
+  #
+  # max_gallery_width
+  # ----------------------------------------------------------------------------
+  #   Total width (px) of an gallery element displayed in a page.
+  #
+  #   values:                           integer
+  #   default:                          1024
+  #
+  # ----------------------------------------------------------------------------
+  #
   enabled:                              false
   title:                                JustfiedGallery Customizer
 
   xhr_container_id:                     customizer
   xhr_data_element:                     galleryCustomizer
   xhr_data_path:                        /assets/data/gallery_customizer/index.html
+  max_gallery_width:                    1024
 
+  # ----------------------------------------------------------------------------
+  # GALLERY options
+  # ----------------------------------------------------------------------------
+  #
+  # rowHeight
+  # ----------------------------------------------------------------------------
+  #   The preferred rows height measured in pixel (px)
+  #
+  #   values:                           integer
+  #   default:                          200
+  #
+  # maxRowHeight
+  # ----------------------------------------------------------------------------
+  #  This option could be a false or negative value to keep it disabled.
+  #  Could be a number (e.g 200) which specifies the maximum row height in pixel.
+  #  Alternatively, a string which specifies a percentage (e.g. "200%" means
+  #  that the row height can't exceed 2 * rowHeight). Note that with this
+  #  option can crop the images if they need to be higher to be justified.
+  #
+  #   values:                           boolean [true|false] or integer
+  #   default:                          false
+  #
+  # maxRowsCount
+  # ----------------------------------------------------------------------------
+  #  This parameter limits the number of rows to show. Justified Gallery
+  #  hides the unwanted rows, and if the page is resized more (or less)
+  #  images are shown. Note that this this option doesn't limit the number
+  #  of rows by making images smaller. A value 0 means disabled.
+  #
+  #   values:                           integer
+  #   default:                          0
+  #
+  # justifyLastRow
+  # ----------------------------------------------------------------------------
+  #  Decide to justify the last row (using 'justify') or not (using
+  #  'nojustify')
+  #
+  #   values:                           value [justify|nojustify]
+  #   default:                          nojustify
+  #
+  # hideLastRow
+  # ----------------------------------------------------------------------------
+  #  Hide the last row.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          false
+  #
+  # margins
+  # ----------------------------------------------------------------------------
+  #  The margins between the images.
+  #
+  #   values:                           integer
+  #   default:                          1
+  #
+  # border
+  # ----------------------------------------------------------------------------
+  #  The border size of the gallery.
+  #
+  #   values:                           integer
+  #   default:                          0
+  #
+  # randomize
+  # ----------------------------------------------------------------------------
+  #  Automatically randomize or not the order of the images.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          false
+  #
+  # sort
+  # ----------------------------------------------------------------------------
+  #  Can be false to do not sort.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          false
+  #
+  # rtl
+  # ----------------------------------------------------------------------------
+  #  Right to left mode.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          false
+  #
+  # refreshTime
+  # ----------------------------------------------------------------------------
+  #  The waited time (ms) before checking the page size. If the page width
+  #  has changed the gallery layout is rebuilt.
+  #
+  #   values:                           integer
+  #   default:                          250
+  #
+  # refreshSensitivity
+  # ----------------------------------------------------------------------------
+  #  Change in width allowed (in px) without re-building the gallery.
+  #
+  #   values:                           integer
+  #   default:                          0
+  #
+  # cssAnimation
+  # ----------------------------------------------------------------------------
+  #  Use or not css animations. With CSS animations it's easier to change
+  #  them by overriding the rules defined by Justified Gallery.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          true
+  #
+  # imagesAnimationDuration
+  # ----------------------------------------------------------------------------
+  #  Image fadeIn duration (in milliseconds). This is ignored if CSS
+  #  animations are used.
+  #
+  #   values:                           integer
+  #   default:                          500
+  #
+    # captions
+  # ----------------------------------------------------------------------------
+  #  Decide if you want to show the captions that appears when your
+  #  mouse is over the image.
+  #
+  #   values:                           boolean [true|false]
+  #   default:                          true
+  #
+  # ----------------------------------------------------------------------------
+  #
   gallery_settings:
     rowHeight:                          200
     justifyLastRow:                     false

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

@@ -161,6 +161,7 @@ settings:
         id:                             home_news_panel
         comment:                        Home News Panel
         type:                           news
+        category_blacklist:             [ posts, public, private, protected, featured, series ]
         animate:                        false
         properties:                     mt-5 mb-5
 
@@ -176,6 +177,7 @@ settings:
                                         <p>
                                           Have fun!
                                         </p>
+
         cards:
 
           - name:                       Recent Posts

data/lib/starter_web/_data/j1_config.yml

@@ -146,7 +146,7 @@ cookies:
 
 
 # ==============================================================================
-# PAGE configuration settings
+# CONTENT configuration settings
 #
 # ------------------------------------------------------------------------------
 
@@ -174,6 +174,38 @@ flicker_timeout:                        150
 prettify:                               true
 
 
+# ==============================================================================
+# PAGE global configuration settings (currently NOT used)
+#
+# NOTE: Set global settings for the Jekyll builder-engine to control
+#       the HTML outputs generated by J1
+#
+# ------------------------------------------------------------------------------
+pages:
+
+
+# ==============================================================================
+# POST global configuration settings
+#
+# NOTE: Set global settings for the Jekyll builder-engine to control
+#       the HTML outputs generated by J1
+#
+# ------------------------------------------------------------------------------
+posts:
+  # ----------------------------------------------------------------------------
+  #   category_blacklist
+  #   --------------------------------------------------------------------------
+  #   List of categories (automatically) generated by Jekyll to be SKIPPED.
+  #   (Additional) Categories are generated by Jekyl from folder names but
+  #   NOT used for J1 to be displayed in preview boxes or J1 Posts Navigator
+  #   views.
+  #
+  #   Default:                          [ posts, public, private, protected, featured, series ]
+  #
+  # ----------------------------------------------------------------------------
+  category_blacklist:                   [ posts, public, private, protected, featured, series ]
+
+
 # ==============================================================================
 # USER configuration settings
 #

data/lib/starter_web/_data/layouts/app.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  #   Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
-  #   NOTE:
-  #     All pages are using a specific banner to display a title and a
-  #     tagline. Title and tagline are to be configured with the FRONTMATTER
-  #     of a page for individual data (text).
+  # NOTE:
+  #   All pages are using a specific header to display a title and a
+  #   tagline. Title and tagline are to be configured with the FRONTMATTER
+  #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,7 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  #   PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   #   NOTE:
   #     The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/article_navigator.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,7 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/blog_archive.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,7 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/collection.yml

@@ -105,23 +105,28 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
-      enabled:                      true
-      region:                       body-header
-      type:                         sync
-      base:                         _includes/themes/j1
-      path:                         modules/attics
-      file:                         generator.html
+      enabled:                          true
+      region:                           body-header
+      type:                             sync
+      base:                             _includes/themes/j1
+      path:                             modules/attics
+      file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # COLLECTION CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML
@@ -160,17 +165,6 @@ lanes:
       path:                             layouts
       file:                             content_generator_collection.html
 
-  # ----------------------------------------------------------------------------
-  # COMMENT connector
-  #
-  - lane:
-      enabled:                          true
-      region:                           body-main
-      type:                             sync
-      base:                             _includes/themes/j1
-      path:                             modules/connectors
-      file:                             comments
-
   # ----------------------------------------------------------------------------
   # FAM
   #
@@ -180,6 +174,5 @@ lanes:
       region:                           body-main
       type:                             async
 
-
 # ------------------------------------------------------------------------------
 # END config

data/lib/starter_web/_data/layouts/default.yml

@@ -104,7 +104,11 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # META data
+  # HEAD region
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # META data loader
   #
   - lane:
       enabled:                          true
@@ -114,39 +118,6 @@ lanes:
       path:                             layouts
       file:                             layout_metadata_generator.html
 
-  # ----------------------------------------------------------------------------
-  # CONNECTORS (analytics)
-  #
-  # - lane:
-  #     enabled:                          true
-  #     region:                           head
-  #     type:                             sync
-  #     base:                             _includes/themes/j1
-  #     path:                             modules/connectors
-  #     file:                             analytics
-
-  # ----------------------------------------------------------------------------
-  # CONNECTORS (translation)
-  #
-  # - lane:
-  #     enabled:                          true
-  #     region:                           head
-  #     type:                             sync
-  #     base:                             _includes/themes/j1
-  #     path:                             modules/connectors
-  #     file:                             translator
-
-  # ----------------------------------------------------------------------------
-  # CONNECTORS (advertising)
-  #
-  # - lane:
-  #     enabled:                          true
-  #     region:                           head
-  #     type:                             sync
-  #     base:                             _includes/themes/j1
-  #     path:                             modules/connectors
-  #     file:                             ads
-
   # ----------------------------------------------------------------------------
   # RESOURCE loader
   #
@@ -159,7 +130,11 @@ lanes:
       file:                             layout_resource_generator.html
 
   # ----------------------------------------------------------------------------
-  # NAVIGATION
+  # BODY region
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # NAVIGATION loader
   #
   - lane:
       enabled:                          true
@@ -194,7 +169,7 @@ lanes:
       class:
 
   # ----------------------------------------------------------------------------
-  # MODULE generator
+  # MODULE loader
   #
   - lane:
       enabled:                          true

data/lib/starter_web/_data/layouts/home.yml

@@ -105,40 +105,28 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # MASTER header
-  #
-  - lane:
-      enabled:                          true
-      region:                           body-header
-      type:                             sync
-      base:                             _includes/themes/j1
-      path:                             modules/attics
-      file:                             generator.html
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
 
   # ----------------------------------------------------------------------------
-  # MASTER slider
+  # MASTER header (attic)
   #
-  - lane:
-      enabled:                          false
-      id:                               master_slider
-      region:                           body-header
-      type:                             async
-      properties:                       mb-0
-
+  # NOTE:
+  #   All pages are using a specific header to display a title and a
+  #   tagline. Title and tagline are to be configured with the FRONTMATTER
+  #   of a page for individual data (text).
   # ----------------------------------------------------------------------------
-  # Top Advertisment
   #
   - lane:
       enabled:                          true
       region:                           body-header
-      id:                               google_ad_top_home
       type:                             sync
       base:                             _includes/themes/j1
-      path:                             modules/ads
-      file:                             google_ad_top_home.html
+      path:                             modules/attics
+      file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  #   PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   #   NOTE:
   #     The CONTENT of a post or page may already rendered (page contains HTML
@@ -166,6 +154,10 @@ lanes:
   #
   # ----------------------------------------------------------------------------
 
+  # ----------------------------------------------------------------------------
+  # CONTENT
+  #
+
   # ----------------------------------------------------------------------------
   # TEASER banner
   #

data/lib/starter_web/_data/layouts/news_panel_posts.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,7 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/page.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,18 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # Ad Block
-  #
-  # - lane:
-  #     enabled:                          false
-  #     region:                           body-header
-  #     type:                             sync
-  #     base:                             _includes/themes/j1
-  #     path:                             blocks/ads
-  #     file:                             ad.html
-
-  # ----------------------------------------------------------------------------
-  # PAGE CONTENT (region body-main)
+  # MAIN region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/post.yml

@@ -105,12 +105,17 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
       enabled:                          true
@@ -121,7 +126,7 @@ lanes:
       file:                             generator.html
 
   # ----------------------------------------------------------------------------
-  # POST CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML

data/lib/starter_web/_data/layouts/raw.yml

@@ -105,23 +105,28 @@
 lanes:
 
   # ----------------------------------------------------------------------------
-  # Page HEADER (region body-header)
+  # HEADER region (region body-header)
+  # ----------------------------------------------------------------------------
+
+  # ----------------------------------------------------------------------------
+  # MASTER header (attic)
   #
   # NOTE:
-  #   All pages are using a specific banner to display a title and a
+  #   All pages are using a specific header to display a title and a
   #   tagline. Title and tagline are to be configured with the FRONTMATTER
   #   of a page for individual data (text).
+  # ----------------------------------------------------------------------------
   #
   - lane:
-      enabled:                      true
-      region:                       body-header
-      type:                         sync
-      base:                         _includes/themes/j1
-      path:                         modules/attics
-      file:                         generator.html
+      enabled:                          true
+      region:                           body-header
+      type:                             sync
+      base:                             _includes/themes/j1
+      path:                             modules/attics
+      file:                             generator.html
 
   # ------------------------------------------------------------------------------
-  # PAGE CONTENT (region body-main)
+  # CONTENT region (region body-main)
   #
   # NOTE:
   #   The CONTENT of a post or page may already rendered (page contains HTML