j1-template 2021.0.12 → 2021.1.0

data/lib/starter_web/pages/public/learn/roundtrip/100_present_images.adoc

@@ -3,25 +3,22 @@ title:                                  Roundtrip
 tagline:                                present images
 date:                                   2020-11-03 00:00:00
 description: >
-                                        This page show some of quite useful features of J1 Template to manage your
-                                        image-based content using lightboxes, carousels (slider) and galleries.
-                                        The image module offers complex functionality based on powerful OpenSource
-                                        libraries like Justified Gallery for high-end, masonry styled preview maps.
-                                        A carousel app, using the jQuery plugin Owl Carousel as a base, let you
-                                        present your images as slide shows.
-                                        Lightboxes like LightGallery or Lightbox V2 support your web for full image
-                                        views of your picture or video content. Have a look, a quick tour what J1
-                                        can do for image data.
+                                        Welcome to the preview page focussing on the image module. This page
+                                        shows some valuable features of the J1 Template to manage your image-based
+                                        content using lightboxes, carousels (slider), and galleries.
 
-tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Images, Module ]
+tags:                                   [ Roundtrip, Introduction ]
+
+comments:                               false
+fam_menu_id:                            page_ctrl_simple
 
 permalink:                              /pages/public/learn/roundtrip/present_images/
 regenerate:                             false
 
 resources:                              [
                                           clipboard, rouge, carousel, lightbox,
-                                          justified_gallery, light_gallery
+                                          justifiedGallery, lightGallery
                                         ]
 resource_options:
   - attic:
@@ -61,28 +58,28 @@ resource_options:
 // Include sub-documents
 // -----------------------------------------------------------------------------
 
-Welcome to the first preview page focussing the image module. This page show
-some of quite useful features of J1 Template to manage your image-based content
-using lightboxes, carousels (slider) and galleries.
+Welcome to the first preview page focussing on the image module. This page
+shows some valuable features of the J1 Template to manage your image-based
+content using lightboxes, carousels (slider), and galleries.
 
 The image module offers complex functionality based on powerful OpenSource
-libraries like Justified Gallery for high-end, masonry styled preview maps.
-A carousel app, using the jQuery plugin Owl Carousel as a base, let you
-present your images as slide shows.
+libraries like JustifiedGallery for high-end, masonry-styled preview maps.
+J1 Template uses the jQuery plugin Owl Carousel as a base for image sliders.
+A carousel app (slider) lets you present your images as shows.
 
-Lightboxes like LightGallery or Lightbox V2 support your web for full image
-views of your picture or video content. Have a look, a quick tour what J1
-can do for image data. Have fun!
+Lightboxes like LightGallery or Lightbox V2 support your web for enlarged
+image views of your picture or video content. Have a look, a quick tour
+of what J1 can do for image data. Have fun!
 
 == J1 Lightboxes
 
 A Lightbox, in general, is a helper which displays enlarged, almost
-screen-filling versions of pictures (or videos), while dimming the rest of the
+screen-filling versions of pictures (or videos) while dimming the rest of the
 page. The technique, introduced by Lightbox V2, gained widespread popularity
 due to its simple and elegant style. The term lightbox is used since then for
 Javascript libraries to support such functionality.
 
-For J1 Template, two different lightboxes can be used:
+For the J1 Template, two different lightboxes can be used:
 
 * Lightbox V2 (lightbox)
 * LightGallery
@@ -97,29 +94,29 @@ _lightbox_. And, LightGallery provides much more functionality on image-based
 data rather than enlarged displaying of images. See the examples below to check
 for the differences in comparison to the simpler Lightbox V2 lightbox.
 
-Both lightboxes are fully integrated to be used as standalone modules or to be
-used as helpers _under-the-hood_ by other apps or modules focussing on
+Both lightboxes are fully integrated to be used as standalone modules or
+used as helpers *under-the-hood* by other apps or modules focussing on
 image-data like gallery or carousel, the build-in carousel module.
 
 == Lightbox Examples
 
 Find below an example of using the lightbox Lightbox standalone. See how
-single (individual) images are linked for the use with Lightbox.
+single (individual) images are linked for use with Lightbox.
 
 .Lightbox block for standalone images
 lightbox::example-standalone[ 400, {data-images-standalone} ]
 
-For a group of images (image sets), Lightbox support image groups. Click
-on the images below to see how Lightbox manage image groups.
+Lightbox supports image groups (image sets). Click on the images below to
+see how Lightbox manages a group of images.
 
 .Lightbox block for grouped images
 lightbox::example-group[ 400, {data-images-group}, group ]
 
 === LightGallery Example
 
-LightGallery provides more complex functions on image data. The lightbox
-supports a gallery-style thumbnail preview plus image resizing, a dowload
-dialogue, sharing provider support and some more helpful. Check what
+LightGallery provides more complex functions on image data. The module
+supports a gallery-style thumbnail preview plus image resizing, a download
+dialog, sharing provider support, and some more helpful. Check what
 LightGallery can do by the following example.
 
 gallery::jg_old_times[]
@@ -131,25 +128,25 @@ J1 Carousel is based on OWL Carousel V1 in the latest (and unfortunately
 last) version of 1.3.3. OWL Carousel is a clean and neat jQuery slider plugin
 for creating fully responsive and touch-enabled carousel sliders.
 
-NOTE: OWL Carousel V1 is no longer available on the Internet; for an unknown
-reason. Anyway, J1 Template is using this version of OWL Carousel as a
-build-in carousel module because the software does an excellent job, is based
-on an MIT license with no issues using them for private and business use.
-And offers a lot of great features!
+NOTE: OWL Carousel V1 is no longer available on the Internet; for an
+unknown reason. Anyway, the J1 Template is using this version of OWL
+Carousel as a build-in carousel module because the software does an excellent
+job, is based on an MIT license with no issues using them for private and
+business use. And offers a lot of great features!
 
 === Simple Text Carousel
 
-A slider or carousel typically is used for displaying images but the
-implementation for J1 Template support a lot more sources to be displayed
-as a slide show: simple text, for example.
+A slider or carousel is typically used for displaying images. Still, the
+implementation for the J1 Template supports a lot more sources to be
+displayed as a slide show: simple text, for example.
 
 .Simple text carousel
 carousel::demo_text_carousel[role="mb-3"]
 
-Important statements or topics can be placed e.g. on top of an article or a
-paragraph to give them better visibility. In one line, you can present
-a bunch of facts to know animated for the reader's attention within as single
-line - no much space is needed.
+Important statements or topics can be placed, e.g., on top of an article or
+a paragraph to give them better visibility. In one line, you can present
+a bunch of facts to know animated for the reader's attention within a single
+line. No much space is needed!
 
 === Parallax Text Carousel
 
@@ -215,27 +212,27 @@ plugin JustifiedGallery as the main gallery module. Beside Justified
 Gallery, a gallery based on pure _Bootstrap_ code is available with the
 built-in gallery app *gallery*.
 
-Justified Gallery is a great jQuery plugin to create responsive, infinite,
+JustifiedGallery 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 the images of a gallery.
 
-See Justified Gallery in action - and for sure all that you see is even
+See JustifiedGallery in action - and for sure all that you see is even
 responsive. Change the size of your current browser window, by width or height,
 to see what will happen!
 
-=== Justified Gallery
+=== JustifiedGallery
 
 Pictures you've made are typically not even in size. Images may have the
 same size (resolution), but some of them are orientated landscape or other
 may portrait. For that reason, a more powerful gallery is needed to create
 so-called justified views.
 
-Justified Gallery is using a so-called masonry grid layout. It works by
+JustifiedGallery is using a so-called masonry grid layout. It works by
 placing elements in an optimal position based on available horizontal and
 vertical space. Sort of like mason fitting stones in a wall. You’ll have
 seen it in use all over the Internet!
 
-.Masonry grid layout of Justified Gallery
+.Masonry grid layout of JustifiedGallery
 gallery::jg_customizer[]
 
 == Whats next

data/lib/starter_web/pages/public/learn/roundtrip/100_present_videos.adoc

@@ -5,19 +5,21 @@ date:                                   2020-11-04 00:00:00
 description: >
                                         Playing video on web pages seems not that special since you can already
                                         watch videos on web pages through plugins like Flash Player, Quicktime
-                                        or Silverlight.
-                                        A new standard goes to HTML5 Video, a pure HTML way to
+                                        or Silverlight. A new standard goes to HTML5 Video, a pure HTML way to
                                         show video on the web; instead of the previous de facto standard of using
                                         proprietary software.
 
-tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Video, Modules ]
+tags:                                   [ Roundtrip, Introduction ]
 
 permalink:                              /pages/public/learn/roundtrip/present_videos/
 regenerate:                             false
 
+comments:                               false
+fam_menu_id:                            page_ctrl_simple
+
 resources:                              [
-                                          light_gallery, justified_gallery, video_js,
+                                          lightGallery, justifiedGallery, video_js,
                                           vimeo_player, vimeo_froogaloop
                                         ]
 resource_options:
@@ -69,14 +71,14 @@ resource_options:
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Playing video on web pages seems not that special since you can already
-watch videos on web pages through plugins like _Flash Player_, _Quicktime_
+watch videos on web pages through plugins like _Flash Player_, _Quicktime_,
 or _Silverlight_. A new standard goes to HTML5 Video, a pure HTML way to
-show video on the web; instead of the previous de facto standard of using
+show video on the web, instead of the previous de facto standard of using
 proprietary software.
 
 == Video Galleries
 
-HTML5 Video opens the doors to your way presenting video content. Modern
+HTML5 Video opens the doors to your way of presenting video content. Modern
 browsers support the video tag `<video>` for the HTML5 video standard.
 Browsers have a built-in multimedia framework already for decoding and displaying
 video content. No need to use such proprietary software components anymore!
@@ -86,21 +88,21 @@ LightGallery.
 
 Two types of video sources are supported:
 
-. videos from local files (your web space)
+. videos from local files (your webspace)
 . videos from online sources (on the Internet) like YouTube, Vimeo, etc.
 
 The combination of the App gallery and the lightbox LightGallery is entirely
 usable for all the video content you want to present on your site. Galleries
 can be placed elsewhere with your content. You can use them for video blogs
-by putting them into your blog articles content.
+by putting them into your blog article's  content.
 
-WARNING: LightGallery can be used for free for private use but for
-business use, a commercial license is needed. See link:{light-gallery-license}[Light Gallery license]
-how to use LightGallery for commercial webs and projects.
+WARNING: LightGallery can be used for free for private use, but a commercial
+license is needed for business use. See link:{light-gallery-license}[Light Gallery license]
+how to use LightGallery for commercial websites and projects.
 
 == Local video content
 
-Digital image content, simple pictures or vidoe, are easy to make. Today, each
+Digital image content, simple pictures or videos, are easy to make. Today, each
 and every mobile has a camera - not that bad! Presenting a bunch
 of (digital) pictures is very easy by using Justified Gallery, for example.
 Videos created by a digicam or a mobile can be played by J1 Template using the
@@ -112,17 +114,16 @@ Two players are available with LightGallery:
 . http://videojs.com/[video.js], a excellent Javascript video library
 
 NOTE: The HTML5 specification does _not_ define which video and audio formats
-browsers _should_ support. J1 LightGallery supports all _typical_ types of
-HTML5 Video formats browsers support today such as MP4, WebM, and Ogg.
+browsers _should_ support. J1 LightGallery can play all types of standard
+HTML5 Video formats on modern browsers today (MP4, WebM, and Ogg).
 
-.HTML5 video gallery
 gallery::jg_video_html5[role="mb-5"]
 
 == Online video content
 
 The Internet is full of inspiring content. Video content is popular,
-the number of channels at _YouTube_ is enormous. If you want to present
-video content from the Internet, e.g. your channel, the online video
+the number of channels on _YouTube_ is enormous. If you want to present
+video content from the Internet, e.g., your channel, the online video
 support of J1 Template may be the right choice. Find some enjoyable videos
 from James Cordon's channel: Carpool Karaoke.
 
@@ -134,7 +135,7 @@ gallery::jg_video_online_vimeo[role="mb-5"]
 
 == Whats next
 
-Images and videos are quite visual - and could be impressive, for sure.
+Images and videos are pretty visual. And it can be impressive, for sure.
 But the most visual component is the text for all pages, for all sites on the
 Internet. To see how text could be presented great for modern responsive
 websites, check the section Typography next.

data/lib/starter_web/pages/public/learn/roundtrip/200_typography.adoc

@@ -8,8 +8,12 @@ description: >
                                         take on an important role of acting not only as plain text but will also serve
                                         as something like images.
 
-tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Typography, Module ]
+tags:                                   [ Roundtrip, Introduction ]
+
+
+comments:                               false
+fam_menu_id:                            page_ctrl_simple
 
 permalink:                              /pages/public/learn/roundtrip/typography/
 regenerate:                             false

data/lib/starter_web/pages/public/learn/roundtrip/300_icon_fonts.adoc

@@ -3,15 +3,19 @@ title:                                  Roundtrip
 tagline:                                icon fonts
 date:                                   2020-11-06 00:00:00
 description: >
-                                        J1 Template support popular icons font sets out-of-the-box.
+                                        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 is 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.
 
-tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Icon, Module ]
+tags:                                   [ Roundtrip, Introduction ]
+
+
+comments:                               false
+fam_menu_id:                            page_ctrl_simple
 
 permalink:                              /pages/public/learn/roundtrip/mdi_icon_font/
 regenerate:                             false
@@ -55,15 +59,15 @@ resource_options:
 
 == Icon Fonts
 
-J1 Template support popular icons font sets out-of-the-box:
+J1 Template supports popular icons font sets out-of-the-box:
 
 * link:{mdi-home}[Material Design Icons, {browser-window--new}] (MDI)
 * link:{fontawesome-home}[FontAwesome Icons V5, {browser-window--new}] (FA)
 * link:{iconify-home}[Iconify Icons, {browser-window--new}] (II)
 
 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 some details
-for <<Material Design Icons>> and <<FontAwesome Icons>>.
+different icons for many categories used for the Web. See below for some
+details for <<Material Design Icons>> and <<FontAwesome Icons>>.
 
 Iconify icons is not a locally stored icon-set like MDI or FA. All icons are
 loaded over the Internet using the so-called *Unified OpenSource Icon
@@ -72,15 +76,14 @@ Framework*. See section <<Iconify Icons>> for more information.
 
 == Material Design Icons
 
-The primary icon-set for J1 Template is
+The primary icon-set for the J1 Template is
 link:{mdi-home}[Material Design Icons, {browser-window--new}],
-because it is extremely rich set providing more than 5900+ icons for the
-current version (v5.9.55). From a design perspective, _MDI_ has an excellen
-*Material Design* support an comes with the original icon set created by
-_Google_ build-in.
+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.
 
 _Material Design Icons_ (MDI) is a beneficial design resource for Web Design
-that is based on _Google_'s Material Design. _MDI_ is a community-driven
+based on _Google_'s Material Design. _MDI_ is a community-driven
 project to create an increased number of icons based on _Google_'s official
 repository and MD style specification.
 
@@ -223,13 +226,13 @@ mdi:heart[5x md-red-900 mdi-pulsed]
 
 |===============================================================================
 
-NOTE: Using Material Design Icons with Asciidoc is quite easy as an inline
-macro `mdi:` is available to place icons where ever you want. See more about
+NOTE: Using Material Design Icons with Asciidoc is easy as an inline
+macro `mdi:` is available to place icons whereever you want. See more about
 this in section
-link:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions]
+link:{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
+various platforms to download icons in the format, color, and size they need
 for any project. The repo contains today 2100+ icons plus converted icons from
 the official set created by _Google_.
 
@@ -239,8 +242,8 @@ icon set is fully integrated and can be used out-of-the-box.
 == FontAwesome Icons
 
 _FontAwesome_ is a font and icon toolkit based on CSS. It was initially created
-by _Dave Gandy_. The previous *version 4* was mainly for the use with Twitter
-Bootstrap *V3*. The new version *V5*, released in December 2017, is focussing
+by _Dave Gandy_. The previous *version 4* was mainly for the use of Twitter
+Bootstrap *V3*. The new version *V5*, released in December 2017, focuses on
 all frameworks used for web development. Today, the *free FA* icon set comes
 with 1400+ icons included.
 
@@ -252,33 +255,34 @@ 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 a face-lifting. Version 5
-comes with more than 2300+ icons, but many of them are available with the Pro
-license only. For the Free version, only a subset of 900+ icons is available.
+FontAwesome V5 meets the Material Design idea (of _Google_), and in comparison
+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 has been extended for J1 Template to
-the same classes (and their respective names) as for other Font Icon sets.
+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 checkout what icons available at
+You can check out what icons available at
 link:{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 needs to be
+load.  But in comparison to Version 4, a lot of differences need to be
 noticed.
 
 If you haven't used V5 yet, it is highly recommended to visit the
 link:{fontawesome-get-started}[Get started, {browser-window--new}] pages to
-learn the basics and features and styles.
+learn the basics and features, and styles.
 
-With version V5 of _FontAwesome_, the icon set is split in two general parts:
+With version V5 of _FontAwesome_, the icon set is split into two general
+parts:
 
 * standard icons (symbols) indicated by *FAS*
 * brand icons (icons for companies and brands) indicated by *FAB*
 
-NOTE: Using FontAwesome with Asciidoc is quite easy as two inline macros
-`fab:` and `fas:` are available to place icons where ever you want. See more
+NOTE: Using FontAwesome with Asciidoc is quite easy as two inline macros,
+`fab:` and `fas:`, are available to place icons where ever you want. See more
 about this in section
 link:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions]
 
@@ -441,21 +445,21 @@ fas:heart[5x md-red-900 fa-pulsed]
 == Iconify Icons
 
 MDI and FA are rich icon sets but designed for general use. Sometimes icons
-are missing in one of these fonts like specific brand or theme icons. An
+are missing in one of these fonts, like a specific brand or theme icon. An
 interesting solution for using font icons from a remote repository is
 link:{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 J1 Template, the
-client is build-in and is loaded if Iconify is requested as a resource. To see
-what icon sets available with that framework, check the page
+To access that framework, a Javascript client is needed. For the J1 Template,
+the client is build-in and is loaded if Iconify is requested as a resource.
+To see what icon sets available with that framework, check the page
 link:{iconify-icon-sets}[Iconify Icon Sets, {browser-window--new}].
 
 NOTE: Using Iconify icons with J1 Template 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:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions]
+link:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions].
 
 Currently, over 40,000 vector icons are available for many different use cases.
 Find some examples below.