j1-template 2021.0.4 → 2021.0.9

data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_3_column.asciidoc

@@ -0,0 +1,16 @@
+// 3-Colum table (Asciidoc)
+// -----------------------------------------------------------------------------
+//
+
+.title_text
+[cols="3,3,6a", subs=+macros, options="header", role="rtable mt-3 mb-5"]
+|===============================================================================
+|Element |Description |Example
+
+|`element`
+|lorem:words[5]
+|
+[role="r-text-100"]
+lorem:sentences[2]
+
+|===============================================================================

data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_4_column.asciidoc

@@ -0,0 +1,25 @@
+// 4-Colum table (Asciidoc)
+// -----------------------------------------------------------------------------
+//
+
+.title_text
+[cols="2,3,2,5a", subs=+macros, options="header", role="rtable mt-3 mb-5"]
+|===============================================================================
+|Property | Value |Default |Description
+
+|`flex-flow`
+|`flex-direction` `flex-wrap`
+|`row nowrap`
+|The `flex-flow` property is a *shorthand* propery for setting both the
+`flex-direction` and `flex-wrap` properties.
+
+.Example
+[source, css]
+----
+.flex-container {
+  display: flex;
+  flex-flow: row wrap;
+}
+----
+
+|===============================================================================

data/lib/starter_web/pages/public/asciidoc_skeletons/book/000_intro.adoc

@@ -0,0 +1,61 @@
+---
+# Top Level Entry Document:             000_intro.asciidoc
+#
+title:                                  Introduction
+tagline:                                Skeleton Book
+date:                                   2021-01-01 00:00:00
+description: >
+                                        Before you start writing, some general thoughts make sense to clarify what
+                                        Speaking, Reading and Writing are all about. What are the differences, what
+                                        the difficulties. I recomment to groove into that topic to become acquainted
+                                        with the base how human use a language rather than step in directly to tools
+                                        and techniques for writing.
+
+tags:                                   [ Introduction, Tutorial ]
+categories:                             [ Asciidoc, Knowledge, Skeleton ]
+
+permalink:                              /pages/public/skeleton/book/intro/
+regenerate:                             true
+
+resources:                              []
+resource_options:
+  - toccer:
+      collapseDepth:                    4
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/pages/skeleton/sigmund-1920x1280.jpg
+          alt:                          Photo by Sigmund on Unsplash
+          alignY:                       top
+          badge:
+            type:                       unsplash
+            author:                     Sigmund
+            href:                       https://unsplash.com/@sigmund
+---
+
+// 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="all" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// Include sub-documents
+// -----------------------------------------------------------------------------
+include::{documentdir}/000_intro.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/100_chapter.adoc

@@ -0,0 +1,58 @@
+---
+# Top Level Entry Document:             100_chapter.asciidoc
+#
+title:                                  Skeleton book
+tagline:                                chapter 1
+date:                                   2021-01-01 00:00:00
+description: >
+                                        Top Level Entry Document 100_chapter.asciidoc
+
+categories:                             [ Asciidoc, Knowledge ]
+tags:                                   [ Skeleton, Book ]
+
+
+permalink:                              /pages/public/skeleton/book/chapter_1/
+regenerate:                             true
+
+resources:                              []
+resource_options:
+  - toccer:
+      collapseDepth:                    3
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/pages/skeleton/sigmund-1920x1280.jpg
+          alt:                          Photo by Sigmund on Unsplash
+          alignY:                       top
+          badge:
+            type:                       unsplash
+            author:                     Sigmund
+            href:                       https://unsplash.com/@sigmund
+---
+
+// 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="all" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// Include sub-documents
+// -----------------------------------------------------------------------------
+include::{documentdir}/100_chapter.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/200_chapter.adoc

@@ -0,0 +1,59 @@
+---
+# ~/document_base_folder
+# Top Level Entry Document:             200_chapter.asciidoc
+#
+title:                                  Skeleton book
+tagline:                                chapter 2
+date:                                   2021-01-01 00:00:00
+description: >
+                                        Top Level Entry Document 100_chapter.asciidoc
+
+categories:                             [ Asciidoc, Knowledge ]
+tags:                                   [ Skeleton, Book ]
+
+permalink:                              /pages/public/skeleton/book/chapter_2/
+regenerate:                             true
+
+resources:                              [ lightbox, light_gallery, justified_gallery ]
+resource_options:
+  - toccer:
+      collapseDepth:                    3
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/pages/skeleton/sigmund-1920x1280.jpg
+          alt:                          Photo by Sigmund on Unsplash
+          alignY:                       top
+          badge:
+            type:                       unsplash
+            author:                     Sigmund
+            href:                       https://unsplash.com/@sigmund
+---
+
+// 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="all" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// Include sub-documents
+// -----------------------------------------------------------------------------
+
+include::{documentdir}/200_chapter.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/900_references.adoc

@@ -0,0 +1,68 @@
+---
+# Top Level Entry Document:             900_sourcess.asciidoc
+#
+title:                                  Skeleton book
+tagline:                                references
+description:
+
+categories:                             [ Asciidoc, Knowledge ]
+tags:                                   [ Skeleton, Book ]
+
+permalink:                              /pages/public/skeleton/book/references/
+regenerate:                             true
+
+resources:                              []
+resource_options:
+  - toccer:
+      collapseDepth:                    3
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/pages/skeleton/romain-vignes-1920x1280.jpg
+          alt:                          Photo by Romain Vignes on Unsplash
+          alignY:                       top
+          badge:
+            type:                       unsplash
+            author:                     Romain Vignes
+            href:                       https://unsplash.com/@rvignes
+---
+
+// 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="all" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+== References
+
+Don't leave any main chapter with a *White Section*. By the references chapter
+you can give your readers a huge added value, if you (clearly) reference the
+sources you have used for writing.
+
+You need for legal reasons ...
+
+...
+
+
+// Include sub-documents
+// -----------------------------------------------------------------------------
+// jadams, 2019-09-28: TODO fix include error 'include file not found:'
+//
+include::{documentdir}/900_references.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/attributes.asciidoc

@@ -0,0 +1,68 @@
+// ~/document_base_folder/000_includes
+//  Asciidoc attribute includes:                 attributes.asciidoc
+// -----------------------------------------------------------------------------
+
+// URLs - Internal references and/or sources on the Internet
+// -----------------------------------------------------------------------------
+tag::urls[]
+:url-j1--home:                                    https://jekyll.one
+:url-wikipedia--chapter:                          https://en.wikipedia.org/wiki/Chapter_(books)/
+:url-wikipedia-en--writing:                       https://en.wikipedia.org/wiki/Introduction_(writing)/
+:url-wikipedia-en--asciidoc:                      https://en.wikipedia.org/wiki/AsciiDoc
+
+:url-fontawesome--home:                           https://fontawesome.com/
+:url-fontawesome--icons:                          https://fontawesome.com/icons?d=gallery/
+:url-fontawesome--get-started:                    https://fontawesome.com/get-started/
+
+:url-mdi--home:                                   https://materialdesignicons.com/
+:url-mdi-icons--cheatsheet:                       https://cdn.materialdesignicons.com/3.3.92/
+
+:url-iconify--home:                               https://iconify.design/
+:url-iconify--icon-sets:                          https://iconify.design/icon-sets/
+:url-iconify--medical-icons:                      https://iconify.design/icon-sets/medical-icon/
+:url-iconify--brand-icons:                        https://iconify.design/icon-sets/logos/
+
+:url-roundtrip--mdi-icons:                        /pages/public/learn/roundtrip/mdi_icon_font/#material-design-icons
+:url-roundtrip--fontawesome-icons:                /pages/public/learn/roundtrip/mdi_icon_font/#fontawesome-icons
+:url-roundtrip--iconify-icons:                    /pages/public/learn/roundtrip/mdi_icon_font/#iconify-icons
+:url-roundtrip--asciidoc-extensions:    /pages/public/learn/roundtrip/asciidoc_extensions/
+
+:url-asciidoctor--asciidoc-writers-guide:         https://asciidoctor.org/docs/asciidoc-writers-guide/
+:url-asciidoctor--asciidoc-manual:                https://docs.asciidoctor.org/asciidoc/latest/
+end::urls[]
+
+
+// Tags - Asciidoc attributes used internally
+// -----------------------------------------------------------------------------
+tag::tags[]
+end::tags[]
+
+
+// Data - Data elements for Asciidoctor extensions
+// -----------------------------------------------------------------------------
+tag::data[]
+:data-images-standalone:                          "pages/roundtrip/100_present_images/lightbox-image-1.jpg, Golden Gate Bridge with San Francisco in distance, pages/roundtrip/100_present_images/lightbox-image-2.jpg, Forest with mountains behind"
+:data-images-group:                               "pages/roundtrip/100_present_images/lightbox-image-1.jpg, Golden Gate Bridge with San Francisco in distance, pages/roundtrip/100_present_images/lightbox-image-2.jpg, Forest with mountains behind"
+end::data[]
+
+
+// Images - Images from local include/images folder
+// -----------------------------------------------------------------------------
+tag::images[]
+end::images[]
+
+
+// PRODUCTS, local product information (e.g. release)
+// -----------------------------------------------------------------------------
+tag::products[]
+:license:                                         e.g. Apache License, Version 2.0
+:revdate:                                         e.g. 2018
+:revnumber:                                       e.g. 1.2.3
+end::products[]
+
+
+// AUTHORS, local author information (e.g. article)
+// -----------------------------------------------------------------------------
+tag::authors[]
+:uri-author-xxx:                                  https://xxx
+end::authors[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/000_intro.asciidoc

@@ -0,0 +1,33 @@
+// ~/document_base_folder/000_includes/documents
+// Intro document: 000_intro.asciidoc
+// -----------------------------------------------------------------------------
+
+== Introduction
+
+{url-wikipedia-en--writing}[From Wikipedia, {browser-window--new}]
+
+In an essay, article, or book, an introduction (also known as a prolegomenon)
+is a beginning section which states the purpose and goals of the following
+writing. This is generally followed by the body and conclusion.
+
+The introduction typically describes the scope of the document and gives
+the brief explanation or summary of the document. It may also explain certain
+elements that are important to the essay if explanations are not part of
+the main text. The readers can have an idea about the following text before
+they actually start reading it.
+
+ln technical writing, the introduction typically includes one or more standard
+subsections: abstract or summary, preface, acknowledgments, and foreword.
+Alternatively, the section labeled introduction itself may be a brief
+section found side-by-side with abstract, foreword, etc. (rather than
+containing them). In this case the set of sections that come before the
+body of the book are known as the front matter. When the book is divided
+into numbered chapters, by convention the introduction and any other
+front-matter sections are unnumbered and precede chapter 1.
+
+Keeping the concept of the introduction the same, different documents
+have different styles to introduce the written text. For example,
+the introduction of a Functional Specification consists of information
+that the whole document is yet to explain. If a Userguide is written,
+the introduction is about the product. In a report, the introduction gives
+a summary about the report contents.

data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter.asciidoc

@@ -0,0 +1,7 @@
+// ~/document_base_folder/_includes/documents
+// Sublevel Entry Document: 100_chapter.asciidoc
+// -----------------------------------------------------------------------------
+
+include::100_chapter/100_chapter_document.asciidoc[]
+
+include::100_chapter/110_chapter_document.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter/100_chapter_document.asciidoc

@@ -0,0 +1,21 @@
+// ~/document_base_folder/_includes/documents/100_chapter/
+// Chapter document: 100_chapter_document.asciidoc
+// -----------------------------------------------------------------------------
+
+== Chapter 1
+
+J1 Template support popular icons font sets out-of-the-box:
+
+* link:{url-mdi--home}[Material Design Icons, {browser-window--new}] (MDI)
+* link:{url-fontawesome--home}[FontAwesome Icons V5, {browser-window--new}] (FA)
+* link:{url-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 link:{url-roundtrip--mdi-icons}[Material Design Icons, {browser-window--new}]
+and link:{url-roundtrip--fontawesome-icons}[FontAwesome Icons, {browser-window--new}].
+
+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 link:{url-roundtrip--iconify-icons}[Iconify Icons, {browser-window--new}]
+for more information.

data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter/110_chapter_document.asciidoc

@@ -0,0 +1,36 @@
+// ~/document_base_folder/_includes/documents/100_chapter/
+// Chapter document: 110_chapter_document.asciidoc
+// -----------------------------------------------------------------------------
+
+=== Section
+
+The primary icon-set for J1 Template is
+link:{url-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.
+
+_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.
+
+==== Subsection
+
+_MDI_ is a growing collection to allow designers and developers targeting
+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_.
+
+// include::{documentdir}/tables/110_material_design_icons.asciidoc
+// include::{tabledir}/110_material_design_icons.asciidoc
+include::../tables/110_material_design_icons.asciidoc[]
+
+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
+this in section
+link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions, {browser-window--new}]
+
+_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.