j1-template 2020.0.20 → 2021.0.0

data/lib/starter_web/_data/modules/defaults/cookie_consent.yml

@@ -1,132 +0,0 @@
-# ------------------------------------------------------------------------------
-#  ~/_data/modules/defaults/cookie_consent.yml
-#  Default configuration settings for J1 Cookie Consent module
-#
-#  Product/Info:
-#  https://jekyll.one
-#
-#  Copyright (C) 2020 Juergen Adams
-#
-#  J1 Template is licensed under the MIT License.
-#  See: https://github.com/jekyll-one/J1 Template/blob/master/LICENSE
-# ------------------------------------------------------------------------------
-
-# ------------------------------------------------------------------------------
-# About this configuration (used for J1 CC only)
-#
-about_config:
-  title:                                Cookie Consent
-  scope:                                Default settings
-  location:                             _data/modules/defaults/cookie_consent.yml
-
-# ------------------------------------------------------------------------------
-# Default settings
-#
-defaults:
-
-  enabled:                              false
-
-  xhr_container_id:                     cookie_consent_modals
-  xhr_data_path:                        /assets/data/cookie_consent/index.html
-
-  modal_type:                           full
-  modal_position:                       top
-  stop_scrolling:                       true
-  consent_modal_id:                     cookie_consent_modals
-  consent_modals_title:                 Privacy
-  whitelisted_pages:                    [
-                                          /,
-                                          /pages/public/about/site/,
-                                          /pages/public/about/become_a_patron/
-                                          /pages/public/legal/en/impress/,
-                                          /pages/public/legal/en/privacy/,
-                                          /pages/public/legal/en/license_agreement/
-                                        ]
-
-  strict:                               false                                   # all pages requires a consent (currently NOT supported)
-  show_consent_icon:                    true                                    # show the consent icon (in quicklinks)
-  show_consent_on_pending:              false                                   # on first visit, whitelisted pages does NOT require a consent (overloaded by strict)
-  delete_cookies_on_decline:            false                                   # currently NOT supported
-
-  categories:
-    enabled:                            true
-    category_title:                     Cookie usage by category
-    category_description:               Usage Information
-    category_description_text:          Cookies are used for content pages if marked
-    category_session:                   Session
-    category_persistent:                Persistent
-    category_first_party:               1st Party
-    category_second_party:              2nd Party
-
-  buttons:
-    policy_button:                      true
-    policy_button_text:                 Cookie Policy
-    accept_button:                      true
-    accept_button_text:                 Yes, I accept cookies
-    decline_button:                     true
-    decline_button_text:                No, I refuse cookies
-
-  policy_about: >
-                                        This website uses cookies to ensure vistors get the best experience
-                                        on our content, presented user-friendly, more effective and safer.
-
-  cookie_policy_title:                  Cookie Policy
-  cookie_policy_tagline: >
-                                        Based on EU legislation on cookies.
-                                        See
-                                        http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CELEX:32009L0136:EN:NOT[Directive 2009/136/EC, window="_blank"] (ePrivacy Directive),
-                                        https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018R1725[Regulation (EU) 2018/1725, window="_blank"] (Data protection)
-                                        for more details
-
-  cookie_policy_text: >
-                                        The operators of this website take protection of your personal data extremely
-                                        seriously. We treat your personal data as confidential and comply with the
-                                        data protection legislation and this privacy policy.
-
-
-                                        A cookie is a commonly used automated data collection tool. Cookies are
-                                        small text files that are placed on your computer or device by websites
-                                        that you visit in order to make websites work, or work more efficiently.
-
-
-                                        NOTE: If you do not wish to receive cookies you may be able to refuse them by
-                                        adjusting your browser settings to reject cookies. If you do so, we may be
-                                        unable to offer you some of our functionalities, services or support.
-                                        If you have previously visited our websites, you may also have to delete
-                                        any existing cookies from your browser.
-
-
-                                        We, may our partners, make use of cookies, web beacons, pixel tags,
-                                        scripts or other similar technologies on our websites to improve the
-                                        browsing experience of our pages. We use different kinds of cookies.
-
-
-                                        Cookies are classified by its *lifespan* and the *domain* to which it
-                                        belongs.
-
-
-                                        Session Cookie::
-                                        Classified by *lifespan*. Necessary to provide you with services and
-                                        features available through our websites. Without these cookies, services
-                                        you may need, such as shopping carts or e-billing, cannot be provided.
-
-
-                                        Persistent Cookie::
-                                        Classified by *lifespan*. Necessary to provide you with services and
-                                        features available through our websites. Without these cookies, services
-                                        you may need, such as shopping carts or e-billing, cannot be provided.
-
-
-                                        First-party Cookie::
-                                        Classified by the *domain*. Collect information that is either used in
-                                        aggregate form to help us understand how the website is being used or how
-                                        effective our marketing campaigns are, or to help us customize the website
-                                        for you.
-
-
-                                        Second-party Cookie::
-                                        Classified by the *domain*. Used to make advertising messages more
-                                        relevant to you.
-
-# ------------------------------------------------------------------------------
-# END config

data/lib/starter_web/_data/modules/defaults/stickybits.yml

@@ -1,36 +0,0 @@
-# ------------------------------------------------------------------------------
-# ~/_data/modules/defaults/stickybits.yml
-# Default configuration settings for J1 Stickybits module
-#
-# Product/Info:
-# https://jekyll.one
-#
-# Copyright (C) 2020 Juergen Adams
-#
-# J1 Template is licensed under the MIT License.
-# See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
-# ------------------------------------------------------------------------------
-
-# ------------------------------------------------------------------------------
-# About this configuration (used for J1 CC only)
-#
-about_config:
-
-  title:                                Stickybits
-  scope:                                Default settings
-  location:                             _data/modules/defaults/stickybits.yml
-
-# ------------------------------------------------------------------------------
-# User configuration settings
-#
-defaults:
-
-  enabled:                              true
-  selector:                             .sticky
-  offset:                               0
-  useFixed:                             false
-  useStickyClasses:                     true                                    # default: false
-  verticalPosition:                     bottom
-
-# ------------------------------------------------------------------------------
-# END config

data/lib/starter_web/_data/modules/ssm.yml

@@ -1,142 +0,0 @@
-# ------------------------------------------------------------------------------
-# ~/_data/modules/ssc.yml
-# User Configuration of the SSC Module (Sticky Side Menu)
-#
-# Product/Info:
-# https://jekyll.one
-#
-# Copyright (C) 2020 Juergen Adams
-#
-# J1 Template is licensed under the MIT License.
-# See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
-#
-# ------------------------------------------------------------------------------
-# NOTE:
-#
-# ------------------------------------------------------------------------------
-
-# ------------------------------------------------------------------------------
-# About this configuration (used for J1 CC only)
-#
-about_config:
-  title:                                Sticky Side Menu
-  scope:                                User settings
-  location:                             _data/modules/ssm.yml
-
-# ------------------------------------------------------------------------------
-# User settings
-#
-settings:
-  enabled:                              true
-  mode:                                 icon                                    # icon|menu
-
-  # ----------------------------------------------------------------------------
-  # CONTAINER elements
-  #
-  items:
-
-    # --------------------------------------------------------------------------
-    # TOPLEVEL items
-    #
-    - item:                             Reload Page
-      enabled:                          true
-      id:                               ssm_reload_page
-      href:
-      target:
-      event_handler:                    reload_page
-      icon:                             reload
-      icon_classes:
-
-    - item:                             Table of Contents
-      enabled:                          true
-      id:                               ssm_toc
-      href:
-      target:
-      event_handler:                    open_ssm_toc
-      icon:                             wrap
-      icon_classes:
-
-    - item:                             To Top
-      enabled:                          true
-      id:                               ssm_scroll_to_top
-      event_handler:                    scroll_to_top
-      href:
-      target:
-      icon:                             step-backward-2
-      icon_classes:                     mdi-rotate-90
-
-    - item:                             Previous Section
-      enabled:                          true
-      id:                               ssm_previous_section
-      event_handler:                    scroll_previous_section
-      href:
-      target:
-      icon:                             step-backward
-      icon_classes:                     mdi-rotate-90
-
-    - item:                             Next Section
-      enabled:                          true
-      id:                               ssm_next_section
-      event_handler:                    scroll_next_section
-      href:
-      target:
-      icon:                             step-forward
-      icon_classes:                     mdi-rotate-90
-
-    - item:                             To Bottom
-      enabled:                          true
-      id:                               ssm_scroll_to_bottom
-      event_handler:                    scroll_to_bottom
-      href:
-      target:
-      icon:                             step-forward-2
-      icon_classes:                     mdi-rotate-90
-
-    - item:                             Leave a Comment
-      enabled:                          false
-      id:                               ssm_scroll_to_comments
-      event_handler:                    scroll_to_comments
-      href:
-      target:
-      icon:                             comment
-      icon_classes:
-
-    - item:                             Tester
-      enabled:                          false
-      id:                               ssm_test
-      href:
-      target:
-      event_handler:                    alert_me
-      icon:                             alert
-      icon_classes:
-
-    # --------------------------------------------------------------------------
-    # MENU items
-    #
-    - item:                             Social Share
-      enabled:                          false
-      icon:                             menu
-      icon_classes:
-      sublevel:
-
-        - title:                        Facebook
-          enabled:                      true
-          id:                           ssm_facebook
-          href:                         https://www.facebook.com/sharer/sharer.php?u=http://demo.enigmaweb.com.au/
-          target:
-          event_handler:                window.open(this.href, 'facebook', 'left=60,top=40,width=500,height=500,toolbar=1,resizable=0'); return false;
-          icon:                         facebook
-          icon_classes:
-
-        - title:                        Twitter
-          enabled:                      true
-          id:                           ssm_twitter
-          href:                         https://twitter.com/home?status=http://demo.enigmaweb.com.au/
-          target:
-          event_handler:                window.open(this.href, 'twitter', 'left=60,top=40,width=500,height=500,toolbar=1,resizable=0'); return false;
-          icon:                         twitter
-          icon_classes:
-
-
-# ------------------------------------------------------------------------------
-# END config

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

@@ -1,47 +0,0 @@
-// ~/document_base_folder/000_includes
-//  Asciidoc attribute includes:                 attributes.asciidoc
-// -----------------------------------------------------------------------------
-
-// URLs - Internal references and/or sources on the Internet
-// -----------------------------------------------------------------------------
-tag::urls[]
-
-:parker-blog:                           https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/
-
-end::urls[]
-
-
-// Tags - Asciidoc attributes used internally
-// -----------------------------------------------------------------------------
-tag::tags[]
-
-:figure-caption:                        Figure
-
-end::tags[]
-
-
-// Data - Data elements for Asciidoctor extensions
-// -----------------------------------------------------------------------------
-tag::data[]
-
-:docker-windows-kinematic-alpha-data:             "blog/series/j1_using_docker/kinematic_alpha.1280x600.png, Docker UI Kinematic on Windows"
-
-end::data[]
-
-
-// Product|Author - Document (e.g release) and Author information
-// -----------------------------------------------------------------------------
-tag::product_info[]
-
-:license:                                         MIT License
-:revdate:                                         2018
-:revnumber:                                       1.0.0
-
-end::product_info[]
-
-tag::authors[]
-
-:uri-author-juergen-adams:                        https://jekyll.one
-
-end::authors[]
-

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

@@ -1,66 +0,0 @@
-// ~/document_base_folder/000_includes
-//  Asciidoc attribute includes:                 attributes.asciidoc
-// -----------------------------------------------------------------------------
-
-
-// URLs - Internal references and/or sources on the Internet
-// -----------------------------------------------------------------------------
-tag::urls[]
-
-:blogging-on-github-part-2:                       http://digitaldrummerj.me/blogging-on-github-part-2-your-first-post/
-:blogging-on-github-part-3:                       http://digitaldrummerj.me//blogging-on-github-part-3-adding-comments/
-:blogging-on-github-part-4:                       http://digitaldrummerj.me//blogging-on-github-part-4-creating-additional-pages/
-
-:docker-install-toolbox-on-windows:               https://docs.docker.com/toolbox/toolbox_install_windows/
-:virtualbox-install-on-windows:                   https://www.virtualbox.org/wiki/Downloads
-
-end::urls[]
-
-// Tags - Asciidoc attributes used internally
-// -----------------------------------------------------------------------------
-tag::tags[]
-
-:debug:                                           false
- 
-:window:                                          window="_blank"
-:figure-caption:                                  Figure
-:y:                                               icon:check[role="green"]
-:n:                                               icon:times[role="red"]
-:c:                                               icon:file-alt[role="blue"]
-:arrow-r:                                         icon:arrow-right[role="blue"]
-:arrow-l:                                         icon:arrow-left[role="blue"]
-:arrow-t:                                         icon:arrow-top[role="blue"]
-:arrow-d:                                         icon:arrow-down[role="blue"]
-:beginner:                                        icon:battery-quarter[role="md-blue"]
-:inter:                                           icon:battery-half[role="md-blue"]
-:advanced:                                        icon:battery-full[role="md-blue"]
-:emdash:                                          —
-
-end::tags[]
-
-
-// Data - Data elements for Asciidoctor extensions
-// -----------------------------------------------------------------------------
-tag::data[]
-
-:data-docker-windows-kinematic-alpha:             "collections/blog/series/j1_using_docker/kinematic_alpha.1280x600.png, Docker UI Kinematic on Windows"
-
-end::data[]
-
-
-
-// Product|Author - Document (e.g release) and Author information
-// -----------------------------------------------------------------------------
-tag::product_info[]
-
-:license:                                         MIT License
-:revdate:                                         2018
-:revnumber:                                       1.0.0
-
-end::product_info[]
-
-tag::authors[]
-
-:uri-author-juergen-adams:                        https://jekyll.one
-
-end::authors[]

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

@@ -1,502 +0,0 @@
----
-title:                                  Using Docker
-tagline:                                docker on windows
-description:                            Docker on Windows
-
-date:                                   2018-11-01 00:00:00 +0100
-series:                                 Docker
-adsense:                                false
-comments:                               false
-toc:                                    true
-
-tags:                                   [ Tutorial, kickstarter ]
-index:                                  [ Docker, Windows, Shared, Folder, Folders ]
-categories:                             []
-
-regenerate:                             false
-
-resources:                              []
-resource_options:
-  - toccer:
-      collapseDepth:                    3
-  - attic:
-      padding_top:                      400
-      padding_bottom:                   50
-      opacity:                          0.5
-      slides:
-        - url:                          /assets/images/modules/attics/banner/docker-1280x600-bw.jpg
-          alt:                          docker_banner_r-1280x500-bw
----
-
-// NOTE:  General Asciidoc page attributes settings
-// -----------------------------------------------------------------------------
-:page-liquid:
-
-
-// Additional Asciidoc page attributes goes here
-// -----------------------------------------------------------------------------
-:page-imagesdir: {{page.images.dir}}/j1_using_docker
-
-// Place an excerpt at the most top position
-// -----------------------------------------------------------------------------
-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).
-
-[role="clearfix mb-3"]
-excerpt__end
-
-// Liquid procedures
-// -----------------------------------------------------------------------------
-{% capture set_env_entry_document %}themes/{{site.template.name}}/procedures/global/set_env_entry_document.proc{%endcapture%}
-
-// Initialize entry document paths
-//
-{% include {{set_env_entry_document}} init_folders=all %}
-
-// Load tags and urls
-//
-include::{includedir}/attributes.asciidoc[tag=tags]
-include::{includedir}/attributes.asciidoc[tag=urls]
-include::{includedir}/attributes.asciidoc[tag=data]
-
-// Additional debug output (if :debug: set to true)
-// -----------------------------------------------------------------------------
-:debug: false
-include::{tabledir}/debug_variables.asciidoc[]
-
-// Page content
-// -----------------------------------------------------------------------------
-//include::{documentsdir}/100-docker-using-shared-folders.asciidoc[]
-
-
-[[readmore]]
-== Docker smooth on Windows
-
-// [role="mb-3"]
-// image::/assets/images/collections/blog/series/j1_using_docker/windows_docker_banner.1280x500.png[{{page.title}}]
-
-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.
-
-What the Docker team recomments: Update to the newer package, if possible.
-This should be discussed, especially for Windows, in more detail ...
-
-[WARNING]
-====
-*The Docker Team mentions the following about Docker Toolbox:*
-
-Docker Toolbox is for *older Windows* systems (or *Apple MacOS* versions)
-that *does not meet* the requirements of the *native* Docker version.
-====
-
-Docker won't never run *natively* on Windows. The *Container Technology*
-used by Docker depends on *Linux* (at least on a Unix flavour of the host
-operating system). For all non-Linux (or Unix) platforms, a *Hypervisor* is
-needed to make it possible to run the needed *Linux OS* for Docker.
-
-Yes, Windows support a *native* Hypervisor layer: `Hyper-V`. Using the Windows
-component `Hyper-V`, any operating system can be run as *virtual machines* on
-Windows. But it should be kept in mind: the Hypervisor layer is *always* needed;
-as well as for the so-called the *native* Docker version on Windows. But:
-real *native* Docker versions does *not* need a Hypervisor layer; they run
-containers direcly on the host OS! This should be kept on mind.
-
-They are some pittfals using *Docker for Windows* if you go for:
-
-* Stability - found quite often issues running containers on *Docker for Windows*.
-If you're  not a Windows specialist, it is hard to findout issues for `Hyper-V`
-, the VM and|or both.
-* Flexibility - it is *NOT* possible to use the Hypervisor `Hyper-V` in
-parallel to *VirtualBox* as an alternative
-* Incompatibility - on some Windows installations, and for sure they met the
-requirements of the *native* Docker version, the installaton was *NOT*
-successful and Docker fails to start
-
-Again: the software included in the *Docker Toolbox* are *current* versions.
-The latest Toolbox contains:
-
-* the Docker Engine Docker, version 18.03.0-ce, build 0520e24302
-* the Docker Machine, version 0.14.0, build 89b8332
-* the Docker Composer, version 1.20.1, build 5d8c71b2
-* a current MINGW64-based GNU bash, version 4.4.19(2)-release (x86_64-pc-msys)
-
-For all the people having their (IT) roots on Unix respectively Linux, the
-*Docker Toolbox* is the better solution on Windows (for now). No need to go
-for the Windows Hypervisor `Hyper-V` - Oracle *VirtualBox* can be used
-instead; as quite often used for testing and development.
-
-Let's have a look how to *Manage Linux on Windows*, to use Docker on the
-Windows platform.
-
-== Installing Docker Toolbox
-
-As discussed ealier, *Docker Toolbox* is using *VirtualBox* for the
-Hypervisor to create the Linux VMs needed. To get the latest version,
-install VirtualBox first (Docker Toolbox includes a installer package
-for VBox but not nessesarily at their latets version).
-
-Go for the link:{virtualbox-install-on-windows}[VirtualBox Download Page]
-and select under *VirtualBox 5.x.y platform packages* the latest version
-for Windows (Windows hosts). Install the package - the installation process
-is quite simple supported by an build in installer wizard.
-
-If done, go for the installation of the Toolbox. A current package can be
-retrieved from link:{docker-install-toolbox-on-windows}[Docker Documents].
-The page includes all the info needed to install the software.
-
-NOTE: For the installation of the *Docker Toolbox*, please deselect the
-installation of *VirtualBox* included as the software has been already
-installed.
-
-NOTE: The commandline interface used by *Docker Toolbox* is based on
-*Git MSYS-git UNIX tools*. If you have *Git* installed already for your
-Windows host, please deselect the installation of *Git* included.
-
-*Docker Toolbox* comes with *NO* graphical user interface (GUI). To manage
-Docker, the included GNU bash of the *Git MSYS-git UNIX tools* shoud be used.
-A very first version of a (native) Docker UI on Windows is *Kitematic*,
-currently in a alpha version included.
-
-ifdef::backend-html5[]
-.Docker UI Kinematic on Windows
-lightbox::docker-windows-kinematic-alpha[800, {data-docker-windows-kinematic-alpha}]
-endif::[]
-
-TIP: You should check *Kitematic*. If started for *Docker Toolbox* on Windows,
-change (the Hypervisor) to Virtualbox.
-
-For Windows users a commandline interface to manage a complex system like
-Docker may sound a bit stone age. It's not for good reasons:
-
-* the knowlegde of the base Docker commands is essential to understand the
-Container Technology better
-
-* Blalal blaaa
-
-
-
-== Manage Linux on Windows
-
-VirtualBox is a greate piece of software for desktop and workstation
-virtualization. A huge number of IT specialist and developers are using VB
-for: testing and development environments. Sometimes for production
-environments – if it's applicable.
-
-One good idea for VirtualBox is, if you are Web|App developer for Linux you
-can keep *Windows* as your primary OS - yeah, yeah those people are living on
-our planet! One can install a Linux distribution of choice in VirtualBox VM
-and reap both benefits of Windows as primary OS and Linux as a server
-platform for good reasons.
-
-=== Create a Linux VM
-
-lorem:sentences[5]
-
-lorem:sentences[3]
-
-
-=== Sharing Data
-
-For (real) native Docker installations, it is easy to share data between then
-host OS and containers managed by Docker. It is simple this:
-
-[source, sh]
-----
-docker run --rm \
-  --volume=$PWD:/srv/jekyll \
-  -p 35729:35729 -p 40000:40000 \
-  -it jekyll-one/j1:latest \
-  j1 serve --incremental --livereload
-----
-
-The container, instructed by `--volume=$PWD:/srv/jekyll` shares the
-filesystem of the host - the *native* way to bring in data into a
-container for processing. In the example a static Jekyll Web is created
-by J1 Template (j1), served by the ports 35729 for livereload and 40000
-serving the web.
-
-For the Windows platform, using a virtual Linux Box for Docker containers,
-this is *NOT* possible. The virtual system is managed by Virtualbox and no
-direct relationship is in between the VBox and the host operating system
-Windows! No (direct) access to the host filesystem is possible. Bad luck so
-far.
-
-Generally spoken, there are 3 ways of sharing files between a Windows host
-and Linux guest boxes; keep files:
-
-* in the guest (Linux) and share them with host through Samba
-* on host (Windows) and use VirtualBox *Shared Folders*
-* on host (Windows) and mount Windows *Public Folders* via CIFS
-from within guest (Linux)
-
-For all people experienced on the Linux platform, the first option is
-probably the easiest. But it has it’s drawbacks. In most cases for testing,
-it's *NOT* wanted to keep files in a VM. In case of corruption of the VM,
-reinstallation needs, or whatever yor data is *lost* in most cases. Truly,
-not an option.
-
-Typically developers want them kept on native Windows *disks* as they are
-expected as more safely stored on physical devices and easier to backup.
-So first option is clearly out.
-
-*Shared Folders* are really a great idea. After installing the *VirtualBox
-Guest Additions* (which brings the mount.vboxsf binary and vboxsf kernel
-module) the guest can mount automatically a Windows OS folder inside the VM.
-Some klicks further the guest start's, mount the *shared folder* in guest and
-voila: you're done! Sounds really great.
-
-But there's a catch – performance. Shared Folders are really, really horrible
-slow. Which in turn kills the idea of programming and testing code without
-loosing hair because of the slowness. You can find tons of articles around
-slow shared folders on the Internet; both for the Big Dogs: VMware and
-VirtualBox. But no solution. Since decades.
-
-Analyzing the performance, it's obvious that kernel spends really large
-amount of time in IO mode – so the vboxsf CIFS emulation of VirtualBoxis
-behaving something like a slug. Birds love slugs but IT professionals don’t
-like that, do they?
-
-It seems that the only viable solution is sharing folders though Windows and
-mounting them via CIFS on the guest, the virtual Linux box. This way, a
-similiar flexible solution for sharing folders can be achived but at a much
-better performance.
-
-
-=== Performance tests
-
-Anyway, *shared folders* will be always slow as the are of type *NAS* - network
-attached storage. For a local network nowadays, typically at Gigabit level and
-quite low in latency, an acceptable performance cab be achived.
-
-I did some simple tests to show the performance differences. There are three
-directories I did for my tests:
-
-* /mnt/media/repo1, data on a physical (local) disk on the host
-* /mnt/media/repo2, data on a physical (local) disk in the guest
-* /mnt/media/repo3, data on a Windows share mounted via cifs in the guest
-
-I've been using simple (bash) script based on *dd* commands for testing.
-The *dd* commands used as a base are shown below. For sure not a quite
-sophisticated test scenario but it's giving a general impression what can
-achived in real world.
-
-NOTE: For multi-platform testing, on Windows the `dd` command is used as well.
-For *Docker Toolbox*, beside the GNU bash, a full set of *GNU CoreUtils* are
-available as well (accessible out of the *Docker Quickstart Terminal*). The
-used (bash) test script needs to be run out of *Docker Quickstart Terminal*.
-Download the tester script from here.
-
-The test script *docker_perf_test.sh* supports a test scenario for
-*General System Performance*. This is focussing on pure CPU|Memory power.
-On both systems (host and guest) these tests are using pure *kernel services*
-for creating input and output data. One is creating random input data as
-fast as possible, the other discards everything it gets as fast as it can.
-
-.General System Performance
-[source, sh]
-----
-dd if=/dev/urandom of=/dev/null bs=1M count=10000
-----
-
-Please see those tests for *General System Performance* for the background
-*What could be achived in therory*. These tests may helpful to compare your
-current setup for the host and the guest same way.
-
-As mentioned, all tests for *docker_perf_test.sh* are based on the `dd`
-command. For *real world* measures, standard *dd tests* are used. You'll
-find a lot of those on the Internet. All tests for *docker_perf_test.sh* are
-changed (from `/dev/zero`) to `/dev/urandom` for the input to put some
-*pressure* on the CPU while processing data for reading or writing from the
-filesystem to be checked. All the tests are *rules of thumb*, no technical
-measures.
-
-NOTE: Zum Messen der Schreibperformance liest man die zu Schreibenden
-Daten am besten aus /dev/zero und schreibt eine normale Datei im Filesystem
-(z.B. mit of=/root/testfile). Die folgenden Beispiele verwenden ein Testdatei,
-um irrtümlichen Datenverlust zu vermeiden. Die dabei erzielbare Performance
-Werte sind etwas geringer (da dadurch auch Metadaten im Filesystem geschrieben
-werden).
-
-Find the base `dd` commands for read an write performance tests below. The
-exported shared folder on Windows is *C:\Users\Public* mapped to the Unix
-(POSIX) folder scheme of */c/Users/Public* on the guest OS.
-
-.Write Performance - Windows host (local disk), Linux guest (shared disk)
-[source, sh]
-----
-dd if=/dev/urandom bs=1M count=1024 | split -b 1M - name.
-----
-.Write Performance (local disk), Linux guest
-[source, sh]
-----
-dd if=/dev/urandom of=/var/tmp/test/samplefile bs=1M count=1024
-----
-
-.Read Performance - Windows host (local disk), Linux guest (shared disk)
-[source, sh]
-----
-dd if=/c/Users/Public/test/samplefile of=/dev/null bs=1M count=1024 iflag=direct
-----
-.Read Performance (local disk), Linux guest
-[source, sh]
-----
-dd if=/var/tmp/test/samplefile of=/dev/null bs=1M count=1024 iflag=direct
-----
-
-Have a look at the table below for the measures found on a *Windows 10*
-desktop host (Intel Core Quad Q9550) using a *SATA-300* disk for the local
-physical disk and a Gigabit network interface (*Realtek PCIe GBE* familiy)
-running a *CentOS 7 Linux* (version 3.10.0-862) as a guest:
-
-.Data transfer rates for 1 GB of data
-[cols="2,2,4,3, options="header", role="table-responsive, full-width"]
-|===============================================================================
-|direction |mountpoint |source |througput [MB/s]
-
-|`read`
-|/mnt/media/repo1
-|physical (local) disk on the *host*
-|85.20
-
-|`read`
-|/mnt/media/repo2
-|physical (local) disk on the *guest*
-|147.00
-
-|`read`
-|/mnt/media/repo3
-|shared disk on the *guest*
-|30.3
-
-|`write`
-|/mnt/media/repo1
-|physical (local) disk on the *host*
-|234.00
-
-|`write`
-|/mnt/media/repo2
-|physical (local) disk on the *guest*
-|34.00
-
-|`write`
-|/mnt/media/repo3
-|shared disk on the *guest*
-|39.9
-
-|===============================================================================
-
-WARNING: Bei Verwendung von if=/dev/zero und bs=1G benötigt das Linuxsystem
-1GB freien Platz im RAM. Falls Ihr Testsystem nicht ausreichend RAM ...
-
-NOTE: Um praxisnahe Ergebnisse zu erhalten empfehlen wir die beschrieben Tests
-mehrmals (z.B. 3 bis 10x) durchzuführen. Damit können Sie Ausreißer rechtzeitig
-erkennen.
-
-
-lorem:sentences[5]
-
-== Publish a Shared Folder
-
-lorem:sentences[5]
-
-lorem:sentences[3]
-
-
-== Mount Shared Folders on Linux
-
-lorem:sentences[5]
-
-=== Installing CIFS
-
-For the Linux VM, a current Ubunt Server of version 18.06 is used. To mount
-CIFS shares, the package `cifs-utils` needs to be installed:
-
-[source, bash]
-----
-sudo apt-get -y install cifs-utils
-----
-
-Mounting filesystems in general, therefor the same to the CIFS share, are
-done as root. This ends up in the situation this folder cannot (accessed??)
-written as normal user.
-
-. Create the `cifs` group
-+
-[source, bash]
-----
-sudo groupadd cifs
-----
-
-[start=2]
-.  Add your user to the `cifs` group
-+
-[source, bash]
-----
-sudo usermod -aG cifs $USER
-----
-
-[start=3]
-.  Create the mountpoint (to be used by Docker) as root
-+
-[source, bash]
-----
-mkdir -p /c/Users/Public
-----
-
-[start=4]
-.  Change the ownership of the mountpoint
-+
-[source, bash]
-----
-chown -R root:cifs  /c/Users/Public
-----
-
-[start=5]
-.  Create a credentials file to place user|password data safe.
-+
-[source, bash]
-----
-touch ~/.smbcredentials
-----
-
-.smbcredentials
-----
-username=<your_windows_user>
-password=<windows_user_password>
-----
-
-=== Mount the share manually
-
-To enable non-authorized users to read and write the shared files, specify
-user and group ID that the mounted shares folders should use. This would
-allow particular users and group members to read|write to the share.
-
-To do so, the following options are used for a public mount:
-
-* username
-* password
-* uid
-* gid
-
-Add the Windows host IP address to the hosts file
-
-./etc/hosts
-<ip_v4_address>  <name_of_the windows_box>  <alias_name>
-
-
-=== Mount the share at boot-time
-
-lorem:sentences[3]
-
-./etc/fstab
-&#47;&#47;win10pc/Public /c/Users/Public cifs uid=1000,gid=5555,credentials=/home/jadams/.smbcredentials,iocharset=utf8,rw  0 0