j1-template 2021.1.13 → 2021.1.18

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

@@ -1,11 +1,12 @@
 ---
 layout:                                 page
 title:                                  Creators Blog
-tagline:                                blog posts by tag
-description:                            Browse articles by tag
+tagline:                                posts by tag
+description: >
+                                        Browse articles by tag
 
-categories:                             [ Navigator ]
-tags:                                   [ Blog, Tags, Viewer ]
+categories:                             [ Blog ]
+tags:                                   [ Navigator, Tags ]
 
 sort:                                   date
 toc:                                    true
@@ -23,10 +24,17 @@ regenerate:                             false
 
 resource_options:
   - attic:
+      padding_top:                      400
+      padding_bottom:                   50
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/library-1920x1280-bw.jpg
-          alt:                          library-1920x1280-bw
+        - url:                          /assets/images/modules/attics/matthaeus-1920x1280.jpg
+          alt:                          Photo by Matthaeus
+          alignY:                       top
+          badge:
+            type:                       unsplash
+            author:                     Matthaeus
+            href:                       https://unsplash.com/@matthaeus123
 ---
 
 {% comment %} TODO: logic for "letter_group_written == false" to be fixed
@@ -40,12 +48,26 @@ resource_options:
 {% capture get_category_item %}themes/{{site.template.name}}/procedures/global/get_category_item.proc{% endcapture %}
 {% capture create_word_cloud %}themes/{{site.template.name}}/procedures/global/create_word_cloud.proc{% endcapture %}
 
+{% comment %} Set config files
+-------------------------------------------------------------------------------- {% endcomment %}
+{% assign template_config               = site.data.j1_config %}
+{% assign blocks                        = site.data.blocks %}
+{% assign modules                       = site.data.modules %}
+{% assign builder                       = site.data.builder %}
+{% assign plugins                       = site.data.plugins %}
+
+{% comment %} Set config data
+-------------------------------------------------------------------------------- {% endcomment %}
+{% assign blog_navigator_defaults       = builder.defaults.blog_navigator.defaults %}
+{% assign blog_navigator_settings       = builder.blog_navigator.settings %}
+
+{% comment %} Set config options
+-------------------------------------------------------------------------------- {% endcomment %}
+{% assign blog_navigator_options        = blog_navigator_defaults | merge: blog_navigator_settings %}
+
 {% comment %} Variables
 -------------------------------------------------------------------------------- {% endcomment %}
-{% assign view_config         = site.data.builder.blog_navigator.category_view %}
-{% assign truncate_words      = site.excerpt_truncate_words %}
-{% assign view_description    = view_config.description %}
-{% assign defaults            = site.data.builder.blog_navigator.defaults %}
+{% assign truncate_words                 = site.excerpt_truncate_words %}
 
 {% if site.permalink == 'none' %}
   {% capture browser_page_url %}{{page.url}}.html{% endcapture %}
@@ -82,6 +104,46 @@ resource_options:
   {% capture tag_list %}{{tag_list | append: tag}}{% unless forloop.last %},{% endunless %}{% endcapture %}
 {% endfor %}
 
+{% comment %} language detection
+-------------------------------------------------------------------------------- {% endcomment %}
+{% if site.language == "en" %}
+  {% assign language = "en" %}
+{% elsif site.language == "de"%}
+  {% assign language = "de" %}
+{% else %}
+  {% assign language = "en" %}
+{% endif %}
+
+{% if language == "en" %}
+  {% assign readmore_text              = "read" %}
+
+  {% assign category_view_button_text = blog_navigator_options.button_text.view_selector.category_view.en %}
+  {% assign date_view_button_text     = blog_navigator_options.button_text.view_selector.date_view.en %}
+  {% assign archive_view_button_text  = blog_navigator_options.button_text.view_selector.archive_view.en %}
+  {% assign tag_view_button_text      = blog_navigator_options.button_text.view_selector.tag_view.en %}
+
+  {% assign view_headline             = blog_navigator_options.tag_view.page_text.en.headline %}
+  {% assign view_description_text     = blog_navigator_options.tag_view.page_text.en.description %}
+{% endif %}
+
+{% if language == "de" %}
+  {% assign readmore_text              = "lesen" %}
+
+  {% assign category_view_button_text = blog_navigator_options.button_text.view_selector.category_view.de %}
+  {% assign date_view_button_text     = blog_navigator_options.button_text.view_selector.date_view.de %}
+  {% assign archive_view_button_text  = blog_navigator_options.button_text.view_selector.archive_view.de %}
+  {% assign tag_view_button_text      = blog_navigator_options.button_text.view_selector.tag_view.de %}
+
+  {% assign view_headline             = blog_navigator_options.tag_view.page_text.de.headline %}
+  {% assign view_description_text     = blog_navigator_options.tag_view.page_text.de.description %}
+{% endif %}
+
+{% comment %} Debugging
+--------------------------------------------------------------------------------
+skip_categories:            {{skip_categories | debug}}
+site_category_word_list:    {{site_category_word_list | debug}}
+--------------------------------------------------------------------------------
+{% endcomment %}
 
 {% comment %} Main
 -------------------------------------------------------------------------------- {% endcomment %}
@@ -90,16 +152,22 @@ resource_options:
 
 <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="{{date_view | prepend: site.baseurl}}" title="View by Date">By Date</a></li>
-    <li class="page-item"><a class="page-link" href="{{category_view | prepend: site.baseurl}}" title="View by Category">By Category</a></li>
-    <li class="page-item"><a class="page-link" href="{{all_view | prepend: site.baseurl}}" title="View All">All Posts</a></li>
+    <li class="page-item"><a class="page-link" href="{{navigator | prepend: site.baseurl}}" alt="Blog View">Navigator</a></li>
+    <li class="page-item"><a class="page-link" href="{{date_view | prepend: site.baseurl}}" alt="View by Date">By Date</a></li>
+    <li class="page-item"><a class="page-link" href="{{category_view | prepend: site.baseurl}}" alt="View by Category">By Category</a></li>
+    <li class="page-item"><a class="page-link" href="{{all_view | prepend: site.baseurl}}" alt="View All">All Posts</a></li>
   </ul>
 </div>
 
 <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>
+  {% if blog_navigator_options.tag_view.page_text.enabled %}
+  <div class="view-description">{{view_description_text}}</div>
+  {% endif %}
+
+  <div class="post-headline">
+    <h1 id="post-headline notoc" class="mt-5">Posts By Tag</h1>
+  </div>
+
   {% assign letter_group = letter_group_array[letter_group_counter] %}
 
   {% for item in (0..site.tags.size) %}{% unless forloop.last %}
@@ -120,7 +188,7 @@ resource_options:
       --------------------------------------------------------------------------
       <!-- jadams, 2018-01-17: logic seems NOT work. Disabled. -->
       {% if letter_group_written == false %}
-        <h3 id="id_{{letter_group}}" class="toc-link mt-5 mb-5"><a title="Back to top" href="#"><i class="fa fa-tags mr-2"></i></a>{{letter_group | upcase}}</h3>
+        <h2 id="id_{{letter_group}}" class="toc-link mt-5 mb-5"><a alt="Back to top" href="#"><i class="fa fa-tags mr-2"></i></a>{{letter_group | upcase}}</h2>
         {% assign letter_group_written = true %}
       {% endif %}
       -------------------------------------------------------------------------- {% endcomment %}
@@ -132,11 +200,11 @@ resource_options:
                     Added workaround by checking if letter_group has a value
       -------------------------------------------------------------------------- {% endcomment %}
       {% if letter_group %}
-      <h3 id="id_{{letter_group}}" class="toc-link mb-3">
-        <a title="Back to top" href="#">
+      <h2 id="id_{{letter_group}}" class="toc-link mb-3">
+        <a alt="Back to top" href="#">
           <i class="fa fa-tags mr-2"></i>
         </a>{{letter_group | upcase}}
-      </h3>
+      </h2>
       {% endif %}
       {% assign letter_group_written = true %}
     {% endif %}
@@ -147,7 +215,7 @@ resource_options:
     first_letter: {{first_letter | debug}}
     {% endcomment %}
 
-    <h4 id="{{this_word | replace: '+','_' | replace: ' ','_' | downcase}}" class="toc-link"><a title="Back to top" href="#"><i class="fa fa-tag mr-2"></i></a>{{this_word}}</h4>
+    <h3 id="{{this_word | replace: '+','_' | replace: ' ','_' | downcase}}" class="toc-link"><a alt="Back to top" href="#"><i class="fa fa-tag mr-2"></i></a>{{this_word}}</h3>
 
     {% for post in site.tags[this_word] %}{% if post.title != null %}
       {% include {{get_category}} post=post %}
@@ -159,25 +227,9 @@ resource_options:
 
       {% assign excerpt = post.excerpt|truncatewords:truncate_words|replace:'...',' ...'|strip_html|strip_newlines|strip %}
 
-      <!-- place post  -->
-      <!--div class="card card-flat mb-4">
-        <div class="card-body">
-
-          <h5 id="{{ 100000 | rand }}" class="card-title">{{ post.title }}</h5>
-          <h6 class="notoc card-subtitle text-muted mb-2">{{ post.tagline }}</h6>
-          <div class="card-text"><p>{{ excerpt }}</p></div>
-        </div>
-        <div class="card-footer">
-          <a class="btn btn-primary btn-raised btn-flex" href="{{post.url}}#readmore">
-            <i class="fa fa-eye fa-lg" style="color:#FFFFFF;"></i>
-            Read more
-          </a>
-        </div>
-      </div -->
-
       <!-- place post  -->
       <article class="card raised-z3 mb-5">
-        <h3 id="{{100000|rand}}" class="card-header bg-primary">{{post.title}}</h3>
+        <h4 id="{{100000|rand}}" class="card-header bg-primary">{{post.title}}</h4>
         <div class="row mx-0">
 
           <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Check if post image is available] -->
@@ -189,7 +241,7 @@ resource_options:
           {% else %}
           <!-- [INFO   ] [j1.pages.blog.navigator.archive          ] [Post image missing, using configured default image] -->
           <div class="col-md-6 img-bg--fill px-0"
-            style="background-image: url({{defaults.post_image}});">
+            style="background-image: url({{blog_navigator_options.post_image}});">
           </div>
           {% endif %}
 
@@ -199,7 +251,12 @@ resource_options:
               <div class="card-footer-text">
                 <hr class="my-3">
                 {% if post.date %}
-                <i class="mdi mdi-calendar-blank mr-1"></i> {{post.date | date: "%Y %B, %e"}}
+                  {% if language == "en" %}
+                    <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date | localize: "%Y %B, %e"}}
+                  {% endif %}
+                  {% if language == "de" %}
+                    <i class="mdi mdi-calendar-blank md-grey-600 mr-1"></i>{{post.date | localize: "%-d. %B %Y"}}
+                  {% endif %}
                 {% endif %}
                 {% if likes_count %}
                 <span class="font-weight-bold"> · </span>
@@ -212,7 +269,7 @@ resource_options:
               </div>
               <a class="card-link text-muted text-lowercase"
                  href="{{post.url}}#readmore">
-                 Read · {{post.tagline}}
+                 {{readmore_text}} · {{post.tagline}}
               </a>
             </div>
           </div>

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

@@ -2,7 +2,8 @@
 layout:                                 blog_archive
 title:                                  Creators Blog
 tagline:                                explore posts
-description:                            Navigate  all articles
+description: >
+                                        Navigate through all articles tis website
 
 categories:                             [ Blog ]
 tags:                                   [ Navigator ]

data/lib/starter_web/pages/public/learn/quickstart.adoc

@@ -0,0 +1,473 @@
+---
+title:                                  Quickstart
+tagline:                                an amazing site in 15 minutes
+date:                                   2021-03-07 00:00:00
+description: >
+                                        Welcome to the pages of J1 Template. If your here
+                                        first time, a good decision you get on that page first.
+                                        For sure, there is no better place to go.
+
+categories:                             [ Knowledge ]
+tags:                                   [ J1, Template, Quickstart ]
+
+comments:                               true
+fam_menu_id:                            page_ctrl_simple
+
+permalink:                              /pages/public/learn/quickstart/
+regenerate:                             false
+
+resources:                              [ clipboard, rouge ]
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/modules/attics/matthew-dockery-1920x1280.jpg
+          alt:                          Photo by Matthew Dockery on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Matthew Dockery
+            href:                       https://unsplash.com/@matt_dockery
+---
+
+// 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
+// -----------------------------------------------------------------------------
+
+*All you need for your new amazing site.*
+
+Jekyll meets Bootstrap - and makes a lot of friends. J1 Template combines
+the best of OpenSource software for the Web and the Web site generator
+`Jekyll`. J1 is OpenSource, and so are the packaged modules. No pain for
+private or professional use. Check J1 Template today to learn what's possible
+if you go to the Jekyll Way.
+
+*Create powerful modern Static Webs: Secure, Flexible and Fast.*
+
+The template comes with a Web included, a skeleton for new website created
+with J1 Template. This Web is called the *Starter Web*, a general-purpose
+Website scaffold to be modified for your needs. The built-in Starter Web
+can be visited live at https://publish.jekyll.one/[J1 Publish, {browser-window--new}].
+This site show live pages deployed on the Internet on _Github_, _Netlify_
+and _Heroku_.
+
+*Have fun exploring what a modern static web, a Jekyll site can do*!
+
+== The Software needed
+
+J1 is supported on all current x64-based OS:
+
+* Windows 10, build >= 1903
+* Windows WSL 2
+* Linux, kernel version >= 4.15 (e.g. Ubuntu  18.x LTS)
+* OSX, version >= 10.10.5 (Yosemite)
+
+WARNING: Note that 32-bit versions (x32) are generally NOT supported for all
+platforms.
+
+=== Development languages and tools
+
+To run the Development System for J1 Template, the following languages and
+tools expected to be in place with your OS:
+
+* Ruby language, version >= 2.6
+* Javascript language (NodeJS), version >= 12.x
+
+NOTE: More current or older versions may work, but not tested.
+
+=== Software upgrades needed for all platforms
+
+If _Ruby_ and _NodeJS_ are in place, some packages are to be upgraded to
+more *current* versions. Install all packages system-wide with their
+respective product installation pathes.
+
+==== Upgrades needed for Ruby < v2.7
+
+Install latest bundler for Ruby:
+
+[source, sh]
+----
+gem install bundler --no-document
+----
+
+Install latest RubyGems for Ruby:
+
+[source, sh]
+----
+gem install rubygems-update --no-document
+update_rubygems --no-document
+gem update --system
+----
+
+==== Upgrades needed for NodeJS
+
+NodeJS comes with NPM pre-installed. The native CLI for the NodeJS package
+management is `npm`. Besides `npm` there's another quite handy CLI for NPM
+available: *Yarn*.
+
+The CLI `yarn` is developed at Facebook and can be used as a replacement
+for `npm`. From a top-level perspective, both package management clients behave
+pretty much the same. The syntax `yarn` uses is shorter in writing, making
+the command-line look a bit more natural. Therefore, we prefer to use `yarn`.
+
+NOTE: Yarn adds some additional features to the NodeJS package management
+implemented for the needs at Facebook. Regarding the J1 development system,
+those add-ons are neither needed nor used.
+
+Install latest NPM and Yarn packages for NodeJS:
+
+[source, sh]
+----
+npm install -g npm@latest
+npm install -g yarn@latest
+----
+
+== Create a Starter Web
+
+Running the J1 template project is very simple:
+
+* Download the J1 Gem
+* Create a J1 web project
+* Setup the runtime environment for your project
+* Run and develop the buildin starter web
+
+Find all details on this with the sections below.
+
+=== Download the J1 Gem
+
+The Gem for J1 Template (runtime system) is published on _RubyGems_.
+You can get it by installing the package using the Ruby `gem` command or
+by downloading it from link:{url-j1--download}[RubyGems, {browser-window--new}].
+
+.Userized installation
+[source, sh]
+----
+gem install j1-template --remote --user-install --no-document
+----
+
+.System-wide installation
+[source, sh]
+----
+gem install j1-template --remote --no-document
+----
+
+NOTE: To *not* pollute the system-wide Gem folder of a Ruby-installation by
+*user* and *project* specific Gems, it is recommend to install *J1* userized.
+
+J1 is a so-called *gem-based* template, a *Ruby Gem* managed by the (gem)
+internal executeable (command) *j1*. Check your version installed or some
+usage information by running:
+
+.Version information
+[source, sh]
+----
+j1 --version
+----
+
+.Usage information
+[source, sh]
+----
+j1 --help
+----
+
+=== Setup a project
+
+Is the Ruby Gem *J1* installed, a project, a website needs to be generated
+by J1's build-in executable *j1*. The command *j1* is used to manage *base*
+project tasks like generating a *project*.
+
+If a *project* (a website) is generated, all development tasks are managed
+by *NPM scripts* (NodeJS). Development *tasks* are defined as *scripts*
+with the project config file `package.json`.
+
+First, create a projects folder for all website to be generated J1. For the
+following examples, a project is generated on _Windows_ using *C:\Temp*
+for the project's folder.
+
+.Usage information
+[source, sh]
+----
+j1 generate starter
+----
+
+.Output
+----
+Running bundle install in c:/Temp/starter ...
+Install bundle in USER gem folder ~/.gem ...
+
+    Bundler: Fetching gem metadata from https://rubygems.org/ ...
+    Bundler: Fetching gem metadata from https://rubygems.org/.
+    Bundler: Resolving dependencies...
+    Bundler: Using rake 12.3.3
+    Bundler: Using public_suffix 4.0.6
+    ...
+    Bundler: Using wdm 0.1.1
+    Bundler: Bundle complete! 34 Gemfile dependencies, 86 gems now installed.
+    Bundler: Bundled gems are installed into `../../Users/jadams/.gem`
+
+Install patches in USER gem folder ~/.gem ...
+Install patches on path C:/Users/jadams/.gem/ruby/2.6.0 ...
+Generated Jekyll site force installed in folder c:/Temp/starter
+----
+
+=== Setup the runtime
+
+The command *j1 generate* creates a project folder with the name given. In
+this example, the project is *starter*. Change to this folder
+
+[source, sh]
+----
+cd C:\Temp\starter
+----
+
+A J1 project consists in several files and folders. Find a typical structure
+as below:
+
+.J1 Project structure
+----
+  ├──── .
+  │     └─ _data  <1>
+  │     └─ _includes <2>
+  │     └─ _plugins <3>
+  │     └─ assets <4>
+  │     └─ collections <5>
+  │     └─ pages <6>
+  │     └─ utilsrv
+  ├──── _config.yml <7>
+  ├──── config.ru
+  ├──── dot.gitattributes
+  ├──── dot.gitignore
+  ├──── dot.nojekyll
+  ├──── favicon.ico
+  ├──── Gemfile <8>
+  ├──── index.html <9>
+  └──── package.json <10>
+----
+<1>   Configuration data for the website
+<2>   Asciidoc (global) includes
+<3>   Build-in (Ruby) plugins
+<4>   Assets for the web
+<5>   Folder that contains all blog posts
+<6>   Folder that contains all (article) pages
+<7>   Central (Jekyll) site configuration
+<8>   Ruby Gemfile
+<9>   Homepage for the web
+<10>  (NPM) Project file
+
+The first step, done only once, is to initialize a project. What means to
+download and install all resources for your new website followed by an
+initial creation process for the new site. Initializing a project is managed
+by the (NPM) *task* `setup`. A bunch of sub-tasks get fired, all of them
+managed by NPM.
+
+Let's start ...
+
+[source, sh]
+----
+yarn setup
+----
+
+Because a lot of sub-tasks getting started for a (first) `setup`, see below
+the output as a summary:
+
+----
+Setup project for first use ..
+Bootstrap base modules ..
+done.
+Configure environment ..
+done.
+Create project folders ..
+Create log folder ..
+Create archived log folder ..
+Create etc folder ..
+done.
+Bootstrap project modules ..
+Bootstrap utility server modules ..
+done.
+Detect OS ..
+OS detected: Windows_NT
+Build site incremental ..
+Configuration file: c:/Temp/starter/_config.yml
+            Source: c:/Temp/starter
+       Destination: c:/Temp/starter/_site
+ Incremental build: enabled
+      Generating...
+    J1 QuickSearch: creating search index ...
+    J1 QuickSearch: finished, index ready.
+      J1 Paginator: autopages, disabled|not configured
+      J1 Paginator: pagination enabled, start processing ...
+      J1 Paginator: finished, processed 5 pagination page|s
+                    done in 25.687 seconds.
+ Auto-regeneration: disabled. Use --watch to enable.
+.. build finished.
+To open the site, run: yarn site
+
+Done in 88.03s.
+----
+
+The `setup` process will take a while - typically some minutes for the
+*first* run (depending on the performances of your Internet connection
+and your workstation). A bunch of NPM modules and Ruby Gems are downloaded
+and linked for the components part of the project. See `setup` as an extended
+*install* and *build* process to manage an initial setup for your new
+website.
+
+=== Run and develop a starter web
+
+Running the Starter Web for development is done like so:
+
+[source, sh]
+----
+yarn site
+----
+
+The task `site` does a lot for you; whatever is necessary for a full-stack
+Web development. The task will put in place all needed CSS and JS components,
+build the Web content.
+
+----
+Startup the site ..
+Configuration file: c:/Temp/starter/_config.yml
+            Source: c:/Temp/starter
+       Destination: c:/Temp/starter/_site
+ Incremental build: enabled
+      Generating...
+    J1 QuickSearch: creating search index ...
+    J1 QuickSearch: finished, index ready.
+      J1 Paginator: autopages, disabled|not configured
+      J1 Paginator: pagination enabled, start processing ...
+      J1 Paginator: finished, processed 5 pagination page|s
+                    done in 7.1 seconds.
+ Auto-regeneration: enabled for '.'
+LiveReload address: http://localhost:40001
+    Server address: http://localhost:40000/
+  Server running... press ctrl-c to stop.
+        LiveReload: Browser connected
+----
+
+Finally, the starter web get openend in your *default* browser.
+
+Go, go, go ..
+
+=== Rebuild a site
+
+A project runs Jekyll in *incremental* mode with *auto-regeneration* enabled.
+All changes made to the pages (posts) of your web at runtime are automatically
+detected and the affected are rebuild and (live) reloaded.
+
+To rebuild the *site* from the scratch, a web can be completely rebuild by
+running the task `rebuild`:
+
+[source, sh]
+----
+yarn rebuild
+----
+
+----
+Rebuild site incremental ..
+Clean up site files ..
+Configuration file: c:/Temp/starter/_config.yml
+           Cleaner: Removing _site...
+           Cleaner: Removing ./.jekyll-metadata...
+           Cleaner: Removing ./.jekyll-cache...
+           Cleaner: Nothing to do for .sass-cache.
+Configuration file: c:/Temp/starter/_config.yml
+            Source: c:/Temp/starter
+       Destination: c:/Temp/starter/_site
+ Incremental build: enabled
+      Generating...
+    J1 QuickSearch: creating search index ...
+    J1 QuickSearch: finished, index ready.
+      J1 Paginator: autopages, disabled|not configured
+      J1 Paginator: pagination enabled, start processing ...
+      J1 Paginator: finished, processed 5 pagination page|s
+                    done in 25.221 seconds.
+ Auto-regeneration: disabled. Use --watch to enable.
+.. rebuild finished.
+To open the site, run: yarn site.
+Done in 34.88s.
+----
+
+If the site rebuild, re-run:
+
+[source, sh]
+----
+yarn site
+----
+
+and continue developing your website.
+
+=== Reset a project
+
+To start from the beginning, you can reset the runtime system to the
+factory state. The top-level task `reset` does the resetting work for you
+and cleans up each and everything except the NPM modules folder `node_modules`
+stored in the project root.
+
+[source, sh]
+----
+yarn reset
+----
+
+The cleanup runs some tasks for the root folder and in parallel sub-tasks
+using Jekyll for the Web:
+
+----
+Reset project to factory state ..
+Clean up base modules ..
+Clean up site files ..
+Configuration file: c:/Temp/starter/_config.yml
+           Cleaner: Removing _site...
+           Cleaner: Removing ./.jekyll-metadata...
+           Cleaner: Removing ./.jekyll-cache...
+           Cleaner: Nothing to do for .sass-cache.
+Clean up projects files ..
+Remove bundle config folder ..
+Remove log folder ..
+Remove etc folder ..
+Remove various log files ..
+Remove lock files ..
+Clean up utility server ..
+done.
+Done in 10.23s.
+----
+
+To reset the project *completely*, delete the folder `node_modules` manually
+and start from the beginning by running the `setup` task again:
+
+[source, sh]
+----
+yarn setup
+----
+
+If the project is newly setup, re-run:
+
+[source, sh]
+----
+yarn site
+----
+
+and continue developing your website.
+
+Happy Jekylling!