j1-template 2020.0.17 → 2020.0.22

data/lib/starter_web/_includes/attributes.asciidoc

@@ -0,0 +1,194 @@
+// ~/includes/attributes.asciidoc
+// Global Ascidoc attributes file
+// -----------------------------------------------------------------------------
+
+// URLS, global references to internal|external web links (macro link:)
+// -----------------------------------------------------------------------------
+tag::urls[]
+
+:url-asciidoctor-plugin--issue_166:               https://github.com/asciidoctor/jekyll-asciidoc/issues/166
+:url__asciidoctor-plugin--issue_166:              https://github.com/asciidoctor/jekyll-asciidoc/issues/166
+
+:url-asciidoctor--extensions_lab:                 https://github.com/asciidoctor/asciidoctor-extensions-lab
+:url-asciidoctor--extensions_use:                 https://github.com/asciidoctor/asciidoctor-extensions-lab#using-an-extension
+:url-asciidoctor--extensions_manual:              http://asciidoctor.org/docs/user-manual/#extensions
+
+:url-bs--themes:                                  https://themes.getbootstrap.com/
+:url-bs--expo:                                    https://expo.getbootstrap.com/
+
+:url-bs_docs:                                     http://getbootstrap.com/docs/4.0/getting-started/introduction/
+:url-bs_docs--examples:                           http://getbootstrap.com/docs/4.0/examples/
+
+:url-bs_docs--content_code:                       https://getbootstrap.com/docs/4.0/content/code/
+:url-bs_docs--content_figures:                    https://getbootstrap.com/docs/4.0/content/figures/
+:url-bs_docs--content_images:                     https://getbootstrap.com/docs/4.0/content/images/
+:url-bs_docs--content_typography:                 https://getbootstrap.com/docs/4.0/content/typography/
+:url-bs_docs--content_tables:                     https://getbootstrap.com/docs/4.0/content/tables/
+
+:url-bs_docs--components_alerts:                  http://getbootstrap.com/docs/4.0/components/alerts/
+:url-bs_docs--components_badges:                  http://getbootstrap.com/docs/4.0/components/badge/
+:url-bs_docs--components_breadcrumb:              http://getbootstrap.com/docs/4.0/components/breadcrumb/
+:url-bs_docs--components_buttons:                 http://getbootstrap.com/docs/4.0/components/buttons/
+:url-bs_docs--components_button_group:            http://getbootstrap.com/docs/4.0/components/button-group/
+:url-bs_docs--components_cards:                   http://getbootstrap.com/docs/4.0/components/card/
+:url-bs_docs--components_carousel:                http://getbootstrap.com/docs/4.0/components/carousel/
+:url-bs_docs--components_collapse:                http://getbootstrap.com/docs/4.0/components/collapse/
+:url-bs_docs--components_dropdowns:               http://getbootstrap.com/docs/4.0/components/dropdowns/
+:url-bs_docs--components_forms:                   http://getbootstrap.com/docs/4.0/components/forms/
+:url-bs_docs--components_input_group:             http://getbootstrap.com/docs/4.0/components/input-group/
+:url-bs_docs--components_jumbotron:               http://getbootstrap.com/docs/4.0/components/jumbotron/
+:url-bs_docs--components_list_group:              http://getbootstrap.com/docs/4.0/components/list-group/
+:url-bs_docs--components_modal:                   http://getbootstrap.com/docs/4.0/components/modal/
+:url-bs_docs--components_navs:                    http://getbootstrap.com/docs/4.0/components/navs/
+:url-bs_docs--components_navbar:                  http://getbootstrap.com/docs/4.0/components/navbar/
+:url-bs_docs--components_pagination:              http://getbootstrap.com/docs/4.0/components/pagination/
+:url-bs_docs--components_popovers:                http://getbootstrap.com/docs/4.0/components/popovers/
+:url-bs_docs--components_progress:                http://getbootstrap.com/docs/4.0/components/progress/
+:url-bs_docs--components_tooltips:                http://getbootstrap.com/docs/4.0/components/tooltips/
+
+:url-bs_docs--utils_borders:                      http://getbootstrap.com/docs/4.0/utilities/borders/
+:url-bs_docs--utils_clearfix:                     http://getbootstrap.com/docs/4.0/utilities/clearfix/
+:url-bs_docs--utils_close_icon:                   http://getbootstrap.com/docs/4.0/utilities/close-icon/
+:url-bs_docs--utils_colors:                       http://getbootstrap.com/docs/4.0/utilities/colors/
+:url-bs_docs--utils_display:                      http://getbootstrap.com/docs/4.0/utilities/display/
+:url-bs_docs--utils_embeds:                       http://getbootstrap.com/docs/4.0/utilities/embed/
+:url-bs_docs--utils_flex:                         http://getbootstrap.com/docs/4.0/utilities/flex/
+:url-bs_docs--utils_float:                        http://getbootstrap.com/docs/4.0/utilities/float/
+:url-bs_docs--utils_image_replacement:            http://getbootstrap.com/docs/4.0/utilities/image-replacement/
+:url-bs_docs--utils_screenreaders:                http://getbootstrap.com/docs/4.0/utilities/screenreaders/
+:url-bs_docs--utils_sizing:                       http://getbootstrap.com/docs/4.0/utilities/sizing/
+:url-bs_docs--utils_spacing:                      http://getbootstrap.com/docs/4.0/utilities/spacing/
+:url-bs_docs--utils_text:                         http://getbootstrap.com/docs/4.0/utilities/text/
+:url-bs_docs--utils_vertical_alignment:           http://getbootstrap.com/docs/4.0/utilities/vertical-align/
+:url-bs_docs--utils_visibility:                   http://getbootstrap.com/docs/4.0/utilities/visibility/
+
+:url-bs_docs--migration_to_v4:                    http://getbootstrap.com/docs/4.0/migration/
+
+:url-bootswatch--home:                            https://bootswatch.com/
+:url-bootswatch--api:                             https://bootswatch.com/help/#api
+
+:url-iconify--home:                               https://iconify.design/
+:url-iconify--icon_sets:                          https://iconify.design/icon-sets/
+:url-iconify--medical_icons:                      https://iconify.design/icon-sets/medical-icon/
+:url-iconify--brand_icons:                        https://iconify.design/icon-sets/logos/
+
+:url-light_gallery--license:                      http://sachinchoolur.github.io/lightGallery/docs/license.html
+
+:url-mdi--home:                                   https://materialdesignicons.com/
+:url-mdi--cheatsheet:                             https://cdn.materialdesignicons.com/3.3.92/
+
+:url-jekyll--home:                                https://jekyllrb.com/
+
+:url-git--home:                                   https://git-scm.com/
+
+:url-gist--home:                                  https://gist.github.com/
+:url-gist--asciidoc_extensions_example:           https://gist.github.com/mojavelinux/5546622
+
+:url-github--signin:                              https://github.com/login
+:url-github--pages:                               https://pages.github.com/
+:url-github--about_org:                           https://help.github.com/articles/about-organizations/
+
+:url-github_dev--oauth_app:                       https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/
+
+:url-github_repo--ruby_gem_bundler:               https://github.com/bundler/bundler
+:url-github_repo--ruby_gem_jekyll_auth:           https://github.com/benbalter/jekyll-auth
+:url-github_repo--md_icons:                       https://github.com/google/material-design-icons
+:url-github_repo--mdi_icons:                      https://github.com/Templarian/MaterialDesign
+
+:url-fontawesome--home:                           https://fontawesome.com/
+:url-fontawesome--icons:                          https://fontawesome.com/icons?d=gallery
+:url-fontawesome--get_started:                    https://fontawesome.com/get-started
+
+:url-j1--home:                                    https://jekyll.one/
+:url-j1--preview:                                 https://preview.jekyll.one/
+
+:url-j1_web_in_a_day--intro:                      /pages/public/learn/kickstarter/web_in_a_day/intro/
+:url-j1_web_in_a_day--meet_and_greet:             /pages/public/learn/kickstarter/web_in_a_day/meet_and_greet/
+:url-j1_web_in_a_day--preparations:               /pages/public/learn/kickstarter/web_in_a_day/preparations/
+:url-j1_web_in_a_day--first_awesome_web:          /pages/public/learn/kickstarter/web_in_a_day/first_awesome_web/
+
+:url-j1_quick_references--jekyll:                 /pages/protected/manuals/quick_references/jekyll/
+:url-j1_downloads---quickstart_intro:             /pages/public/learn/downloads/quickstart/intro/
+
+:url-j1--learn_whats_up:                          https://jekyll.one/pages/public/learn/whats_up/
+:url-j1--learn_present_images:                    https://jekyll.one/pages/public/learn/roundtrip/present_images/
+:url-j1--learn_present_videos:                    https://jekyll.one/pages/public/learn/roundtrip/present_videos/
+:url-j1--learn_typography:                        https://jekyll.one/pages/public/learn/roundtrip/typography/
+:url-j1--learn_icon_fonts:                        https://jekyll.one/pages/public/learn/roundtrip/mdi_icon_font/
+:url-j1--learn_asciidoc_extensions:               https://jekyll.one/pages/public/learn/roundtrip/asciidoc_extensions/
+:url-j1--learn_extended_modals:                   https://jekyll.one/pages/public/learn/roundtrip/modals/
+:url-j1--learn_responsive_tables:                 https://jekyll.one/pages/public/learn/roundtrip/responsive_tables/
+:url-j1--learn_themes:                            https://jekyll.one/pages/public/learn/roundtrip/themes/
+
+:url-stackoverflow--usage_fonticons:              https://stackoverflow.com/questions/11135261/should-i-use-i-tag-for-icons-instead-of-span
+
+:url-w3org--css_spec:                             https://www.w3.org/Style/CSS/specs.en.html
+
+:url-w3schools--css_tutorial:                     https://www.w3schools.com/css/default.asp
+
+end::urls[]
+
+
+// TAGS, global asciidoc attributes (variables)
+// -----------------------------------------------------------------------------
+tag::tags[]
+
+:browser-window--new:                             window="blank"
+:clipboard--noclip:                               noclip
+:level--beginner:                                 icon:battery-quarter[role="md-blue"]
+:level--advanced:                                 icon:battery-full[role="md-blue"]
+:figure-caption--text:                            Figure
+
+:icon-checked:                                    icon:check[role="green"]
+:icon-times:                                      icon:times[role="red"]
+:icon-file:                                       icon:file-alt[role="blue"]
+:icon-battery--quarter:                           icon:battery-quarter[role="md-blue"]
+:icon-battery--full:                              icon:battery-full[role="md-blue"]
+
+:char-emdash:                                     —
+:char-middot:                                     ·
+:char-dot:                                        .
+:char-dot--double:                                ..
+:char-bullet:                                     •
+:char-bullet--big:                                ●
+:char-bullet--bigger:                             ⬤
+
+end::tags[]
+
+
+// DATA, global references to data elements (asciidoc extensions)
+// -----------------------------------------------------------------------------
+tag::data[]
+:data-lightbox--example:                          "pages/roundtrip/100_present_images/lightbox-image-1.jpg, Golden Gate Bridge"
+end::data[]
+
+
+// DOCUMENTS, global document resources (macro include::)
+// -----------------------------------------------------------------------------
+tag::documents[]
+:docs-licenses--mit:                              {globaldocumentsdir}/licenses/mit.asciidoc
+end::documents[]
+
+
+// TABLES, global table resources (macro include::)
+// -----------------------------------------------------------------------------
+tag::tables[]
+:table-template--variables:                       {globaltablesdir}/template_variables.asciidoc
+:table-jekyll--variables:                         {globaltablesdir}/jekyll_variables.asciidoc
+end::tables[]
+
+
+// PRODUCTS, global product information (e.g. release)
+// -----------------------------------------------------------------------------
+tag::products[]
+:j1-license:                                      MIT License
+:j1-version:                                      2020.0.22
+end::products[]
+
+
+// AUTHORS, global author information (special variables)
+// -----------------------------------------------------------------------------
+tag::authors[]
+:author-adams--name:                              "Jürgen Adams"
+:author-adams--url:                               https://jekyll.one
+end::authors[]

data/lib/starter_web/_includes/documents/licenses/mit.asciidoc

@@ -0,0 +1,19 @@
+Copyright (C) [year] [full name]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/lib/starter_web/_includes/tables/jekyll_variables.asciidoc

@@ -0,0 +1,45 @@
+.Jekyll variables (Liquid)
+[cols="3,3a,6a, options="header", width="100%", role="rtable mt-3"]
+|===============================================================================
+|Name |Value |Description
+
+|`page.path`
+|{{ page.path }}
+|The path to the raw post or page. Example usage: Linking back to the page
+or post's source on GitHub. This can be overridden in the `YAML Front Matter`.
+
+|`site.collections_dir`
+|{{ site.collections_dir }}
+|lorem:sentences[1]
+
+|`page.images.dir`
+|{{ page.images.dir }}
+|Image path set pagewise. See FRONTMATTER defaults in `_config.yml` for the
+images path specified by: `images.dir` for specific page *type*. See the
+example below for a page of type *pages*.
+[source, yaml]
+----
+defaults:
+  - scope:
+      path:          pages
+      type:          pages
+
+    values:
+      images:
+        dir:        /assets/images/pages
+----
+
+|`page-imagesdir`
+|{{ page-imagesdir }}
+| Images path set in the page by `:page-imagesdir:`.
+
+|`template`
+|{{ site.template.name }}
+|Name of the template used for rendering a page. Settings are taken from
+sitewide configuration defined by `_config.yml`.
+
+|`includedir`
+|{{ includedir }}
+|lorem:sentences[1]
+
+|===============================================================================

data/lib/starter_web/_includes/tables/template_variables.asciidoc

@@ -0,0 +1,46 @@
+.Template variables (Asciidoc)
+[cols="cols="3,3a,6a, options="header", width="100%", role="rtable mt-3"]
+|===============================================================================
+|Name |Value |Description
+
+|`content_root`
+|{content_root}
+|Path to the document source folder *relative* to the current content *source
+type* (`post` or `page`)
+
+|`page_root`
+|{page_root}
+|Path to the document folder seen *absolute* from the current content *source
+type* (`post` or `page`)
+
+|`globalincludedir`
+|{globalincludedir}
+|Path to the *global* includes folder *relative* to the current content *source
+type* (`post` or `page`)
+
+|`globaltablesdir`
+|{globaltablesdir}
+|Path to the *global* includes folder for *tables* *relative* to the current
+content *source type* (`post` or `page`)
+
+|`globaldocumentsdir`
+|{globaldocumentsdir}
+|Path to the *global* includes folder for *documents* *relative* to the current
+content *source type* (`post` or `page`)
+
+|`includedir`
+|{includedir}
+|Path to the *local* includes folder seen *absolute* from the current
+content *source type* (`post` or `page`)
+
+|`documentdir`
+|{documentdir}
+|Path to the *local* include folder for *documents* seen *absolute*
+from the current content *source type* (`post` or `page`)
+
+|`tabledir`
+|{tabledir}
+|Path to the *local* include folder for *tables* seen *absolute*
+from the current content *source type* (`post` or `page`)
+
+|===============================================================================

data/lib/starter_web/assets/images/modules/icons/j1/scalable/j1.svg

@@ -16,7 +16,7 @@
    version="1.1"
    inkscape:version="0.91 r13725"
    sodipodi:docname="j1.svg"
-   inkscape:export-filename="X:\j1\github\j1_template\packages\300_template_src\assets\images\modules\icons\j1\j1-512x512.png"
+   inkscape:export-filename="X:\j1\github\j1-template\packages\300_template_src\assets\images\modules\icons\j1\j1-512x512.png"
    inkscape:export-xdpi="90"
    inkscape:export-ydpi="90">
   <title
@@ -1313,9 +1313,9 @@
      borderopacity="1.0"
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
-     inkscape:zoom="1.3373274"
-     inkscape:cx="341.84077"
-     inkscape:cy="181.05754"
+     inkscape:zoom="1.71"
+     inkscape:cx="250"
+     inkscape:cy="250"
      inkscape:document-units="px"
      inkscape:current-layer="layer1"
      showgrid="true"
@@ -1361,10 +1361,6 @@
        position="666.2542,249.0041"
        orientation="0,1"
        id="guide4541" />
-    <sodipodi:guide
-       position="-25.802752,175.45872"
-       orientation="0,1"
-       id="guide4547" />
   </sodipodi:namedview>
   <metadata
      id="metadata7">
@@ -1417,33 +1413,33 @@
      id="layer1"
      transform="translate(0,-552.36218)"
      style="display:inline">
-    <rect
-       style="fill:none;fill-opacity:1"
-       id="rect3745"
-       width="93.470009"
-       height="91.974487"
-       x="-267.69809"
-       y="556.59729" />
-    <rect
-       style="fill:#ffffff;fill-opacity:1"
-       id="rect3747"
-       width="102.44314"
-       height="109.92074"
-       x="-222.08473"
-       y="631.37329" />
-    <text
-       xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:203.11209106px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#87aade;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;"
-       x="57.554077"
-       y="1092.8141"
-       id="text4682"
-       sodipodi:linespacing="125%"
-       transform="scale(1.2190564,0.82030662)"><tspan
-         sodipodi:role="line"
-         id="tspan4684"
-         x="57.554077"
-         y="1092.8141"
-         style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:564.20019531px;font-family:'Brush Script MT';-inkscape-font-specification:'Brush Script MT Italic';fill:#87aade;">j1</tspan></text>
+    <g
+       id="g4482">
+      <text
+         transform="scale(-1.1438394,0.87424863)"
+         sodipodi:linespacing="125%"
+         id="text4513"
+         y="1111.0399"
+         x="-420.70685"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:541.57806396px;line-height:125%;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;fill:#757575;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+         xml:space="preserve"><tspan
+           y="1111.0399"
+           x="-420.70685"
+           id="tspan4515"
+           sodipodi:role="line">1</tspan></text>
+      <text
+         transform="scale(1.1450956,-0.87328952)"
+         sodipodi:linespacing="125%"
+         id="text4513-3"
+         y="-723.17688"
+         x="15.25074"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:545.76879883px;line-height:125%;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;display:inline;fill:#0d47a1;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;"
+         xml:space="preserve"><tspan
+           y="-723.17688"
+           x="15.25074"
+           id="tspan4515-9"
+           sodipodi:role="line">1</tspan></text>
+    </g>
   </g>
   <g
      style="display:none"

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

@@ -6,7 +6,7 @@ description:                            Auto-generated welcome post
 date:                                   <%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %>
 series:
 adsense:                                false
-image:                                  /assets/images/modules/attics/welcome-1920x1280-bw.jpg
+image:                                  /assets/images/modules/attics/katie-moum-1920x1280.jpg
 
 tags:                                   [ Example, Post ]
 index:                                  []
@@ -19,47 +19,48 @@ resource_options:
   - attic:
       opacity:                          0.5
       slides:
-        - url:                          /assets/images/modules/attics/welcome-1920x1280-bw.jpg
-          alt:                          Photo by Belinda Fewings on Unsplash
+        - url:                          /assets/images/modules/attics/katie-moum-1920x1280.jpg
+          alt:                          Photo by Katie Moum on Unsplash
           alignY:                       0.3
 #         caption:
-#           text:                       Photo by Belinda Fewings on Unsplash
-#           href:                       https://unsplash.com/@bel2000a
+#           text:                       Photo by Katie Moum on Unsplash
+#           href:                       https://unsplash.com/@katiemoum
           badge:
             type:                       unsplash
-            author:                     Belinda Fewings
-            href:                       https://unsplash.com/@bel2000a
+            author:                     Katie Moum
+            href:                       https://unsplash.com/@katiemoum
 ---
 
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
 
-// NOTE:  General Asciidoc page attributes settings
+// Place an excerpt at the most top position
 // -----------------------------------------------------------------------------
-:page-liquid:
+All you're doing at the end of the day is writing your content and Jekyll does
+all the tricky things needed for a website: putting out HTML, Javascript and
+CSS. As a result, the site creation process gets out of your way. It's done
+by Jekyll, and allows you to concentrate on what truly matters: your content.
+
+[role="clearfix mb-3"]
+excerpt__end
 
-// Additional Asciidoc page attributes goes here
+//  Load Liquid procedures
 // -----------------------------------------------------------------------------
-// :page-imagesdir: {{page.images.dir}}
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
 
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="all" %}
 
-// NOTE: Place an excerpt at the most top position
+// Set page (local) attributes here
 // -----------------------------------------------------------------------------
-If you’re not familiar with Jekyll (or other site generators), Jekyll is a
-so-called static site generator. Think of it like a CMS but without all the
-complexity and headache. No need to build a giant content strangling Rube
-Goldberg machine to manage content.
-
-All you’re doing at the end of the day is writing your content and Jekyll does
-all the tricky things needed for a web site: putting out HTML, Javascript
-and CSS. As a result, the site creation process gets out of your way, it's done
-by Jekyll, and allows you to concentrate on what truly matters: your content.
-[role="clearfix mb-3"]
-excerpt__end
-[role="clearfix mb-3"]
-excerpt__end
+// :page--attr:                         <attr-value>
 
 
 // Page content
-// -----------------------------------------------------------------------------
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[readmore]]
 == What is a static site?
 
@@ -67,93 +68,90 @@ excerpt__end
 // image::{{page.image}}[{{page.title}}]
 // image::/assets/images/modules/attics/spider-web-1920x1200-bw.png[{{page.title}}, 800]
 
-All you’re doing at the end of the day is writing your content and Jekyll does
-all the tricky things needed for a web site: putting out HTML, Javascript
-and CSS. As a result, the site creation process gets out of your way, it's done
-by Jekyll, and allows you to concentrate on what truly matters: your content.
-
-A static site serve the content straight to the user as it is stored on
-the server side. To put it in another way, in opposition to WordPress
+A static site serves the content straight to the user as it is stored on
+the server-side. To put it in another way, in opposition to WordPress
 which use a database to load dynamic content, a static site will display
 the same content to every user as it will directly load the HTML files
-on the server.
-
-=== What is different?
 
-What are the differences between a static site and a dynamic website?
+=== What's different?
 
 To make it simple, a dynamic website uses a database and PHP/MySQL to
-generate the content of a page when a user will request it. For example,
+generate the content of a page when a user requests it. For example,
 building a website using WordPress CMS will result in having a dynamic
-website.
+Website.
 
 === Why use a static site?
 
-Wat are the advantages of a static website over a dynamic site?
-You may be wondering “Why should I build a static site when I could do a
-WordPress?”. Well, having a database implies a lot of downsides. Here
-comes the tree main advantages of using a static site over a dynamic
+What are the advantages of a static website over a dynamic site?
+You may be wondering *Why should I build a static site when I could do a
+WordPress?*. Well, having a database implies a lot of downsides. Here
+come the main advantages of using a static site over a dynamic
 one.
 
-Static: the better performance and a crazy fast load time!
+Performance::
+The better performance and a crazy fast load time.
 
-One the of the main advantages of using a static site is the fact that
-it is crazy fast to load. Indeed, when the user request a page, there is
-no need to request a database and various files in order to generate the
+One of the main advantages of using a static site is the fact that
+it is crazy fast to load. Indeed, when the user requests a page, there is
+no need to request a database and various files to generate the
 page itself as all the content is already placed in a one and only file:
-an HTML one. That’s why, by using a static site you will get a boost in
+an HTML one. That’s why by using a static site, you will get a boost in
 your loading time that will provide great user experience for the
 internauts. Moreover, we know that more and more people are surfing the
 web using their smartphones with, sometimes, poor internet connections,
 that’s why having fast loading times will participate in making your
-website mobile friendly.
+website mobile-friendly.
 
-== Security aspects
-
-Having a static website: say goodbye to hacking and security issues!
+Security::
+Having a static website: say goodbye to hacking and security issues.
 
 Tired of getting WordPress notifications about security issues and
 updates every week? No worries, as a static site has no database, there
 are close to no hack possible compared to a WordPress website. Indeed,
-your site will have way less footprints and security issues since it
+your site will have way fewer footprints and security issues since it
 will only load plain HTML and CSS files. The security gain in having a
 static website is one the main reason why many famous brands switch to
-static site instead of having their website on Drupal or WordPress.
-
-== Building and Hosting
+a static site instead of having their website on Drupal or WordPress.
 
-Building a static site and hosting: you will save you money!
+Hosting::
+Building a static site and hosting: you will save you money.
 
 Using a static site, you will only have most of the time only HTML and
-CSS files to host. This kind of files are super light which also means
+CSS files to host. This kind of files is super light which also means
 that you will not need a powerhouse hosting to have a static site up and
-running. Moreover, if your traffic suddenly increase, your site will not
+running. Moreover, if your traffic suddenly increases, your site will not
 go down contrary to a dynamic site which should request the database
 each time for each user.
 
+Control::
+You're the master.
+
+Using a CMS means, giving control over your site to others. Simple like this.
+
 == Why use a site generator?
 
-Working with HTML files can sometimes be quite annoying. Indeed, if you
-need to make a modification you must manually change every file. If you
-have a website with 10 pages, it can be ok but imagine if you have a
-corporate site with 100+ pages or a blog with thousands of pages?! Using
-a static site generator will solve this issue as it separates the
+Working with pure HTML files is annoying; senseless today. Indeed, if you need
+to make a modification on your *self-managed* pages, you have to manually
+change every file. That's monkey's work from the early days of static websites.
+If your site comes with 10 pages, it can be manageable but imagine if your site
+is providing 100+ pages or the blog planned for hundreds of articles?
+
+Using a static site generator will solve this issue as it separates the
 content and the template. To say it another way, by using a static site
-generator you will only need to make the modification once and the
+generator, you will only need to make the modification once, and the
 generator will apply it to all your pages.
 
 === Why Jekyll?
 
 As the popularity of static sites is growing, there are plenty of static
-site generators available on the market. The more famous are Jekyll,
+site generators available on the market. The more famous is Jekyll,
 Middleman and Hugo. Each one has its own specificities and may suits you
-better depending on the programming languages you already are familiar
-with.
+better depending on the programming languages you already are familiar with.
 
 Which static site generator should I use?
 
-When I wanted to switch from WordPress to Static I personally
-choose Jekyll as for me it is the best static site generator so far.
-This blog is powered under Jekyll.
+When I decided to go for a blog based on a static web, I personally
+choose Jekyll as for me. It's a well known static site generator, good support
+in case of trouble and the software gets regularly  updated.
 
-Happy Jekylling!
+This blog is powered by Jekyll. For good reasons.