j1-template 2023.8.1 → 2023.9.0

data/lib/j1/version.rb

@@ -1,3 +1,3 @@
 module J1
-  VERSION = '2023.8.1'
+  VERSION = '2023.9.0'
 end

data/lib/starter_web/Gemfile

@@ -75,11 +75,11 @@ gem 'jekyll', '~> 4.0'
 # Specify the THEME GEM used for the project
 
 # Loaded from RubyGems
-gem 'j1-template', '~> 2023.8.0'
+gem 'j1-template', '~> 2023.9.0'
 
 # Loaded from gem.fury.io
 #source 'https://gem.fury.io/jekyll-one-org/' do
-#  gem 'j1-template', '~> 2023.8.0'
+#  gem 'j1-template', '~> 2023.9.0'
 #end
 
 # ------------------------------------------------------------------------------

data/lib/starter_web/README.md

@@ -379,7 +379,7 @@ This command creates a **initial** project in folder **my-starter**.
   2023-02-28 18:12:12 - GENERATE: Resolving dependencies...
   2023-02-28 18:12:12 - GENERATE: Using bundler 2.3.7
   ...
-  2023-02-28 18:12:12 - GENERATE: Using j1-template 2023.8.1
+  2023-02-28 18:12:12 - GENERATE: Using j1-template 2023.9.0
   2023-02-28 18:12:12 - GENERATE: Bundle complete! 31 Gemfile dependencies, 78 gems now installed.
   2023-02-28 18:12:12 - GENERATE: Bundled gems are installed into `../../.gem`
   2023-02-28 18:12:12 - GENERATE:  C:/Users/xxx/.gem/ruby/3.1.0;C:/DevTools/Ruby31-x64/lib/ruby/gems/3.1.0;
@@ -415,7 +415,7 @@ commands are available as well.
   2023-02-28 18:17:48 - SETUP: Initialize the project ...
   2023-02-28 18:17:48 - SETUP: Be patient, this will take a while ...
   2023-02-28 18:17:49 - SETUP:
-  2023-02-28 18:17:49 - SETUP: > j1@2023.8.1 setup C:\Users\xxx\j1-projects\my-starter
+  2023-02-28 18:17:49 - SETUP: > j1@2023.9.0 setup C:\Users\xxx\j1-projects\my-starter
   2023-02-28 18:17:49 - SETUP: > npm --silent run setup-start && npm --silent run setup-base && run-s -s setup:*
   2023-02-28 18:17:49 - SETUP:
   2023-02-28 18:17:50 - SETUP: Setup project for first use ..
@@ -460,7 +460,7 @@ browser. Let's start the journey ...
   Check setup state of the J1 project ...
   2023-02-28 18:26:18 - SITE: Starting up your site ...
   2023-02-28 18:26:18 - SITE:
-  2023-02-28 18:26:18 - SITE: > j1@2023.8.1 j1-site C:\Users\jadams\j1-projects\my-starter
+  2023-02-28 18:26:18 - SITE: > j1@2023.9.0 j1-site C:\Users\jadams\j1-projects\my-starter
   2023-02-28 18:26:18 - SITE: > run-p -s j1-site:*
   2023-02-28 18:26:18 - SITE:
   2023-02-28 18:26:20 - SITE: Startup UTILSRV ..
@@ -499,7 +499,7 @@ Check setup state of the J1 project ...
 REBUILD: Rebuild the projects website ...
 REBUILD: Be patient, this will take a while ...
 2023-02-28 18:45:09 - REBUILD:
-2023-02-28 18:45:09 - REBUILD: > j1@2023.8.1 rebuild C:\Users\xxx\j1-projects\my-starter
+2023-02-28 18:45:09 - REBUILD: > j1@2023.9.0 rebuild C:\Users\xxx\j1-projects\my-starter
 2023-02-28 18:45:09 - REBUILD: > run-s -s rebuild:* && run-s -s post-rebuild:*
 2023-02-28 18:45:09 - REBUILD:
 2023-02-28 18:45:10 - REBUILD: Rebuild site incremental ..
@@ -547,7 +547,7 @@ using Lerna for all packages:
   2023-02-28 18:29:07 - RESET: Reset the project to factory state ...
   2023-02-28 18:29:07 - RESET: Be patient, this will take a while ...
   2023-02-28 18:29:08 - RESET:
-  2023-02-28 18:29:08 - RESET: > j1@2023.8.1 reset C:\Users\xxx\j1-projects\my-starter
+  2023-02-28 18:29:08 - RESET: > j1@2023.9.0 reset C:\Users\xxx\j1-projects\my-starter
   2023-02-28 18:29:08 - RESET: > run-s -s reset:*
   2023-02-28 18:29:08 - RESET:
   2023-02-28 18:29:08 - RESET: Reset project to factory state ..

data/lib/starter_web/_config.yml

@@ -53,7 +53,7 @@ environment:                            development
 # ------------------------------------------------------------------------------
 # Sets the build version of the site
 #
-version:                                2023.8.1
+version:                                2023.9.0
 
 # copyright
 # ------------------------------------------------------------------------------

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

@@ -120,7 +120,7 @@ settings:
           mode:                         lg-fade
           cssEasing:                    cubic-bezier(0.25, 0, 0.25, 1)
 
-    # ----------------------------------------------------------------------------
+    # --------------------------------------------------------------------------
     # Old Times
     #
     - gallery:
@@ -144,8 +144,8 @@ settings:
                                         ]
         captions_lightbox:              []
         gallery_options:
-          rowHeight:                    200
-          margins:                      5
+          rowHeight:                    250
+          margins:                      3
         lightbox_options:
           lightbox:                     lg
           mode:                         lg-fade

data/lib/starter_web/_data/templates/feed.xml

@@ -57,7 +57,7 @@
   <id>{{ page.url | absolute_url | xml_escape }}</id>
   <post_limited>{{ limit_posts }}</post_limited>
   <template_name>J1 Theme</template_name>
-  <template_version>2023.8.1</template_version>
+  <template_version>2023.9.0</template_version>
 
   {% assign title = site.title | default: site.name %}
   {% if page.collection != "posts" %}

data/lib/starter_web/_plugins/index/lunr.rb

@@ -391,6 +391,6 @@ end
 
 module Jekyll
   module J1LunrSearch
-    VERSION = '2023.8.1'
+    VERSION = '2023.9.0'
   end
 end

data/lib/starter_web/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "j1",
-  "version": "2023.8.1",
+  "version": "2023.9.0",
   "description": "J1 Theme Starter Web",
   "homepage": "https://your.site",
   "author": {

data/lib/starter_web/pages/public/learn/roundtrip/_includes/documents/themes_bootstrap.asciidoc

@@ -42,10 +42,13 @@ You can find all available stylesheets to be applied on your pages from the
 *Themes* menu. You're invited to check how a page is changing for its design
 if a different stylesheet for web design is used.
 
-WARNING: For changing from one style to the next at *runtime*, the current
+[WARNING]
+====
+For changing from one style to the next at *runtime*, the current
 version of the J1 Template system tries add new styles to J1 specific
 components like fonts, headlines, lists or paragraphs. Changing the style
 will work for the most *common* elements, but *not all* of them for now.
+====
 
 Select a style from the *Themes* menu, and the new BS-based stylesheet is
 automatically applied to all pages of your website.

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

@@ -68,11 +68,14 @@ extensions to the markup language Asciidoc is made especially for documents
 of the Jekyll content type *page*, but can be used for posts or collections
 as well.
 
-TIP: Most extensions are based on well-documented examples from the
+[TIP]
+====
+Most extensions are based on well-documented examples from the
 link:{url-asciidoctor--extensions-lab}[Asciidoctor Extensions Lab, {browser-window--new}].
 To create Asciidoc extensions on your own, it is highly recommended to read the
 link:{url-asciidoctor--extensions-manual}[extensions section, {browser-window--new}] in
 the Asciidoctor user manual.
+====
 
 mdi:clock-time-five-outline[24px, md-gray mt-4 mr-2]
 *15 Minutes* to read
@@ -91,8 +94,11 @@ If a result block `[.result]` is placed under a listing block, clicking the
 toggle button *view* `VIEW` displays or hide the content given by the
 result block.
 
-TIP: The *View Result Extension* is quite helpful for sections discussing
+[TIP]
+====
+The *View Result Extension* is quite helpful for sections discussing
 code elements.
+====
 
 .This example place a button *VIEW* top right of the example box
 [source, no_template, role="noclip"]
@@ -140,8 +146,11 @@ trippings.
 
 |===
 
-NOTE: All colors for all default admonition blocks set to the standard
+[NOTE]
+====
+All colors for all default admonition blocks set to the standard
 color set. Find available block types and their colors below.
+====
 
 When you want to call attention to a single paragraph, start the first
 line of the paragraph with the label you want to use. The label must be
@@ -543,9 +552,12 @@ mdi:font-awesome[2x, ml-3 mr-2 mb-2] Brand icon +
 mdi:apple[2x, md-indigo ml-3 mr-2] Brand icon (colored)
 ====
 
-NOTE: Parameters for icon size `icon_size` and modifiers `modifier` are
+[NOTE]
+====
+Parameters for icon size `icon_size` and modifiers `modifier` are
 optional. If not given, the icons size `size` is set to default `1x`, the
 color to *black* and no settings for *modifiers* `modifier` are applied.
+====
 
 [role="mt-4"]
 === Font Awesome Icons
@@ -578,10 +590,12 @@ fab:font-awesome[2x, ml-3 mr-2 mb-2] Brand icon +
 fab:apple[2x, md-indigo ml-3 mr-2] Brand icon (colored)
 ====
 
-NOTE: Parameters for icon size `icon_size` and modifiers `modifier` are
+[NOTE]
+====
+Parameters for icon size `icon_size` and modifiers `modifier` are
 optional. If not given, the icons size is set to default `1x`, the color
 to *black* and no settings for modifiers  `modifier` are applied.
-
+====
 
 [role="mt-4"]
 === Iconify Icons

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

@@ -67,11 +67,14 @@ CSS front-end framework of version V5. The Bootstrap theme feature enables
 the presentation of different versions of the same site using already prepared
 Bootstrap CSS style sets.
 
-NOTE: link:{url-bs--home}[Bootstrap, {browser-window--new}] is an HTML, CSS and
+[NOTE]
+====
+link:{url-bs--home}[Bootstrap, {browser-window--new}] is an HTML, CSS and
 Javascripts Library that focuses on simplifying the development of modern web
 pages. The primary purpose of applying the framework to J1 is to provide a
 general standard for colors, sizes, fonts, and the overall layout of a
 based site.
+====
 
 Using 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

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

@@ -75,9 +75,12 @@ MDI and FA icons 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>>.
 
-NOTE: Iconify icons are not a locally stored icon-set like MDI or FA.
+[NOTE]
+====
+Iconify icons are not a locally stored icon-set like MDI or FA.
 Icons are loaded over the Internet using the so-called *Unified OpenSource Icon
 Framework*. See section <<Iconify Icons>> for more information.
+====
 
 mdi:clock-time-five-outline[24px, md-gray mt-4 mr-2]
 *10 Minutes* to read
@@ -241,9 +244,11 @@ Using Material Design Icons is easy as the inline macro `mdi:` is available
 to place icons wherever you want. See more about this in section
 link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
 
-NOTE: _J1 Template_ supports the full set of _MDI_ for the Web. The
+[NOTE]
+====
+_J1 Template_ supports the full set of _MDI_ for the Web. The
 icon set is fully integrated and can be used out-of-the-box.
-
+====
 
 [role="mt-5"]
 == Material Design Light Icons
@@ -389,11 +394,9 @@ included.
 
 Since version 5, the icon set comes in two packages: FontAwesome *Free*
 and the proprietary, commercial FontAwesome *Pro* version but requires a
-license fee to pay.
-
-NOTE: The free versions (all releases up to 4 and the free version for 5) are
-available under SIL Open Font License 1.1, Creative Commons Attribution 4.0,
-and the MIT License.
+license fee to pay. The free versions (all releases up to 4 and the free
+version for 5) are available under SIL Open Font License 1.1, Creative
+Commons Attribution 4.0, and the MIT License.
 
 FontAwesome V5 meets the Material Design idea of _Google_, and in comparison
 to Version 4, the current version is much more than face-lifting. The new
@@ -401,19 +404,25 @@ version comes with more than 2300+ icons, but many are available only with
 the Pro license. For the Free version, only a subset of 900+ icons is
 available.
 
-NOTE: The CSS styles for FontAwesome V5 have been extended for the J1 Template
+[NOTE]
+====
+The CSS styles for FontAwesome V5 have been extended for the J1 Template
 to the same classes (and their respective names) for other Font Icon sets.
 Already existing styles like `fa-flip-vertical` are available as `fa-flip-v`
 as well.
+====
 
 You can check out what icons available at
 link:{url-fontawesome--icons}[FontAwesome Icons, {browser-window--new}].
 _FontAwesome_ V5 is fully integrated - no need for additional resources to
 load. But in comparison to Version 4, a lot of differences are to be noticed.
 
-TIP: If you haven't used V5 yet, it is highly recommended to visit the
+[TIP]
+====
+If you haven't used V5 yet, it is highly recommended to visit the
 link:{url-fontawesome--get-started}[Get started, {browser-window--new}] pages to
 learn the basics and features and styles.
+====
 
 With version V5 of _FontAwesome_, the icon set is split into two general
 parts:
@@ -422,10 +431,13 @@ parts:
 * brand icons, including symbols for companies and brands,
   indicated by *FAB*
 
-NOTE: Using FontAwesome with Asciidoc is quite easy to use as two inline
+[NOTE]
+====
+Using FontAwesome with Asciidoc is quite easy to use as two inline
 macros `fab:` and `fas:` are available to place icons where ever you want.
 See more about this in section
 link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
+====
 
 Find below examples of both sets and how to use with J1 Template.
 
@@ -626,10 +638,13 @@ the client is build-in and is loaded if Iconify is requested as a resource.
 To see what icon sets are available with that framework, check the page
 link:{url-iconify--icon-sets}[Iconify Icon Sets, {browser-window--new}].
 
-NOTE: Using Iconify icons with J1 Template is quite easy. An inline macro
+[NOTE]
+====
+Using Iconify icons with J1 Template is quite easy. An inline macro
 `iconify:` is available to place icons where ever you want. See more about
 this in section
 link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
+====
 
 Currently, over 40,000 vector icons are available for many different use cases.
 Find some examples below.

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

@@ -158,10 +158,13 @@ In this document, there are several fields, like `title`, `tagline`, or
 fields are available, like `tags` or `categories` that can be used for
 more specific searches based on `identifiers`.
 
-NOTE: The document *content* is collected by the (intrinsic) field `body`.
+[NOTE]
+====
+The document *content* is collected by the (intrinsic) field `body`.
 To limit the index data loaded by the browser, the body field is removed from
 a document. The `body` field not available as an *explicit* field for searches,
 but the *content* is still fully searchable.
+====
 
 To do a simple full-text search as well as more specific searches, the
 QuickSearch core engine Lunr offers a query language, a DSL (domain-specific
@@ -243,8 +246,11 @@ The above example will match documents that contain either `jekyll` *OR*
 `tutorial`. Documents that contain _both_ will increase the score, and those
 documents are returned first.
 
-NOTE: Comparing to a Google search (terms are combined at Google by a
+[NOTE]
+====
+Comparing to a Google search (terms are combined at Google by a
 logical `AND`) a Quicksearch combines the terms by an `OR`.
+====
 
 To combine search terms in a QuickSearch query by a logical *AND*, the terms
 could be prepended by a plus sign (`+`) to mark them as for the QuickSearch
@@ -267,13 +273,15 @@ beginning with `Jek`:
 jek*
 ----
 
-NOTE: Language grammar rules are not relevant for searches. For simplification,
+[NOTE]
+====
+Language grammar rules are not relevant for searches. For simplification,
 all words (terms) are transformed to lower case. As a result, the word
 `Jekyll` is the same as `jekyll` from a search-engines perspective. Language
 variations of `Jekyll's` or plurals like `Generators` are reduced
 to their base form. For searches, don't take care of grammar rules but the
 spelling. If you're unsure about the spelling of a word, use wildcards.
-
+====
 
 === Fields
 

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

@@ -82,8 +82,11 @@ Modals are a great choice to bring the user's attention. Using the J1 Template
 enhanced modal styles, emotional weight is added to the information displayed.
 Ranging from an info level, a simple warning to critical messages.
 
-TIP: For more information on how to use Bootstrap’s JavaScript modal
+[TIP]
+====
+For more information on how to use Bootstrap’s JavaScript modal
 plugin, refer to: link:{url-bs-docs--components-modal}[Bootstrap Docs, {browser-window--new}].
+====
 
 // include::{documentdir}/tables/bs_modal_examples.asciidoc[]
 include::{documentdir}/410_table_bs_modal_examples.asciidoc[]