j1-template 2023.0.16 → 2023.1.0

data/lib/starter_web/index.html

@@ -1,114 +1,129 @@
----
-layout:                                 home
-compress:                               true
-
-title:                                  Starter
-tagline:                                Build-In Theme
-description: >
-                                        The Jekyll One Starter theme gives web developers and
-                                        hobbyists a clean implementation in Jekyll for starting
-                                        new projects and combines the best of open source software
-                                        for the Web. Jekyll One is open source and the modules packed
-                                        as well. No pain for private or professional purposes.
-
-keywords: >
-                                        Jekyll, Jekyll, JekyllOne, Theme, Template, Ruby, Gem
-
-categories:                             [ Site ]
-tags:                                   [ Home ]
-
-robots:
-  index:                                true
-  follow:                               true
-
-image:
-  path:                                 /assets/images/modules/attics/1920x1280/kristopher-roller.jpg
-  width:                                1920
-  height:                               1200
-  alt:                                  Photo by Kristopher Roller on Unsplash
-
-personalization:                        false
-comments:                               false
-exclude_from_search:                    false
-fab_menu_id:                            default
-scrollbar:                              false
-toc:                                    false
-regenerate:                             false
-
-accordion:
-  debug:                                false
-  name:                                 custom_panel
-  id:                                   bs5_accordion
-
-  header:
-    title:                              Custom Panel
-    tagline:                            creating dynamic content
-    description: >
-                                        <p class="dropcap">
-                                          This is an example for a Custom Panel based on Bootstrap V5. The example
-                                          code for the <b>dynamic content</b> is taken from the Bootstrap V5 Doc
-                                          pages at:
-                                        </p>
-                                        <a class="ml-3 mb-5"
-                                           href="https://getbootstrap.com/docs/5.2/components/accordion/"
-                                           target="_blank" rel="noopener noreferrer">
-                                          Accordion · Bootstrap v5.2
-                                        </a>
-  elements:
-    - element:
-      expanded:                         true
-      title:                            "Accordion Item #1"
-      content: >
-                                        <strong>This is the first item's accordion body.</strong> It is shown by default,
-                                        until the collapse plugin adds the appropriate classes that we use to style each element.
-                                        These classes control the overall appearance, as well as the showing and hiding via CSS
-                                        transitions. You can modify any of this with custom CSS or overriding our default variables.
-                                        It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>,
-                                        though the transition does limit overflow.
-    - element:
-      title:                            "Accordion Item #2"
-      content: >
-                                        <strong>This is the second item's accordion body.</strong> It is hidden by default, until
-                                        the collapse plugin adds the appropriate classes that we use to style each element. These
-                                        classes control the overall appearance, as well as the showing and hiding via CSS transitions.
-                                        You can modify any of this with custom CSS or overriding our default variables. It's also worth
-                                        noting that just about any HTML can go within the <code>.accordion-body</code>, though the
-                                        transition does limit overflow.
-    - element:
-      title:                            "Accordion Item #3"
-      content: >
-                                        <strong>This is the third item's accordion body.</strong> It is hidden by default, until
-                                        the collapse plugin adds the appropriate classes that we use to style each element. These
-                                        classes control the overall appearance, as well as the showing and hiding via CSS transitions.
-                                        You can modify any of this with custom CSS or overriding our default variables. It's also worth
-                                        noting that just about any HTML can go within the <code>.accordion-body</code>, though the
-                                        transition does limit overflow.
-
-resources:                              [ animate, iconify, scroller ]
-resource_options:
-  - attic:
-      padding_top:                      600
-      slides:
-        - url:                          /assets/images/modules/attics/1920x1280/kristopher-roller.jpg
-          alt:                          Photo by Kristopher Roller on Unsplash
-          title:                        Starter
-          tagline:                      Build-In Theme
-          badge:
-            type:                       unsplash
-            author:                     Kristopher Roller
-            href:                       https://unsplash.com/@krisroller
----
-
-<pre>
-
-  This page is created by the layout: home.
-
-  If this text is displayed (instead of the home page expected),
-  something went  wrong with the layout definitions. Check  the
-  output of the Jekyll engine building this site.
-
-  Check the  contents   of folder _layouts. Verify  if the base
-  layout  "home" exists  and the  referring  chain
-  (inheritance) is correct.
-
-</pre>
+---
+layout:                                 home
+compress:                               true
+
+title:                                  Starter
+tagline:                                Build-In Theme
+description: >
+                                        The Jekyll One Starter theme gives web developers and
+                                        hobbyists a clean implementation in Jekyll for starting
+                                        new projects and combines the best of open source software
+                                        for the Web. Jekyll One is open source and the modules packed
+                                        as well. No pain for private or professional purposes.
+
+keywords: >
+                                        Jekyll, Jekyll, JekyllOne, Theme, Template, Ruby, Gem
+
+categories:                             [ Site ]
+tags:                                   [ Home ]
+
+robots:
+  index:                                true
+  follow:                               true
+
+# image:
+#   path:                               /assets/images/custom/header/avatar.svg
+#   width:                              1920
+#   height:                             1200
+#   alt:                                Family Cartoon
+
+
+# image:
+#   path:                               /assets/images/custom/header/family.svg
+#   width:                              1920
+#   height:                             1200
+#   alt:                                Family Cartoon
+
+image:
+  path:                                 /assets/images/modules/attics/1920x1280/kristopher-roller.jpg
+  width:                                1920
+  height:                               1200
+  alt:                                  Photo by Kristopher Roller on Unsplash
+
+personalization:                        false
+comments:                               false
+exclude_from_search:                    false
+fab_menu_id:                            default
+scrollbar:                              false
+toc:                                    false
+regenerate:                             false
+
+accordion:
+  enabled:                              false
+  debug:                                false
+
+  name:                                 custom_panel
+  id:                                   bs5_accordion
+
+  header:
+    title:                              Custom Panel
+    tagline:                            creating dynamic content
+    description: >
+                                        <p class="dropcap">
+                                          This is an example for a Custom Panel based on Bootstrap V5. The example
+                                          code for the <b>dynamic content</b> is taken from the Bootstrap V5 Doc
+                                          pages at:
+                                        </p>
+                                        <a class="ml-3 mb-5"
+                                           href="https://getbootstrap.com/docs/5.2/components/accordion/"
+                                           target="_blank" rel="noopener noreferrer">
+                                          Accordion · Bootstrap v5.2
+                                        </a>
+  elements:
+    - element:
+      expanded:                         true
+      title:                            "Accordion Item #1"
+      content: >
+                                        <strong>This is the first item's accordion body.</strong> It is shown by default,
+                                        until the collapse plugin adds the appropriate classes that we use to style each element.
+                                        These classes control the overall appearance, as well as the showing and hiding via CSS
+                                        transitions. You can modify any of this with custom CSS or overriding our default variables.
+                                        It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>,
+                                        though the transition does limit overflow.
+    - element:
+      title:                            "Accordion Item #2"
+      content: >
+                                        <strong>This is the second item's accordion body.</strong> It is hidden by default, until
+                                        the collapse plugin adds the appropriate classes that we use to style each element. These
+                                        classes control the overall appearance, as well as the showing and hiding via CSS transitions.
+                                        You can modify any of this with custom CSS or overriding our default variables. It's also worth
+                                        noting that just about any HTML can go within the <code>.accordion-body</code>, though the
+                                        transition does limit overflow.
+    - element:
+      title:                            "Accordion Item #3"
+      content: >
+                                        <strong>This is the third item's accordion body.</strong> It is hidden by default, until
+                                        the collapse plugin adds the appropriate classes that we use to style each element. These
+                                        classes control the overall appearance, as well as the showing and hiding via CSS transitions.
+                                        You can modify any of this with custom CSS or overriding our default variables. It's also worth
+                                        noting that just about any HTML can go within the <code>.accordion-body</code>, though the
+                                        transition does limit overflow.
+
+resources:                              [ animate, iconify, scroller ]
+resource_options:
+  - attic:
+      padding_top:                      600
+      slides:
+        - url:                          /assets/images/modules/attics/1920x1280/kristopher-roller.jpg
+          alt:                          Photo by Kristopher Roller on Unsplash
+          title:                        Starter
+          tagline:                      Build-In Theme
+          badge:
+            type:                       unsplash
+            author:                     Kristopher Roller
+            href:                       https://unsplash.com/@krisroller
+---
+
+<pre>
+
+  This page is created by the layout: home.
+
+  If this text is displayed (instead of the home page expected),
+  something went  wrong with the layout definitions. Check  the
+  output of the Jekyll engine building this site.
+
+  Check the  contents   of folder _layouts. Verify  if the base
+  layout  "home" exists  and the  referring  chain
+  (inheritance) is correct.
+
+</pre>

data/lib/starter_web/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "j1",
-  "version": "2023.0.16",
+  "version": "2023.1.0",
   "description": "J1 Theme Starter Web",
   "homepage": "https://your.site",
   "author": {
@@ -41,14 +41,14 @@
     "opt_skip_initial_build": "--skip-initial-build",
     "opt_webserver": "puma",
     "opt_interface": "0.0.0.0",
-    "opt_web_port": "20000",
-    "opt_web_url": "http://localhost:20000/",
-    "opt_app_port": "20010",
-    "opt_app_url": "http://localhost:20010/",
+    "opt_web_port": "30000",
+    "opt_web_url": "http://localhost:30000/",
+    "opt_app_port": "30010",
+    "opt_app_url": "http://localhost:30010/",
     "opt_profile": "",
     "opt_watch": "--watch",
     "opt_livereload": "--livereload",
-    "opt_livereload_port": "20001"
+    "opt_livereload_port": "30001"
   },
   "nbi": {
   "opt_output_type": "plain",
@@ -64,7 +64,7 @@
     "j1-app": "run-p -s app:*",
     "app:rackup": "cross-var cross-env INTERFACE=$npm_package_jekyll_opt_interface PORT=$npm_package_jekyll_opt_app_port bundle exec puma -C _data/puma/config.rb",
     "_app:jekyll": "cross-var cross-env JEKYLL_ENV=$npm_package_config_mode BUNDLE_GEMFILE=$npm_package_ruby_gemfile bundle exec jekyll b -c $npm_package_jekyll_configfile $npm_package_jekyll_opt_incremental --watch",
-    "_app:open": "npm run delay-3s && cross-var open-cli $npm_package_jekyll_opt_app_url",
+    "app:open": "npm run delay-3s && cross-var open-cli $npm_package_jekyll_opt_app_url",
     "delay-1s": "node ./node_modules/npm-delay 1000",
     "delay-2s": "node ./node_modules/npm-delay 2000",
     "delay-3s": "node ./node_modules/npm-delay 3000",
@@ -124,10 +124,10 @@
     "setup:detect-os": "echo Detect OS .. && cross-env if-env OS=Windows_NT && cross-var echo \"OS detected: $OS\" || OS=$(echo $(getos)) && echo \"OS detected: $OS\" && echo done.",
     "setup:site": "run-s -s build",
     "site": "run-p -s site:*",
-    "site:jekyll": "echo Startup the site .. && cross-env SINATRA_ACTIVESUPPORT_WARNING=false bundle exec jekyll s --incremental --livereload --livereload-port $npm_package_jekyll_opt_livereload_port --open",
+    "site:jekyll": "echo Startup the site .. && cross-env SINATRA_ACTIVESUPPORT_WARNING=false bundle exec jekyll s --incremental --livereload --skip-initial-build  --livereload-port $npm_package_jekyll_opt_livereload_port --watch --open 2>jekyll.err.log",
     "site:utilsrv": "npm --prefix ./utilsrv --silent run utilsrv",
     "j1-site": "run-p -s j1-site:*",
-    "j1-site:jekyll": "bundle exec jekyll s --incremental --livereload --open",
+    "j1-site:jekyll": "echo Startup the site .. && cross-env bundle exec jekyll s --incremental --livereload --skip-initial-build --livereload-port $npm_package_jekyll_opt_livereload_port --watch --open 2>jekyll.err.log",
     "j1-site:utilsrv": "npm --prefix ./utilsrv --silent run utilsrv",
     "bump": "run-s -s ver && run-s -s bump:* && run-s -s ver",
     "ver": "cross-var cross-env echo \"Project version: $npm_package_version\"",

data/lib/starter_web/pages/public/about/site.adoc

@@ -12,7 +12,7 @@ categories:                             [ About ]
 tags:                                   [ Site, Review ]
 
 image:
-  path:                                 /assets/images/modules/attics/1920x1280/j1-theme-mockup-1.jpg
+  path:                                 /assets/images/modules/attics/1920x1280/j1-starter-mockup-1.jpg
   width:                                1920
   height:                               1280
   alt:                                  J1 Theme Mockup
@@ -29,7 +29,7 @@ resource_options:
   - attic:
       padding_top:                      600
       slides:
-        - url:                          /assets/images/modules/attics/1920x1280/j1-theme-mockup-1.jpg
+        - url:                          /assets/images/modules/attics/1920x1280/j1-starter-mockup-1.jpg
           alt:                          J1 Themes Mockup
 ---
 

data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/documentation.adoc

@@ -30,7 +30,7 @@ exclude_from_search:                    false
 fab_menu_id:                            page_ctrl
 scrollbar:                              false
 toc:                                    true
-regenerate:                             true
+regenerate:                             false
 permalink:                              /pages/public/skeleton/documentation/
 
 resources:                              [ animate, clipboard, lightbox, rouge ]

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

@@ -245,7 +245,7 @@ site_category_word_list:    {{site_category_word_list | debug}}
             </p>
 
             </div>
-            <a class="card-link md-grey-900 text-lowercase"
+            <a class="card-link text-lowercase"
                href="{{post.url}}#readmore">
                {{readmore_text}} · {{post.tagline}}
             </a>

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

@@ -287,7 +287,7 @@ site_category_word_list:    {{site_category_word_list | debug}}
                   </p>
 
                   </div>
-                  <a class="card-link md-grey-900 text-lowercase"
+                  <a class="card-link text-lowercase"
                      href="{{post.url}}#readmore">
                      {{readmore_text}} · {{post.tagline}}
                   </a>

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

@@ -267,7 +267,7 @@ site_category_word_list:    {{site_category_word_list | debug}}
                 </p>
 
                 </div>
-                <a class="card-link md-grey-900 text-lowercase"
+                <a class="card-link text-lowercase"
                    href="{{post.url}}#readmore">
                    {{readmore_text}} · {{post.tagline}}
                 </a>

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

@@ -289,7 +289,7 @@ site_category_word_list:    {{site_category_word_list | debug}}
               </p>
 
               </div>
-              <a class="card-link md-grey-900 text-lowercase"
+              <a class="card-link text-lowercase"
                  href="{{post.url}}#readmore">
                  {{readmore_text}} · {{post.tagline}}
               </a>

data/lib/starter_web/pages/public/bookshelf/article_previewer/viewer_biography.adoc

@@ -0,0 +1,89 @@
+---
+title:                                  Biography
+tagline:                                Today's People
+date:                                   2023-01-29 00:00:00
+description: >
+                                        Today's people is a collection contains the biography's
+                                        of celebrities well known by most of us. Find the books issued
+                                        by musicans, actors and more.
+
+categories:                             [ Biography, Collection ]
+tags:                                   [ Preview ]
+
+image:
+  path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Giammarco on Unsplash
+
+fab_menu_id:                            open_toc
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/biography/
+
+resources:                              [ animate ]
+resource_options:
+  - attic:
+      padding_top:                      600
+      slides:
+        - url:                          /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+          alt:                          Photo by Giammarco on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Giammarco
+            href:                       https://unsplash.com/@giamboscaro
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set page (local) attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+{% comment %} Liquid procedures
+-------------------------------------------------------------------------------- {% endcomment %}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+{% capture create_collection_article_preview %}themes/{{site.template.name}}/procedures/collections/create_collection_article_preview.proc{% endcapture %}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="none" %}
+
+{% comment %} Debugging
+-------------------------------------------------------------------------------- {% endcomment %}
+{% comment %} site.biography: {{ site.biography | debug }} {% endcomment %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[role="dropcap"]
+A biography is a written account of a person's life, typically focusing on
+major achievements, events, and experiences. It can be a detailed record of
+a person's life, covering everything from their birth and childhood to their
+personal and professional accomplishments and even their death.
+
+[role="mb-4"]
+Biographies can be written by someone or someone else and found in various
+formats, including books, articles, and online sources. A biography aims to
+provide insight into a person's life, personality, and achievements and to
+inspire and inform readers about their accomplishments and contributions
+to society.
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Available articles
+
+[role="mb-4"]
+Find below all available articles in the collection. The content is
+automatically generated and taken from the articles this collection
+contains.
+
+++++
+<div class="row mb-4">
+  <div class="col-md-12 col-xs-12">
+    {% include {{create_collection_article_preview}} collection=site.biography %}
+  </div>
+</div>
+++++

data/lib/starter_web/pages/public/bookshelf/article_previewer/viewer_fantasy.adoc

@@ -0,0 +1,81 @@
+---
+title:                                  Fantasy
+tagline:                                Fantasy Literature
+date:                                   2023-01-29 00:00:00
+description: >
+                                        Fantasy Literature in the Book Shelf
+
+categories:                             [ Fantasy, Collection ]
+tags:                                   [ Preview ]
+
+image:
+  path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Giammarco on Unsplash
+
+robots:
+  index:                                false
+  follow:                               false
+
+fab_menu_id:                            open_toc
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/fantasy/
+
+resources:                              [ animate ]
+resource_options:
+  - attic:
+      padding_top:                      600
+      slides:
+        - url:                          /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+          alt:                          Photo by Giammarco on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Giammarco
+            href:                       https://unsplash.com/@giamboscaro
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+{% comment %} Liquid procedures
+-------------------------------------------------------------------------------- {% endcomment %}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+{% capture create_collection_article_preview %}themes/{{site.template.name}}/procedures/collections/create_collection_article_preview.proc{% endcapture %}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="none" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[role="dropcap"]
+The fantasy genre has become popular the past few years. Once a genre
+restricted to a few Tolkien fanatics and literature freaks, Fantasy has
+now gone mainstream in a big way, from the mega-popular Harry Potter series
+capturing the world's attention for a decade; brought Fantasy to readers of
+all ages.
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Available articles
+
+[role="mb-4"]
+Find below all available articles in the collection. The content is
+automatically generated and taken from the articles this collection
+contains.
+
+++++
+<div class="row mb-4">
+  <div class="col-md-12 col-xs-12">
+    {% include {{create_collection_article_preview}} collection=site.fantasy %}
+  </div>
+</div>
+++++

data/lib/starter_web/pages/public/bookshelf/article_previewer/viewer_romance.adoc

@@ -0,0 +1,81 @@
+---
+title:                                  Romance
+tagline:                                Romance Literature
+date:                                   2023-01-29 00:00:00
+description: >
+                                        Romance Literature in the Book Shelf
+
+categories:                             [ Romance, Collection ]
+tags:                                   [ Preview ]
+
+image:
+  path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Giammarco on Unsplash
+
+robots:
+  index:                                false
+  follow:                               false
+
+fab_menu_id:                            open_toc
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/romance/
+
+resources:                              [ animate ]
+resource_options:
+  - attic:
+      padding_top:                      600
+      slides:
+        - url:                          /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+          alt:                          Photo by Giammarco on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Giammarco
+            href:                       https://unsplash.com/@giamboscaro
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+{% comment %} Liquid procedures
+-------------------------------------------------------------------------------- {% endcomment %}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+{% capture create_collection_article_preview %}themes/{{site.template.name}}/procedures/collections/create_collection_article_preview.proc{% endcapture %}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="none" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[role="dropcap"]
+The romance genre is a popular category of books that consistently churns out
+bestsellers. The aim of the genre is simple, showcasing a love story where
+two people overcome adversity to obtain their happily ever after. According to
+the Romance Writers of America, women count for 82% percent of the genre’s
+readership.
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Available articles
+
+[role="mb-4"]
+Find below all available articles in the collection. The content is
+automatically generated and taken from the articles this collection
+contains.
+
+++++
+<div class="row mb-4">
+  <div class="col-md-12 col-xs-12">
+    {% include {{create_collection_article_preview}} collection=site.romance %}
+  </div>
+</div>
+++++