j1-template 2023.0.17 → 2023.2.0

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

@@ -0,0 +1,98 @@
+---
+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:                             [ Books ]
+tags:                                   [ Biography, Preview ]
+
+image:
+  path:                                 /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Giammarco on Unsplash
+
+toc:                                    false
+fab_menu_id:                            default
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/biography/
+
+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
+-------------------------------------------------------------------------------- {% endcomment %}
+{% comment %} site.biography: {{ site.biography | debug }} {% endcomment %}
+
+
+// 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
+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="notoc mb-4"]
+
+////
+++++
+<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/learn/bookshelf/article_previewer/viewer_fantasy.adoc

@@ -0,0 +1,86 @@
+---
+title:                                  Fantasy
+tagline:                                Fantasy Literature
+date:                                   2023-01-29 00:00:00
+description: >
+                                        Fantasy Literature in the Book Shelf
+
+categories:                             [ Books ]
+tags:                                   [ Fantasy, 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
+
+toc:                                    false
+fab_menu_id:                            default
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/fantasy/
+
+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 (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 Books
+
+[role="mb-4"]
+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">
+    {% include {{create_collection_article_preview}} collection=site.fantasy %}
+  </div>
+</div>
+++++
+////

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

@@ -0,0 +1,87 @@
+---
+title:                                  Romance
+tagline:                                Romance Literature
+date:                                   2023-01-29 00:00:00
+description: >
+                                        Romance Literature in the Book Shelf
+
+categories:                             [ Books ]
+tags:                                   [ Romance, 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
+
+toc:                                    false
+fab_menu_id:                            default
+fab_menu_id:                            open_toc
+regenerate:                             false
+permalink:                              /pages/public/bookshelf/romance/
+
+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 (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 Books
+
+[role="mb-4"]
+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">
+    {% include {{create_collection_article_preview}} collection=site.romance %}
+  </div>
+</div>
+++++
+////

data/lib/starter_web/pages/public/{bookshelf/whats_up.adoc → learn/bookshelf/jekyll_collections.adoc}

@@ -1,26 +1,35 @@
 ---
 layout:                                 page
 
-title:                                  What's up
-tagline:                                Jekyll Collections Overview
-date:                                   2020-11-03 12:00:00
+title:                                  Jekyll Collections
+tagline:                                What Collections Are
+date:                                   2023-01-03 00:00:00
 description: >
                                         Jekyll Collections Overview
 categories:                             [ Jekyll, Collection ]
 tags:                                   [ Info, Overview ]
 
+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/collections/whats_up/
+permalink:                              /pages/public/collections/jekyll_collections/
 
+resources:                              [ animate ]
 resource_options:
   - attic:
       padding_top:                      600
       slides:
         - url:                          /assets/images/modules/attics/giammarco-boscaro-1920x1280.jpg
-          alt:                          giammarco-boscaro-1920x1280
-
-regenerate:                             false
+          alt:                          Photo by Giammarco on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Giammarco
+            href:                       https://unsplash.com/@giamboscaro
 ---
 
 // Page Initializer
@@ -32,31 +41,30 @@ regenerate:                             false
 // -----------------------------------------------------------------------------
 // :page--attr:                         <attr-value>
 
-// Place an excerpt at the most top position
-// -----------------------------------------------------------------------------
-Collections are Jekyll's most powerful and simultaneously least understood
-feature. Collections add another possibility, or use-case, outside of Jekyll's
-post- and page-publishing functionality. Collections have the potential to
-bring Jekyll's zen-like simplicity to all sorts of other types of content that
-aren't ordered as with posts (ordered by date), but have a set *relationship*
-with one another - hence the name: _collection_.
-
-[role="clearfix mb-3"]
-excerpt__end
-
 
 // Content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-[[readmore]]
-== Traditional - Posts and pages
+[role="dropcap"]
+Collections are Jekyll's most powerful and simultaneously least understood
+feature of the generator. Collections add another possibility, or use-case,
+outside of Jekyll's post- and page-publishing functionality. Collections have
+the potential to bring Jekyll's zen-like simplicity to all sorts of other types
+of content that aren't ordered as with posts (ordered by date), but have a
+set *relationship* with one another - hence the name: _collection_.
 
-Source: https://ben.balter.com/2015/02/20/jekyll-collections/[Ben Balter: Jekyll Collections]
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+== Posts and Pages
 
+////
 {% if page.image.name %}
 .{{page.tagline}}
 [role="mb-5"]
-image::{{page.image.name}}[{{page.title}}]
+image::{{page.image.name}}[{{page.title}}, width=1280]
 {% endif %}
+////
+
+Source: https://ben.balter.com/2015/02/20/jekyll-collections/[Ben Balter: Jekyll Collections]
 
 Most Jekyll sites are organized around two types of content, posts (ordered)
 and pages (un-ordered).

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/

data/lib/starter_web/pages/public/learn/roundtrip/asciidoc_extensions.adoc

@@ -718,11 +718,15 @@ Asciidoc (Asciidoctor) extensions open up the Markup language to new use cases.
 Using the full power of programming languages to extend what's needed, whether
 Ruby, Java, Groovy, or JavaScript. The number of extensions will grow - to get
 handy and powerful functionality needed for modern web pages based on the
-Asciidoc Markup language generated by Jekyll. For sure!
+Asciidoc Markup language generated by Jekyll. For sure.
 
-The next preview is focussing on advanced Bootstrap Modals. The modals feature
-is currently in beta status, but it is a great option to customize your
-user dialogues using them!
+J1 Theme supports a set of advanced Bootstrap Modals that add dialogs to your
+web pages for user notifications. The advanced Modals highlight important
+information to your visitors. Modals are positioned over everything else in
+the document so that messages get the full user's attention.
+
+The next preview is focussing on advanced Bootstrap Modals, a great option
+to customize your user dialogues using them!
 
 Have a look for the link:{url-roundtrip--extended-modals}[Modal Extensions]
 feature of J1 Theme.

data/lib/starter_web/pages/public/learn/roundtrip/bootstrap_themes.adoc

@@ -3,13 +3,11 @@ title:                                  Themes
 tagline:                                Bootstrap Styles
 date:                                   2020-11-10 00:00:00
 description: >
-                                        J1 Starter, a Jekyll theme for multifunctional Bootstrap-based and responsive
-                                        websites, offers various unique functionalities compared to other Jekyll
-                                        themes and templates. Bootstrap themes for the J1 theme are based on the
-                                        free and open-source CSS front-end framework Bootstrap of version V5.
-                                        The Bootstrap themes for J1 theme enables the presentation of
-                                        different versions (skins) of the same site using already prepared
-                                        Bootstrap CSS templates.
+                                        J1 Theme offers various unique functionalities compared to other Jekyll
+                                        themes and templates. Bootstrap themes for the J1 Theme are based on the
+                                        free and open-source CSS front-end framework Bootstrap of version V5. The
+                                        Bootstrap themes for the J1 enable the presentation of different versions
+                                        (skins) of the same site using already prepared Bootstrap CSS templates.
 keywords: >
                                         Jekyll, Theme, JekyllOne, CSS, Bootstrap, Style, Skin, Roundtrip
 
@@ -22,7 +20,7 @@ image:
   height:                               1280
   alt:                                  Photo by Clem Onojeghuo on Unsplash
 
-regenerate:                             true
+regenerate:                             false
 permalink:                              /pages/public/learn/roundtrip/themes/
 
 resources:                              [ animate, rouge, clipboard, lightbox ]
@@ -73,8 +71,8 @@ J1-based site.
 
 Using Bootstrap themes results in a uniform appearance for the content in
 terms of the overall layout, text, tables, and form elements across all
-modern web browsers available on the market. In addition, developers can take
-advantage of CSS classes defined in Bootstrap to customize content
+modern web browsers available on the market. In addition, developers can
+take advantage of CSS classes defined in Bootstrap to customize content
 individually.
 
 // Include sub-documents (if any)
@@ -83,7 +81,17 @@ include::{documentdir}/themes_bootstrap.asciidoc[]
 
 == What next
 
-An important feature for larger webs is searching. The visitors should be able
-to search your site to find pages and posts they are interested in. Check what
-is searching a J1 website all about at
+The search option for the J1 Theme is based on the search engine Lunr and
+is fully integrated with the template. Lunr is designed to be lightweight
+yet full-featured to provide users with a great search experience. Using
+Lunr for a Jekyll website, there is no need to integrate complex external,
+server-sided search engines like Google or Bing.
+
+Visitors should be able to search your site to find pages and posts they
+are interested in. Usability is one of the top criteria for all visitors
+browsing your site. A good user experience and excellent content are key
+factors for the success of a website. Nothing in this business is guaranteed,
+but user experience efforts are good reasons your readers will return.
+
+Check what is searching a J1 website all about at
 link:{url-roundtrip--quicksearch}[Lunr Search].

data/lib/starter_web/pages/public/learn/roundtrip/icon_fonts.adoc

@@ -582,5 +582,14 @@ Have you've enjoyed the possibilities J1 offers for managing and
 manipulating font icons. Do you think these icon sets can fit your needs?
 Using Iconify, for all topics, you will find a suitable icon. And it's simple.
 
-To check more features of the J1 Theme, go for the
+J1 Theme implements some handy Ruby-based enhancements for Asciidoctor.
+Providing extensions for a Jekyll theme is a unique feature of JekyllOne (J1)
+compared to other Jekyll themes and templates. Most extensions are based on
+well-documented examples from the Asciidoctor Extensions Lab.
+
+To make the use of modules for the template easier, some more extensions
+support you to place for example lightboxes, sliders, galleries or fonts icons
+using Asciidoc block elements. I'm sure, you'll love it.
+
+To check the more the J1 Theme offers, go for the
 link:{url-roundtrip--asciidoc-extensions}[Asciidoc Extensions] made for J1!

data/lib/starter_web/pages/public/learn/roundtrip/lunr_search.adoc

@@ -3,7 +3,7 @@ title:                                  Search
 tagline:                                Lunr For J1
 date:                                   2020-11-08 00:00:00
 description: >
-                                        The QuickSearch option for the J1 Theme is based on the
+                                        The search option for the J1 Theme is based on the
                                         search engine Lunr and is fully integrated with the template.
                                         Lunr is designed to be lightweight yet full-featured to provide
                                         users with a great search experience. Using Lunr for a Jekyll
@@ -59,7 +59,7 @@ resource_options:
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [role="dropcap"]
-The QuickSearch option for the J1 Theme is based on the search engine Lunr and
+The search option for the J1 Theme is based on the search engine Lunr and
 is fully integrated with the Template. Lunr is designed to be lightweight yet
 full-featured to provide users with a great search experience. Using Lunr for
 a Jekyll website, there is no need to integrate complex external, server-sided
@@ -427,10 +427,27 @@ To simulate a logical *AND* search of documents that contain the word `jekyll`
 
 You reached the end of the roundtrip. Hopefully you enjoyed exploring what J1
 can do for your new website. To make things real for your site, go for
-_J1 in a Day_. This tutorial guides you through all the steps on how to
-setup your environment, manage and build a website and how to create content.
+_J1 in a Day_.
 
-It's a pleasant journey to learn what  modern static webs can offer today.
+J1 in a Day is a tutorial learning to create modern websites using the J1
+Theme. This Tutorial focuses on the basics of Jekyll and J1, which all
+people need to know for a successful way to a modern static website. Jekyll
+(and J1) is quite different from classic Content Management Systems (CMS).
+
+If you would like to learn more about the use of Jekyll and J1 Theme, the
+tutorials present what you need to know:
+
+* The basics of modern static webs
+* Creating an awesome Site
+* Development System
+* Project Management
+* Create Content
+
+It sounds much, spending a whole day to get Jekyll and J1 to know. Yes, it is
+much. But it makes sense to get a full overview of what can be achieved by
+modern static websites.
+
+It's a pleasant journey to learn what modern static webs can offer today.
 Start your journey from here:
 link:{url-j1-kickstarter--web-in-a-day}[J1 in a Day, {browser-window--new}].
 

data/lib/starter_web/pages/public/learn/roundtrip/modal_extentions.adoc

@@ -79,14 +79,20 @@ include::{documentdir}/410_table_bs_modal_examples.asciidoc[]
 
 == What next
 
-Bootstrap is a helpful framework that offers in the current V5
-version a complete set of styles to create excellent responsive designs.
-In the sense of all can be improved, the responsive tables support of BS
-needs some enhancement to display tables on low-resolution devices or smaller
-(browser-) window sizes.
-
-The first version for improved responsive tables that scale better is available
-for the J1 Theme. Check out from here what the
+Bootstrap is a helpful framework that offers a complete set of styles in
+the current V5 version to create excellent responsive designs. In the sense
+that all can be improved, the responsive tables support of BS needs some
+enhancement to display tables on low-resolution devices or smaller window
+sizes.
+
+The Jekyll Theme JekyllOne supports a new design for responsive tables based
+on Bootstrap. The approach used by J1 Theme is based on pure CSS styles on
+top of the classic Bootstrap tags for simplicity and portability to be viewed
+best on all devices and browsers. Responsive tables help to read this important
+information on mobiles a lot. This feature is what is meant to be fully
+responsive!
+
+Check out from here what the
 link:{url-roundtrip--responsive-tables}[Responsive Tables] can do!
 
 // Include the modals HTML portion