j1-template 2021.0.15 → 2021.1.3

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

@@ -0,0 +1,119 @@
+---
+title:                                  J1 Template
+tagline:                                first version is out
+
+categories:                             [ Featured, Post ]
+tags:                                   [ J1, Template ]
+
+image:                                  /assets/images/modules/attics/runner-1920x1200.jpg
+
+fam_menu_id:                            default
+
+regenerate:                             false
+
+resources:                              []
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/modules/attics/runner-1920x1200.jpg
+          alt:                          Photo by Alex Holyoake on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Alex Holyoake
+            href:                       https://unsplash.com/@stairhopper
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+:badges-enabled:                        false
+
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+The template system was initially developed to create a simple but fully
+configurable website creation toolset for document servers. Document servers
+provide websites or other content formats like PDF, projects, software
+documentation, or similar approaches.
+
+[role="clearfix mb-3"]
+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
+// -----------------------------------------------------------------------------
+
+ifeval::[{badges-enabled} == true]
+{badge-j1--license} {badge-j1--version-latest} {badge-j1-gh--last-commit} {badge-j1--downloads}
+endif::[]
+
+// [[readmore]]
+Many large today's companies like {url-docker--docs}[Docker, {browser-window--new}]
+are using template-based systems to create their documentation sites. Or like
+{url-oreilly-atlas--home}[O'Reilly Atlas, {browser-window--new}],
+to provide a fully-featured writers platform for writing books or extensive
+documentation.
+
+All these platforms are technically different, but they share common ideas:
+
+* the layout of all content (pages) is based on a standard skeleton but
+  separated from the content
+* content is written using a neutral meta-language
+* the final output is not predefined
+* the result is automatically generated by engines (robots)
+
+To make these real, a lot of things are to be managed. You can imagine.
+The approaches of Docker or O'Reilly points to a possible solution: a template
+system based on _Bootstrap_ for the CCS framework, _Jekyll_ and _Liquid_ for
+the core engines, and _Asciidoc_ (Asciidoctor) for a neutral meta-language
+writing content.
+
+The next thought comes to my mind. Why developing a toolset for only
+document servers? Documentation webs of today are complex websites. Some
+features used for general web design may be not needed for documentation
+systems, but a lot of components are required that are wanted in general:
+
+* a powerful CSS and Javascript framework
+* a modular approach for dynamic content and apps
+* a configuration system to separate content from the layout and to automate
+  creation processes following the development pattern *MVC*
+  (https://blog.codinghorror.com/understanding-model-view-controller/[Model–View–Controller, {browser-window--new}])
+
+A plan was made in 2016, based on Jekyll V3 and Bootstrap V3, to create a
+template-based robot system that can be used for all types of websites, for
+all standard formats to create digital content.
+
+I was too optimistic about how long it would take to build such a system:
+
+* easy to use by developers and non-technical people
+* modular, powerful and stable
+* supporting modern content design
+* usable on common computer hardware, available to the public
+* less in components, using well-known software
+* entirely usable on small PCs locally as well as on powerful remote systems
+  on the Internet
+
+It took me nearly four years. Now, in early 2021, I can present the first
+version of J1 Template for the public. Hopefully, most of the objectives
+are achieved.
+
+Have fun!

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

@@ -18,6 +18,10 @@ end::tags[]
 // DATA, local references to data elements (asciidoc extensions)
 // -----------------------------------------------------------------------------
 tag::data[]
+
+:data-kickstart-wiad--static-web-access:          "collections/blog/featured/static-web-access.png, Accessing scheme for a static web"
+:data-kickstart-wiad--dynamic-web-access:         "collections/blog/featured/dynamic-web-access.png, Accessing scheme for a CMS (dynamic web)"
+
 end::data[]
 
 // DOCUMENTS, local document resources (macro include::)

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

@@ -1,17 +1,11 @@
 ---
 title:                                  Test Post 1
 tagline:                                testing series elements
-date:                                   2020-01-01 00:00:00
-description: >
 
 categories:                             [ Series ]
 tags:                                   [ Post, Test ]
 
 series:                                 test-series
-adsense:                                false
-comments:                               false
-toc:                                    true
-exclude_from_search:                    false
 
 regenerate:                             false
 
@@ -24,8 +18,8 @@ resource_options:
       padding_bottom:                   50
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/banner/docker-1280x600-bw.jpg
-          alt:                          docker_banner_r-1280x500-bw
+        - url:                          /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
+          alt:                          admin-dashboard-bootstrap
 ---
 
 // Page Initializer

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

@@ -1,18 +1,11 @@
 ---
 title:                                  Test Post 2
 tagline:                                testing series elements
-date:                                   2020-01-02 00:00:00
-description: >
-                                        Testing series elements
 
-tags:                                   [ Post, Test ]
 categories:                             [ Series ]
+tags:                                   [ Post, Test ]
 
 series:                                 test-series
-adsense:                                false
-comments:                               false
-toc:                                    true
-exclude_from_search:                    false
 
 regenerate:                             false
 
@@ -25,8 +18,8 @@ resource_options:
       padding_bottom:                   50
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/banner/docker-1280x600-bw.jpg
-          alt:                          docker_banner_r-1280x500-bw
+        - url:                          /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
+          alt:                          admin-dashboard-bootstrap
 ---
 
 // Page Initializer

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

@@ -1,18 +1,11 @@
 ---
 title:                                  Test Post 3
 tagline:                                testing series elements
-date:                                   2020-01-03 00:00:00
-description: >
-                                        Testing series elements
 
-tags:                                   [ Post, Test ]
 categories:                             [ Series ]
+tags:                                   [ Post, Test ]
 
 series:                                 test-series
-adsense:                                false
-comments:                               false
-toc:                                    true
-exclude_from_search:                    false
 
 regenerate:                             false
 
@@ -25,8 +18,8 @@ resource_options:
       padding_bottom:                   50
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/banner/docker-1280x600-bw.jpg
-          alt:                          docker_banner_r-1280x500-bw
+        - url:                          /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
+          alt:                          admin-dashboard-bootstrap
 ---
 
 // Page Initializer

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

@@ -1,18 +1,11 @@
 ---
 title:                                  Test Post 4
 tagline:                                testing series elements
-date:                                   2020-01-04 00:00:00
-description: >
-                                        Testing series elements
 
-tags:                                   [ Post, Test ]
 categories:                             [ Series ]
+tags:                                   [ Post, Test ]
 
 series:                                 test-series
-adsense:                                false
-comments:                               false
-toc:                                    true
-exclude_from_search:                    false
 
 regenerate:                             false
 
@@ -25,8 +18,8 @@ resource_options:
       padding_bottom:                   50
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/banner/docker-1280x600-bw.jpg
-          alt:                          docker_banner_r-1280x500-bw
+        - url:                          /assets/images/modules/attics/admin-dashboard-bootstrap-1280x600.jpg
+          alt:                          admin-dashboard-bootstrap
 ---
 
 // Page Initializer

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

@@ -1,11 +1,13 @@
 ---
 title:                                  Minneapolis
 tagline:                                largest city in the state of minnesota
-date:                                   2016-11-20 19:16:49 +0100
 
-tags:                                   [ USA, Minnesota, City, Minneapolis ]
 categories:                             [ Wikipedia ]
+tags:                                   [ USA, Minnesota, City, Minneapolis ]
+
+image:                                  /assets/images/collections/blog/wikipedia/minneapolis.1200x400.jpg
 
+sitemap:                                false
 regenerate:                             false
 
 resources:                              []

data/lib/starter_web/collections/posts/public/wikipedia/_posts/2016-11-24-narcisse-snake-dens.adoc

@@ -1,11 +1,13 @@
 ---
 title:                                  Narcisse Snake Dens
 tagline:                                largest snake population
-date:                                   2016-11-24 00:00:00 +0100
 
-tags:                                   [ Canada, Cities ]
 categories:                             [ Wikipedia ]
+tags:                                   [ Canada, Cities ]
+
+image:                                  /assets/images/collections/blog/wikipedia/narcise-snake-pits.1200x400.jpg
 
+sitemap:                                false
 regenerate:                             false
 
 resources:                              []

data/lib/starter_web/collections/posts/public/wikipedia/_posts/2016-11-26-columbia-river.adoc

@@ -1,11 +1,13 @@
 ---
 title:                                  Columbia River
 tagline:                                largest river in the pacific northwest region
-date:                                   2016-11-26 00:00:00 +0100
 
-tags:                                   [ USA, Rivers ]
 categories:                             [ Wikipedia ]
+tags:                                   [ USA, Rivers ]
+
+image:                                  /assets/images/collections/blog/wikipedia/columbia-river.1200x400.jpg
 
+sitemap:                                false
 regenerate:                             false
 
 resources:                              []

data/lib/starter_web/dot.gitattributes

@@ -13,5 +13,5 @@
 # ------------------------------------------------------------------------------
 
 # Enforce Unix newlines, all text files
-#
+# ------------------------------------------------------------------------------
 * text=auto eol=lf

data/lib/starter_web/dot.gitignore

@@ -14,6 +14,8 @@ Gemfile.lock
 
 Passengerfile.json
 
+google*.html
+
 tmp/
 
 \.bundle/
@@ -30,6 +32,8 @@ tmp/
 
 **/*.log
 
+**/*.current
+
 **/*.swp
 
 **/*_backup
@@ -38,7 +42,7 @@ tmp/
 # Never publish your sensitive personal and/or OAuth
 # data to any repo - not to public, not to any private.
 # ------------------------------------------------------------------------------
-.env
+private.yml
 
 
 # Unneeded files for the generated site

data/lib/starter_web/index.html

@@ -14,21 +14,19 @@ description: >
 categories:                             []
 tags:                                   []
 
-analytics:                              false
+robots:
+  index:                                true
+  follow:                               true
+
+analytics:                              true
 advertising:                            false
 comments:                               false
 
 fam_menu_id:                            default
 scrollbar:                              false
 toc:                                    false
-indexed:                                false
-exclude_from_search:                    true
 
-regenerate:                             false
-
-robots:
-  index:                                true
-  follow:                               true
+regenerate:                             true
 
 resources:                              []
 resource_options:
@@ -38,13 +36,9 @@ resource_options:
       opacity:                          0.5
       slides:
         - url:                          /assets/images/modules/attics/runner-1920x1200.jpg
-#         alt:                          Photo by Alex Holyoake on Unsplash
-#         badge:
-#           type:                       unsplash
-#           author:                     Alex Holyoake
-#           href:                       https://unsplash.com/@stairhopper
 ---
 
+
 <pre>
   This page is created by the layout: {{ page.layout }}.
 

data/lib/starter_web/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "j1_starter",
-  "version": "2021.0.15",
+  "version": "2021.1.2",
   "description": "J1 Template Starter Web",
   "homepage": "https://your.site",
   "author": {
@@ -19,9 +19,9 @@
     "loglevel": "silent"
   },
   "engines": {
-    "node": ">=10.0",
+    "node": ">=12.0",
     "npm": ">=6.0",
-    "yarn": ">=1.6"
+    "yarn": ">=1.22"
   },
   "keywords": [
     "Jekyll",
@@ -58,6 +58,7 @@
     "app:rackup": "cross-env SINATRA_ACTIVESUPPORT_WARNING=false WEBSERVER=$npm_package_jekyll_opt_webserver INTERFACE=$npm_package_jekyll_opt_interface PORT=$npm_package_jekyll_opt_app_port j1 rackup",
     "app:jekyll": "cross-var cross-env JEKYLL_ENV=$npm_package_config_mode BUNDLE_GEMFILE=$npm_package_ruby_gemfile bundle exec jekyll b -c $npm_package_jekyll_configfile $npm_package_jekyll_opt_incremental --watch",
     "app:open": "npm run delay-3s && cross-var opn $npm_package_jekyll_opt_app_url",
+
     "delay-1s": "node ./node_modules/npm-delay 1000",
     "delay-2s": "node ./node_modules/npm-delay 2000",
     "delay-3s": "node ./node_modules/npm-delay 3000",
@@ -123,7 +124,7 @@
     "setup:detect-os": "echo Detect OS .. && cross-env if-env OS=Windows_NT && cross-var echo \"OS detected: $OS\" || OS=$(echo $(getos)) && echo \"OS detected: $OS\" && echo done.",
     "setup:site": "run-s -s build",
 
-    "site": "run-s site:*",
+    "site": "run-p -s site:*",
     "site:jekyll": "echo Startup the site .. && cross-env SINATRA_ACTIVESUPPORT_WARNING=false bundle exec jekyll s --incremental --livereload --livereload-port $npm_package_jekyll_opt_livereload_port --open",
     "site:utilsrv": "npm --prefix ./utilsrv --silent run utilsrv",
 

data/lib/starter_web/pages/public/about/about_site.adoc

@@ -10,7 +10,7 @@ description: >
 tags:                                   [ Overview ]
 categories:                             [ Software, Platforms, Contributers ]
 
-scrollbar:                              true
+scrollbar:                              false
 
 permalink:                              /pages/public/about/site/
 regenerate:                             false

data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/asciidoc-extensions/gallery.asciidoc

@@ -1,5 +1,5 @@
 // Find (JustifieGallery, jg) gallery configuration with:
-// ~/_data/apps/justified_gallery.yml
+// ~/_data/apps/justifiedGallery.yml
 
 //.Title
 gallery::jg_example[]

data/lib/starter_web/pages/public/asciidoc_skeletons/book/000_intro.adoc

@@ -3,7 +3,7 @@
 #
 title:                                  Introduction
 tagline:                                Skeleton Book
-date:                                   2021-01-01 00:00:00
+date:                                   2021-01-01 00:00:00 +100
 description: >
                                         Before you start writing, some general thoughts make sense to clarify what
                                         Speaking, Reading and Writing are all about. What are the differences, what
@@ -14,6 +14,12 @@ description: >
 tags:                                   [ Introduction, Tutorial ]
 categories:                             [ Asciidoc, Knowledge, Skeleton ]
 
+sitemap:                                false
+robots:
+  index:                                false
+  follow:                               false
+
+
 permalink:                              /pages/public/skeleton/book/intro/
 regenerate:                             false