j1-template 2022.0.9 → 2022.0.13

data/lib/starter_web/_includes/attributes.asciidoc

@@ -437,7 +437,7 @@ end::tables[]
 // -----------------------------------------------------------------------------
 tag::products[]
 :j1--license:                                     MIT License
-:j1--version:                                     2022.0.9
+:j1--version:                                     2022.0.13
 :j1--site-name:                                   Jekyll One
 end::products[]
 

data/lib/starter_web/_includes/themes/j1/modules/ads/google_ad_content_home.html

@@ -0,0 +1,11 @@
+<!-- insert gad container -->
+<div id="xxx..xx" class="mb-5">
+  <!-- display-ad-horizontal-2 -->
+  <ins class="adsbygoogle"
+       style="display:block"
+       data-ad-client="ca-pub-xxxx..xxx"
+       data-ad-slot="xxxx..xx"
+       data-ad-format="auto"
+       data-full-width-responsive="true">
+  </ins>
+</div>

data/lib/starter_web/_includes/themes/j1/modules/ads/google_ad_top_home.html

@@ -0,0 +1,11 @@
+<!-- insert gad container -->
+<div id="xxx..xx" class="mb-5">
+  <!-- display-ad-horizontal-1 -->
+  <ins class="adsbygoogle"
+       style="display:block"
+       data-ad-client="ca-pub-xxxx..xxx"
+       data-ad-slot="xxx..xx"
+       data-ad-format="auto"
+       data-full-width-responsive="true">
+  </ins>
+</div>

data/lib/starter_web/_plugins/lunr_index.rb

@@ -364,6 +364,6 @@ end
 
 module Jekyll
   module J1LunrSearch
-    VERSION = '2022.0.9'
+    VERSION = '2022.0.13'
   end
 end

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

@@ -9,7 +9,7 @@ tags:                                   [ J1, Jekyll ]
 image:                                  /assets/images/modules/attics/katie-moum-1920x1280.jpg
 
 regenerate:                             false
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - attic:
       opacity:                          0.5

data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.adoc

@@ -9,7 +9,7 @@ image:                                  /assets/images/modules/attics/cookies-19
 
 regenerate:                             false
 
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - attic:
       padding_top:                      400

data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.ads.asciidoc

@@ -0,0 +1,196 @@
+---
+title:                                  Cookies
+tagline:                                good to know
+
+categories:                             [ Knowledge ]
+tags:                                   [ Cookies ]
+
+image:                                  /assets/images/modules/attics/cookies-1920x1200.jpg
+
+regenerate:                             false
+
+resources:                              [ animate, advertising ]
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/modules/attics/cookies-1920x1200.jpg
+          alt:                          Photo by Miroslava on Unsplash
+#         caption:
+#           text:                       Photo by Miroslava on Unsplash
+#           href:                       https://unsplash.com/@miroslava
+          badge:
+            type:                       unsplash
+            author:                     Miroslava
+            href:                       https://unsplash.com/@miroslava
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+// Additional Asciidoc page attributes goes here
+// -----------------------------------------------------------------------------
+// :page-imagesdir: {{page.images.dir}}
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="dropcap"]
+Is it needed for visitors to know what cookies are about? No doubts, you're
+requested to inform - in Europe for legal reasons. All users visiting websites
+are bothered all the time to accept cookies. For good reasons.
+
+excerpt__end
+
+//  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
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+++++
+<!-- insert gad container -->
+<div id="xxx..xx" class="mb-5">
+  <!-- display-ad-horizontal-1 -->
+  <ins class="adsbygoogle"
+       style="display:block"
+       data-ad-client="ca-pub-xxxx..xxx"
+       data-ad-slot="xxxx..xx"
+       data-ad-format="auto"
+       data-full-width-responsive="true">
+  </ins>
+</div>
+++++
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+
+== What are cookies technically
+
+In short: a  cookie is a small piece of data that a website asks your
+browser to store on your computer or mobile device. The cookie allows the
+website to "remember" your actions or preferences over time. All modern
+browsers support cookies, but users can set their browsers to decline them
+and can delete them whenever they like. Good to know.
+
+Websites mainly use cookies for:
+
+Identification::
+Identify users
+
+General information storage::
+Remember users' custom preferences
+
+Support::
+Help users complete tasks without re-entering information when browsing from
+one page to another or when visiting the site later.
+
+Track behavioral::
+Cookies can also be used for online behavioral target advertising and to
+show adverts relevant to something that the user searched for in the past.
+The webserver supplying the webpage can store a cookie on the user's
+computer or mobile device.
+
+All these cookies are called HTTP header cookies. Another way of storing
+cookies is through JavaScript code contained or referenced on that page.
+Each time the user requests a new page, the webserver can receive the
+values of the cookies it previously set and return the page with content
+relating to these values. Similarly, JavaScript code can read a
+cookie belonging to its domain and act accordingly.
+
+.How are they used
+[NOTE]
+====
+The web server supplying the webpage can store a cookie on the user's
+computer or mobile device. An external web server that manages files
+included or referenced in the web page can store cookies. All these
+cookies are called HTTP header cookies. Another way of storing cookies
+is through JavaScript code contained or referenced on that page.
+
+Each time the user requests a new page, the web server can receive the
+values of the cookies it previously set and return the page with content
+relating to these values. Similarly, JavaScript code can read a
+cookie belonging to its domain and act accordingly.
+====
+
+== Types of cookies
+
+HTTP cookies are essential to the modern Internet but potentially a
+vulnerability to your privacy. As a necessary part of web browsing, cookies
+help web developers give you more personal, convenient website visits.
+Cookies let websites remember you, your website logins, shopping carts, and
+more. But they can also be a treasure trove of private info for criminals
+to spy on.
+
+Since the data in cookies doesn't change, cookies themselves aren't harmful.
+They *can't infect* computers with viruses or other malware. However, some
+cyberattacks can hijack cookies and enable access to your browsing sessions.
+The danger lies in their ability to track individuals' browsing histories.
+Cookies generally can be classified by its *lifespan* and the *domain* to
+which it belongs.
+
+=== By Lifespan
+
+Cookies classified by *lifespan* are either a:
+
+Session cookie::
+Session cookies gets automatically deleted when the user closes the web browser
+and all open window tabs.
+
+Persistent cookie::
+A persistent cookie *remains* on the user's computer/device for a pre-defined
+period of time.
+
+=== By Domain
+
+Cookies classified by the *domain* to which it belongs, are either of:
+
+First-party cookie::
+First-party cookie cookies are set by the webserver of the visited page
+and share the *same domain* you're visiting. These are generally safer, as
+long as users are browsing reputable websites or ones that have not been
+compromised.
+
+Third-party cookies::
+Third-party cookies are stored by a *different* domain to the visited page.
+This can happen when the webpage references a file located outside its domain.
+Third-party cookies let advertisers or analytics companies track the user's
+browsing history across the web on *any* sites that contain their ads.
+
+
+== Security aspects on using cookies
+
+Without cookies, the web would not work as it does today. However, since the
+mid 90ies when cookies were invented, the web changed quite a lot, and so did
+the attack methods on web applications; as mentioned, the Internet is not a
+friendly place.
+
+A well-known attack method is known as Cross-Site Request Forgery or short
+*CSRF*. CSRF is an attack, a criminal act, that forces an end user to execute
+unwanted actions. A cookie may play a *role* in such scenarios, but they are
+not generally *unsafe* if you want, you can read more about that on the
+CRSF Page on {url-owasp-attacks--csrf}[OWASP, {browser-window--new}].
+
+== How to control cookies
+
+Users can take control, used or *not* used, or delete cookies. For more
+details, see {url-about-cookies--home}[AboutCookies]. You can delete
+all cookies that are already on your computer, and you can set most
+browsers to prevent them from being placed.
+
+If you do this, however, you may have to manually adjust some preferences
+every time you visit a site, and some services and functionalities may not
+work.

data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.comments.asciidoc

@@ -0,0 +1,182 @@
+---
+title:                                  Cookies
+tagline:                                good to know
+
+categories:                             [ Knowledge ]
+tags:                                   [ Cookies ]
+
+image:                                  /assets/images/modules/attics/cookies-1920x1200.jpg
+
+regenerate:                             false
+
+resources:                              [ animate, comments ]
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/modules/attics/cookies-1920x1200.jpg
+          alt:                          Photo by Miroslava on Unsplash
+#         caption:
+#           text:                       Photo by Miroslava on Unsplash
+#           href:                       https://unsplash.com/@miroslava
+          badge:
+            type:                       unsplash
+            author:                     Miroslava
+            href:                       https://unsplash.com/@miroslava
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+// Additional Asciidoc page attributes goes here
+// -----------------------------------------------------------------------------
+// :page-imagesdir: {{page.images.dir}}
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="dropcap"]
+Is it needed for visitors to know what cookies are about? No doubts, you're
+requested to inform - in Europe for legal reasons. All users visiting websites
+are bothered all the time to accept cookies. For good reasons.
+
+excerpt__end
+
+//  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 (if any)
+// -----------------------------------------------------------------------------
+
+== What are cookies technically
+
+In short: a  cookie is a small piece of data that a website asks your
+browser to store on your computer or mobile device. The cookie allows the
+website to "remember" your actions or preferences over time. All modern
+browsers support cookies, but users can set their browsers to decline them
+and can delete them whenever they like. Good to know.
+
+Websites mainly use cookies for:
+
+Identification::
+Identify users
+
+General information storage::
+Remember users' custom preferences
+
+Support::
+Help users complete tasks without re-entering information when browsing from
+one page to another or when visiting the site later.
+
+Track behavioral::
+Cookies can also be used for online behavioral target advertising and to
+show adverts relevant to something that the user searched for in the past.
+The webserver supplying the webpage can store a cookie on the user's
+computer or mobile device.
+
+All these cookies are called HTTP header cookies. Another way of storing
+cookies is through JavaScript code contained or referenced on that page.
+Each time the user requests a new page, the webserver can receive the
+values of the cookies it previously set and return the page with content
+relating to these values. Similarly, JavaScript code can read a
+cookie belonging to its domain and act accordingly.
+
+.How are they used
+[NOTE]
+====
+The web server supplying the webpage can store a cookie on the user's
+computer or mobile device. An external web server that manages files
+included or referenced in the web page can store cookies. All these
+cookies are called HTTP header cookies. Another way of storing cookies
+is through JavaScript code contained or referenced on that page.
+
+Each time the user requests a new page, the web server can receive the
+values of the cookies it previously set and return the page with content
+relating to these values. Similarly, JavaScript code can read a
+cookie belonging to its domain and act accordingly.
+====
+
+== Types of cookies
+
+HTTP cookies are essential to the modern Internet but potentially a
+vulnerability to your privacy. As a necessary part of web browsing, cookies
+help web developers give you more personal, convenient website visits.
+Cookies let websites remember you, your website logins, shopping carts, and
+more. But they can also be a treasure trove of private info for criminals
+to spy on.
+
+Since the data in cookies doesn't change, cookies themselves aren't harmful.
+They *can't infect* computers with viruses or other malware. However, some
+cyberattacks can hijack cookies and enable access to your browsing sessions.
+The danger lies in their ability to track individuals' browsing histories.
+Cookies generally can be classified by its *lifespan* and the *domain* to
+which it belongs.
+
+=== By Lifespan
+
+Cookies classified by *lifespan* are either a:
+
+Session cookie::
+Session cookies gets automatically deleted when the user closes the web browser
+and all open window tabs.
+
+Persistent cookie::
+A persistent cookie *remains* on the user's computer/device for a pre-defined
+period of time.
+
+=== By Domain
+
+Cookies classified by the *domain* to which it belongs, are either of:
+
+First-party cookie::
+First-party cookie cookies are set by the webserver of the visited page
+and share the *same domain* you're visiting. These are generally safer, as
+long as users are browsing reputable websites or ones that have not been
+compromised.
+
+Third-party cookies::
+Third-party cookies are stored by a *different* domain to the visited page.
+This can happen when the webpage references a file located outside its domain.
+Third-party cookies let advertisers or analytics companies track the user's
+browsing history across the web on *any* sites that contain their ads.
+
+
+== Security aspects on using cookies
+
+Without cookies, the web would not work as it does today. However, since the
+mid 90ies when cookies were invented, the web changed quite a lot, and so did
+the attack methods on web applications; as mentioned, the Internet is not a
+friendly place.
+
+A well-known attack method is known as Cross-Site Request Forgery or short
+*CSRF*. CSRF is an attack, a criminal act, that forces an end user to execute
+unwanted actions. A cookie may play a *role* in such scenarios, but they are
+not generally *unsafe* if you want, you can read more about that on the
+CRSF Page on {url-owasp-attacks--csrf}[OWASP, {browser-window--new}].
+
+== How to control cookies
+
+Users can take control, used or *not* used, or delete cookies. For more
+details, see {url-about-cookies--home}[AboutCookies]. You can delete
+all cookies that are already on your computer, and you can set most
+browsers to prevent them from being placed.
+
+If you do this, however, you may have to manually adjust some preferences
+every time you visit a site, and some services and functionalities may not
+work.

data/lib/starter_web/collections/posts/public/featured/_posts/2021-02-01-site-generators.adoc

@@ -9,7 +9,7 @@ image:                                  /assets/images/modules/attics/machine-ge
 
 regenerate:                             false
 
-resources:                              [ lightbox ]
+resources:                              [ animate, lightbox ]
 resource_options:
   - attic:
       padding_top:                      400

data/lib/starter_web/collections/posts/public/featured/_posts/2021-03-03-about-j1.adoc

@@ -11,7 +11,7 @@ fab_menu_id:                            default
 
 regenerate:                             false
 
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - attic:
       padding_top:                      400

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-01-post-wiki-series.adoc

@@ -9,7 +9,7 @@ series:                                 wiki-series
 image:                                  /assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg
 regenerate:                             false
 
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - toccer:
       collapseDepth:                    3

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-02-post-wiki-series.adoc

@@ -10,7 +10,7 @@ image:                                  /assets/images/collections/blog/wikipedi
 
 regenerate:                             false
 
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - toccer:
       collapseDepth:                    3

data/lib/starter_web/collections/posts/public/series/_posts/2020-01-03-post-wiki-series.adoc

@@ -10,7 +10,7 @@ image:                                  /assets/images/collections/blog/wikipedi
 
 regenerate:                             false
 
-resources:                              []
+resources:                              [ animate ]
 resource_options:
   - toccer:
       collapseDepth:                    3

data/lib/starter_web/index.html

@@ -22,10 +22,6 @@ robots:
 personalization:                        false
 exclude_from_search:                    false
 
-analytics:                              true
-advertising:                            false
-comments:                               false
-
 fab_menu_id:                            default
 scrollbar:                              false
 toc:                                    false

data/lib/starter_web/package.json

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

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

@@ -15,7 +15,6 @@ categories:                             [ Knowledge ]
 tags:                                   [ Asciidoc, Skeleton, Documentation, PDF ]
 
 sitemap:                                false
-advertising:                            false
 comments:                               false
 
 robots:

data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/multi.adoc

@@ -13,7 +13,6 @@ categories:                             [ Knowledge ]
 tags:                                   [ Asciidoc, Skeleton, Document ]
 
 sitemap:                                false
-advertising:                            false
 comments:                               false
 
 robots:

data/lib/starter_web/pages/public/asciidoc_skeletons/simple-document/simple.adoc

@@ -12,7 +12,6 @@ categories:                             [ Knowledge ]
 tags:                                   [ Asciidoc, Skeleton, Document ]
 
 sitemap:                                false
-advertising:                            false
 comments:                               false
 
 robots:

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

@@ -17,7 +17,6 @@ pagination:
   permalink:                            /page:num/
 
 analytics:                              true
-advertising:                            false
 comments:                               false
 
 exclude_from_search:                    true

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

@@ -16,7 +16,6 @@ pagination:
   permalink:                            /page:num/
 
 analytics:                              true
-advertising:                            false
 comments:                               false
 
 exclude_from_search:                    true

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

@@ -17,7 +17,6 @@ pagination:
   permalink:                            /page:num/
 
 analytics:                              true
-advertising:                            false
 comments:                               false
 
 exclude_from_search:                    true

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

@@ -16,7 +16,6 @@ pagination:
   permalink:                            /page:num/
 
 analytics:                              false
-advertising:                            false
 comments:                               false
 
 exclude_from_search:                    true

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

@@ -18,7 +18,6 @@ toc:                                    true
 fab_menu_id:                            default
 
 analytics:                              true
-advertising:                            false
 comments:                               false
 
 regenerate:                             true                                    # needed to update pagination pages

data/lib/starter_web/pages/public/learn/roundtrip/100_present_images.adoc

@@ -16,8 +16,10 @@ permalink:                              /pages/public/learn/roundtrip/present_im
 regenerate:                             false
 
 resources:                              [
-                                          animate, clipboard, rouge, carousel, lightbox,
-                                          justifiedGallery, lightGallery
+                                          animate, clipboard,
+                                          carousel, justifiedGallery,
+                                          lightbox, lightGallery,
+                                          rouge
                                         ]
 resource_options:
   - attic:
@@ -120,7 +122,6 @@ LightGallery can do this by the following example.
 
 gallery::jg_old_times[]
 
-
 == J1 Carousel App
 
 J1 Carousel is based on OWL Carousel V1 in the latest (and unfortunately