j1-template 2020.0.21 → 2020.0.22

data/lib/starter_web/collections/posts/public/{featured/_posts/000_includes → series/_posts/_includes}/attributes.asciidoc

@@ -2,21 +2,23 @@
 //  Asciidoc attribute includes:                 attributes.asciidoc
 // -----------------------------------------------------------------------------
 
+
 // URLs - Internal references and/or sources on the Internet
 // -----------------------------------------------------------------------------
 tag::urls[]
 
-:parker-blog:                           https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/
+:blogging-on-github-part-2:                       http://digitaldrummerj.me/blogging-on-github-part-2-your-first-post/
+:blogging-on-github-part-3:                       http://digitaldrummerj.me//blogging-on-github-part-3-adding-comments/
+:blogging-on-github-part-4:                       http://digitaldrummerj.me//blogging-on-github-part-4-creating-additional-pages/
 
-end::urls[]
+:docker-install-toolbox-on-windows:               https://docs.docker.com/toolbox/toolbox_install_windows/
+:virtualbox-install-on-windows:                   https://www.virtualbox.org/wiki/Downloads
 
+end::urls[]
 
 // Tags - Asciidoc attributes used internally
 // -----------------------------------------------------------------------------
 tag::tags[]
-
-:figure-caption:                        Figure
-
 end::tags[]
 
 
@@ -24,24 +26,12 @@ end::tags[]
 // -----------------------------------------------------------------------------
 tag::data[]
 
-:docker-windows-kinematic-alpha-data:             "blog/series/j1_using_docker/kinematic_alpha.1280x600.png, Docker UI Kinematic on Windows"
+:data-docker-windows-kinematic-alpha:             "collections/blog/series/j1_using_docker/kinematic_alpha.1280x600.png, Docker UI Kinematic on Windows"
 
 end::data[]
 
-
-// Product|Author - Document (e.g release) and Author information
-// -----------------------------------------------------------------------------
-tag::product_info[]
-
-:license:                                         MIT License
-:revdate:                                         2018
-:revnumber:                                       1.0.0
-
-end::product_info[]
-
 tag::authors[]
 
 :uri-author-juergen-adams:                        https://jekyll.one
 
 end::authors[]
-

data/lib/starter_web/collections/posts/public/test_posts/_posts/2020-09-11-test_post.adoc

@@ -10,6 +10,8 @@ tags:                                   [ Test, Posts ]
 index:                                  [ Test, Posts ]
 categories:                             []
 
+
+
 regenerate:                             false
 
 resources:                              []
@@ -23,12 +25,17 @@ resource_options:
           alt:                          Minnesota
 ---
 
-// Page Initializer
+// Collection Initializer (posts|collections)
 // =============================================================================
 // Enable the Liquid Preprocessor
 :page-liquid:
 
-// Place an excerpt at the most top position
+// Set page (local) attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+:debug:                                 false
+
+// Place an excerpt at the most top positison
 // -----------------------------------------------------------------------------
 Minneapolis is the largest city in the state of Minnesota in the United States,
 and the county seat of Hennepin County. According to the United States Census
@@ -42,26 +49,105 @@ excerpt__end
 // -----------------------------------------------------------------------------
 {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
 
-// Load page attributes (all)
+// Load page attributes
 // -----------------------------------------------------------------------------
 {% include {{load_attributes}} scope="all" %}
 
-// Additional Asciidoc page attributes goes here
-// -----------------------------------------------------------------------------
-//:page-imagesdir:                        {{page.images.dir}}
+ifeval::["{debug}" == "true"]
+
+// Liquid preprocessor not applied to included AsciiDoc files
+// https://github.com/asciidoctor/jekyll-asciidoc/issues/166
+== Notes
+
+The Liquid preprocessor not applied to included AsciiDoc files by the
+*jekyll-asciidoc* plugin.
 
+.From link:{https://github.com/asciidoctor/jekyll-asciidoc/issues/166}[Plugin {char-middot} jekyll-asciidoc {char-middot} issue]
 
-// Page content
+*mojavelinux commented on 3 Oct 2017*
+
+The problem is that the liquid filter is applied to the raw source, before
+the AsciiDoc plugin gets involved. That step doesn't know anything about
+AsciiDoc includes, so it only looks at the flat source. Then Asciidoctor
+comes in and converts the content. Only then is the include file folded in,
+but Asciidoctor doesn't know anything about liquid. That's why the liquid
+tags are not processed in the include file.
+
+There was never a test for this scenario, which is why it got overlooked.
+
+In order to solve this, we'd need to introduce a custom IncludeProcessor
+that applies the liquid filter on the included content. At the moment,
+that has side effects, so it needs to be handled carefully.
+
+== Variables
+
+// Include table|s (global source)
 // -----------------------------------------------------------------------------
+include::{table-template--variables}[]
+
+.Jekyll variables (Liquid)
+[cols="3,3a,6a, options="header", width="100%", role="rtable mt-3"]
+|===============================================================================
+|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]
+
+|===============================================================================
+
+== MIT license
+
+include::{docs-licenses--mit}[]
+
+endif::[]
+
+
+// Content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[readmore]]
 == Physical
 
 [role="mb-3"]
-image::{image__wikipedia--minneapolis}[{{page.title}}]
-
-image::/assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg[{{page.title}}]
+image::collections/blog/wikipedia/minneapolis.1200x400.jpg[{{page.title}}]
 
-Read: link:{url__wikipedia-en--minneapolis}[From Wikipedia, the free encyclopedia, window="_blank"].
+[role="mt-2"]
+Read {char-middot} link:{url-wikipedia_en--minneapolis}[From Wikipedia, {browser-window--new}].
 
 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

data/lib/starter_web/collections/posts/public/test_posts/_posts/{includes → _includes}/attributes.asciidoc

@@ -5,7 +5,7 @@
 // URLs - Internal references and/or sources on the Internet
 // -----------------------------------------------------------------------------
 tag::urls[]
-:url__wikipedia-en--minneapolis:                  https://en.wikipedia.org/wiki/Geography_of_Minneapolis
+:url-wikipedia_en--minneapolis:                   https://en.wikipedia.org/wiki/Geography_of_Minneapolis
 end::urls[]
 
 
@@ -15,13 +15,6 @@ tag::tags[]
 end::tags[]
 
 
-// Images - Images from template assets
-// -----------------------------------------------------------------------------
-tag::images[]
-:image__wikipedia--minneapolis:                   "/assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg"
-end::images[]
-
-
 // Data - Data elements for Asciidoctor extensions
 // -----------------------------------------------------------------------------
 tag::data[]

data/lib/starter_web/collections/posts/public/wikipedia/_posts/2016-11-20-minneapolis.adoc

@@ -23,8 +23,9 @@ resource_options:
           alt:                          Minnesota
 ---
 
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
 :page-liquid:
 
 // Additional Asciidoc page attributes goes here
@@ -32,7 +33,6 @@ resource_options:
 :page-imagesdir:                        {{page.images.dir}}
 :wikipedia-article:                     https://en.wikipedia.org/wiki/Geography_of_Minneapolis
 
-
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
 Minneapolis is the largest city in the state of Minnesota in the United States,
@@ -43,13 +43,22 @@ of it is land and 9.1 km² (3.5 mi²) of it (6.01%) is water.
 [role="clearfix mb-3"]
 excerpt__end
 
-// Page content
+//  Load Liquid procedures
+// -----------------------------------------------------------------------------
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+
+// Load page attributes
 // -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="none" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[readmore]]
 == Physical
 
 [role="mb-3"]
-image::/assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg[{{page.title}}]
+image::collections/blog/wikipedia/minneapolis.1200x400.jpg[{{page.title}}]
 
 // Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
 

data/lib/starter_web/collections/posts/public/wikipedia/_posts/_includes/attributes.asciidoc

@@ -0,0 +1,37 @@
+// ~/document_base_folder/000_includes
+//  Asciidoc attribute includes:                 attributes.asciidoc
+// -----------------------------------------------------------------------------
+
+// URLS, local references to internal|external web links (macro link:)
+// -----------------------------------------------------------------------------
+tag::urls[]
+end::urls[]
+
+
+// TAGS, local asciidoc attributes (general variables)
+// -----------------------------------------------------------------------------
+tag::tags[]
+end::tags[]
+
+
+// DATA, local references to data elements (asciidoc extensions)
+// -----------------------------------------------------------------------------
+tag::data[]
+end::data[]
+
+// DOCUMENTS, local document resources (macro include::)
+// -----------------------------------------------------------------------------
+tag::documents[]
+end::documents[]
+
+
+// TABLES, local table resources (macro include::)
+// -----------------------------------------------------------------------------
+tag::tables[]
+end::tables[]
+
+
+// AUTHORS, local author information (special variables)
+// -----------------------------------------------------------------------------
+tag::authors[]
+end::authors[]

data/lib/starter_web/package.json

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

data/lib/starter_web/pages/protected/site_search.adoc

@@ -33,13 +33,13 @@ resource_options:
 // -----------------------------------------------------------------------------
 {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
 
-// Load page attributes (all)
+// Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} %}
+{% include {{load_attributes}} scope="none"%}
 
-// Page content
-// =============================================================================
 
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 == Site Search
 
 J1 Template integrates an Algolia Search Index for all documents of this site.

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

@@ -55,7 +55,7 @@ resource_options:
 {% comment %} Main
 -------------------------------------------------------------------------------- {% endcomment %}
 <!-- [INFO   ] [ {{page.url}} ] [Generate HTML}] -->
-<div class="paginator ml-2">
+<div class="paginator ml-3">
   <ul class="pagination raised-z0">
     <li class="page-item"><a class="page-link" href="{{navigator     | prepend: site.baseurl}}" title="Blog View">Navigator</a></li>
     <li class="page-item"><a class="page-link" href="{{category_view | prepend: site.baseurl}}" title="View by Category">By Category</a></li>
@@ -64,7 +64,7 @@ resource_options:
   </ul>
 </div>
 
-<div id="index" class="post-archive-search-results col-md-10 col-sm-10 col-xs-11">
+<div id="index" class="post-search-results ml-3">
   <div class="view-description">{{view_description}}</div>
   <div class="post-headline">
     <h2 id="post-headline" class="mt-5">All Posts</h2>

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

@@ -92,7 +92,7 @@ resource_options:
   </ul>
 </div>
 
-<div class="post-search-results col-md-10 col-sm-10 col-xs-11">
+<div class="post-search-results ml-3">
 
   <div class="view-description">{{view_description}}</div>
   <div class="post-headline">

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

@@ -63,7 +63,7 @@ resource_options:
   </ul>
 </div>
 
-<div id="index" class="post-search-results col-md-10 col-sm-10 col-xs-11">
+<div id="index" class="post-search-results ml-3">
 
   <div class="view-description">{{view_description}}</div>
   <div class="post-headline">

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

@@ -86,7 +86,7 @@ resource_options:
   </ul>
 </div>
 
-<div class="post-search-results col-md-10 col-sm-10 col-xs-11">
+<div class="post-search-results ml-3">
   <div class="view-description mb-1">{{view_description}}</div>
   <div class="post-headline"> <h2 id="post-headline" class="mt-5">Posts By Tag</h2></div>
   {% assign letter_group = letter_group_array[letter_group_counter] %}

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

@@ -37,22 +37,26 @@ resource_options:
 // 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 (all)
+// Load page attributes
 // -----------------------------------------------------------------------------
 {% include {{load_attributes}} scope="all" %}
 
+
 // Page content
-// =============================================================================
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 // Include sub-documents
 // -----------------------------------------------------------------------------
 include::{documentdir}/100_meet_and_greet_jekyll.asciidoc[]
 
-
 == Summarize!
 
 include::{includedir}/parts.asciidoc[tag=summarize]

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

@@ -21,21 +21,26 @@ resource_options:
 // 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 (all)
+// Load page attributes
 // -----------------------------------------------------------------------------
-{% include {{load_attributes}} scope="all" %}
+{% include {{load_attributes}} scope="none" %}
+
 
 // Page content
-// =============================================================================
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 // Include sub-documents
 // -----------------------------------------------------------------------------
 include::{documentdir}/200_preparations.asciidoc[]
 
-
 == Summarize!
 
 include::{includedir}/parts.asciidoc[tag=summarize]