j1-template 2021.1.22 → 2021.1.23

data/lib/starter_web/_data/modules/infiniteScroll.yml

@@ -0,0 +1,66 @@
+# ------------------------------------------------------------------------------
+# ~/_data/modules/infiniteScroll.yml
+# User configuration for J1 infiniteScroll
+#
+# Product/Info:
+# https://jekyll.one
+#
+# Copyright (C) 2021 Juergen Adams
+#
+# J1 Template is licensed under the MIT License.
+# See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
+# ------------------------------------------------------------------------------
+
+# ------------------------------------------------------------------------------
+# About this configuration (used for J1 CC only)
+#
+about_config:
+
+  title:                                infiniteScroll
+  scope:                                User settings
+  location:                             _data/modules/infiniteScroll.yml
+
+# ------------------------------------------------------------------------------
+# User configuration settings
+#
+settings:
+  enabled:                              true
+
+  scrollers:
+
+    # ==========================================================================
+    # Image Galleries
+    #
+
+    # --------------------------------------------------------------------------
+    # News Panel
+    #
+    - scroller:
+        enabled:                        true
+        id:                             home_news_panel
+        data_path:                      /assets/data/news_panel_posts
+        pages:                          "page${pageNumber}/index.html"
+        lastPage:                       4
+        history:                        false
+        scrollThreshold:                10
+        scrollOffset:                   470
+        checkLastPage:                  true
+        check_status:                   true
+
+    # --------------------------------------------------------------------------
+    # Article Navigator
+    #
+    - scroller:
+        enabled:                        true
+        id:                             article_navigator
+        data_path:                      /assets/data/article_navigator
+        pages:                          "page${pageNumber}/index.html"
+        lastPage:                       4
+        history:                        false
+        scrollThreshold:                10
+        scrollOffset:                   470
+        checkLastPage:                  true
+        check_status:                   true
+
+# ------------------------------------------------------------------------------
+# END config

data/lib/starter_web/_data/resources.yml

@@ -1260,5 +1260,48 @@ resources:
         js:                             []
         init_function:                  [ j1.adapter.rtextResizer.init ]
 
+  # ----------------------------------------------------------------------------
+  # infiniteScroll
+  # NOTE: https://infinite-scroll.com/
+  #
+  - name:                               infiniteScroll
+    resource:
+      id:                               infinitescroll
+      enabled:                          true
+      comment:                          J1 infiniteScroll
+      region:                           head
+      layout:                           [ all ]
+      required:                         ondemand                                # always | ondemand
+      preload:                          false                                   # property currently unused
+      script_load:                      defer
+      dependencies:                     false
+      pass_init_data:                   false
+      data:
+        css:                            [ modules/infiniteScroll/css/theme/uno ]
+        files:                          [ adapter/js/infiniteScroll.js ]
+        js:                             [ modules/infiniteScroll/js/infiniteScroll ]
+        init_function:                  [ j1.adapter.infiniteScroll.init ]
+
+  # ----------------------------------------------------------------------------
+  # infiniteScroll
+  # NOTE: https://infinite-scroll.com/
+  #
+  - name:                               showOnScroll
+    resource:
+      id:                               showonscroll
+      enabled:                          true
+      comment:                          J1 showOnScroll
+      region:                           head
+      layout:                           [ all ]
+      required:                         ondemand                                # always | ondemand
+      preload:                          false                                   # property currently unused
+      script_load:                      defer
+      dependencies:                     false
+      pass_init_data:                   false
+      data:
+        css:                            []
+        files:                          []
+        js:                             [ modules/showOnScroll/js/showOnScroll ]
+        init_function:                  []
 # ------------------------------------------------------------------------------
 # END config

data/lib/starter_web/_includes/attributes.asciidoc

@@ -423,7 +423,7 @@ end::tables[]
 // -----------------------------------------------------------------------------
 tag::products[]
 :j1--license:                                     MIT License
-:j1--version:                                     2021.1.22
+:j1--version:                                     2021.1.23
 :j1--site-name:                                   Jekyll One
 end::products[]
 

data/lib/starter_web/_plugins/lunr_index.rb

@@ -364,6 +364,6 @@ end
 
 module Jekyll
   module J1LunrSearch
-    VERSION = '2021.1.22'
+    VERSION = '2021.1.23'
   end
 end

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-01-post-test-series.adoc

@@ -6,7 +6,7 @@ categories:                             [ Examples ]
 tags:                                   [ Series, Test ]
 
 series:                                 test-series
-
+image:                                  /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
 regenerate:                             false
 
 resources:                              []
@@ -33,7 +33,7 @@ resource_options:
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-[role="dropcap"]
+[role="dropcap mt-3"]
 This post is a *test series element*. Post series can help to split larger
 posts into a group of smaller articles. This may helpful, if a large post
 should be split into several *main chapters* but grouped together.

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-02-post-test-series.adoc

@@ -6,6 +6,7 @@ categories:                             [ Examples ]
 tags:                                   [ Series, Test ]
 
 series:                                 test-series
+image:                                  /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
 
 regenerate:                             false
 
@@ -33,7 +34,7 @@ resource_options:
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-[role="dropcap"]
+[role="dropcap mt-3"]
 This post is a *test series element*. Post series can help to split larger
 posts into a group of smaller articles. This may helpful, if a large post
 should be split into several *main chapters* but grouped together.

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-03-post-test-series.adoc

@@ -6,6 +6,7 @@ categories:                             [ Examples ]
 tags:                                   [ Series, Test ]
 
 series:                                 test-series
+image:                                  /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
 
 regenerate:                             false
 
@@ -33,7 +34,7 @@ resource_options:
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-[role="dropcap"]
+[role="dropcap mt-3"]
 This post is a *test series element*. Post series can help to split larger
 posts into a group of smaller articles. This may helpful, if a large post
 should be split into several *main chapters* but grouped together.

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-04-post-test-series.adoc

@@ -6,6 +6,7 @@ categories:                             [ Examples ]
 tags:                                   [ Series, Test ]
 
 series:                                 test-series
+image:                                  /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
 
 regenerate:                             false
 
@@ -33,7 +34,7 @@ resource_options:
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-[role="dropcap"]
+[role="dropcap mt-3"]
 This post is a *test series element*. Post series can help to split larger
 posts into a group of smaller articles. This may helpful, if a large post
 should be split into several *main chapters* but grouped together.

data/lib/starter_web/index.html

@@ -31,7 +31,7 @@ toc:                                    false
 
 regenerate:                             true
 
-resources:                              []
+resources:                              [ animate, infinitescroll, showonscroll ]
 resource_options:
   - attic:
       padding_top:                      400
@@ -41,7 +41,6 @@ resource_options:
         - url:                          /assets/images/modules/attics/runner-1920x1200.jpg
 ---
 
-
 <pre>
   This page is created by the layout: {{ page.layout }}.
 

data/lib/starter_web/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "j1_starter",
-  "version": "2021.1.22",
+  "version": "2021.1.23",
   "description": "J1 Template Starter Web",
   "homepage": "https://your.site",
   "author": {

data/lib/starter_web/pages/public/blog/navigator/archive/categoryview.html

@@ -205,20 +205,20 @@ site_category_word_list:    {{site_category_word_list | debug}}
               {% if post.image %}
               <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image is available] -->
               <div class="col-md-6 img-bg--fill px-0"
-                style="background-image: url({{post.image}});">
+                style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{post.image}});">
               </div>
               {% else %}
               <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image missing, using configured default image] -->
               <div class="col-md-6 img-bg--fill px-0"
-                style="background-image: url({{blog_navigator_options.post_image}});">
+                style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{blog_navigator_options.post_image}});">
               </div>
               {% endif %}
 
-              <div class="col-md-6">
-                <div class="card-body r-text-300">{{excerpt}}</div>
+              <div class="col-md-6 p-0">
+                <div class="card-body r-text-300 mt-4">{{excerpt}}</div>
                 <div class="card-footer r-text-200">
                   <div class="card-footer-text">
-                    <hr class="my-3">
+
                     {% if post.date %}
                       {% if language == "en" %}
                         <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date | localize: "%Y %B, %e"}}

data/lib/starter_web/pages/public/blog/navigator/archive/dateview.html

@@ -189,20 +189,20 @@ site_category_word_list:    {{site_category_word_list | debug}}
             {% if post.image %}
             <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image is available] -->
             <div class="col-md-6 img-bg--fill px-0"
-              style="background-image: url({{post.image}});">
+              style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{post.image}});">
             </div>
             {% else %}
             <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image missing, using configured default image] -->
             <div class="col-md-6 img-bg--fill px-0"
-              style="background-image: url({{blog_navigator_options.post_image}});">
+              style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{blog_navigator_options.post_image}});">
             </div>
             {% endif %}
 
-            <div class="col-md-6">
-              <div class="card-body r-text-300">{{excerpt}}</div>
+            <div class="col-md-6 p-0">
+              <div class="card-body r-text-300 mt-4">{{excerpt}}</div>
               <div class="card-footer r-text-200">
                 <div class="card-footer-text">
-                  <hr class="my-3">
+
                   {% if post.date %}
                     {% if language == "en" %}
                       <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date|localize: "%Y %B, %e"}}

data/lib/starter_web/pages/public/blog/navigator/archive/tagview.html

@@ -238,20 +238,20 @@ site_category_word_list:    {{site_category_word_list | debug}}
           {% if post.image %}
           <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image is available] -->
           <div class="col-md-6 img-bg--fill px-0"
-            style="background-image: url({{post.image}});">
+            style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{post.image}});">
           </div>
           {% else %}
           <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image missing, using configured default image] -->
           <div class="col-md-6 img-bg--fill px-0"
-            style="background-image: url({{blog_navigator_options.post_image}});">
+            style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{blog_navigator_options.post_image}});">
           </div>
           {% endif %}
 
-          <div class="col-md-6">
-            <div class="card-body r-text-300">{{excerpt}}</div>
+          <div class="col-md-6 p-0">
+            <div class="card-body r-text-300 mt-4">{{excerpt}}</div>
             <div class="card-footer r-text-200">
               <div class="card-footer-text">
-                <hr class="my-3">
+
                 {% if post.date %}
                   {% if language == "en" %}
                     <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date | localize: "%Y %B, %e"}}

data/lib/starter_web/pages/public/blog/navigator/archive.html

@@ -1,9 +1,8 @@
 ---
 layout:                                 page
-title:                                  Creators Blog
+title:                                  Blog Archive
 tagline:                                all posts
-description: >
-                                        Browse all articles provided by this website
+description:                            Create index pages for articles this website
 
 categories:                             [ Blog ]
 tags:                                   [ Navigator, Archive ]
@@ -16,7 +15,7 @@ pagination:
   enabled:                              false
   permalink:                            /page:num/
 
-analytics:                              true
+analytics:                              false
 advertising:                            false
 comments:                               false
 
@@ -163,20 +162,20 @@ site_category_word_list:    {{site_category_word_list | debug}}
         {% if post.image %}
         <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image is available] -->
         <div class="col-md-6 img-bg--fill px-0"
-          style="background-image: url({{post.image}});">
+          style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{post.image}});">
         </div>
         {% else %}
         <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image missing, using configured default image] -->
         <div class="col-md-6 img-bg--fill px-0"
-          style="background-image: url({{blog_navigator_options.post_image}});">
+          style="border-right: 1px dotted rgba(0, 0, 0, 0.25); background-image: url({{blog_navigator_options.post_image}});">
         </div>
         {% endif %}
 
-        <div class="col-md-6">
-          <div class="card-body r-text-300">{{excerpt}}</div>
+        <div class="col-md-6 p-0">
+          <div class="card-body r-text-300  mt-4">{{excerpt}}</div>
           <div class="card-footer r-text-200">
             <div class="card-footer-text">
-              <hr class="my-3">
+
               {% if post.date %}
                 {% if language == "en" %}
                   <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date | localize: "%Y %B, %e"}}

data/lib/starter_web/pages/public/learn/quickstart.adoc

@@ -3,9 +3,10 @@ title:                                  Quickstart
 tagline:                                an amazing site in 15 minutes
 date:                                   2021-03-07 00:00:00
 description: >
-                                        Welcome to the pages of J1 Template. If your here
-                                        first time, a good decision you get on that page first.
-                                        For sure, there is no better place to go.
+                                        The template comes with a Web included, a skeleton for
+                                        a new website created with J1 Template. This Web is called
+                                        the "Starter web", a general-purpose scaffold to be modified
+                                        for your needs.
 
 categories:                             [ Knowledge ]
 tags:                                   [ J1, Template, Quickstart ]
@@ -55,24 +56,14 @@ resource_options:
 // Include sub-documents
 // -----------------------------------------------------------------------------
 
-*All you need for your new amazing site.*
-
-Jekyll meets Bootstrap - and makes a lot of friends. J1 Template combines
-the best of OpenSource software for the Web and the Web site generator
-`Jekyll`. J1 is OpenSource, and so are the packaged modules. No pain for
-private or professional use. Check J1 Template today to learn what's possible
-if you go to the Jekyll Way.
-
-*Create powerful modern Static Webs: Secure, Flexible and Fast.*
-
-The template comes with a Web included, a skeleton for new website created
-with J1 Template. This Web is called the *Starter Web*, a general-purpose
-Website scaffold to be modified for your needs. The built-in Starter Web
-can be visited live at https://publish.jekyll.one/[J1 Publish, {browser-window--new}].
-This site show live pages deployed on the Internet on _Github_, _Netlify_
+The template comes with a Web included, a skeleton for new a website created
+using J1 Template. This Web is called the *Starter web*, a general-purpose
+scaffold to be modified for your needs. The built-in Starter web  is available
+live at https://publish.jekyll.one/[J1 Publish, {browser-window--new}]. This
+site show live pages deployed on the Internet on _Github_, _Netlify_
 and _Heroku_.
 
-*Have fun exploring what a modern static web, a Jekyll site can do*!
+A *Starter web* is created in minutes. This section
 
 == The Software needed
 
@@ -98,9 +89,9 @@ NOTE: More current or older versions may work, but not tested.
 
 === Software upgrades needed for all platforms
 
-If _Ruby_ and _NodeJS_ are in place, some packages are to be upgraded to
+If _Ruby_ and _NodeJS_ are in place, some packages needs to be upgraded to
 more *current* versions. Install all packages system-wide with their
-respective product installation pathes.
+respective product installation paths.
 
 ==== Upgrades needed for Ruby < v2.7
 
@@ -201,7 +192,7 @@ If a *project* (a website) is generated, all development tasks are managed
 by *NPM scripts* (NodeJS). Development *tasks* are defined as *scripts*
 with the project config file `package.json`.
 
-First, create a projects folder for all website to be generated J1. For the
+First, create a projects folder for all websites to be generated J1. For the
 following examples, a project is generated on _Windows_ using *C:\Temp*
 for the project's folder.
 
@@ -278,7 +269,7 @@ as below:
 The first step, done only once, is to initialize a project. What means to
 download and install all resources for your new website followed by an
 initial creation process for the new site. Initializing a project is managed
-by the (NPM) *task* `setup`. A bunch of sub-tasks get fired, all of them
+by the (NPM) *task* `setup`. A bunch of sub-tasks gets fired, all of them
 managed by NPM.
 
 Let's start ...
@@ -326,12 +317,11 @@ To open the site, run: yarn site
 Done in 88.03s.
 ----
 
-The `setup` process will take a while - typically some minutes for the
-*first* run (depending on the performances of your Internet connection
-and your workstation). A bunch of NPM modules and Ruby Gems are downloaded
-and linked for the components part of the project. See `setup` as an extended
-*install* and *build* process to manage an initial setup for your new
-website.
+The `setup` process will take a while. Typically some minutes for the *first*
+run, depending on your Internet connection bandwidth and the workstation
+performance. Many NPM modules and Ruby Gems are downloaded and linked for
+the components part of the project. See `setup` as an extended *install* and
+*build* process to manage your new website's initial setup.
 
 === Run and develop a starter web
 
@@ -373,10 +363,11 @@ Go, go, go ..
 === Rebuild a site
 
 A project runs Jekyll in *incremental* mode with *auto-regeneration* enabled.
-All changes made to the pages (posts) of your web at runtime are automatically
-detected and the affected are rebuild and (live) reloaded.
+All changes made to your web's pages and posts at runtime are automatically
+detected, and the affected pages are rebuilt  and automatically reloaded with
+your browser.
 
-To rebuild the *site* from the scratch, a web can be completely rebuild by
+For rebuilding a *site* from scratch, a web can be completely rebuilt by
 running the task `rebuild`:
 
 [source, sh]