j1-template 2022.6.3 → 2023.0.1

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

@@ -85,7 +85,8 @@ tag::data[]
 :data-images-standalone:                          "assets/images/modules/gallery/old_times/image_02.jpg, GrandPa's 80th Birthday"
 :data-images-group:                               "assets/images/modules/gallery/old_times/image_03.jpg, GrandPa's annual journey, assets/images/modules/gallery/old_times/image_04.jpg, GrandPa's annual journey"
 
-:data-images--themes-menu:                        "assets/images/pages/roundtrip/500_themes/themes-menu-1280x800.jpg, Themes menu (Bootswatch)"
+:data-images--themes-menu:                        "assets/images/pages/roundtrip/themes-menu-1280x800.jpg, Themes menu (Bootswatch)"
+:data-images--styles-menu:                        "assets/images/pages/roundtrip/styles-menu-1280x800.jpg, Styles menu (Bootswatch)"
 
 :data-quicksearch-icon:                           "assets/images/pages/roundtrip/600_quicksearch/quicksearch_icon-800x200.jpg, Search button (magnifier) in the quick access area"
 :data-quicksearch-input:                          "assets/images/pages/roundtrip/600_quicksearch/quicksearch_input-800x200.jpg, Input bar for a QuickSearch"

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

@@ -1,10 +1,11 @@
+[role="mt-4"]
 == The Themes Menu
 
-Themes adjust the website's appearance based on the core CSS rules and
-definitions of Bootstrap. Themes do not change the framework's functionality
+Styles adjust the website's appearance based on the core CSS rules and
+definitions of Bootstrap. Styles do not change the framework's functionality
 but modify rule-based, e.g., the color scheme, fonts, sizes, or the
 appearance of more complex elements like forms or tables. Additionally, a
-theme may add additional components to extend the Bootstrap's framework.
+style may add additional components to extend the Bootstrap's framework.
 
 Modifying the CSS styles of link:{url-bs--home}[Bootstrap, {browser-window--new}]
 is not rocket science. But, to be honest, some knowledge is needed for
@@ -20,32 +21,32 @@ Thanks to the people at link:{url-bootswatch--home}[Bootswatch, {browser-window-
 a great set of already prepared Bootstrap stylesheets in various designs are
 available on their website. There is no need to start from scratch. It is not
 needed to re-define all the Bootstrap variables, and rebuild the framework
-files to create a new theme. Many different styles are available. What is
+files to create a new style. Many different styles are available. What is
 already available at Bootswatch is at least a good base for your modifications;
 your unique design.
 
 Besides the bunch of different stylesheets at Bootswatch, an
 link:{url-bootswatch--api}[Integration API, {browser-window--new}] is provided
 that helps a lot to integrate available designs into an existing site. This API
-is the base to integrate selectable Bootswatch stylesheets into the J1 Template
+is the base to integrate selectable Bootswatch stylesheets into the J1 Theme
 navigation system for easy use.
 
-=== Apply a theme
+=== Apply a Style
 
-The base for designing pages using the J1 Template is the theme Uno, a modern
-light theme used for many types of websites. And what we mentioned
-already, web design is not: one size fits all. The theme Uno can be seen as
-a good base, a starting point. Combining Uno and a different theme may be a fast
-solution for your site!?
+The base for designing pages using the J1 Theme is the style Uno, a modern
+light CSS layout used for many types of websites. And what we mentioned
+already, web design is not: one size fits all. The style Uno can be seen as
+a good base, a starting point. Combining Uno and a different styles may be
+a fast solution for your site!?
 
-You can find all available themes and stylesheets on your pages
-from the menu Themes. You're invited to check how a page is changing for
+You can find all available styles and stylesheets on your pages from the
+menu Themes. You're invited to check how a page is changing for
 its design if other stylesheets, other ideas of web design are used.
 
-TIP: Changing BS-based styles is one thing. Changing from one theme to the
-next at runtime is a bit more challenging. For the first version of the J1
-Template, many styles are automatically changed for J1 specific components,
+TIP: Changing BS-based styles is one thing. Changing from one style to the
+next at runtime is a bit more challenging. For the current version of the J1
+Theme, many styles are automatically changed for J1 specific components,
 but not all of them for now.
 
-Select a theme from this menu, and a new BS-based stylesheet is automatically
+Select a style from this menu, and a new BS-based stylesheet is automatically
 applied to your pages.

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

@@ -5,13 +5,13 @@ _Rouge_ is a pure Ruby and themeable syntax highlighter. It can highlight
 available themes and examples for several languages of how
 highlighting works using _Rouge_.
 
-For the default theme `Uno` of J1 Template, the following _Rouge_ themes
+For the default theme `Uno` of J1 Theme, the following _Rouge_ themes
 are used:
 
 * light: `igorpro`
 * dark: `monokai.sublime`
 
-NOTE: The default themes used for the J1 Template can be configured with the
+NOTE: The default themes used for the J1 Theme can be configured with the
 global template config file `~/_data/j1_config.yml`.
 
 

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

@@ -3,15 +3,16 @@ title:                                  Asciidoc Enhancements
 tagline:                                Asciidoctor Extensions
 date:                                   2020-11-07 00:00:00
 description: >
-                                        J1 Template implements some incubating Ruby-based
-                                        extensions for Asciidoctor. Most extensions are based
-                                        on the examples given with the Asciidoctor Extensions
-                                        Lab. All implemented Asciidoctor Extensions can be
-                                        found in this article.
+                                        J1 Theme implements some handy Ruby-based extensions 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.
+keywords: >
+                                        Jekyll, Theme, JekyllOne, Asciidoc, Asciidoctor, Ruby, Extensions, Roundtrip
 
-
-categories:                             [ Roundtrip, Asciidoc ]
-tags:                                   [ Extension ]
+categories:                             [ Roundtrip ]
+tags:                                   [ Asciidoc, Extension ]
 
 image:
   path:                                 /assets/images/pages/roundtrip/puzzle-1920x1280-bw.jpg
@@ -22,7 +23,7 @@ image:
 permalink:                              /pages/public/learn/roundtrip/asciidoc_extensions/
 regenerate:                             false
 
-resources:                              [ animate, clipboard, lightbox, iconify, twemoji, rouge ]
+resources:                              [ animate, clipboard, lightbox, iconify, rouge ]
 resource_options:
   - attic:
       slides:
@@ -51,27 +52,26 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-// Include sub-documents (if any)
-// -----------------------------------------------------------------------------
 [role="dropcap"]
-J1 Template implements some incubating Ruby-based extensions for Asciidoctor.
-Most extensions are based on the examples given with the
+J1 Theme implements some handy Ruby-based extensions for Asciidoctor.
+Providing extensions for a Jekyll theme is a unique feature of JekyllOne
+compared to other Jekyll themes and templates. All already implemented
+Asciidoctor extensions you'll find below. Additional valuable extensions
+to the markup language Asciidoc is made especially for documents of the
+Jekyll content type pages, but can be used for posts or collections as well.
+
+TIP: Most extensions are based on well-documented examples from the
 link:{url-asciidoctor--extensions-lab}[Asciidoctor Extensions Lab, {browser-window--new}].
-If you simply want to use the extensions from this repository, go ahead to
-link:{url-asciidoctor--extensions-use}[Using an extension, {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.
 
-All already implemented Asciidoctor Extensions you'll find below. Additional
-valuable extensions to the Markup language Asciidoc to the Markup language
-Asciidoc is made especially for documents of the Jekyll content type pages
-(but can be used for posts or collections as well).
-
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+[role="mt-4"]
 == Asciidoc Result Extension
 
-J1 Template adds a simple Javascript based on the `View Result Extension` to
+J1 Theme adds a simple Javascript based on the `View Result Extension` to
 any `listingblock`. The extension adds an interactive toggle button `VIEW`
 to the output of an Asciidoc listing block box placed to the top right of
 the example box. If a result block `[.result]` is placed under a `listingblock`,
@@ -209,7 +209,7 @@ text.
 Quote or excerpt text
 ----
 
-After landing the cloaked Klingon bird of prey in Golden Gate park:
+Example of a quoted *paragraph*:
 
 [quote, Captain James T. Kirk, Star Trek IV: The Voyage Home]
 Everybody remember where we parked.
@@ -248,6 +248,8 @@ paragraph text (multiline)
 ____
 ----
 
+Example of a quoted *block*:
+
 [quote, Monty Python and the Holy Grail]
 ____
 Dennis: Come and see the violence inherent in the system.
@@ -269,7 +271,7 @@ of the page. The technique, introduced by Lightbox V2, gained widespread
 popularity thanks to its simple style. The term lightbox has been employed
 since then for Javascript libraries to support such functionality.
 
-To make the use of the built-in lightbox easier, the J1 Template offers an
+To make the use of the built-in lightbox easier, the J1 Theme offers an
 Asciidoc extension: the lightBox block macro. The block macro `lightbox::`
 embeds one or more images into the output document and puts the default
 lightbox for J1 automatically on. The images `size` (width) and additional
@@ -364,7 +366,7 @@ lightbox::images-group[ 400, {data-images-group}, group_name ]
 
 JustifiedGallery, the default gallery for J1, is a great jQuery plugin to
 create responsive, infinite, and high-quality justified image galleries.
-J1 Template combines the Gallery with the lightboxes supported to enlarge
+J1 Theme combines the Gallery with the lightboxes supported to enlarge
 the images of a gallery.
 
 Pictures you’ve made are typically not even in size. Images may have the same
@@ -397,7 +399,7 @@ or for content related to a specific country. The use of country flags can
 make language selections or country indicators more visual to support your
 visitors by making a more meaningful presentation.
 
-The J1 Template comes with full support of country flags for Asciidoc
+The J1 Theme comes with full support of country flags for Asciidoc
 documents included.
 
 Country flags can be used as inline icons by using the `flag:` inline macro:
@@ -490,7 +492,7 @@ flag:es[rectangle, xl]
 
 == Icon Fonts
 
-The J1 Template comes with full icon support for Asciidoc documents included.
+The J1 Theme comes with full icon support for Asciidoc documents included.
 All icon fonts are supported:
 
 * FA (FontAwesome)
@@ -722,4 +724,4 @@ is currently in beta status, but it is 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 Template.
+feature of J1 Theme.

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

@@ -1,15 +1,20 @@
 ---
 title:                                  Bootstrap Themes
-tagline:                                J1 Template Theming
+tagline:                                J1 Themes Feature
 date:                                   2020-11-10 00:00:00
 description: >
-                                        The themes feature for J1 is in an experimental
-                                        state for the template system. Anyway, it makes
-                                        sense to present what is possible using different
-                                        versions of Bootstrap's CSS styles for a website.
+                                        JekyllOne, 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.
+keywords: >
+                                        Jekyll, Theme, JekyllOne, CSS, Bootstrap, Style, Skin, Roundtrip
 
-categories:                             [ Roundtrip, Bootstrap ]
-tags:                                   [ Module, Themes ]
+categories:                             [ Roundtrip ]
+tags:                                   [ Bootstrap, Module, Theme ]
 
 image:
   path:                                 /assets/images/pages/roundtrip/themes-1920x1280-bw.jpg
@@ -53,16 +58,19 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 [role="dropcap"]
-Themes for the template system J1 are based on the free and open-source CSS
-front-end framework {url-bs--home}[Bootstrap, {browser-window--new}] of
-version V5. Bootstrap is an HTML, CSS & JS 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 J1-based site.
+Bootstrap Themes for the J1 Theme are based on the free and open-source
+CSS front-end framework of version V5. The Bootstrap themes feature enables
+the presentation of different versions of the same site using already prepared
+Bootstrap CSS templates.
+
+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
+J1-based site.
 
-Using Bootstrap styles results in a uniform appearance for the content in
+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

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

@@ -3,14 +3,17 @@ title:                                  Icon Fonts
 tagline:                                Popular Icons Sets
 date:                                   2020-11-06 00:00:00
 description: >
-                                        J1 Template supports popular icons font sets out-of-the-box.
-                                        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.
-                                        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.
-
-categories:                             [ Roundtrip, Icon Fonts ]
+                                        J1 Theme supports popular icons font sets out-of-the-box.
+                                        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. Iconify icons are not a locally stored icon-set
+                                        like MDI or FA. All Iconify icons are loaded over the Internet
+                                        using the so-called Unified OpenSource Icon Framework.
+keywords: >
+                                        Jekyll, Theme, JekyllOne, Icon, Fonts, MDI, Fontawesome,
+                                        Iconify, Roundtrip
+
+categories:                             [ Roundtrip ]
 tags:                                   [ Module, Icon ]
 
 image:
@@ -55,17 +58,14 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-// Include sub-documents (if any)
-// -----------------------------------------------------------------------------
 [role="dropcap"]
-J1 Template supports popular icons font sets out-of-the-box. 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. 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.
+J1 Theme supports popular icons font sets out-of-the-box. 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. Iconify icons are not a locally stored
+icon-set like MDI or FA. All Iconify icons are loaded over the Internet
+using the so-called Unified OpenSource Icon Framework.
 
-J1 Template supports popular icons font sets out-of-the-box:
+J1 Theme supports popular icons font sets out-of-the-box:
 
 * link:{url-mdi--home}[Material Design Icons, {browser-window--new}] (MDI)
 * link:{url-fontawesome--home}[FontAwesome Icons V5, {browser-window--new}] (FA)
@@ -79,9 +79,12 @@ 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
 
-The primary icon-set for the J1 Template is
+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
@@ -241,7 +244,7 @@ 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_.
 
-_J1 Template_ supports the full set of _MDI_ for the Web (Webfont, WOFF). The
+_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.
 
 == FontAwesome Icons
@@ -265,7 +268,7 @@ to Version 4, the current version is much more than face-lifting. Version 5
 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 Theme
 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.
@@ -291,7 +294,7 @@ 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 and the use with J1 Template.
+Find below examples of both and the use with J1 Theme.
 
 === Brand icons
 
@@ -485,12 +488,12 @@ link:{url-iconify--home}[Iconify, {browser-window--new}]. Iconify is a so-called
 unified OpenSource icon framework that makes it possible to use icons from
 different icon sets using one (unified) syntax.
 
-To access that framework, a Javascript client is needed. For the J1 Template,
+To access that framework, a Javascript client is needed. For the J1 Theme,
 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 Asciidoctor
+NOTE: Using Iconify icons with J1 Theme is quite easy. An Asciidoctor
 inline macro `iconify:` (Asciidoctor Extension) is available to place icons
 where ever you want. See more about this in section
 link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
@@ -578,5 +581,5 @@ 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 template, go for the
+To check more features of the J1 Theme, 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,12 +3,16 @@ title:                                  Lunr Search
 tagline:                                QuickSearch for J1
 date:                                   2020-11-08 00:00:00
 description: >
-                                        QuickSearch is based on the search engine Lunr,
-                                        fully integrated with the J1 Template. Lunr is designed
-                                        to be lightweight yet full-featured to provide a
-                                        great search experience. No need for complex external,
-                                        server-sided search engines or commercial services
-                                        on the Internet like Google.
+                                        The QuickSearch 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.
+
+keywords: >
+                                        Jekyll, Theme, JekyllOne, Lunr, QuickSearch, Find,
+                                        Search, Google, Bing, Roundtrip
 
 categories:                             [ Roundtrip ]
 tags:                                   [ Module, Quicksearch ]
@@ -56,25 +60,27 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-// Include sub-documents (if any)
-// -----------------------------------------------------------------------------
 [role="dropcap"]
-The QuickSearch module for J1 Template is based on the search engine _Lunr_,
-fully integrated with the template system. _Lunr_ is designed to be lightweight
-yet full-featured to provide a great search experience. No need for complex
-external, server-sided search engines or commercial services on the Internet
-like Google. Searching a website using QuickSearch is different from search
-engines like Google or Microsoft Bing. Those search platforms using complex
-algorithms to provide a simple interface to the public but using a lot of
-artificial intelligence (AI) methods to make sense of results out of a
-handful of words given for a search.
+The QuickSearch 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.
+
+Searching a website using QuickSearch is different from search engines like
+Google or Microsoft Bing. Those search platforms using complex algorithms to
+provide a simple interface to the public but using a lot of artificial
+intelligence (AI) methods to make sense of results out of a handful of words
+given for a search.
 
 Nevertheless, QuickSearch, the J1 implementation of Lunr, is simple like
 searching at Google but offers additional features to do searches more
 specifically - if wanted. QuickSearch provides an easy-to-use query language
-for better results - anyway!
+for better results - with no advertising if wanted!
 
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+[role="mt-4"]
 == Core concepts
 
 Understanding some of the concepts and terminology that QuickSearch (Lunr)
@@ -335,7 +341,7 @@ Example\|s: Search
 summary what the document is all about.
 
 Example\|s: QuickSearch is based on the search engine Lunr, fully integrated
-with J1 Template  ...
+with J1 Theme  ...
 
 |===
 

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

@@ -3,14 +3,18 @@ title:                                  Modal Extensions
 tagline:                                Improve Visitor Experience
 date:                                   2020-11-08 00:00:00
 description: >
-                                        Advanced Bootstrap modals are used to add dialogs to your
-                                        web pages for user notifications. To highlight important
-                                        information to your visitors. Modals are positioned over
-                                        everything else in the document so that messages get the
-                                        user's attention.
+                                        J1 Theme supports a large 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.
 
-categories:                             [ Roundtrip, Bootstrap ]
-tags:                                   [ Modal, Extension ]
+keywords: >
+                                        Jekyll, Theme, JekyllOne, Bootstrap, Modals, Advanced, Extension,
+                                        Roundtrip
+
+categories:                             [ Roundtrip ]
+tags:                                   [ Bootstrap, Modal, Extension ]
 
 image:
   path:                                 /assets/images/pages/roundtrip/bootstrap-1920x1000-bw.jpg
@@ -52,23 +56,21 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 [role="dropcap"]
-Enhanced Bootstrap Modals are used to add dialogues to your web pages for user
-notifications. To highlight important information to your visitors. Modals are
-positioned over everything else in the document so that messages get the
-user's attention.
-
+J1 Theme supports a large 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.
 
 // Include sub-documents (if any)
 // -----------------------------------------------------------------------------
+[role="mt-4"]
 == Modal Examples
 
-To improve your visitor's experience on important information that shouldn't
-be missed. Modals are a great choice to bring the user's attention. Using the
-J1 Template BS enhanced predefined modal styles, some emotional weight is
-added to the information displayed - ranging from an info level, a simple
-warning to critical messages.
+Improve your reader's experience with important information that be noticed.
+Modals are a great choice to bring the user's attention. Using the J1 Theme
+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
 plugin, refer to: link:{url-bs-docs--components-modal}[Bootstrap Docs, {browser-window--new}].
@@ -85,7 +87,7 @@ 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 Template. Check out from here what the
+for the J1 Theme. Check out from here what the
 link:{url-roundtrip--responsive-tables}[Responsive Tables] can do!
 
 // Include the modals HTML portion