j1-template 2023.1.0 → 2023.2.0

data/lib/starter_web/index.html

@@ -1,129 +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/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>
+---
+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
+
+toc:                                    false
+fab_menu_id:                            default
+scrollbar:                              false
+comments:                               false
+personalization:                        false
+exclude_from_search:                    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.1.0",
+  "version": "2023.2.0",
   "description": "J1 Theme Starter Web",
   "homepage": "https://your.site",
   "author": {

data/lib/starter_web/pages/public/learn/bookshelf/article_previewer/viewer_all_books.adoc

@@ -0,0 +1,107 @@
+---
+title:                                  Bookshelf
+tagline:                                All Books
+date:                                   2023-01-29 00:00:00
+description: >
+                                        All available articles in the Bookshelf. The content is
+                                        automatically generated and taken from the articles of the
+                                        collections in the Bookshelf contains.
+
+categories:                             [ Books ]
+tags:                                   [ Bookshelf ]
+
+image:
+  path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Giammarco on Unsplash
+
+toc:                                    true
+fab_menu_id:                            open_toc
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/bookshelf/
+
+resources:                              [ animate, masonry ]
+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
+site.biography: {{ site.biography | debug }}
+-------------------------------------------------------------------------------- {% endcomment %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[role="dropcap"]
+Find below all available articles in the Bookshelf. The content is
+automatically generated and taken from the articles of the `collections`
+the *Bookshelf* contains:
+
+* Biography
+* Fantasy
+* Romance
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Biography
+
+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.
+
+masonry::collection_biography[role="mb-5"]
+
+== Fantasy
+
+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.
+
+masonry::collection_fantasy[role="mb-5"]
+
+== Romance
+
+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.
+
+masonry::collection_romance[role="mb-5"]

data/lib/starter_web/pages/public/{bookshelf → learn/bookshelf}/article_previewer/viewer_biography.adoc

@@ -7,8 +7,8 @@ description: >
                                         of celebrities well known by most of us. Find the books issued
                                         by musicans, actors and more.
 
-categories:                             [ Biography, Collection ]
-tags:                                   [ Preview ]
+categories:                             [ Books ]
+tags:                                   [ Biography, Preview ]
 
 image:
   path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
@@ -16,11 +16,12 @@ image:
   height:                               1280
   alt:                                  Photo by Giammarco on Unsplash
 
-fab_menu_id:                            open_toc
+toc:                                    false
+fab_menu_id:                            default
 regenerate:                             false
 permalink:                              /pages/public/bookshelf/biography/
 
-resources:                              [ animate ]
+resources:                              [ animate, masonry ]
 resource_options:
   - attic:
       padding_top:                      600
@@ -59,6 +60,19 @@ resource_options:
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [role="dropcap"]
+Find below all available articles the `Booskhelf` collections contains.
+The content is automatically generated and taken from the articles the
+collections contains.
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Available Books
+
+[role="mb-4"]
+Find below all available articles in the `biography` collection. The content
+is automatically generated and taken from the articles this collection
+contains.
+
 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
@@ -71,15 +85,9 @@ 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.
+masonry::collection_biography[role="notoc mb-4"]
 
+////
 ++++
 <div class="row mb-4">
   <div class="col-md-12 col-xs-12">
@@ -87,3 +95,4 @@ contains.
   </div>
 </div>
 ++++
+////

data/lib/starter_web/pages/public/{bookshelf → learn/bookshelf}/article_previewer/viewer_fantasy.adoc

@@ -5,8 +5,8 @@ date:                                   2023-01-29 00:00:00
 description: >
                                         Fantasy Literature in the Book Shelf
 
-categories:                             [ Fantasy, Collection ]
-tags:                                   [ Preview ]
+categories:                             [ Books ]
+tags:                                   [ Fantasy, Preview ]
 
 image:
   path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
@@ -18,11 +18,12 @@ robots:
   index:                                false
   follow:                               false
 
-fab_menu_id:                            open_toc
+toc:                                    false
+fab_menu_id:                            default
 regenerate:                             false
 permalink:                              /pages/public/bookshelf/fantasy/
 
-resources:                              [ animate ]
+resources:                              [ animate, masonry ]
 resource_options:
   - attic:
       padding_top:                      600
@@ -65,13 +66,16 @@ all ages.
 
 // Include sub-documents (if any)
 // -----------------------------------------------------------------------------
-== Available articles
+== Available Books
 
 [role="mb-4"]
-Find below all available articles in the collection. The content is
+Find below all available articles in the `fantasy` collection. The content is
 automatically generated and taken from the articles this collection
 contains.
 
+masonry::collection_fantasy[role="mb-4"]
+
+////
 ++++
 <div class="row mb-4">
   <div class="col-md-12 col-xs-12">
@@ -79,3 +83,4 @@ contains.
   </div>
 </div>
 ++++
+////

data/lib/starter_web/pages/public/{bookshelf → learn/bookshelf}/article_previewer/viewer_romance.adoc

@@ -5,8 +5,8 @@ date:                                   2023-01-29 00:00:00
 description: >
                                         Romance Literature in the Book Shelf
 
-categories:                             [ Romance, Collection ]
-tags:                                   [ Preview ]
+categories:                             [ Books ]
+tags:                                   [ Romance, Preview ]
 
 image:
   path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
@@ -18,11 +18,13 @@ robots:
   index:                                false
   follow:                               false
 
+toc:                                    false
+fab_menu_id:                            default
 fab_menu_id:                            open_toc
 regenerate:                             false
 permalink:                              /pages/public/bookshelf/romance/
 
-resources:                              [ animate ]
+resources:                              [ animate, masonry ]
 resource_options:
   - attic:
       padding_top:                      600
@@ -65,13 +67,16 @@ readership.
 
 // Include sub-documents (if any)
 // -----------------------------------------------------------------------------
-== Available articles
+== Available Books
 
 [role="mb-4"]
-Find below all available articles in the collection. The content is
+Find below all available articles in the `romance` collection. The content is
 automatically generated and taken from the articles this collection
 contains.
 
+masonry::collection_romance[role="mb-4"]
+
+////
 ++++
 <div class="row mb-4">
   <div class="col-md-12 col-xs-12">
@@ -79,3 +84,4 @@ contains.
   </div>
 </div>
 ++++
+////

data/lib/starter_web/pages/public/learn/roundtrip/_includes/attributes.asciidoc

@@ -14,7 +14,7 @@ tag::urls[]
 :url-w3schools--css-tutorial:                     https://www.w3schools.com/css/default.asp
 
 :url-fontawesome--home:                           https://fontawesome.com/
-:url-fontawesome--icons:                          https://fontawesome.com/icons?d=gallery
+:url-fontawesome--icons:                          https://fontawesome.com/v5/search
 :url-fontawesome--get-started:                    https://fontawesome.com/get-started
 
 :url-mdi--home:                                   https://materialdesignicons.com/
@@ -54,7 +54,7 @@ tag::urls[]
 
 :url-previewer--theme:                            /pages/public/previewer/theme/
 
-:url-fa-icons--previewer:                         https://fontawesome.com/v5.15/icons?d=gallery&p=2
+:url-fa-icons--previewer:                         https://fontawesome.com/v5/search
 :url-iconify-icons--previewer:                    https://icon-sets.iconify.design/
 
 :url-kickstarter--web-in-a-day:                   https://jekyll.one/pages/public/learn/kickstarter/web_in_a_day/meet_and_greet/