j1_template_mde 2018.4.10

data/lib/starter_web/collections/posts/series/_posts/2018-11-01-docker-using-shared-folders.adoc

@@ -0,0 +1,94 @@
+---
+title:                                  Using Docker
+tagline:                                Docker on Windows
+description:                            Using Docker on Windows
+date:                                   2018-11-01 00:00:00 +0100
+
+series:                                 j1-using-docker
+readmore:                               true
+adsense:                                false
+
+tags:                                   [ Docker, Windows, Shared, Folder, Folders ]
+regenerate:                             true
+
+resource_options:
+
+  - toccer:
+      collapseDepth:                    3
+
+  - masthead:
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/master_header/docker_banner_r.1280x500.png
+          caption_color:                rgba_lighten_800
+          transition:                   fadeInOut
+---
+
+// NOTE:  General Asciidoc page attributes settings
+//
+:page-liquid:
+
+//  Load Liquid procedures
+// -------------------------------------------------------------------
+{% capture set_env_entry_document %}themes/{{site.template.name}}/procedures/global/set_env_entry_document.proc{%endcapture%}
+//{% capture set_image_block %}themes/{{site.template.name}}/procedures/global/set_image_block.proc{%endcapture%}
+
+// Initialize entry document environmental attributes
+// -------------------------------------------------------------------
+{% include {{set_env_entry_document}} init_folders=all %}
+
+{% assign my_page_path = "./collections/posts/series/_posts" %}
+//{% capture my_page_root %}{{ page_path | remove_first: './' | strip}}{% endcapture %}
+{% assign my_page_root=page_path|remove_first:'./'|strip %}
+
+// Load tags and urls
+//
+//include::{includedir}/attributes.asciidoc[tag=tags]
+//include::{includedir}/attributes.asciidoc[tag=urls]
+//include::{includedir}/attributes.asciidoc[tag=data]
+
+include::{{my_page_path}}/000_includes/attributes.asciidoc[tag=tags]
+include::{{my_page_path}}/000_includes/attributes.asciidoc[tag=urls]
+include::{{my_page_path}}/000_includes/attributes.asciidoc[tag=data]
+
+// {arrow-r} page_path:--{{page_path}}
+//
+// {arrow-r} my_page_path:--{{my_page_path}}--
+//
+// {arrow-r} page_root:--{{page_root}}--
+//
+// {arrow-r} my_page_root:--{{my_page_root}}--
+
+// Additional Asciidoc page attributes goes here
+//
+// See FRONTMATTER defaults in _config.yml for the images path
+:page-imagesdir:                        {{page.images.dir}}/j1_using_docker
+
+// Additional debug output
+//
+//include::{tabledir}/debug_variables.asciidoc[]
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="mb-3"]
+image::{page-imagesdir}/windows_docker_banner.1280x500.png[{{page.title}}]
+
+How to run Docker smooth on Windows? Sounds like a quite simple question
+follwed by a simple answer: go for *Docker for Windows*. Unfortunately,
+the answer is *not* that easy. As often: it depends (on the use case).
+
+In general, two incarnations of Docker for Windows are available:
+
+* Legacy solution: *Docker Toolbox*
+* Native solution: *Docker for Windows*
+
+Before the native version of Docker *Docker for Windows* was available,
+a *cross-platform* solution called *Docker Toolbox* could be used.
+*Docker Toolbox* is a bundle of *current* Docker software based on
+*Docker Machine* combined with the *Docker Engine* bundled with
+*VirtualBox* as a Hypervisor to run Linux boxes as virtual machines
+on Windows.
+
+excerpt__end
+
+include::{documentsdir}/100-docker-using-shared-folders.asciidoc[]

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

@@ -0,0 +1,112 @@
+---
+title:                                  Minneapolis
+tagline:                                Largest City in the state of Minnesota
+description:                            Largest City in the state of Minnesota
+date:                                   2016-11-20 19:16:49 +0100
+
+tags:                                   [ USA, Minnesota, City, Minneapolis ]
+regenerate:                             false
+---
+
+// Enable the Liquid Preprocessor
+//
+:page-liquid:
+
+// Set other global page attributes here
+// -----------------------------------------------------------------------------
+:page-imagesdir:                        {{page.images.dir}}
+:wikipedia-article:                     https://en.wikipedia.org/wiki/Geography_of_Minneapolis
+
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="mb-3"]
+image::{page-imagesdir}/minneapolis.1200x400.jpg[{{page.title}}]
+
+Minneapolis is the largest city in the state of Minnesota in the United States,
+and the county seat of Hennepin County. According to the United States Census
+Bureau, the city has a total area of 151.3 km² (58.4 mi²). 142.2 km² (54.9 mi²)
+of it is land and 9.1 km² (3.5 mi²) of it (6.01%) is water.
+
+The city center is located just south of 45 degrees north latitude. On the south
+side of Golden Valley Road just east of Wirth Parkway, a stone containing a
+weathered plaque marks a point on the 45th parallel.
+
+[role="clearfix mb-3"]
+excerpt__end
+
+
+[[readmore]]
+== Physical
+
+Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
+
+The Mississippi, which runs to the southeast, directed the early growth of the
+city. Most early streets ran parallel to the river to maximize the amount of
+land that could be used. Eventually, growth of Minneapolis turned to north-south
+and east-west streets.
+
+Many unique  intersections like Seven Corners on the eastern periphery of
+downtown were formed to translate between the two layouts. Some streets,
+especially older and more traditionally important ones like Hennepin Avenue
+and Nicollet Avenue, have both orientations at different points.
+
+== Parks and lakes
+
+Minneapolis has a large park system consisting of ten square miles (26 km²)
+of land and water that is interlinked in many places. Theodore Wirth is often
+credited with the development of this system that brought a playground within
+the reach of most children and the canopy of trees and boulevards in much of
+the city. The Mississippi National River and Recreation Area connects regional
+parks and visitors centers.
+
+Theodore Wirth Park is the largest in the city, shared with Golden Valley,
+and is about 60% the size of Central Park in New York City. Minnehaha Park
+is one of the most famous, the site of Minnehaha Falls and cultural heritage
+events every year. Tower Hill Park in Prospect Park is the home of a 1913
+water tower, one of the highest points in Minneapolis.
+
+The Grand Rounds Scenic Byway circles through the city and many of the larger
+park areas including land along the Mississippi, lakes and scenic areas.
+A parkway for cars, a bikeway for riders, and a walkway for pedestrians run
+parallel paths along the 50-mile route. A growing number of bikeways and
+walkways crisscross the city and interconnect with neighboring cities.
+
+Twenty four small lakes are within the city limits. Among the largest
+freshwater lakes to the west are Lake Harriet, Lake Calhoun, Lake of the
+Isles, and Cedar Lake, known together as the "Chain of Lakes". Lake Nokomis
+and Lake Hiawatha are to the east. Connected by bike, running and walking
+paths, Minneapolis lakes are used for swimming, fishing, picnics and boating.
+
+== Flora and fauna
+
+The area now occupied by the Twin Cities generally consisted of a 155 foot
+(47 m) thick layer of St. Peter Sandstone, under a 16 foot (5 m) thick layer
+of shale, under a 35 foot (11 m) thick layer of Platteville limestone.[4]
+These layers were the result of an Ordovician Period sea which covered
+east-central Minnesota 500 million years ago. The hard limestone cap
+was formed from fossilized shell fish. About 20,000 years ago, the area
+was covered by the Superior Lobe of the Laurentide ice sheet, which left
+the St. Croix moraine on the Twin Cities as it receded.
+
+Later the Grantsburg Sublobe of the Des Moines Lobe also covered the area.
+Under these vast layers of ice, tunnel valleys were formed, cutting through the
+limestone layer with tremendous force, to release ice meltwater and glacier
+effluence. The result was a series of troughs in the limestone, which
+were filled by glacial till and outwash deposit as the glaciers receded.
+Sometimes the sediment would be mixed with huge chunks of ice, which would
+leave voids in the soil. These voids created basins for the Twin Cities Lakes,
+such as Harriet and Lake Calhoun. Connecting the city lakes in several
+north-south arteries are gorges cut through the bedrock, but filled with
+sand and sediment.
+
+When River Warren Falls receded past the confluence of the much smaller
+Upper Mississippi River, a new waterfall was created where that river entered
+the much-lower glacial River Warren. The new falls also receded upstream on
+the Mississippi, migrating eight miles (12875 m) over 9600 years to where
+Louis Hennepin first saw it and named St. Anthony Falls in 1680. Due to its
+value as a power source, this waterfall determined the location of Minneapolis.
+One branch of the river coming from the west, Minnehaha Creek receded only a
+few hundred yards from one of the channels of the Mississippi. Minnehaha Falls
+remains as a picturesque and informative relic of River Warren Falls, and the
+limestone-over-sandstone construction is readily apparent in its small gorge.

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

@@ -0,0 +1,81 @@
+---
+title:                                  Narcisse Snake Pits
+tagline:                                Largest snakes population
+description:                            Largest snakes population
+date:                                   2016-11-24 00:00:00 +0100
+
+tags:                                   [
+                                          Canada, Geography, Narcisse, Manitoba,
+                                          Cities, Snakes, Largest population,
+                                          Wikipedia
+                                        ]
+
+icon:
+  name:
+
+image:
+  name:
+
+regenerate:                             false
+---
+
+// Enable the Liquid Preprocessor
+//
+:page-liquid:
+
+// Set other global page attributes here
+// -----------------------------------------------------------------------------
+:page-imagesdir:                        {{page.images.dir}}
+:wikipedia-article:                     https://en.wikipedia.org/wiki/Narcisse_Snake_Pits
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="mb-3"]
+image::{page-imagesdir}/narcise-snake-pits.1200x400.jpg[{{page.title}}]
+
+The Narcisse Snake Pits are located in the Rural Municipality of Armstrong
+about 6 kilometres (3.7 mi) north of Narcisse, Manitoba, Canada. The dens
+are the winter home of tens of thousands of red-sided garter snakes
+(Thamnophis sirtalis parietalis).
+
+These pits are the largest concentration in the world of this particular type
+of snake. Their winter dens are subterranean caverns formed by the area's
+water-worn limestone bedrock.
+
+In the spring, they come up from their dens to the snake pits, where they
+engage in mating rituals. Then they disperse into the nearby marshes for
+the summer.
+
+[role="clearfix mb-3"]
+excerpt__end
+
+
+[[readmore]]
+== Conservation
+
+Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
+
+The population of red-sided garter snakes around Narcisse was roughly 70,000
+until terrible weather in 1999 killed tens of thousands of them before they
+could reach their winter dens. This tragedy triggered concern about the
+snakes' biannual migratory path, which cuts right across Highway 17.
+
+Every year, ten thousand snakes trying to get to or from their winter dens had
+been crushed under the wheels of vehicles. This had not been a problem before,
+because the vast population compensated for the losses. After the winter of
+1999, however, the population of garter snakes was dangerously low, causing
+Manitoba Hydro and volunteers to intervene.
+
+Foot-high snow fences were built to force snakes into six-inch (15-cm)
+tunnels that went under Highway 17. Since some snakes still managed to
+squeeze under the fence and onto the road, signs were put up during the
+migratory season urging motorists to slow down to avoid accidentally driving
+over snakes. These measures worked, and now less than a thousand snakes per
+season are killed on the highway.
+
+== Visiting
+
+The conservation area is open to the public. The snakes are most active
+during the spring and fall - in late April to early May, which is the mating
+season, and also in early September, when the snakes slither back down to
+their winter dens.

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

@@ -0,0 +1,68 @@
+---
+title:                                  Columbia River
+tagline:                                Largest River in the Pacific Northwest region
+description:                            Rivers of the Pacific Northwest region
+date:                                   2016-11-26 00:00:00 +0100
+
+tags:                                   [ USA, Northwest Region, Rocky Mountains, Rivers ]
+
+regenerate:                             false
+---
+
+// Enable the Liquid Preprocessor
+//
+:page-liquid:
+
+// Set other global page attributes here
+// -----------------------------------------------------------------------------
+:page-imagesdir:                        {{page.images.dir}}
+:wikipedia-article:                     https://en.wikipedia.org/wiki/Columbia_River
+
+// Place an excerpt at the most top position
+// -----------------------------------------------------------------------------
+[role="mb-3"]
+image::{page-imagesdir}/columbia-river.1200x400.jpg[{{page.title}}]
+
+The *Columbia River* is the largest river in the Pacific Northwest region of
+North America. It flows northwest and then south into the US state of Washington,
+then turns west to form most of the border between Washington and the state of
+Oregon before emptying into the Pacific Ocean.
+
+The river is 1,243 miles (2,000 km) long, and its largest tributary is the
+Snake River. Its drainage basin is roughly the size of France and extends
+into seven US states and a Canadian province.
+
+[role="clearfix mb-3"]
+excerpt__end
+
+
+[[readmore]]
+== Columbia River
+
+Read: link:{wikipedia-article}[From Wikipedia, the free encyclopedia, window="_blank"].
+
+By volume, the Columbia is the fourth-largest river in the United States; it
+has the greatest flow of any North American river draining into the Pacific.
+The river’s heavy flow and relatively steep  gives it tremendous
+potential for the generation of electricity. The 14 hydroelectric dams on
+the Columbia’s main stem and many more on its tributaries produce more than
+44% of total U.S. hydroelectric generation – much more hydroelectric power
+than those of any other North American river.
+
+The Columbia and its tributaries have been central to the region’s culture and
+economy for thousands of years. They have been used for transportation since
+ancient times, linking the many cultural groups of the region. The river system
+hosts many species of fish, which migrate between habitats and the saline
+waters of the Pacific Ocean. These fish—especially the salmon species—provided
+the core subsistence for native peoples; in past centuries, Indigenous peoples
+traveled across western North America to the Columbia to trade for fish.
+
+In the late 18th century, a private American ship became the first non-indigenous
+vessel to enter the river; it was followed by a British explorer, who navigated
+past the Oregon Coast Range into the Willamette Valley. In the following
+decades, fur trading companies used the Columbia as a key transportation route.
+Overland explorers entered the Willamette Valley through the scenic but
+treacherous Columbia River Gorge, and pioneers began to settle the valley in
+increasing numbers, following both routes to enter it. Steamships along the
+river linked communities and facilitated trade; the arrival of railroads in
+the late 19th century, many running along the river, supplemented these links.

data/lib/starter_web/index.html

@@ -0,0 +1,57 @@
+---
+layout:                                 home
+
+title:                                  Jekyll One Template
+tagline:                                Made for Jekyll · Made for Your Web
+description:                            Jekyll One Template. Gem-based template made for Jekyll.
+
+tags:                                   [ Template, Jekyll, Clean, Responsive, Featured, Gem-Based ]
+resources:                              cookiebar
+indexed:                                false
+regenerate:                             false 
+
+resource_options:
+
+  - masthead:
+      padding_top:                      600
+      padding_bottom:                   60
+      margin_bottom:                    50
+      title:
+        color:                          "#ef2929"                               #rgba_lighten_800
+      tagline:
+        color:                          rgba_lighten_800
+      background_color:
+        color_1:                        "#162126"
+        color_2:                        "#849191"
+
+      opacity:                          .6
+      alignY:                           .25
+      transition:                       fade
+      duration:                         3000
+      transitionDuration:               2500
+
+      slides:
+        - url:                          /assets/images/master_header/ideas-start-here.1920x1200.png
+---
+
+<pre>
+
+  This page is created by the layout: {{ page.layout }}.
+
+  If this text is displaywd (instead of the home page expected),
+  something went  wrong with the layout definitions. Check  the
+  output of the Jekyll engine building this site.
+
+  Check the  contents   of folder _layouts. Verify  if the base
+  layout  "{{ page.layout }}" exists  and the  referring  chain
+  (inheritance) is correct.
+
+  If you see this page within the J1 Template Development System,
+  re-run a site built running: 
+
+  lerna --scope starter_web run jekyllb 
+  and open the starter web again by:
+
+  yarn starter
+
+</pre>

data/lib/starter_web/package.json

@@ -0,0 +1,104 @@
+{
+  "private": true,
+  "name": "j1_starter",
+  "version": "2018.4.10",
+  "description": "Starter site for J1 Template",
+  "homepage": "https://your.site",
+  "author": {
+    "name": "Your Name",
+    "email": "name@mail.site",
+    "url": "https://your.site"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://your.site"
+  },
+  "config": {
+    "bumplevel": "patch",
+    "mode": "production",
+    "loglevel": "silent"
+  },
+  "engines": {
+    "node": ">=8.0",
+    "npm": ">=6.0",
+    "yarn": ">=1.6",
+    "jekyll": ">=3.8"
+  },
+  "keywords": [
+    "Jekyll",
+    "One",
+    "Server",
+    "Web",
+    "Site"
+  ],
+  "scripts": {
+    "app": "cross-var cross-env if-env J1DOCKER=true && run-s app-docker || run-s app-local",
+    "app-local": "run-p -s app-local:*",
+    "app-local:rackup": "cross-env SINATRA_ACTIVESUPPORT_WARNING=false bundle exec rackup -o 127.0.0.1 -p 4000",
+    "app-local:open": "npm run delay-3s && opn http://127.0.0.1:4000/",
+    "app-docker": "run-p -s app-docker:*",
+    "app-docker:rackup": "bundle exec rackup -o 0.0.0.0 -p 4000",
+    "detect-os": "echo Detecting OS .. && cross-env cross-var if-env OS=Windows_NT && cross-var echo OS detected as: $OS || OS=$(echo $(getos) && echo OS detected as: $OS",
+    "detect-docker": "echo Detecting DOCKER .. && cross-var cross-env if-env J1DOCKER=true && cross-var cross-env echo Docker detected as: $J1DOCKER || echo no Docker detected",
+    "built": "run-p -s built:*",
+    "built:info": "echo Built the site from current incremental ..",
+    "built:do": "bundle exec jekyll b --incremental",
+    "rebuilt": "run-p -s rebuilt:*",
+    "rebuilt:info": "echo Build the site from scratch ..",
+    "rebuilt:clean": "shx rm -rf _site && shx rm -f Gemfile.lock && shx rm -f .jekyll-metadata",
+    "rebuilt:do": "bundle exec jekyll b",
+    "delay-1s": "node ./node_modules/npm-delay 1000",
+    "delay-2s": "node ./node_modules/npm-delay 2000",
+    "delay-3s": "node ./node_modules/npm-delay 3000",
+    "delay-5s": "node ./node_modules/npm-delay 5000",
+    "delay-10s": "node ./node_modules/npm-delay 10000",
+    "delay-15s": "node ./node_modules/npm-delay 15000",
+    "delay-30s": "node ./node_modules/npm-delay 30000",
+    "clean": "run-p -s clean:*",
+    "clean:start": "echo Cleaning up project files ..",
+    "clean:logs": "shx rm -f *.log",
+    "clean:locks": "shx rm -f *.lock && shx rm -f package-lock.json",
+    "clean:site": "echo Cleaning up site files .. && shx rm -f .jekyll-metadata && shx rm -rf _site",
+    "credentials": "run-s -s credential:*",
+    "credential:echo": "echo Store username and password ..",
+    "credential:set": "git config credential.helper store && echo Finished.",
+    "reset": "run-s -s reset:*",
+    "reset:start": "echo Resetting the project to factory state ..",
+    "reset:clean-files": "npm --silent run clean",
+    "reset:finished": "echo Finished.",
+    "setup": "npm --silent run setup-start && npm --silent run setup-base && run-s -s setup:*",
+    "setup-start": "echo Setting up the project for first use ..",
+    "setup-base": "echo Bootstrapping base modules .. && npm i shx npm-run-all cross-var cross-env -D > install.log && echo Finished.",
+    "setup:env": "cross-var echo \"Configuring NODE|NPM environment ..\" && run-s -s set-env:*",
+    "set-env:loglevel": "cross-var npm config set jekyll_one_com:loglevel  $npm_package_config_loglevel && cross-var echo \"LOGLEVEL: $npm_package_config_loglevel\"",
+    "set-env:mode": "cross-var npm config set jekyll_one_com:mode $npm_package_config_mode && cross-var echo \"MODE:     $npm_package_config_mode\" && echo Finished.",
+    "setup:node-modules": "echo Bootstrapping project modules .. && npm install > install.log && echo Finished.",
+    "setup:detect-os": "echo Detecting OS .. && cross-var cross-env if-env OS=Windows_NT && cross-var cross-env echo OS detected as: $OS || OS=$(echo $(getos)) && echo OS detected as: $OS",
+    "setup:site": "echo Build the site .. && run-s -s built",
+    "site": "cross-var cross-env if-env J1DOCKER=true && run-s site-docker || run-s site-local",
+    "site-local": "echo Startup the site - local .. && bundle exec jekyll s --incremental --livereload --open",
+    "site-docker": "echo Startup the site - dockerized .. && bundle exec jekyll s --host 0.0.0.0 --incremental --livereload",
+    "deploy": "echo Add, Commit, Push and Deploy changed files to the Remotes && run-s -s git:*",
+    "git:add": "git add .",
+    "git:commit": "echo Commit files to repo && git commit -a",
+    "git:github": "echo Push files to Github && git push github master",
+    "git:j1git": "echo Push files to J1 Git Server && git push",
+    "bump": "run-s -s ver && run-s -s bump:* && run-s -s ver",
+    "ver": "cross-var echo \"project version: $npm_package_version\"",
+    "bump:project": "cross-var npm version $npm_package_config_bumplevel",
+    "bump-no-git": "cross-var npm --no-git-tag-version version $npm_package_config_bumplevel"
+  },
+  "dependencies": {
+    "getos": "^3.1.0",
+    "getos-cli": "^1.0.0",
+    "if-env": "^1.0.4",
+    "npm-delay": "^1.0.4",
+    "opn-cli": "^3.1.0"
+  },
+  "devDependencies": {
+    "cross-env": "^5.2.0",
+    "cross-var": "^1.1.0",
+    "npm-run-all": "^4.1.5",
+    "shx": "^0.2.2"
+  }
+}