j1-template 2021.1.29 → 2021.2.0

data/lib/starter_web/_data/modules/navigator_menu.yml

@@ -64,7 +64,7 @@
     # Asciidoc Skeletons
     #
     - title:                            Asciidoc Skeletons
-      icon:                             television-guide
+      icon:                             application-settings
       dropdown:
         - title:                        Simple-Document
           href:                         /pages/public/skeleton/simple/
@@ -73,7 +73,7 @@
           href:                         /pages/public/skeleton/multi/
           icon:                         file-document-multiple-outline
         - title:                        Documentation
-          href:                         /pages/public/skeleton/book/
+          href:                         /pages/public/skeleton/documentation/
           icon:                         book-open-blank-variant
 
 # ------------------------------------------------------------------------------
@@ -83,7 +83,7 @@
   sublevel:
     - title:                            Creators Blog
       href:                             /pages/public/blog/navigator/
-      icon:                             navigation
+      icon:                             near-me
     - title:                            Categories
       href:                             /pages/public/blog/navigator/archive/categoryview/
       icon:                             pin

data/lib/starter_web/_data/resources.yml

@@ -357,6 +357,7 @@ resources:
         css:                            [
                                           core/css/themes/uno-light/bootstrap,
                                           core/css/icon-fonts/materialdesign,
+                                          core/css/icon-fonts/materialdesign-light,                                          
                                           core/css/icon-fonts/fontawesome,
                                           core/css/vendor
 
@@ -893,6 +894,27 @@ resources:
         js:                             [ modules/mdiPreviewer/js/previewer ]
         init_function:                  []
 
+  # ----------------------------------------------------------------------------
+  # MDIl Previewer (light)
+  #
+  - name:                               MDIL Previewer
+    resource:
+      id:                               mdil_previewer
+      enabled:                          true
+      comment:                          module mdil_previewer
+      layout:                           [ page ]
+      region:                           head
+      required:                         ondemand
+      preload:                          false                                   # property currently unused
+      script_load:                      deferred
+      dependencies:                     false
+      pass_init_data:                   false
+      data:
+        css:                            [ modules/mdilPreviewer/css/previewer ]
+        files:                          []
+        js:                             [ modules/mdilPreviewer/js/previewer ]
+        init_function:                  []
+
   # ----------------------------------------------------------------------------
   # Iconify (Icons) Framework
   #

data/lib/starter_web/_includes/attributes.asciidoc

@@ -423,7 +423,7 @@ end::tables[]
 // -----------------------------------------------------------------------------
 tag::products[]
 :j1--license:                                     MIT License
-:j1--version:                                     2021.1.29
+:j1--version:                                     2021.2.0
 :j1--site-name:                                   Jekyll One
 end::products[]
 

data/lib/starter_web/_plugins/lunr_index.rb

@@ -364,6 +364,6 @@ end
 
 module Jekyll
   module J1LunrSearch
-    VERSION = '2021.1.29'
+    VERSION = '2021.2.0'
   end
 end

data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-20-minneapolis.adoc → series/_posts/2020-01-01-post-wiki-series.adoc}

@@ -2,16 +2,17 @@
 title:                                  Minneapolis
 tagline:                                largest city in the state of minnesota
 
-categories:                             [ Wikipedia ]
-tags:                                   [ USA, Minnesota, Cities, Minneapolis ]
+categories:                             [ Examples ]
+tags:                                   [ Series, USA, Minnesota, Cities, Minneapolis ]
 
+series:                                 wiki-series
 image:                                  /assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg
-
-sitemap:                                false
 regenerate:                             false
 
 resources:                              []
 resource_options:
+  - toccer:
+      collapseDepth:                    3
   - attic:
       padding_top:                      400
       padding_bottom:                   50
@@ -39,7 +40,6 @@ and the county seat of Hennepin County. According to the United States Census
 Bureau, the city has a total area of 151.3 km² (58.4 mi²). 142.2 km² (54.9 mi²)
 of it is land and 9.1 km² (3.5 mi²) of it (6.01%) is water.
 
-
 excerpt__end
 
 //  Load Liquid procedures
@@ -48,23 +48,22 @@ excerpt__end
 
 // Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="all" %}
+{% include {{load_attributes}} scope="none" %}
 
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
 
 // Include sub-documents
 // -----------------------------------------------------------------------------
-
 [[readmore]]
 == Physical
 
-[role="mb-3"]
+[role="mt-3 mb-5"]
 image::collections/blog/wikipedia/minneapolis.1200x400.jpg[{{page.title}}]
 
-// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
-
+[role="dropcap mt-4"]
 The Mississippi, which runs to the southeast, directed the early growth of the
 city. Most early streets ran parallel to the river to maximize the amount of
 land that could be used. Eventually, growth of Minneapolis turned to north-south
@@ -77,6 +76,7 @@ and Nicollet Avenue, have both orientations at different points.
 
 == Parks and lakes
 
+[role="dropcap mt-4"]
 Minneapolis has a large park system consisting of ten square miles (26 km²)
 of land and water that is interlinked in many places. Theodore Wirth is often
 credited with the development of this system that brought a playground within
@@ -104,6 +104,7 @@ paths, Minneapolis lakes are used for swimming, fishing, picnics and boating.
 
 == Flora and fauna
 
+[role="dropcap mt-4"]
 The area now occupied by the Twin Cities generally consisted of a 155 foot
 (47 m) thick layer of St. Peter Sandstone, under a 16 foot (5 m) thick layer
 of shale, under a 35 foot (11 m) thick layer of Platteville limestone.[4]

data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-24-narcisse-snake-dens.adoc → series/_posts/2020-01-02-post-wiki-series.adoc}

@@ -2,16 +2,18 @@
 title:                                  Narcisse Snake Dens
 tagline:                                largest snake population
 
-categories:                             [ Wikipedia ]
-tags:                                   [ Canada, Cities, Narcisse ]
+categories:                             [ Examples ]
+tags:                                   [ Series, Canada, Cities, Narcisse ]
 
+series:                                 wiki-series
 image:                                  /assets/images/collections/blog/wikipedia/narcise-snake-pits.1200x400.jpg
 
-sitemap:                                false
 regenerate:                             false
 
 resources:                              []
 resource_options:
+  - toccer:
+      collapseDepth:                    3
   - attic:
       padding_top:                      400
       padding_bottom:                   50
@@ -21,14 +23,14 @@ resource_options:
           alt:                          Narcisse Snake Pits
 ---
 
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
 :page-liquid:
 
-// Additional Asciidoc page attributes goes here
+// Set (local) page attributes here
 // -----------------------------------------------------------------------------
-:page-imagesdir: {{page.images.dir}}
-:wikipedia-article:                     https://en.wikipedia.org/wiki/Narcisse_Snake_Pits
+// :page--attr:                         <attr-value>
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
@@ -46,23 +48,22 @@ excerpt__end
 
 // Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="all" %}
+{% include {{load_attributes}} scope="none" %}
 
 
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
 
 // Include sub-documents
 // -----------------------------------------------------------------------------
-
 [[readmore]]
 == Conservation
 
-[role="mb-3"]
+[role="mt-3 mb-5"]
 image::/assets/images/collections/blog/wikipedia/narcise-snake-pits.1200x400.jpg[{{page.title}}]
 
-// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
-
+[role="dropcap mt-4"]
 These pits are the largest concentration in the world of this particular type
 of snake. Their winter dens are subterranean caverns formed by the area's
 water-worn limestone bedrock. In the spring, they come up from their dens to
@@ -89,6 +90,7 @@ season are killed on the highway.
 
 == Visiting
 
+[role="dropcap mt-4"]
 The conservation area is open to the public. The snakes are most active
 during the spring and fall - in late April to early May, which is the mating
 season, and also in early September, when the snakes slither back down to

data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-26-columbia-river.adoc → series/_posts/2020-01-03-post-wiki-series.adoc}

@@ -1,17 +1,19 @@
 ---
 title:                                  Columbia River
-tagline:                                largest river in the pacific northwest region
+tagline:                                largest river in the pacific northwest
 
-categories:                             [ Wikipedia ]
-tags:                                   [ USA, Rivers ]
+categories:                             [ Examples ]
+tags:                                   [ Series, USA, Rivers ]
 
+series:                                 wiki-series
 image:                                  /assets/images/collections/blog/wikipedia/columbia-river.1200x400.jpg
 
-sitemap:                                false
 regenerate:                             false
 
 resources:                              []
 resource_options:
+  - toccer:
+      collapseDepth:                    3
   - attic:
       padding_top:                      400
       padding_bottom:                   50
@@ -21,8 +23,9 @@ resource_options:
           alt:                          Columbia River
 ---
 
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
 :page-liquid:
 
 // Additional Asciidoc page attributes goes here
@@ -33,7 +36,7 @@ resource_options:
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
 [role="dropcap"]
-*Columbia River* is the largest river in the Pacific Northwest region of
+Columbia River is the largest river in the Pacific Northwest region of
 North America. It flows northwest and then south into the US state of Washington,
 then turns west to form most of the border between Washington and the state of
 Oregon before emptying into the Pacific Ocean.
@@ -46,7 +49,7 @@ excerpt__end
 
 // Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="all" %}
+{% include {{load_attributes}} scope="none" %}
 
 
 // Page content
@@ -55,14 +58,28 @@ excerpt__end
 // Include sub-documents
 // -----------------------------------------------------------------------------
 
+//  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
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
+
+// Include sub-documents
+// -----------------------------------------------------------------------------
 [[readmore]]
 == Columbia River
 
-[role="mb-3"]
+[role="mt-3 mb-5"]
 image::/assets/images/collections/blog/wikipedia/columbia-river.1200x400.jpg[{{page.title}}]
 
-// Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
-
+[role="dropcap mt-4"]
 The river is 1,243 miles (2,000 km) long, and its largest tributary is the
 Snake River. Its drainage basin is roughly the size of France and extends
 into seven US states and a Canadian province.

data/lib/starter_web/index.html

@@ -1,8 +1,8 @@
 ---
 layout:                                 home
 
-title:                                  J1
-tagline:                                starter
+title:                                  Jekyll One
+tagline:                                starter web
 description: >
                                         Jekyll One Template. Gem-based template made for Jekyll.
                                         J1 meets Jekyll and Bootstrap. And makes a lot of friends.

data/lib/starter_web/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "j1_starter",
-  "version": "2021.1.29",
+  "version": "2021.2.0",
   "description": "J1 Template Starter Web",
   "homepage": "https://your.site",
   "author": {

data/lib/starter_web/pages/public/asciidoc_skeletons/{book → documentation}/000_intro.adoc

@@ -5,14 +5,12 @@ title:                                  Introduction
 tagline:                                Skeleton Book
 date:                                   2021-01-01 00:00:00 +100
 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.
+                                        Prawn is a pure Ruby PDF generation library that provides
+                                        a lot of great functionality while trying to remain simple
+                                        by providing a reasonable performance.
 
 categories:                             [ Knowledge ]
-tags:                                   [ Asciidoc, Skeleton ]
+tags:                                   [ Asciidoctor, PDF, Converter ]
 
 sitemap:                                false
 robots:
@@ -20,7 +18,7 @@ robots:
   follow:                               false
 
 
-permalink:                              /pages/public/skeleton/book/intro/
+permalink:                              /pages/public/skeleton/documentation/000_intro/
 regenerate:                             false
 
 resources:                              []

data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/100_converter.adoc

@@ -0,0 +1,43 @@
+---
+title:                                  Asciidoctor PDF Converter
+tagline:                                A native PDF converter for AsciiDoc
+description:                            Native PDF Converter for Asciidoctor
+
+categories:                             [ Knowledge ]
+tags:                                   [ Asciidoctor, PDF, Converter ]
+
+
+permalink:                              /pages/public/skeleton/documentation/100_converter/
+regenerate:                             false
+
+resources:                              [ lightbox, clipboard, rouge ]
+resource_options:
+  - toccer:
+      collapseDepth:                    2
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set page (local) 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_converter.asciidoc[]

data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/200_themes.adoc

@@ -0,0 +1,61 @@
+---
+title:                                  Asciidoctor PDF Themes
+tagline:                                Theming Guide for the Asciidoctor PDF Converter
+description:                            Asciidoctor PDF Theming Guide
+
+categories:                             [ Knowledge ]
+tags:                                   [ Asciidoctor, PDF, Converter ]
+
+permalink:                              /pages/public/skeleton/documentation/200_themes/
+regenerate:                             false
+
+resources:                              [ lightbox, clipboard, rouge ]
+resource_options:
+  - toccer:
+      collapseDepth:                    2
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set page (local) 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
+// -----------------------------------------------------------------------------
+
+//////////
+Topics remaining to document:
+* line height and line height length (and what that all means)
+* title page layout / title page images (logo & background)
+* document that unicode escape sequences can be used inside double-quoted strings
+//////////
+
+The theming system in *Asciidoctor PDF* is used to control the layout and styling
+of the PDF file *Asciidoctor PDF* generates from AsciiDoc. This document describes
+how the theming system works, how to define a custom theme in YAML and how to
+activate the theme when running *Asciidoctor PDF*.
+
+IMPORTANT: If you're using a custom theme, you're expected to bring your own
+fonts or declare the fonts from the default theme. If you don't declare your
+own fonts, the built-in PDF (afm) fonts will be used, which only support
+WINANSI characters (similar to Basic Latin).
+
+// Include documents
+// -------------------------------------------------------------------
+include::{documentdir}/200_themes.asciidoc[]

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

@@ -0,0 +1,95 @@
+// ~/document_base_folder/_includes
+//  Asciidoc attribute includes:                 attributes.asciidoc
+// -----------------------------------------------------------------------------
+
+// URLs - Internal references and/or sources on the Internet
+// -----------------------------------------------------------------------------
+tag::urls[]
+:uri-symfony-yaml-format-strings:                 https://symfony.com/doc/current/components/yaml/yaml_format.html#strings
+
+:uri-wikipedia-yaml:                              https://en.wikipedia.org/wiki/YAML
+:uri-wikipedia-codepage-windows-1252:             https://en.wikipedia.org/wiki/Windows-1252
+
+:uri-asciidoctor:                                 https://asciidoctor.org
+:uri-asciidoctor-extentions-catalog:              https://github.com/asciidoctor/asciidoctor-extensions-lab#extension-catalog
+:uri-asciidoctor-pdf:                             https://github.com/asciidoctor/asciidoctor-pdf
+:uri-asciidoctor-pdf-gem:                         https://rubygems.org/gems/asciidoctor-pdf
+:uri-asciidoctor-pdf-repo:                        {uri-asciidoctor-pdf}
+:uri-asciidoctor-pdf-issues:                      {uri-asciidoctor-pdf-repo}/issues
+:uri-asciidoctor-pdf-issues-1:                    {uri-asciidoctor-pdf}/issues/1
+:uri-asciidoctor-pdf-issues-95:                   {uri-asciidoctor-pdf}/issues/95
+:uri-asciidoctor-pdf-list:                        https://discuss.asciidoctor.org
+:uri-asciidoctor-pdf-base-theme:                  https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/themes/base-theme.yml
+:uri-asciidoctor-pdf-default-theme:               https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/themes/default-theme.yml
+:uri-asciidoctor-mathematical:                    https://github.com/asciidoctor/asciidoctor-mathematical
+:uri-asciidoctor-pdf-cjk-kai_gen_gothic:          https://github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic
+:uri-asciidoctor-pdf-cjk:                         https://github.com/chloerei/asciidoctor-pdf-cjk
+:uri-asciidoctor-yaml-style-for-maven:            http://discuss.asciidoctor.org/Asciidoctor-YAML-style-file-for-PDF-and-maven-td3849.html
+:uri-asciidoctor-theme-example-for-maven:         https://github.com/asciidoctor/asciidoctor-maven-examples/tree/master/asciidoctor-pdf-with-theme-example
+:uri-asciidoctor-theme-example-for-gradle:        https://github.com/asciidoctor/asciidoctor-gradle-examples/tree/master/asciidoc-to-pdf-with-theme-example
+
+:uri-ghostscript-ps-pdf-marks:                    http://milan.kupcevic.net/ghostscript-ps-pdf/#marks
+
+:uri-prawn-home:                                  http://prawnpdf.org
+:uri-prawn-gmagick:                               https://github.com/packetmonkey/prawn-gmagick
+:uri-prawn-svg:                                   https://github.com/mogest/prawn-svg
+:uri-prawn-improved-handling-of-encodings:        https://github.com/prawnpdf/prawn/blob/master/CHANGELOG.md#vastly-improved-handling-of-encodings-for-pdf-built-in-afm-fonts
+:uri-prawn-lib-page-geometry:                     https://github.com/prawnpdf/pdf-core/blob/0.6.0/lib/pdf/core/page_geometry.rb#L16-L68[Named size]
+:uri-prawn-pdf-typesetting:                       http://www.sitepoint.com/hackable-pdf-typesetting-in-ruby-with-prawn
+
+:uri-rouge-home:                                  http://rouge.jneen.net/
+:uri-rouge-token:                                 https://github.com/jneen/rouge/blob/master/lib/rouge/token.rb
+:uri-rouge-themes:                                https://github.com/jneen/rouge/tree/master/lib/rouge/themes
+
+:uri-rvm:                                         https://rvm.io
+:uri-graphicsmagick:                              https://www.graphicsmagick.org
+:uri-google-groups-image-quality:                 https://groups.google.com/forum/#!msg/prawn-ruby/MbMsCx862iY/6ImCsvLGfVcJ[Discussion about image quality in PDFs]
+
+:uri-font-font-awesome:                           https://fortawesome.github.io/Font-Awesome/
+:uri-font-foundation-icon-fonts-3:                http://zurb.com/playground/foundation-icon-fonts-3
+:uri-font-paymentfont:                            http://paymentfont.io/
+:uri-font-octicons:                               https://octicons.github.com/
+:uri-font-prawn-icon:                             https://github.com/jessedoyle/prawn-icon/tree/master/data/fonts
+
+:uri-font-roboto-ttf:                             https://github.com/google/roboto/tree/master/out/RobotoTTF
+:uri-font-droid-sans-fallback-ttf:                https://github.com/android/platform_frameworks_base/blob/master/data/fonts/DroidSansFallback.ttf
+:uri-font-noto-serif:                             https://www.google.com/get/noto/#/family/noto-serif
+:uri-font-m-plus-fonts:                           https://mplus-fonts.osdn.jp/about-en.html
+end::urls[]
+
+
+// FOOTNOTES, local asciidoc attributes (variables)
+// -----------------------------------------------------------------------------
+tag::footnotes[]
+end::footnotes[]
+
+
+// Tags - Asciidoc attributes used internally
+// -----------------------------------------------------------------------------
+tag::tags[]
+:images-dir:                                      pages/manuals/asciidoctor_pdf
+end::tags[]
+
+
+// Data - Data elements for Asciidoctor extensions
+// -----------------------------------------------------------------------------
+tag::data[]
+end::data[]
+
+
+// Images - Images from local include/images folder
+// -----------------------------------------------------------------------------
+tag::images[]
+end::images[]
+
+
+// PRODUCTS, local product information (e.g. release)
+// -----------------------------------------------------------------------------
+tag::products[]
+end::products[]
+
+
+// AUTHORS, local author information (e.g. article)
+// -----------------------------------------------------------------------------
+tag::authors[]
+end::authors[]