RubyGems - j1-template - Versions diffs - 2020.0.18 → 2020.0.24 - Mend

j1-template 2020.0.18 → 2020.0.24

Files changed (523) hide show

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

@@ -1,21 +1,24 @@
 ---
 title:                                  Roundtrip
 tagline:                                present videos
-description:                            J1 Template Roundtrip - Present video based data
-tags:                                   [ Page, Roundtrip ]
-index:                                  [ Template, Roundtrip, Video ]
-categories:                             [ pages ]
-scrollbar:                              false
-toc:                                    true
+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
+                                        show video on the web; instead of the previous de facto standard of using
+                                        proprietary software.
+date:                                   2020-11-04 12:00:00
+tags:                                   [ Roundtrip, Introduction ]
+categories:                             [ Video, Module ]
 permalink:                              /pages/public/learn/roundtrip/present_videos/
-regenerate:                             true
+regenerate:                             false
 resources:                              [
                                           light_gallery, justified_gallery, video_js,
-                                          vimeo_player, vimeo_player, vimeo_froogaloop
+                                          vimeo_player, vimeo_froogaloop
                                         ]
 resource_options:
   - attic:
@@ -44,96 +47,85 @@ resource_options:
 ---
+// Page Initializer
+// =============================================================================
 // Enable the Liquid Preprocessor
-// -----------------------------------------------------------------------------
 :page-liquid:
-// Set other global page attributes here
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-//:my-asciidoc-attribute:
+// :page--attr:                         <attr-value>
+:images-dir:                            {imagesdir}/pages/roundtrip/100_present_images
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
-{% capture set_env_entry_document %}themes/{{site.template.name}}/procedures/global/set_env_entry_document.proc{%endcapture%}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
-// Initialize entry document environmental attributes
+// Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{set_env_entry_document}} %}
-// Load tag, url and data attributes
-// -----------------------------------------------------------------------------
-include::{includedir}/attributes.asciidoc[tag=tags]
-include::{includedir}/attributes.asciidoc[tag=urls]
-include::{includedir}/attributes.asciidoc[tag=data]
-// Set local page attributes
-// -----------------------------------------------------------------------------
-:images-dir:                            {imagesdir}/pages/roundtrip/100_present_images
+{% include {{load_attributes}} scope="all" %}
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-// Include sub-documents
-// -----------------------------------------------------------------------------
-Playing video on a web page seems not that special since you can already
+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.
+proprietary software.
 == Video Galleries
-*HTML5 Video* open the doors to *your way* presenting video content. Modern
-browsers support the video tag `<video>` for the HTML5 Video standard. Browsers
-have a build-in multimedia framework already for decoding and displaying
+HTML5 Video opens the doors to your way 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!
-HTML5 Video support is given by the App *gallery* combined with the Lightbox
-*LightGallery*.
+HTML5 Video support is given by the App gallery combined with the Lightbox
+LightGallery.
 Two types of video sources are supported:
-. videos from *local* files (your web space)
-. videos from *online* sources (on the Internet) like YouTube, Vimeo, etc.
+. videos from local files (your web space)
+. videos from online sources (on the Internet) like YouTube, Vimeo, etc.
-The combination of the App *gallery* and the lightbox *LightGallery* is quite
+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
-for example by placing them into your blog articles content.
+by putting them into your blog articles 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 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.
 == Local video content
-Digital image content, simple pictures or vidoes, are quite 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 digi cam or a mobile can played by J1 Template using the
-*HTML5 Video* support of *LightGallery*.
+Digital image content, simple pictures or vidoe, 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
+HTML5 Video support of LightGallery.
-Two players are available with *LightGallery*:
+Two players are available with LightGallery:
 . an internal player used by default
 . 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 supports all _typical_ types of
+HTML5 Video formats browsers support today such as MP4, WebM, and Ogg.
 .HTML5 video gallery
 gallery::jg_video_html5[role="mb-5"]
 == Online video content
-The Internet is full of interesting content. Video content is very popular,
-the number of channels at e.g. _YouTube_ is enormous. If you want to present
-video content from the Internet, e.g. your channnel, the online video
-support of J1 Template may a good choice. Find some enjoyable videos from
-*James Cordon's* channel: *Carpool Karaoke*.
+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
+support of J1 Template may be the right choice. Find some enjoyable videos
+from James Cordon's channel: Carpool Karaoke.
 .YouTube Video Gallery - Carpool Karaoke
 gallery::jg_video_online_youtube[role="mb-5"]
@@ -143,9 +135,9 @@ gallery::jg_video_online_vimeo[role="mb-5"]
 == Whats next
-Images and videos are quite *visual* - and could be impressive, for sure.
-But the most visual component is *text* for all pages, for all sites on the
+Images and videos are quite visual - and could 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.
+websites, check the section Typography next.
 What? Find out how it works. go for: link:{roundtrip-typography}[Typography].

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

@@ -1,22 +1,21 @@
 ---
 title:                                  Roundtrip
 tagline:                                typography
-description:                            Typography, a crucial branding element
+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:                                   [ Page, Roundtrip ]
-index:                                  [ Template, Roundtrip, Typography ]
-categories:                             [ pages ]
+date:                                   2020-11-05 12:00:00
+tags:                                   [ Roundtrip, Introduction ]
+categories:                             [ Typography, Module ]
 permalink:                              /pages/public/learn/roundtrip/typography/
-regenerate:                             true
-toc:                                    true
-advertising:                            false
+regenerate:                             false
 resources:                              []
 resource_options:
-# - ssm:
-#     mode:                             menu
   - attic:
       padding_top:                      400
       padding_bottom:                   50
@@ -33,71 +32,59 @@ resource_options:
             href:                       https://unsplash.com/@alicekat/portfolio
 ---
+// Page Initializer
+// =============================================================================
 // Enable the Liquid Preprocessor
-// -----------------------------------------------------------------------------
 :page-liquid:
-// Set other global page attributes here
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-//:my-asciidoc-attribute:
+// :page--attr:                         <attr-value>
+:images-dir:                            {imagesdir}/pages/roundtrip/100_present_images
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
-{% capture set_env_entry_document %}themes/{{site.template.name}}/procedures/global/set_env_entry_document.proc{%endcapture%}
-// Initialize entry document environmental attributes
-// -----------------------------------------------------------------------------
-{% include {{set_env_entry_document}} %}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
-// Load tag, url and data attributes
+// Load page attributes
 // -----------------------------------------------------------------------------
-include::{includedir}/attributes.asciidoc[tag=tags]
-include::{includedir}/attributes.asciidoc[tag=urls]
-include::{includedir}/attributes.asciidoc[tag=data]
-// Set local page attributes
-// -----------------------------------------------------------------------------
-// :images-dir:                         {imagesdir}/path/to/page/images
+{% include {{load_attributes}} scope="all" %}
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-// Include sub-documents
-// -----------------------------------------------------------------------------
 == Typography
-Typography serves as one the most crucial branding elements for any business.
-Typography matters for any media presenting text. Text will take on a important
-role of acting not only as plain text but will also serve as something like
-images.
+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.
 == Responsive Text
 One common flaw seen in many templates and frameworks (sadly to say: the same
-to Bootstrap) is a lack of support for truly *responsive text*. While elements
-on a page resize fluidly, text still resizes on a fixed basis. To avoiding this
-issue, especially for heavily text focussed pages, J1 Template supports styles
-that fluidly scales text size and line-height to optimize readability for the
-user.
+to Bootstrap, including V4) is a lack of support for genuinely responsive text.
+While elements on a page resize fluidly, the text still resizes on a fixed basis.
+To avoiding this issue, especially for heavily text focussed pages, J1 Template
+supports styles that fluidly scale text size and line-height to optimize
+readability for the user.
-Below you find an example how text behaves if defined on a fixed basis - what
-you'll see quite often. Change the size of your Browser Window to see what
-will happen in terms of responsiveness.
+Below you find an example of how text behaves if defined on a fixed basis -
+what you'll see quite often. Change the size of your Browser Window to see
+what will happen in terms of responsiveness.
 ++++
 <div>
-  <button type="button" name="toggle-r-text" class="btn btn-info btn-raised btn-flex mt-3 mb-3">
+  <button type="button" name="toggle-r-text" class="btn btn-primary btn-raised btn-flex mt-3 mb-3">
     <i class="toggle-button mdi mdi-toggle-switch-off mdi-lg mdi-md-bg-primary-50 mr-1"></i>
     Toggle rtext
   </button>
   <div class="mb-4">
     <div class="content">
-      <h4 class="notoc">The Extremes of Good and Evil</h4>
-      <h6 class="notoc text-gray mb-3">Cicero, Paragraph 1.10.32 · Translation by H. Rackham, Issue 1914 - De Finibus</h6>
+      <!-- jadams, 2020-11-15: adjusted heading levels (Google optimisation) -->
+      <h3 class="notoc">The Extremes of Good and Evil</h3>
+      <p class="small notoc text-gray mb-3">Cicero, Paragraph 1.10.32 · Translation by H. Rackham, Issue 1914 - De Finibus</p>
       <p class="toggle-description no-r-text">
         But I must explain to you how all this mistaken idea of denouncing
         pleasure and praising pain was born and I will give you a complete
@@ -136,24 +123,25 @@ and off Responsive Text to see the difference!
 Responsive Text comes in five different scale factors in a range from 100 to
 500. Scaling `r-text` gives you the flexibility to use `r-text` everywhere. Or
-you can offer different text sizes of your Web for vistors having a visual
+you can offer different text sizes of your Web for visitors having a visual
 handicap or reading disabilities.
 To see `r-text` scaling in action, click on the button above to resize
-the text from `r-text` level *300* to *500* back and forth. And again: resize
-your Browser and watch the size of this text body change to see responsiveness
-of the text in action.
+the text from `r-text` level 300 to 500 back and forth. Simply resize
+your Browser and watch the size of this text body change to see the
+responsiveness in action.
 ++++
 <div>
-  <button type="button" name="scale-r-text" class="btn btn-info btn-raised btn-flex mt-3 mb-3">
+  <button type="button" name="scale-r-text" class="btn btn-primary btn-raised btn-flex mt-3 mb-3">
     <i class="scale-button mdi mdi-arrow-up mdi-lg mdi-md-bg-primary-50 mr-1"></i>
     Scale rtext
   </button>
   <div class="mb-4">
     <div class="content">
-      <h4 class="notoc">The Extremes of Good and Evil</h4>
-      <h6 class="notoc text-gray mb-3">Cicero, Paragraph 1.10.33 · Translation by H. Rackham, Issue 1914 - De Finibus</h6>
+      <!-- jadams, 2020-11-15: adjusted heading levels (Google optimisation) -->
+      <h3 class="notoc">The Extremes of Good and Evil</h3>
+      <p class="small notoc text-gray mb-3">Cicero, Paragraph 1.10.32 · Translation by H. Rackham, Issue 1914 - De Finibus</p>
       <p class="scale-description r-text-300">
         On the other hand, we denounce with righteous indignation and dislike men who
         are so beguiled and demoralized by the charms of pleasure of the moment, so
@@ -184,21 +172,21 @@ of the text in action.
 == Scale factors
-As mentioned, `r-text` comes in five levels of size. The base of `r-text` are
+As mentioned, `r-text` comes in five levels of size. The base of `r-text` is
 the Fibonacci numbers extracted from the Fibonacci series. These numbers are
 the most popular division ratios in typography. When speaking of the golden
 ratio (1: 1.618) in typography and graphic design, the Fibonacci numbers are
 usually the base.
-The Fibonacci series are translated into CSS Media queries and scale a base
-font size accordingly. Additionaly, the resulting font scale series have
+The Fibonacci series is translated into CSS Media queries and scale a base
+font size accordingly. Further, the resulting font scale series have
 multipliers (scale factors) ranging from 0.5 (50%) up to 1.0 (100%) of the
 base.
 That way, five series are available by the five scale factors. See the following
 table how `r-text` scales.
-[cols="3,2,7a", options="header", role="table-responsive-stacked-lg"]
+[cols="3,2,7a", options="header", role="rtable"]
 |===============================================================================
 |Property | Factor |Example text
@@ -252,11 +240,11 @@ explorer of the truth, the master-builder of human happiness.
 //////////
 === Mixing font sizes
-See the example below. Two cards are tied together by a title of *Your Topic*.
-The *taglines* are different and focus on *different* things. Because the title
-is on each and every card of such a group, it makes sense to give the *upper*
-level headline a smaller font size than the *tagline* that decribes different
-*features*.
+See the example below. Two cards are tied together by a title of Your Topic.
+The taglines are different and focus on different things. Because the title
+is on each and every card of such a group, it makes sense to give the upper
+level headline a smaller font size than the tagline that decribes different
+features.
 To not loose the focus on reading the text, font icons are used to support what
 a card decribes to get the readers orientated better. The left one has a
@@ -267,7 +255,7 @@ video and audio.
 <div id="roundtrip_example_panel" class="mt-2 mb-3"></div>
 ++++
-The *body* text is the *smallest* in size. On one hand to save space on other
+The body text is the smallest in size. On one hand to save space on other
 hand the readers know in general what they can can expect to read about. To
 focus the body text, it's positioned in the middle and centered for optimal
 placement. A final quote text followed by a button in card footer guides the
@@ -278,20 +266,20 @@ choosen per chance. It is a good idea to spend some time on text and design.
 === Text in Action
-User interfaces (UI) enable vistors to interact with a page, explore things
+User interfaces (UI) enable visitors to interact with a page, explore things
 on their own - playing around. Presenting a service or a product in simple nav
 elements may help to reduce to space needed - more can be placed on page. On
 other hand, navigation elements present by playful and interactive means.
 The next two simple examples shows you what type of UI's may helpful to present
-a bunch of information *on a small footprint*: tabbed text by using Bootstrap's
-*Nav Pills*.
+a bunch of information on a small footprint: tabbed text by using Bootstrap's
+Nav Pills.
-The design for the Bootstrap *nav pills* were change into MD Design. As all
+The design for the Bootstrap nav pills were change into MD Design. As all
 elements available with J1 Template, the _Meterial Design_ color palette is
 used. All Bootstrap base classes can be used to colorize:
-[cols="5,7a", options="header", role="table-responsive-stacked-lg mb-5"]
+[cols="5,7a", options="header", role="rtable mb-5"]
 |===============================================================================
 |Property | Example
@@ -314,7 +302,7 @@ used. All Bootstrap base classes can be used to colorize:
 |`nav-pills-info`
 |
 ++++
-<button type="button" class="btn btn-info btn-raised btn-round">
+<button type="button" class="btn btn-primary btn-raised btn-round">
   color example
 </button>
 ++++
@@ -518,9 +506,9 @@ used. All Bootstrap base classes can be used to colorize:
 == Whats next
-Have you enjoyed playing with text? We hope so. But even more can J1 do for
+Have you enjoyed playing with the text? We hope so. But even more, J1 can do for
 your web pages. With the examples on that page, icons were used to support the
-meaning what was grouped as text.
+meaning of what was grouped as text.
 J1 Template supports popular icons font sets like:
@@ -529,4 +517,4 @@ J1 Template supports popular icons font sets like:
 * Iconify
 Would you like learn more about icons? The next example page focus on what's
-possible using link:{roundtrip-icon-fonts}[icon fonts].
+possible using link:{roundtrip-icon-fonts}[icon fonts, {browser-window--new}].

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

@@ -1,11 +1,17 @@
 ---
 title:                                  Roundtrip
 tagline:                                icon fonts
-description:                            J1 Template Roundtrip - Icon Fonts
-tags:                                   [ Page, Roundtrip ]
-index:                                  [ Template, Roundtrip, Material, Design, MDI, FontAwesome, Icon, Fonts ]
-categories:                             [ pages ]
+description: >
+                                        J1 Template support 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.
+date:                                   2020-11-06 12:00:00
+tags:                                   [ Roundtrip, Introduction ]
+categories:                             [ Icon, Module ]
 permalink:                              /pages/public/learn/roundtrip/mdi_icon_font/
 regenerate:                             false
@@ -25,77 +31,65 @@ resource_options:
             href:                       https://unsplash.com/@aquatium
 ---
+// Page Initializer
+// =============================================================================
 // Enable the Liquid Preprocessor
-// -----------------------------------------------------------------------------
 :page-liquid:
-// Set other global page attributes here
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-//:my-asciidoc-attribute:
+// :page--attr:                         <attr-value>
+:images-dir:                            {imagesdir}/pages/roundtrip/100_present_images
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
-{% capture set_env_entry_document %}themes/{{site.template.name}}/procedures/global/set_env_entry_document.proc{%endcapture%}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
-// Initialize entry document environmental attributes
+// Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{set_env_entry_document}} %}
-// Load tag, url and data attributes
-// -----------------------------------------------------------------------------
-include::{includedir}/attributes.asciidoc[tag=tags]
-include::{includedir}/attributes.asciidoc[tag=urls]
-include::{includedir}/attributes.asciidoc[tag=data]
-// Set local page attributes
-// -----------------------------------------------------------------------------
-// :images-dir:                         {imagesdir}/path/to/page/images
+{% include {{load_attributes}} scope="all" %}
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-// Include sub-documents
-// -----------------------------------------------------------------------------
 == Icon Fonts
 J1 Template support popular icons font sets out-of-the-box:
-* link:{mdi-home}[Material Design Icons, {window}] (MDI)
-* link:{fontawesome-home}[FontAwesome Icons V5, {window}] (FA)
-* link:{iconify-home}[Iconify Icons, {window}] (II)
+* 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>>.
-Iconify Icons is not a local stored icon set like MDI or FA. All icons are
-loaded over the *Internet* using the so-called unified open source icon
-framework. See section <<Iconify Icons>> for more information.
+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*. See section <<Iconify Icons>> for more information.
 == Material Design Icons
-The primary icon set for J1 Template are link:{mdi-home}[Material Design Icons, {window}],
-because it is an rich set providing more than 3300+ icons (v3.3.92). From a design
-prospective, _MDI_ has an excellent Material Design support an comes with the
+The primary icon-set for J1 Template is link:{mdi-home}[Material Design Icons, {browser-window--new}],
+because it is extremely rich set providing more than 3300+ icons (v3.3.92). From a design
+perspective, _MDI_ has an excellent Material Design support an comes with the
 original icon set created by _Google_ build-in.
-_Material Design Icons_ (MDI) is a very helpful design resource for Web Design
-that is based on *_Google_'s Material Design*. _MDI_ is a community-driven
-project to create an increased icon-set based on _Google_'s official repository
+_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
+project to create an increased number of icons based on _Google_'s official repository
 and MD style specification.
 .Material Design Icons
-[cols="2a,3a,4a,^", options="header", width="100%", role="table-responsive-stacked-lg mt-3"]
+[cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
 |===============================================================================
 |Size |Modifier |Markup |Render
 |1x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer +
 [source, adoc, role="noclip"]
 ----
 mdi:account[1x]
@@ -104,7 +98,7 @@ mdi:account[1x]
 |3x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer +
 [source, adoc, role="noclip"]
 ----
 mdi:account[3x]
@@ -113,7 +107,7 @@ mdi:account[3x]
 |5x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer
 [source, adoc, role="noclip"]
 ----
 mdi:account[5x]
@@ -141,7 +135,7 @@ mdi:account[5x mdi-rotate-315]
 |5x
 |`mdi-light` +
 `mdi-flip-v`
-|Color set to MDI Light (Grey) and flipped vertical
+|Colour set to MDI Light (Grey) and flipped vertical
 [source, adoc, role="noclip"]
 ----
 mdi:alert[5x mdi-light mdi-flip-v]
@@ -150,7 +144,7 @@ mdi:alert[5x mdi-light mdi-flip-v]
 |5x
 |`md-indigo`
-|Color set to MDI Indigo
+|Colour set to MDI Indigo
 [source, adoc, role="noclip"]
 ----
 mdi:alert[5x md-indigo]
@@ -159,7 +153,7 @@ mdi:alert[5x md-indigo]
 |5x
 |`md-pink`
-|Color set to MDI Pink
+|Colour set to MDI Pink
 [source, adoc, role="noclip"]
 ----
 mdi:alert[5x md-pink]
@@ -178,7 +172,7 @@ mdi:loading[5x mdi-spin]
 |5x
 |`md-red-900` +
 `mdi-pulsed`
-|Color set to MDI Dark Red and added animation of type Pulsed
+|Colour  set to MDI Dark Red and added animation of type Pulsed
 [source, adoc, role="noclip"]
 ----
 mdi:heart[5x md-red-900 mdi-pulsed]
@@ -188,7 +182,7 @@ mdi:heart[5x md-red-900 mdi-pulsed]
 |===============================================================================
 NOTE: Using Material Design Icons with Asciidoc is quite easy as an inline macro
-`mdi:` is avaialble to place icons where ever you want. See more about
+`mdi:` is available to place icons where ever you want. See more about
 this in section link:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions]
 _MDI_ is a growing collection to allow designers and developers targeting
@@ -199,14 +193,14 @@ the official set created by _Google_.
 _J1 Template_ 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.
-For MDI a *Preview Page* is available to explore what can be done base on the
-J1 implemetation regarding sizes, colors, animations etc. Go for the
-link:{previewer-mdi}[Preview Page, {window}] and check-out what's
+For MDI a Preview Page is available to explore what can be done base on the
+J1 implementation regarding sizes, colours, animations etc. Go for the
+link:{previewer-mdi}[Preview Page, {browser-window--new}] and check-out what's
 possible using MDI font icons!
 == FontAwesome Icons
-FontAwesome is a font and icon toolkit based on CSS. It was originally created
+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 all
 frameworks used for web development. Today, FA comes with 2300+ icons included.
@@ -214,8 +208,8 @@ frameworks used for web development. Today, FA comes with 2300+ icons included.
 [NOTE]
 ====
-Since version 5, the icon set comes in two packages: FontAwesome *Free*
-and the *proprietary* FontAwesome *Pro* version available for a license fee.
+Since version 5, the icon set comes in two packages: FontAwesome Free
+and the proprietary FontAwesome Pro version available for a license fee.
 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,
@@ -223,13 +217,13 @@ and the MIT License.
 ====
 .FontAwesome Icons
-[cols="2a,3a,4a,^", options="header", width="100%", role="table-responsive-stacked-lg mt-3"]
+[cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
 |===============================================================================
 |Size |Modifier |Markup |Render
 |1x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer
 [source, adoc, role="noclip"]
 ----
 fas:user[1x]
@@ -238,7 +232,7 @@ fas:user[1x]
 |3x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer
 [source, adoc, role="noclip"]
 ----
 fas:user[3x]
@@ -247,7 +241,7 @@ fas:user[3x]
 |5x
 |no modifier set
-|All `icon_name` can be found on the Preview page for *MDI Icon Previewer*
+|All `icon_name` can be found on the Preview page for MDI Icon Previewer
 [source, adoc, role="noclip"]
 ----
 fas:user[5x]
@@ -266,7 +260,7 @@ fas:user[5x fa-rotate-90]
 |5x
 |`mdi-light` +
 `fa-flip-v`
-|Color set to MDI Light (Grey) and flipped vertical
+|Colour set to MDI Light (Grey) and flipped vertical
 [source, adoc, role="noclip"]
 ----
 fas:exclamation-triangle[5x mdi-light fa-flip-v]
@@ -275,7 +269,7 @@ fas:exclamation-triangle[5x mdi-light fa-flip-v]
 |5x
 |`md-indigo`
-|Color set to MDI Indigo
+|Colour set to MDI Indigo
 [source, adoc, role="noclip"]
 ----
 fas:alert[5x md-indigo]
@@ -284,7 +278,7 @@ fas:alert[5x md-indigo]
 |5x
 |`md-pink`
-|Color set to MDI Pink
+|Colour set to MDI Pink
 [source, adoc, role="noclip"]
 ----
 fas:alert[5x md-pink]
@@ -303,7 +297,7 @@ fas:circle-notch[5x fa-spin]
 |5x
 |`md-red-900` +
 `md-red-900` `fa-pulsed`
-|Color set to MDI Dark Red and added animation of type Pulsed
+|Colour set to MDI Dark Red and added animation of type Pulsed
 [source, adoc, role="noclip"]
 ----
 fas:heart[5x md-red-900 fa-pulsed]
@@ -313,57 +307,57 @@ fas:heart[5x md-red-900 fa-pulsed]
 |===============================================================================
 NOTE: Using FontAwesome with Asciidoc is quite easy as two inline macros
-`fas:` and `fas:` are avaialble to place icons where ever you want. See more about
+`fas:` 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]
-FontAwesome V5 meets the Material Design idea (of _Google_) and in compare to
-Version 4, the current version is much more than a face-lifting. The Version 5
-comes with more than 2300+ icons but many of them are available with the *Pro*
-license only. For the *Free* version, 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 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.
 NOTE: The CSS styles for FontAwesome V5 has been extended for J1 Template to
-the *same* styles (and their respective *names*) as for other Font Icon sets.
-Already existing styles like `fa-flip-vertical` is available as `fa-flip-v`
-as well. See all styles that can be used with the MDI
-link:{previewer-mdi}[Preview Page, {window}].
+the same classes (and their respective names) as for other Font Icon sets.
+Already existing styles like `fa-flip-vertical` are available as `fa-flip-v`
+as well. See all types that can be used with the MDI
+link:{previewer-mdi}[Preview Page, {browser-window--new}].
 You can checkout what icons available at link:{fontawesome-icons}[FontAwesome Icons,
-{window}]. _FontAwesome_ V5 is fully integrated - no need for additional
-resources to load. But in compare to Version 4 a lot of differences needs to be
-noticed.
+{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 noticed.
 If you haven't used V5 yet, it is highly recommended to visit the
-link:{fontawesome-get-started}[Get started, {window}] pages to learn
+link:{fontawesome-get-started}[Get started, {browser-window--new}] pages to learn
 the basics and features and styles.
 == Iconify Icons
-MDI and FA are quite rich icon sets but designed for *general* use. Sometimes
-icons are missing in one of these fonts like specific *brand* or *theme*
+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 interesting solution for using font icons from a *remote* repository is
-link:{iconify-home}[Iconify, {window}]. Iconify is a so-called unified
-*open source icon framework* that makes it possible to use icons from different
+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 syntax.
 To access that framework, a Javascript client is needed. For J1 Template, the
 client is available with the JS assets (/assets/themes/j1/extensions/iconify)
 and is loaded per default. To see what icon sets available with that framework,
-check the page link:{iconify-icon-sets}[Iconify Icon Sets, {window}].
+check the page link:{iconify-icon-sets}[Iconify Icon Sets, {browser-window--new}].
 Currently, over 40,000 vector icons are available for many different use cases.
 Find some examples below.
 .Brand Icons
-[cols="2a,3a,4a,^", options="header", width="100%", role="table-responsive-stacked-lg mt-3"]
+[cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
 |===============================================================================
 |Size |Modifier |Markup |Render
 |3x
 |no modifier set
-|All `icons` can be found on the preview page at link:{iconify-brand-icons}[SVG Logos, {window}]
+|All `icons` can be found on the preview page at link:{iconify-brand-icons}[SVG Logos, {browser-window--new}]
 [source, adoc, role="noclip"]
 ----
 iconify:logos:opensource[3x]
@@ -372,7 +366,7 @@ iconify:logos:opensource[3x]
 |5x
 |no modifier set
-|All `icons` can be found on the preview page at link:{iconify-brand-icons}[SVG Logos, {window}]
+|All `icons` can be found on the preview page at link:{iconify-brand-icons}[SVG Logos, {browser-window--new}]
 [source, adoc, role="noclip"]
 ----
 iconify:logos:atom[5x]
@@ -382,13 +376,13 @@ iconify:logos:atom[5x]
 |===============================================================================
 .Medical Icons
-[cols="2a,3a,4a,^", options="header", width="100%", role="table-responsive-stacked-lg mt-3"]
+[cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
 |===============================================================================
 |Size |Modifier |Markup |Render
 |3x
 |no modifier set
-|All `icons` can be found on the preview page at link:{iconify-medical-icons}[Medical Icons, {window}]
+|All `icons` can be found on the preview page at link:{iconify-medical-icons}[Medical Icons, {browser-window--new}]
 [source, adoc, role="noclip"]
 ----
 iconify:medical-icon:i-ear-nose-throat[3x]
@@ -397,7 +391,7 @@ iconify:medical-icon:i-ear-nose-throat[3x]
 |5x
 |`md-red-900`
-|All `icons` can be found on the preview page at link:{iconify-medical-icons}[Medical Icons, {window}]
+|All `icons` can be found on the preview page at link:{iconify-medical-icons}[Medical Icons, {browser-window--new}]
 [source, adoc, role="noclip"]
 ----
 iconify:medical-icon:i-ear-nose-throat[5x md-red-900]
@@ -407,16 +401,16 @@ iconify:medical-icon:i-ear-nose-throat[5x md-red-900]
 |===============================================================================
 NOTE: Using Iconify icons with Asciidoc is quite easy as an inline macro
-`iconify:` is avaialble to place icons where ever you want. See more about
+`iconify:` is available to place icons where ever you want. See more about
 this in section link:{roundtrip-asciidoc-extensions}#icon-fonts[Asciidoc Extensions]
 == Whats next
-Hopefully you've enjoyed the possibilities J1 offers for managing and
-manipulating *Font Icons*. Do you think these Icons sets fit your needs?
+Have you've enjoyed the possibilities J1 offers for managing and
+manipulating Font Icons. Do you think these Icons sets can fit your needs?
-Using Iconify, for all topics a icon font should be found. And it's simple,
-is'nt it?
+Using Iconify, for all topics an icon font should be found. And it's simple,
+isn't it?
 We hope so.