j1-template 2023.3.0 → 2023.3.2

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

@@ -1,5 +1,5 @@
 ---
-title:                                  Icons
+title:                                  Icon Fonts
 tagline:                                Popular Icons Sets
 date:                                   2020-11-06 00:00:00
 description: >
@@ -68,6 +68,7 @@ using the so-called Unified OpenSource Icon Framework.
 J1 Theme supports popular icons font sets out-of-the-box:
 
 * link:{url-mdi--home}[Material Design Icons, {browser-window--new}] (MDI)
+* link:{url-mdil--home}[Material Design Light Icons, {browser-window--new}] (MDIL)
 * link:{url-fontawesome--home}[FontAwesome Icons V5, {browser-window--new}] (FA)
 * link:{url-iconify--home}[Iconify Icons, {browser-window--new}] (II)
 
@@ -75,20 +76,21 @@ The icon sets MDI and FA are very good in design and have a rich set of
 different icons for many categories used for the Web. See below for some
 details for <<Material Design Icons>> and <<FontAwesome Icons>>.
 
+[role="mb-5"]
 Iconify icons are not a locally stored icon-set like MDI or FA. All icons are
 loaded over the Internet using the so-called *Unified OpenSource Icon
 Framework*. See section <<Iconify Icons>> for more information.
 
 // Include sub-documents (if any)
 // -----------------------------------------------------------------------------
-[role="mt-4"]
-== Material Design Icons
+== Material Design Icons (Regular)
 
 The primary icon-set for the J1 Theme is
 link:{url-mdi--home}[Material Design Icons, {browser-window--new}],
-because it is a rich set providing more than 5900+ icons for the current
-version (v5.9.55). MDI has excellent *Material Design* support from a design
-perspective and comes with the original icon set created by _Google_ build-in.
+because it is a rich set providing more than 7200+ icons for the current
+version (v7.0.96, March 2023). MDI has excellent *Material Design* support
+from a design perspective and comes with the original icon set created by
+_Google_ build-in.
 
 _Material Design Icons_ (MDI) is a beneficial design resource for Web Design
 based on _Google_'s Material Design. _MDI_ is a community-driven
@@ -241,12 +243,149 @@ link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
 
 _MDI_ is a growing collection to allow designers and developers targeting
 various platforms to download icons in the format, color, and size they need
-for any project. The repo today contains 6000+ icons (v5.4.55) including
-converted icons from the official set created by _Google_.
+for any project. The repo today contains 7200+ icons (v7.0.96, March 2023)
+including converted icons from the official set created by _Google_.
 
-_J1 Theme_ supports the full set of _MDI_ for the Web (Webfont, WOFF). The
+NOTE: _J1 Theme_ supports the full set of _MDI_ for the Web (Webfont, WOFF). The
 icon set is fully integrated and can be used out-of-the-box.
 
+
+[role="mt-5"]
+== Material Design Light Icons
+
+The primary icon-set for the J1 Theme is
+link:{url-mdi--home}[Material Design Icons, {browser-window--new}],
+because it is a rich set providing more than 260+ icons for the current
+version (v0.2.63). MDI has excellent *Material Design* support from a design
+perspective and comes with the original icon set created by _Google_ build-in.
+
+.Material Design Light Icons
+[cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
+|===
+|Size |Modifier |Markup |Render
+
+|1x
+|no modifier set
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+No modifiers +
+[source, adoc, role="noclip"]
+----
+mdil:account[1x]
+----
+|mdil:account[1x]
+
+|3x
+|no modifier set
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+No modifiers +
+[source, adoc, role="noclip"]
+----
+mdil:account[3x]
+----
+|mdil:account[3x]
+
+|5x
+|no modifier set
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+No modifiers +
+[source, adoc, role="noclip"]
+----
+mdil:account[5x]
+----
+|mdil:account[5x]
+
+|5x
+|`mdi-rotate-45`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Rotate 45 degrees +
+[source, adoc, role="noclip"]
+----
+mdil:account[5x mdi-rotate-45]
+----
+|mdil:account[5x mdi-rotate-45]
+
+|5x
+|`mdi-rotate-315`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Rotate 315 degrees +
+[source, adoc, role="noclip"]
+----
+mdil:account[5x mdi-rotate-315]
+----
+|mdil:account[5x mdi-rotate-315]
+
+|5x
+|`mdi-light` +
+`mdi-flip-v`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Color set to (md) light-grey and flipped vertical +
+[source, adoc, role="noclip"]
+----
+mdil:alert[5x mdi-light mdi-flip-v]
+----
+|mdil:alert[5x mdi-light mdi-flip-v]
+
+|5x
+|`md-indigo`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Color set to (md) indigo +
+[source, adoc, role="noclip"]
+----
+mdil:alert[5x md-indigo]
+----
+|mdil:account[5x md-indigo]
+
+|5x
+|`md-pink`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Color set to (md) pink +
+[source, adoc, role="noclip"]
+----
+mdil:alert[5x md-pink]
+----
+|mdil:account[5x md-pink]
+
+|5x
+|`md-red-900` +
+`mdi-pulsed`
+|All icons can be found for preview at the
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
+page online. +
+
+Color  set to (md) color dark-red and added animation of type pulsed +
+[source, adoc, role="noclip"]
+----
+mdil:heart[5x md-red-900 mdi-pulsed]
+----
+|mdil:heart[5x md-red-900 mdi-pulsed]
+
+|===
+
+[role="mt-5"]
 == FontAwesome Icons
 
 _FontAwesome_ is a font and icon toolkit based on CSS, initially
@@ -296,6 +435,7 @@ link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
 
 Find below examples of both and the use with J1 Theme.
 
+[role="mt-5"]
 === Brand icons
 
 .FontAwesome Icons (FAB)
@@ -329,7 +469,7 @@ fab:blogger[5x md-blue]
 
 |===
 
-
+[role="mt-5"]
 === Standard icons
 
 .FontAwesome Icons (FAS)
@@ -478,7 +618,7 @@ fas:heart[5x md-red-900 fa-pulsed]
 
 |===
 
-
+[role="mt-5"]
 == Iconify Icons
 
 MDI and FA are rich icon sets but designed for general use. Sometimes icons
@@ -574,7 +714,7 @@ iconify:medical-icon:i-ear-nose-throat[5x md-red-900]
 
 |===
 
-
+[role="mt-5"]
 == What next
 
 Have you've enjoyed the possibilities J1 offers for managing and

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

@@ -60,8 +60,8 @@ resource_options:
 :url-j1-docs--lightbox-module:          https://jekyll.one/pages/public/manuals/modules/lightbox/
 :url-j1-docs--masterslider-module:      https://jekyll.one/pages/public/manuals/modules/masterslider/
 
-:url-j1-masterslider-previewer:         https://jekyll.one/pages/public/previewer/masterslider/
-:url-j1-slick-previewer:                https://jekyll.one/pages/public/previewer/slick/
+:url-j1-masterslider-previewer:         https://jekyll.one/pages/public/tools/previewer/masterslider/
+:url-j1-slick-previewer:                https://jekyll.one/pages/public/tools/previewer/slick/
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -246,7 +246,7 @@ lazy loading, or autoplay. Slick carousels are compatible with all modern
 browsers and devices, making it a great choice to create a responsive and
 mobile-friendly website.
 
-=== Slick Image Carousel
+=== Image Carousel
 
 [role="mb-4"]
 An _Slick_ image carousel typically consists of a container with images and
@@ -258,7 +258,7 @@ between images, to make the presentation more engaging and visually appealing.
 .Carousel + Arrows + Dots + Captions + Lightbox
 slick::image_carousel_full[role="mb-5"]
 
-=== Slick Carousel from Collections
+=== Carousel from Collections
 
 [role="mb-4"]
 A carousel from a collection for J1 Template is a *pre-defined* carousel
@@ -272,12 +272,36 @@ like *Arrows* and *Dots*.
 .Collection Biography + Arrows + Dots + Gutters
 slick::collection_carousel_biography[role="mb-5"]
 
+=== Carousel from Posts
+
+A Carousel from posts for J1 Template is a *pre-defined* carousel type to
+display post articles on a webpage. It is a popular way to showcase a
+selection of post articles visually appealingly and can be useful for
+highlighting important or *featured* content for your posts content.
+
+[role="mb-4"]
+Post carousels pull news articles from a specific *group*. All Carousels for
+posts display the post category, the title, the author information and
+date. All Slick carousels for the J1 Theme can be easily customized in
+various ways, such as changing the number of posts displayed, the slider
+speed, or the navigation options like *Arrows* and *Dots*.
+
+.Asciidoc configuration
+[source, config, role="noclip mb-3"]
+----
+slick::post_carousel_featured[]
+----
+
+.Post Carousel (Featured Posts)
+slick::post_carousel_featured[role="mb-4"]
+
 === More about Slick Carousels
 
 [role="mb-4"]
 If you're interested to learn more about _Slick_, go previewer page
 link:{url-j1-slick-previewer}[Slick Previewer, {browser-window--new}],
 
+
 [#masterSlider]
 == J1 Master Slider
 

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

@@ -15,7 +15,7 @@ categories:                             [ Info ]
 tags:                                   [ Introduction ]
 
 image:
-  path:                                 /assets/images/modules/attics/1920x1280/alexander-redl.jpg
+  path:                                 /assets/images/modules/attics/1920x1280/brigitta-schneiter.jpg
   width:                                1920
   height:                               1280
   alt:                                  Photo by Alexander Redl on Unsplash
@@ -24,16 +24,16 @@ fab_menu_id:                            default
 regenerate:                             false
 permalink:                              /pages/public/learn/where_to_go/
 
-resources:                              [ animate ]
+resources:                              [ animate, comments ]
 resource_options:
   - attic:
       slides:
-        - url:                          /assets/images/modules/attics/1920x1280/alexander-redl.jpg
-          alt:                          Photo by Alexander Redl on Unsplash
+        - url:                          /assets/images/modules/attics/1920x1280/brigitta-schneiter.jpg
+          alt:                          Photo by Brigitta Schneiter on Unsplash
           badge:
             type:                       unsplash
-            author:                     Alexander Redl
-            href:                       https://unsplash.com/@alexanderredl
+            author:                     Brigitta Schneiter
+            href:                       https://unsplash.com/de/@brisch27
 ---
 
 // Page Initializer
@@ -44,11 +44,10 @@ resource_options:
 // Set (local) page attributes here
 // -----------------------------------------------------------------------------
 // :page--attr:                         <attr-value>
-:url-j1--cheatsheet-template:           /pages/public/learn/cheatsheet/j1/
 :url-j1--jekyll-collections:            /pages/public/learn/bookshelf/jekyll_collections/
+:url-j1--cheatsheet-template:           https://jekyll.one/pages/public/tools/cheatsheet/j1/
 :url-j1--tutorial-j1-in-a-day:          https://jekyll.one/pages/public/learn/kickstart/web_in_a_day/meet_and_greet/
-:url-j1--tutorial-learning-seo:         https://jekyll.one/pages/public/learn/kickstart/learning_seo/what_seo_is
-
+:url-j1--tutorial-learning-seo:         https://jekyll.one/pages/public/learn/kickstart/learning_seo/what_seo_is/
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -61,9 +60,9 @@ resource_options:
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [role="dropcap"]
-Welcome to the learning pages of the J1 Theme. A good decision to get on that
-page first. Certainly, there is no better place to start learning what J1 Theme
-can do and what pages are available to experience more.
+Welcome to the learning pages of JekyllOne, the J1 Theme. A good decision to
+get on that page first. Certainly, there is no better place to start learning
+what the J1 Theme can do and what pages are available to experience more.
 
 // Include sub-documents (if any) (if any)
 // -----------------------------------------------------------------------------
@@ -72,7 +71,6 @@ The *Learn* section contains all you need to expirience what Jekyll and J1
 can do for your new website, for your new static web. You are welcome to spend
 some time diving into the techniques of creating modern static webs.
 
-
 Roundtrip::
 In this section, you’ll find a tour to show some of the main features of
 the J1 theme. This trip covers how image data can be managed using

data/lib/starter_web/pages/public/{learn → tools}/cheatsheet/gem.adoc

@@ -21,7 +21,7 @@ image:
   alt:                                  Photo by Recha Oktaviani on Unsplash
 
 regenerate:                             false
-permalink:                              /pages/public/learn/cheatsheet/gem/
+permalink:                              /pages/public/tools/cheatsheet/gem/
 
 resources:                              [ animate, clipboard, rouge ]
 resource_options:
@@ -120,7 +120,7 @@ Add this line to your application's Gemfile:
 
 [source, sh]
 ----
-gem 'j1_template', '~> 2023.3.0'
+gem 'j1_template', '~> 2023.3.2'
 ----
 
 and install the locally created RubGem as:
@@ -172,14 +172,14 @@ bla ... specific version ...
 
 [source, sh]
 ----
-gem install j1-template -v 2023.3.0 --user-install --no-document
+gem install j1-template -v 2023.3.2 --user-install --no-document
 ----
 
 You can also use *version* comparators like `>=` or `~>`.
 
 [source, sh]
 ----
-gem install j1-template -v "~> 2023.3.0" --user-install --no-document
+gem install j1-template -v "~> 2023.3.2" --user-install --no-document
 ----
 
 === Install from a different source
@@ -188,7 +188,7 @@ bla ... specific version ...
 
 [source, sh]
 ----
-gem install j1-template -v 2023.3.0 --source 'https://gem.fury.io/jekyll-one-org/' --user-install --no-document
+gem install j1-template -v 2023.3.2 --source 'https://gem.fury.io/jekyll-one-org/' --user-install --no-document
 ----
 
 [role="mt-5"]

data/lib/starter_web/pages/public/{learn → tools}/cheatsheet/git.adoc

@@ -20,7 +20,7 @@ image:
   alt:                                  Photo by Recha Oktaviani on Unsplash
 
 regenerate:                             false
-permalink:                              /pages/public/learn/cheatsheet/git/
+permalink:                              /pages/public/tools/cheatsheet/git/
 
 resources:                              [ animate, clipboard, rouge ]
 resource_options:
@@ -1076,28 +1076,28 @@ git rm -rf --cached . && git add .
 git commit -am "Cleanup files"
 ----
 
-|`commit -am "New version 2023.3.0"`
+|`commit -am "New version 2023.3.2"`
 |Commit a specific *version*.
 |
 [source, sh]
 ----
-git commit -am "New version 2023.3.0"
+git commit -am "New version 2023.3.2"
 ----
 
-|`commit --allow-empty -m "New version 2023.3.0"`
+|`commit --allow-empty -m "New version 2023.3.2"`
 |Commit a specific version but *no* (file) changes applied.
 |
 [source, sh]
 ----
-git commit --allow-empty -m "New version 2023.3.0"
+git commit --allow-empty -m "New version 2023.3.2"
 ----
 
-|`commit -am "Prepare new version 2023.3.0"`
+|`commit -am "Prepare new version 2023.3.2"`
 |Commit a specific version but changes are *not* final.
 |
 [source, sh]
 ----
-git commit -am "Prepare new version 2023.3.0"
+git commit -am "Prepare new version 2023.3.2"
 ----
 
 |`commit -am "Latest files"`
@@ -1346,14 +1346,14 @@ Use the git 'tag' command with the '-d' option
 
 [source, sh]
 ----
-git tag -d v2023.3.0
+git tag -d v2023.3.2
 ----
 
 .from remote
 
 [source, sh]
 ----
-git push -d origin v2023.3.0
+git push -d origin v2023.3.2
 ----
 
 
@@ -1364,7 +1364,7 @@ then push the new tag
 
 [source, sh]
 ----
-git tag -a v2023.3.0 -m "v2023.3.0"
+git tag -a v2023.3.2 -m "v2023.3.2"
 git push origin --tags
 ----
 
@@ -1396,10 +1396,10 @@ Then:
 [source, sh]
 ----
 git commit -am "Cleanup files"
-git commit -am "New version 2023.3.0"
-git commit --allow-empty -m "New version 2023.3.0"
-git commit -am "Prepare new version 2023.3.0"
-git commit -am "Latest files of version 2023.3.0"
+git commit -am "New version 2023.3.2"
+git commit --allow-empty -m "New version 2023.3.2"
+git commit -am "Prepare new version 2023.3.2"
+git commit -am "Latest files of version 2023.3.2"
 ----
 
 

data/lib/starter_web/pages/public/{learn → tools}/cheatsheet/j1.adoc

@@ -20,7 +20,7 @@ image:
   alt:                                  Photo by Recha Oktaviani on Unsplash
 
 regenerate:                             false
-permalink:                              /pages/public/learn/cheatsheet/j1/
+permalink:                              /pages/public/tools/cheatsheet/j1/
 
 resources:                              [ animate, clipboard, rouge ]
 resource_options:

data/lib/starter_web/pages/public/{learn → tools}/cheatsheet/yaml.adoc

@@ -20,7 +20,7 @@ image:
   alt:                                  Photo by Recha Oktaviani on Unsplash
 
 regenerate:                             false
-permalink:                              /pages/public/learn/cheatsheet/yaml/
+permalink:                              /pages/public/tools/cheatsheet/yaml/
 
 resources:                              [ animate, clipboard, rouge ]
 resource_options:

data/lib/starter_web/pages/public/{previewer → tools/previewer}/preview_bootstrap_theme.adoc

@@ -18,7 +18,7 @@ image:
   alt:                                  Photo by Clem Onojeghuo on Unsplash
 
 regenerate:                             false
-permalink:                              /pages/public/previewer/current_theme/
+permalink:                              /pages/public/tools/previewer/current_theme/
 
 resources:                              [ animate, clipboard, rouge ]
 resource_options:

data/lib/starter_web/utilsrv/_defaults/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "utls",
-  "version": "2023.3.0",
+  "version": "2023.3.2",
   "description": "J1 Theme Utility Server",
   "homepage": "https://jekyll.one",
   "author": {

data/lib/starter_web/utilsrv/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "utls",
-  "version": "2023.3.0",
+  "version": "2023.3.2",
   "description": "J1 Theme Utility Server",
   "homepage": "https://jekyll.one",
   "author": {