j1-template 2020.0.18 → 2020.0.24

data/lib/starter_web/_plugins/prettify.rb

@@ -9,9 +9,7 @@
 #
 # J1 Template is licensed under the MIT License.
 # See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
-#
 # ------------------------------------------------------------------------------
-#
 #  NOTE:
 #  CustomFilters cannot be used in SAFE mode (e.g not usable for
 #  rendering pages with Jekyll on GitHub
@@ -23,7 +21,6 @@
 #
 #    {% endcapture %}
 #    {{ cache_name | pretty_print }}
-#
 # ------------------------------------------------------------------------------
 require 'nokogiri'
 require 'nokogiri-pretty'

data/lib/starter_web/_plugins/simple_search_filter.rb

@@ -9,7 +9,6 @@
 #
 # J1 Template is licensed under the MIT License.
 # See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
-#
 # ------------------------------------------------------------------------------
 
 module Jekyll

data/lib/starter_web/_plugins/symlink_watcher.rb

@@ -13,14 +13,13 @@
 # See: https://github.com/willnorris/willnorris.com/blob/master/LICENSE
 # J1 Template is licensed under the MIT License.
 # See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
-#
 # ------------------------------------------------------------------------------
 # NOTE:
 #   The symlink_watcher plugin extends jekyll-watch to listen also
 #   for changes in any symlinked sub-directory.
 #
-#   For example, in _drafts directory is a symlink to a directory 
-#   elsewhere on the filesystem. This plugin will cause jekyll to 
+#   For example, in _drafts directory is a symlink to a directory
+#   elsewhere on the filesystem. This plugin will cause jekyll to
 #   regenerate the site when ANY file change in the drafts folder.
 # ------------------------------------------------------------------------------
 require "find"

data/lib/starter_web/assets/images/modules/icons/j1/scalable/j1.svg

@@ -16,7 +16,7 @@
    version="1.1"
    inkscape:version="0.91 r13725"
    sodipodi:docname="j1.svg"
-   inkscape:export-filename="X:\j1\github\j1_template\packages\300_template_src\assets\images\modules\icons\j1\j1-512x512.png"
+   inkscape:export-filename="X:\j1\github\j1-template\packages\300_template_src\assets\images\modules\icons\j1\j1-512x512.png"
    inkscape:export-xdpi="90"
    inkscape:export-ydpi="90">
   <title
@@ -1313,9 +1313,9 @@
      borderopacity="1.0"
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
-     inkscape:zoom="1.3373274"
-     inkscape:cx="341.84077"
-     inkscape:cy="181.05754"
+     inkscape:zoom="1.71"
+     inkscape:cx="250"
+     inkscape:cy="250"
      inkscape:document-units="px"
      inkscape:current-layer="layer1"
      showgrid="true"
@@ -1361,10 +1361,6 @@
        position="666.2542,249.0041"
        orientation="0,1"
        id="guide4541" />
-    <sodipodi:guide
-       position="-25.802752,175.45872"
-       orientation="0,1"
-       id="guide4547" />
   </sodipodi:namedview>
   <metadata
      id="metadata7">
@@ -1417,33 +1413,33 @@
      id="layer1"
      transform="translate(0,-552.36218)"
      style="display:inline">
-    <rect
-       style="fill:none;fill-opacity:1"
-       id="rect3745"
-       width="93.470009"
-       height="91.974487"
-       x="-267.69809"
-       y="556.59729" />
-    <rect
-       style="fill:#ffffff;fill-opacity:1"
-       id="rect3747"
-       width="102.44314"
-       height="109.92074"
-       x="-222.08473"
-       y="631.37329" />
-    <text
-       xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:203.11209106px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#87aade;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;"
-       x="57.554077"
-       y="1092.8141"
-       id="text4682"
-       sodipodi:linespacing="125%"
-       transform="scale(1.2190564,0.82030662)"><tspan
-         sodipodi:role="line"
-         id="tspan4684"
-         x="57.554077"
-         y="1092.8141"
-         style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:564.20019531px;font-family:'Brush Script MT';-inkscape-font-specification:'Brush Script MT Italic';fill:#87aade;">j1</tspan></text>
+    <g
+       id="g4482">
+      <text
+         transform="scale(-1.1438394,0.87424863)"
+         sodipodi:linespacing="125%"
+         id="text4513"
+         y="1111.0399"
+         x="-420.70685"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:541.57806396px;line-height:125%;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;fill:#757575;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+         xml:space="preserve"><tspan
+           y="1111.0399"
+           x="-420.70685"
+           id="tspan4515"
+           sodipodi:role="line">1</tspan></text>
+      <text
+         transform="scale(1.1450956,-0.87328952)"
+         sodipodi:linespacing="125%"
+         id="text4513-3"
+         y="-723.17688"
+         x="15.25074"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:545.76879883px;line-height:125%;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;display:inline;fill:#0d47a1;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;"
+         xml:space="preserve"><tspan
+           y="-723.17688"
+           x="15.25074"
+           id="tspan4515-9"
+           sodipodi:role="line">1</tspan></text>
+    </g>
   </g>
   <g
      style="display:none"

data/lib/starter_web/collections/posts/public/featured/_posts/0000-00-00-welcome-to-j1-template.adoc.erb

@@ -6,7 +6,7 @@ description:                            Auto-generated welcome post
 date:                                   <%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %>
 series:
 adsense:                                false
-image:                                  /assets/images/modules/attics/welcome-1920x1280-bw.jpg
+image:                                  /assets/images/modules/attics/katie-moum-1920x1280.jpg
 
 tags:                                   [ Example, Post ]
 index:                                  []
@@ -19,47 +19,48 @@ resource_options:
   - attic:
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/welcome-1920x1280-bw.jpg
-          alt:                          Photo by Belinda Fewings on Unsplash
+        - url:                          /assets/images/modules/attics/katie-moum-1920x1280.jpg
+          alt:                          Photo by Katie Moum on Unsplash
           alignY:                       0.3
 #         caption:
-#           text:                       Photo by Belinda Fewings on Unsplash
-#           href:                       https://unsplash.com/@bel2000a
+#           text:                       Photo by Katie Moum on Unsplash
+#           href:                       https://unsplash.com/@katiemoum
           badge:
             type:                       unsplash
-            author:                     Belinda Fewings
-            href:                       https://unsplash.com/@bel2000a
+            author:                     Katie Moum
+            href:                       https://unsplash.com/@katiemoum
 ---
 
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
 
-// NOTE:  General Asciidoc page attributes settings
+// Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-:page-liquid:
+All you're doing at the end of the day is writing your content and Jekyll does
+all the tricky things needed for a website: putting out HTML, Javascript and
+CSS. As a result, the site creation process gets out of your way. It's done
+by Jekyll, and allows you to concentrate on what truly matters: your content.
+
+[role="clearfix mb-3"]
+excerpt__end
 
-// Additional Asciidoc page attributes goes here
+//  Load Liquid procedures
 // -----------------------------------------------------------------------------
-// :page-imagesdir: {{page.images.dir}}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
 
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="all" %}
 
-// NOTE: Place an excerpt at the most top position
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-If you’re not familiar with Jekyll (or other site generators), Jekyll is a
-so-called static site generator. Think of it like a CMS but without all the
-complexity and headache. No need to build a giant content strangling Rube
-Goldberg machine to manage content.
-
-All you’re doing at the end of the day is writing your content and Jekyll does
-all the tricky things needed for a web site: putting out HTML, Javascript
-and CSS. As a result, the site creation process gets out of your way, it's done
-by Jekyll, and allows you to concentrate on what truly matters: your content.
-[role="clearfix mb-3"]
-excerpt__end
-[role="clearfix mb-3"]
-excerpt__end
+// :page--attr:                         <attr-value>
 
 
 // Page content
-// -----------------------------------------------------------------------------
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[readmore]]
 == What is a static site?
 
@@ -67,93 +68,90 @@ excerpt__end
 // image::{{page.image}}[{{page.title}}]
 // image::/assets/images/modules/attics/spider-web-1920x1200-bw.png[{{page.title}}, 800]
 
-All you’re doing at the end of the day is writing your content and Jekyll does
-all the tricky things needed for a web site: putting out HTML, Javascript
-and CSS. As a result, the site creation process gets out of your way, it's done
-by Jekyll, and allows you to concentrate on what truly matters: your content.
-
-A static site serve the content straight to the user as it is stored on
-the server side. To put it in another way, in opposition to WordPress
+A static site serves the content straight to the user as it is stored on
+the server-side. To put it in another way, in opposition to WordPress
 which use a database to load dynamic content, a static site will display
 the same content to every user as it will directly load the HTML files
-on the server.
-
-=== What is different?
 
-What are the differences between a static site and a dynamic website?
+=== What's different?
 
 To make it simple, a dynamic website uses a database and PHP/MySQL to
-generate the content of a page when a user will request it. For example,
+generate the content of a page when a user requests it. For example,
 building a website using WordPress CMS will result in having a dynamic
-website.
+Website.
 
 === Why use a static site?
 
-Wat are the advantages of a static website over a dynamic site?
-You may be wondering “Why should I build a static site when I could do a
-WordPress?”. Well, having a database implies a lot of downsides. Here
-comes the tree main advantages of using a static site over a dynamic
+What are the advantages of a static website over a dynamic site?
+You may be wondering *Why should I build a static site when I could do a
+WordPress?*. Well, having a database implies a lot of downsides. Here
+come the main advantages of using a static site over a dynamic
 one.
 
-Static: the better performance and a crazy fast load time!
+Performance::
+The better performance and a crazy fast load time.
 
-One the of the main advantages of using a static site is the fact that
-it is crazy fast to load. Indeed, when the user request a page, there is
-no need to request a database and various files in order to generate the
+One of the main advantages of using a static site is the fact that
+it is crazy fast to load. Indeed, when the user requests a page, there is
+no need to request a database and various files to generate the
 page itself as all the content is already placed in a one and only file:
-an HTML one. That’s why, by using a static site you will get a boost in
+an HTML one. That’s why by using a static site, you will get a boost in
 your loading time that will provide great user experience for the
 internauts. Moreover, we know that more and more people are surfing the
 web using their smartphones with, sometimes, poor internet connections,
 that’s why having fast loading times will participate in making your
-website mobile friendly.
+website mobile-friendly.
 
-== Security aspects
-
-Having a static website: say goodbye to hacking and security issues!
+Security::
+Having a static website: say goodbye to hacking and security issues.
 
 Tired of getting WordPress notifications about security issues and
 updates every week? No worries, as a static site has no database, there
 are close to no hack possible compared to a WordPress website. Indeed,
-your site will have way less footprints and security issues since it
+your site will have way fewer footprints and security issues since it
 will only load plain HTML and CSS files. The security gain in having a
 static website is one the main reason why many famous brands switch to
-static site instead of having their website on Drupal or WordPress.
-
-== Building and Hosting
+a static site instead of having their website on Drupal or WordPress.
 
-Building a static site and hosting: you will save you money!
+Hosting::
+Building a static site and hosting: you will save you money.
 
 Using a static site, you will only have most of the time only HTML and
-CSS files to host. This kind of files are super light which also means
+CSS files to host. This kind of files is super light which also means
 that you will not need a powerhouse hosting to have a static site up and
-running. Moreover, if your traffic suddenly increase, your site will not
+running. Moreover, if your traffic suddenly increases, your site will not
 go down contrary to a dynamic site which should request the database
 each time for each user.
 
+Control::
+You're the master.
+
+Using a CMS means, giving control over your site to others. Simple like this.
+
 == Why use a site generator?
 
-Working with HTML files can sometimes be quite annoying. Indeed, if you
-need to make a modification you must manually change every file. If you
-have a website with 10 pages, it can be ok but imagine if you have a
-corporate site with 100+ pages or a blog with thousands of pages?! Using
-a static site generator will solve this issue as it separates the
+Working with pure HTML files is annoying; senseless today. Indeed, if you need
+to make a modification on your *self-managed* pages, you have to manually
+change every file. That's monkey's work from the early days of static websites.
+If your site comes with 10 pages, it can be manageable but imagine if your site
+is providing 100+ pages or the blog planned for hundreds of articles?
+
+Using a static site generator will solve this issue as it separates the
 content and the template. To say it another way, by using a static site
-generator you will only need to make the modification once and the
+generator, you will only need to make the modification once, and the
 generator will apply it to all your pages.
 
 === Why Jekyll?
 
 As the popularity of static sites is growing, there are plenty of static
-site generators available on the market. The more famous are Jekyll,
+site generators available on the market. The more famous is Jekyll,
 Middleman and Hugo. Each one has its own specificities and may suits you
-better depending on the programming languages you already are familiar
-with.
+better depending on the programming languages you already are familiar with.
 
 Which static site generator should I use?
 
-When I wanted to switch from WordPress to Static I personally
-choose Jekyll as for me it is the best static site generator so far.
-This blog is powered under Jekyll.
+When I decided to go for a blog based on a static web, I personally
+choose Jekyll as for me. It's a well known static site generator, good support
+in case of trouble and the software gets regularly  updated.
 
-Happy Jekylling!
+This blog is powered by Jekyll. For good reasons.

data/lib/starter_web/collections/posts/public/featured/_posts/2018-05-01-confusion-about-base-url.adoc

@@ -9,8 +9,7 @@ adsense:                                false
 image:                                  /assets/images/collections/blog/featured/what-is-a-baseurl.jpg
 
 tags:                                   [ Jekyll, Configuration ]
-index:                                  [ Jekyll, Configuration, URL, base_url ]
-categories:                             [ featured ]
+categories:                             [ Featured ]
 
 regenerate:                             false
 
@@ -25,12 +24,14 @@ resource_options:
           alt:                          jekyll.1200x600-bw.jpg
 ---
 
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
 :page-liquid:
 
-// Additional Asciidoc page attributes goes here
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
 :page-imagesdir: {{page.images.dir}}
 :wikipedia-article:                     https://en.wikipedia.org/wiki/Geography_of_Minneapolis
 
@@ -45,8 +46,17 @@ and how to use it.
 [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]]
 == Mimic GitHub Pages
 

data/lib/starter_web/collections/posts/public/featured/_posts/2019-05-01-top-open-source-static-site-generators.adoc

@@ -1,7 +1,7 @@
 ---
 title:                                  Site generators
-tagline:                                open-source tools
-description:                            Top open-source site generators
+tagline:                                OpenSource tools
+description:                            Top Open Source site generators
 
 date:                                   2019-05-01 00:00:00
 series:
@@ -9,9 +9,9 @@ adsense:                                false
 image:                                  /assets/images/modules/attics/building-blocks-1920x1280-bw.jpg
 
 tags:                                   [ Jekyll, Generators ]
-index:                                  [ Jekyll, Top, Open, Source, Static, Site, Generators ]
-categories:                             []
+categories:                             [ Featured ]
 
+toc:                                    true
 regenerate:                             false
 
 resources:                              []
@@ -32,28 +32,34 @@ resource_options:
             href:                       https://unsplash.com/@ryanquintal/portfolio
 ---
 
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
 :page-liquid:
 
-// Additional Asciidoc page attributes goes here
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-// :page-imagesdir: {{page.images.dir}}
+// :page--attr:                         <attr-value>
 
 // Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-People quite often ask, if static websites make sense for anything beyond a
-one-page website. Some other see in static websites the stone age of the
-World Wide Web. What's about static websites today? What's achiveable?
-
-This article highlights top open source projects, in many different programming
-languages. Have a look what's going on the market.
+This article highlights top OpenSource projects, in many different
+programming languages. Have a look what's going on the market.
 
 [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]]
 == Static Site Generators
 
@@ -66,31 +72,34 @@ That means fetching the content from a database to pass them over to a template
 system for adding the required structure information (e.g. CSS styles).
 This means each page is assembled on demand.
 
-For many, many websites dynamic page generation is completely unnecessary and
+=== Is an CMS needed?
+
+For many, many websites dynamic page generation is entirely unnecessary and
 adds unwanted risks in terms of complexity, performance losses and security
 issues. After all, the content of most websites changes only, when the content
-authors makes changes.
+authors make changes.
 
-Why a hell should a web page always assembled on demand if there are no
+Why the hell should a web page always assembled on demand if there are no
 changes?
 
 NOTE: To be fair, most CMS are providing caching systems for web pages to
-prevent unnessesary creation processes. It is not easy to implement such
-a caching system and in the very end, it adds the next level of complexity.
+prevent unnecessary creation processes. It is not easy to implement such
+a caching strategy, and in the very end, it adds the next level of
+complexity.
 
-A Static Site Generator takes a different approach and generate all the pages
-of the website upfront. That does not nessesarily mean, that a static website
-is always generated from the scratch. Modern generators support a so-called
+A Static Site Generator takes a different approach and generates all the pages
+of the website upfront. That does not necessarily mean that a static website
+is always built from scratch. Modern generators support a so-called
 incremental build; like Jekyll does. When there are changes detected to the
-content, only selected pages are rebuild.
+content, only selected pages will rebuild.
 
 This means overall, statically build web pages having no moving parts in the
 deployed website. This results in browser-side caching only, the performance
-goes up and static sites are far more secure because they are build already.
+goes up, and static sites are far more secure because they build already.
 
-To find out what Open Source Static Site Generators are available today and
-their ranking in terms of popularity go for StaticGen You'll will find the
-most complete list of generators!
+To find out what OpenSource Static Site Generators are available today and
+their ranking in terms of popularity go for StaticGen You'll find the most
+complete list of generators!
 
 Check https://www.staticgen.com[StaticGen].