j1-template 2021.0.16 → 2021.1.4

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

@@ -1,23 +1,25 @@
 ---
 title:                                  Roundtrip
 tagline:                                present videos
-date:                                   2020-11-04 00:00:00
+date:                                   2020-11-04 00:00:00  +100
 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

@@ -1,15 +1,19 @@
 ---
 title:                                  Roundtrip
 tagline:                                typography
-date:                                   2020-11-05 00:00:00
+date:                                   2020-11-05 00:00:00 +100
 description: >
                                         The character font serves as one of the most crucial branding elements for
                                         any business. Typography matters for any media presenting text. The text will
                                         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

@@ -1,17 +1,21 @@
 ---
 title:                                  Roundtrip
 tagline:                                icon fonts
-date:                                   2020-11-06 00:00:00
+date:                                   2020-11-06 00:00:00 +100
 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.

data/lib/starter_web/pages/public/learn/roundtrip/400_asciidoc_extensions.adoc

@@ -1,18 +1,19 @@
 ---
 title:                                  Roundtrip
 tagline:                                asciidoc extensions
-date:                                   2020-11-07 00:00:00
+date:                                   2020-11-07 00:00:00 +100
 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.
-                                        A set of useful extensions to the Markup language Asciidoc are made
-                                        especially for documents of the Jekyll content type pages, but can
-                                        be used for post or collections as well.
+                                        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.
 
-tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Asciidoc, Extension ]
+tags:                                   [ Roundtrip, Introduction ]
+
+comments:                               false
+fam_menu_id:                            page_ctrl_simple
 
 permalink:                              /pages/public/learn/roundtrip/asciidoc_extensions/
 regenerate:                             false
@@ -60,27 +61,27 @@ Most extensions are based on the examples given with the
 If you simply want to use the extensions from this repository, go ahead to
 {asciidoctor-extensions-use-extension}[Using an extension, {browser-window--new}].
 
-To create extensions on your own, it is highly recommended to read first the
+To create extensions on your own, it is highly recommended to read the
 {asciidoctor-user-manual-extensions}[extensions section, {browser-window--new}] in
 the Asciidoctor user manual.
 
 == Asciidoc Extensions
 
-All already implemented Asciidoctor Extensions can be found below. A set of
-additional useful extensions to the Markup language Asciidoc are made
-especially for documents of the Jekyll content type pages (but can be used
-for post or collections as well).
+All already implemented Asciidoctor Extensions can be found below. Additional
+valuable extensions to the Markup language Asciidoc to the Markup language
+Asciidoc are made especially for documents of the Jekyll content type pages
+(but can be used for posts or collections as well).
 
 == Asciidoc Code
 
 J1 Template 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 listingblock box placed to the top right of
+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`,
 clicking the toggle button `VIEW` displays (or hide) the content given by the
 `result block`.
 
-The `View Result Extension` is quite useful for example sections discussing
+The `View Result Extension` is quite helpful, for sections discussing
 Asciidoc code and how the resulting (HTML) code would look alike.
 
 .This example place a button `VIEW` top right of the example box
@@ -118,8 +119,8 @@ CAUTION: Icon background-color: red
 == Q&A Blocks
 
 Q&A sections are used quite often to answer popular questions. To make
-such a Q&A section more eye-minded, the additional Admonition Blocks
-`[QUESTION]` and `[ANSWER]` are available for J1 Template as Asciidoctor
+such a Q&A section more eye-minded. The additional Admonition Blocks
+`[QUESTION]` and `[ANSWER]` are available through the J1 Template Asciidoctor
 extensions.
 
 === Question block
@@ -145,7 +146,7 @@ What's the main tool for selecting colors used for J1 Template?
 
 The Admonition Answer block is an extension to the Asciidoc admonition
 block types that introduce an admonition type of answer in conjunction
-to the admonition of type question.
+with the type question's admonition.
 
 .Example of a answer block
 [source, prometheus, role="noclip"]
@@ -165,11 +166,11 @@ You'll find the full color scheme for Material Design.
 
 == Lightboxes
 
-To make the use of the built-in Lightbox easier, J1 Template offers an Asciidoc
-extension: the LightBox block macro. The `lightbox::` block macro embeds one or
-more images into the output document and puts the default Lightbox (lightbox)
-for J1 automatically on. For all images, the `size` (width) and individual
-`caption text` can be configured.
+To make the use of the built-in Lightbox easier, the J1 Template offers an
+Asciidoc extension: the LightBox block macro. The `lightbox::` block macro
+embeds one or more images into the output document and puts the default
+Lightbox for J1 automatically on. For all images, the `size` (width) and
+individual `caption text` can be configured.
 
 .Lightbox Block
 [source, prometheus, role="noclip"]
@@ -182,11 +183,11 @@ NOTE: For a `lightbox::` block, images are placed in the output document
 without any other scaling than in width - they are placed using simple
 HTML `img` tags. This is fine for images that are even in size. For images in
 different sizes, a gallery should be used as a J1 Gallery Apps to rearrange
-images and make them fit at its best for the available space.
+images and make them fit at their best for the available space.
 
 === Standalone Images
 
-For your convenience, and better readability, the image data should be
+For your convenience and better readability, the image data should be
 defined as Asciidoc attributes. The image data is given as a string
 of data pairs:
 
@@ -209,7 +210,7 @@ default asset path for images, a relative path needs to be given for
 `path/to/image`.
 
 WARNING: If an absolute path is configured, like `/path/to/image`, the base
-path gets ignored - this is the default behaviour of the Asciidoc Markup
+path gets ignored - this is the default behavior of the Asciidoc Markup
 processor. If an absolute path is given, the full path to the images
 used has to be configured.
 
@@ -245,7 +246,7 @@ lightbox::images-group[ 400, {data-images-group}, group_name ]
 
 == Icon Fonts
 
-J1 Template comes with full icon support for Asciidoc documents included.
+The J1 Template comes with full icon support for Asciidoc documents included.
 All icon fonts are supported:
 
 * FA (FontAwesome)
@@ -390,17 +391,17 @@ and Twitter Emoji emoji:smile[].
 
 == Blind Text (Lorem)
 
-The Ruby Gem Middleman, a Ruby-gem based static site generator, provides a
-set of powerful helpers for generating random text content. The Lorem
+The Ruby Gem Middleman, a Ruby-based static site generator, provides a
+set of great helpers for generating random text content. The Lorem
 inline macro `lorem:` adapted this functionality from Middleman for the use
 of Asciidoc-based documents processed by Jekyll.
 
 If you start writing larger documents having several chapters, not all of the
 content is available at the beginning. It is quite useful to place blind text
-first to get a better impression how a page will look-alike that is not
+first to get a better impression of how a page will look-alike that is not
 finished yet.
 
-Placeholders for blind text comes in several flavours given by `macro`. The
+Placeholders for blind text comes in several flavors given by `macro`. The
 syntax for the `lorem:` inline macro is simple like this:
 
 [source, prometheus]
@@ -491,11 +492,12 @@ include::{documentdir}/100_gistblock.asciidoc[]
 
 Asciidoc, respectively Asciidoctor, extensions open up the Markup language to
 new use cases. Using the full power of programming languages to extend what's
-needed whether it be Ruby, Java, Groovy or JavaScript. The number of extensions
-will grow - to get handy and powerful functionality that is needed for modern
-web pages based on the Asciidoc Markup language generated by Jekyll. For sure!
+needed, whether it be Ruby, Java, Groovy, or JavaScript. The number of
+extensions will grow - to get handy and powerful functionality that is needed
+for modern web pages based on the Asciidoc Markup language generated by Jekyll.
+For sure!
 
-The next preview is focussing advanced Bootstrap Modals. The modals feature
+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!