j1-template 2021.0.0 → 2021.0.5

data/lib/starter_web/pages/public/about/become_a_patron.adoc

@@ -1,11 +1,15 @@
 ---
 title:                                  J1 Template
 tagline:                                become a patron
-description:                            Help to create premium content
+date:                                   2021-02-01 00:00:00
+description: >
+                                        Help to create premium content
 
 tags:                                   [ Patron, Premium, Content ]
 categories:                             [ pages ]
 
+exclude_from_search:                    true
+
 permalink:                              /pages/public/about/become_a_patron/
 regenerate:                             false
 
@@ -24,7 +28,28 @@ resource_options:
             href:                       https://unsplash.com/@annoand/portfolio
 ---
 
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+//  Load Liquid procedures
+// -----------------------------------------------------------------------------
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="global" %}
+
+
 // Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// Include sub-documents
 // -----------------------------------------------------------------------------
 
 _Patron_ allows fans -- the *patrons* -- to pay creators for their work. Many

data/lib/starter_web/pages/public/blog/navigator/archive.html

@@ -7,6 +7,8 @@ description:                            Browse all articles
 tags:                                   [ Blog, Creator ]
 categories:                             [ Navigator, Archive, Viewer ]
 
+exclude_from_search:                    true
+
 sort:                                   date
 toc:                                    true
 fam:                                    true

data/lib/starter_web/pages/public/blog/navigator/archive/categoryview.html

@@ -7,6 +7,8 @@ description:                            Browse articles by category
 tags:                                   [ Blog, Creator ]
 categories:                             [ Navigator, Category, Viewer ]
 
+exclude_from_search:                    true
+
 sort:                                   date
 toc:                                    true
 fam:                                    true
@@ -123,7 +125,7 @@ resource_options:
             {% assign provider      = sharing.provider %}
             {% assign likes_count   = sharing.likes_count %}
             {% assign comment_count = sharing.comment_count %}
-          {% endfor %}          
+          {% endfor %}
 
           <article class="card raised-z5 mb-5">
             <h3 id="{{100000|rand}}" class="card-header bg-primary notoc">{{post.title}}</h3>

data/lib/starter_web/pages/public/blog/navigator/archive/dateview.html

@@ -7,6 +7,8 @@ description:                            Browse articles by date
 tags:                                   [ Blog, Creator ]
 categories:                             [ Navigator, Date, Viewer ]
 
+exclude_from_search:                    true
+
 sort:                                   date
 toc:                                    true
 fam:                                    true

data/lib/starter_web/pages/public/blog/navigator/archive/tagview.html

@@ -7,6 +7,8 @@ description:                            Browse articles by tag
 tags:                                   [ Blog, Creator ]
 categories:                             [ Navigator, Tag, Viewer ]
 
+exclude_from_search:                    true
+
 sort:                                   date
 toc:                                    true
 fam:                                    true

data/lib/starter_web/pages/public/blog/navigator/index.html

@@ -7,6 +7,8 @@ description:                            Navigate  all articles
 tags:                                   [ Blog, Creator ]
 categories:                             [ Navigator ]
 
+exclude_from_search:                    true
+
 sort:                                   date
 toc:                                    false
 fam:                                    false

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/100_meet_and_greet_jekyll.adoc

@@ -1,7 +1,7 @@
 ---
 title:                                  Web in a Day
 tagline:                                meet & greet jekyll
-date:                                   2018-05-01 00:00:00
+date:                                   2020-08-01 09:00:00
 description: >
                                         Web in a Day is the first in a series of tutorials to
                                         learn how to create modern websites using Jekyll. This
@@ -9,8 +9,8 @@ description: >
                                         J1 Template which all people needs to know for a successful
                                         way to a modern static website using Jekyll and J1 Template
 
-tags:                                   [ Kickstarter, Introduction ]
-categories:                             [ Jekyll, Knowledge, Tutorial ]
+tags:                                   [ Jekyll, Tutorial ]
+categories:                             [ Knowledge ]
 
 permalink:                              /pages/public/learn/kickstarter/web_in_a_day/meet_and_greet/
 regenerate:                             false

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/200_preparations.adoc

@@ -5,7 +5,7 @@ date:                                   2018-05-01 00:00:00
 description: >
                                         Modern static website in a day
 
-tags:                                   [ Kickstarter, Introduction ]
+tags:                                   [ Preparations ]
 categories:                             [ Jekyll, Knowledge, Tutorial ]
 
 permalink:                              /pages/public/learn/kickstarter/web_in_a_day/preparations/
@@ -42,7 +42,7 @@ resource_options:
 
 // Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="none" %}
+{% include {{load_attributes}} scope="all" %}
 
 
 // Page content

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/300_first_awesome_web.adoc

@@ -5,7 +5,7 @@ date:                                   2018-05-01 00:00:00
 description: >
                                         Modern static website in a day
 
-tags:                                   [ Kickstarter, Introduction ]
+tags:                                   [ WebDesign ]
 categories:                             [ Jekyll, Knowledge, Tutorial ]
 
 permalink:                              /pages/public/learn/kickstarter/web_in_a_day/first_awesome_web/
@@ -42,7 +42,7 @@ resource_options:
 
 // Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="none" %}
+{% include {{load_attributes}} scope="all" %}
 
 
 // Page content

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/_includes/documents/300_first_awesome_web.asciidoc

@@ -1,12 +1,11 @@
-lorem:sentences[5]
-
-To not waste time, get through the turorial and find out what is the *Jekyll Way*.
-And if this the way you want to go.
-
-Have a good time, a good day learning Jekyll.
-
-== First awesome website
-
-lorem:sentences[5] +
-lorem:sentences[3] +
-
+lorem:sentences[5]
+
+To not waste time, get through the turorial and find out what is the *Jekyll Way*.
+And if this the way you want to go.
+
+Have a good time, a good day learning Jekyll.
+
+== First awesome website
+
+lorem:sentences[5] +
+lorem:sentences[3] +

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/_includes/tables/debug_variables.asciidoc

@@ -1,48 +1,47 @@
-ifeval::["{debug}" == "true"]
-.Liquid variables
-[cols="2,4,6a, options="header", role="table-responsive, full-width"]
-|===============================================================================
-|name |value |description 
-
-|`page.path`
-|{{ page.path }}
-|The path to the raw post or page. Example usage: Linking back to the page 
-or post's source on GitHub. This can be overridden in the `YAML Front Matter`.
-
-|`site.collections_dir`
-|{{ site.collections_dir }}
-|lorem:sentences[1]
-
-|`page.images.dir`
-|{{ page.images.dir }}
-|Image path set pagewise. See FRONTMATTER defaults in `_config.yml` for the 
-images path specified by: `images.dir` for specific page *type*. See the 
-example below for a page of type *pages*.
-[source, yaml]
-----
-defaults:
-  - scope:
-      path:          pages
-      type:          pages
-
-    values:
-      images:
-        dir:        /assets/images/pages
-----
-
-|`page-imagesdir`
-|{{ page-imagesdir }}
-| Images path set in the page by `:page-imagesdir:`. 
-
-|`template`
-|{{ site.template.name }}
-|Name of the template used for rendering a page. Settings are taken from 
-sitewide configuration defined by `_config.yml`.
-
-|`includedir`
-|{{ includedir }}
-|lorem:sentences[1]
-
-|===============================================================================
-endif::[]
-
+ifeval::["{debug}" == "true"]
+.Liquid variables
+[cols="2,4,6a, options="header", role="table-responsive, full-width"]
+|===============================================================================
+|name |value |description
+
+|`page.path`
+|{{ page.path }}
+|The path to the raw post or page. Example usage: Linking back to the page
+or post's source on GitHub. This can be overridden in the `YAML Front Matter`.
+
+|`site.collections_dir`
+|{{ site.collections_dir }}
+|lorem:sentences[1]
+
+|`page.images.dir`
+|{{ page.images.dir }}
+|Image path set pagewise. See FRONTMATTER defaults in `_config.yml` for the
+images path specified by: `images.dir` for specific page *type*. See the
+example below for a page of type *pages*.
+[source, yaml]
+----
+defaults:
+  - scope:
+      path:          pages
+      type:          pages
+
+    values:
+      images:
+        dir:        /assets/images/pages
+----
+
+|`page-imagesdir`
+|{{ page-imagesdir }}
+| Images path set in the page by `:page-imagesdir:`.
+
+|`template`
+|{{ site.template.name }}
+|Name of the template used for rendering a page. Settings are taken from
+sitewide configuration defined by `_config.yml`.
+
+|`includedir`
+|{{ includedir }}
+|lorem:sentences[1]
+
+|===============================================================================
+endif::[]

data/lib/starter_web/pages/public/learn/kickstarter/web_in_a_day/_includes/tables/readme

@@ -0,0 +1 @@
+bla

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

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                present images
-date:                                   2020-11-03 12:00:00
+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.
@@ -17,7 +17,7 @@ tags:                                   [ Roundtrip, Introduction ]
 categories:                             [ Images, Module ]
 
 permalink:                              /pages/public/learn/roundtrip/present_images/
-regenerate:                             true
+regenerate:                             false
 
 resources:                              [
                                           clipboard, rouge, carousel, lightbox,
@@ -57,6 +57,10 @@ resource_options:
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// 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.

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

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                present videos
-date:                                   2020-11-04 12:00:00
+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
@@ -11,7 +11,7 @@ description: >
                                         proprietary software.
 
 tags:                                   [ Roundtrip, Introduction ]
-categories:                             [ Video, Module ]
+categories:                             [ Video, Modules ]
 
 permalink:                              /pages/public/learn/roundtrip/present_videos/
 regenerate:                             false
@@ -44,7 +44,6 @@ resource_options:
           alt:                          Broadway Underground
           alignY:                       top
           transition:                   push_left|push_right|cover_up|cover_down|fade|fadeInOut
-
 ---
 
 // Page Initializer

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

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                typography
-date:                                   2020-11-05 12:00:00
+date:                                   2020-11-05 00:00:00
 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

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

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                icon fonts
-date:                                   2020-11-06 12:00:00
+date:                                   2020-11-06 00:00:00
 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
@@ -73,9 +73,10 @@ Framework*. See section <<Iconify Icons>> for more information.
 == Material Design Icons
 
 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.
+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.
 
 _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

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

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                asciidoc extensions
-date:                                   2020-11-07 12:00:00
+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

data/lib/starter_web/pages/public/learn/roundtrip/410_bs_modals_extentions.adoc

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                advanced bootstrap modals
-date:                                   2020-11-08 12:00:00
+date:                                   2020-11-08 00:00:00
 description: >
                                         Bootstrap modals are used to add dialogues to your web pages for user
                                         notifications. To highlight important information to your visitor's. Modals

data/lib/starter_web/pages/public/learn/roundtrip/420_responsive_tables_extensions.adoc

@@ -1,7 +1,7 @@
 ---
 title:                                  Roundtrip
 tagline:                                responsive tables
-date:                                   2020-11-09 12:00:00
+date:                                   2020-11-09 00:00:00
 description: >
                                         Creating a design for responsive tables is challenging. The approach used by
                                         J1 Template is based on pure CSS on top of the classic Bootstrap styles for

data/lib/starter_web/pages/public/learn/roundtrip/500_themes.adoc

@@ -1,14 +1,15 @@
 ---
 title:                                  Roundtrip
 tagline:                                themes
-date:                                   2020-11-10 12:00:00
+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
+                                        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.
 
-tags:                                   [ Roundtrip, Introduction ]
-categories:                             [ Theme, Module ]
+tags:                                   [ Bootstrap, Themes ]
+categories:                             [ Introduction, Features ]
 
 permalink:                              /pages/public/learn/roundtrip/themes/
 regenerate:                             false
@@ -46,15 +47,26 @@ resource_options:
 // -----------------------------------------------------------------------------
 {% include {{load_attributes}} scope="all" %}
 
-
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-++++
-<!-- page_path:            {{page_path | debug}} -->
-<!-- site.source:          {{site.source | debug}} -->
-<!-- site.source.size:     {{site.source.size | debug}} -->
-++++
+// Include sub-documents
+// -----------------------------------------------------------------------------
+
+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 V4.
+
+Bootstrap is a HTML, CSS & JS Library that focuses on simplifying the
+development of modern web pages. The primary purpose to apply the framework
+to J1 is to provide a general standard colors, sizes, fonts and the overall
+layout of a J1-based site. Bootstrap provides basic style definitions for all
+common used HTML elements.
+
+This 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 individually.
 
 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
@@ -62,6 +74,13 @@ versions of Bootstrap's CSS styles for a website.
 
 == Template themes
 
+Themes step in the framework to further adjust the appearance of a website
+based on the core CSS rules and definitions of Bootstrap. Themes does not
+change the functionality of the framwork, but modifies 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 additonal components but in
+the *sense* of Bootstrap's framework rules and philosophy.
+
 It is expected that many people will change the template for their needs. To
 really create unique websites. Fundamental to do this is are CSS styles
 defined by Bootstrap.
@@ -70,7 +89,8 @@ Modifying the CSS styles of link:{bootstrap-home}[Bootstrap, {browser-window--ne
 is not rocket science. But, to be honest, some knowledge is needed to
 link:{w3org-css-spec}[the CSS technology] to do so. We encourage you to spend
 some time first on learning CSS. To learn what is the
-link:{w3schools-css-tutorial}[design base, {browser-window--new}] of each and every website.
+link:{w3schools-css-tutorial}[design base, {browser-window--new}] of each and
+every website.
 
 Thanks to the people at link:{bootswatch-home}[Bootswatch, {browser-window--new}],
 a great set of already prepared Bootstrap stylesheets in various designs are
@@ -85,7 +105,6 @@ 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
 navigation system for easy use.
 
-
 === Apply a template theme
 
 The base for designing pages using J1 Template is the theme Uno, a modern
@@ -109,9 +128,10 @@ automatically applied to your pages.
 
 == Code Highlighter Rouge
 
-lorem:sentences[5]
-
-lorem:sentences[3]
+_Rouge_ is a pure Ruby and themeable syntax highlighter. It can highlight
+100+ different languages, and output HTML or ANSI 256-color text. Find with
+this section all available themes and examples for several lanuguages how
+highlightning works using _Rouge_.
 
 === Apply a theme
 
@@ -148,7 +168,7 @@ Make a selection of theme below to preview a theme.
 <div id="selected" class="mt-1 mb-3"></div>
 ++++
 
-=== Liquid
+=== Highlight Liquid code
 
 {% raw %}
 [source, liquid]
@@ -162,7 +182,7 @@ Hello {{ 'now' | date: "%Y %h" }}
 ----
 {% endraw %}
 
-=== Javascript
+=== Highlight Javascript code
 
 [source, javascript]
 ----
@@ -181,7 +201,7 @@ function styleSheetLoaded(styleSheet) {
 }
 ----
 
-=== Ruby
+=== Highlight Ruby code
 
 [source, ruby]
 ----