Release 4.8.0 💎

* Integrate search into masthead
* Fix cutoff descenders in archive article titles
* Remove search page from `/test` site
* Enable masthead search
* Remove dedicated search page
* Fix masthead search form padding
* Improve insertion of search content
* Speed up page transition
* Add fade transition to search content
* Rename visibility class names
* Add `site.search` to _config.yml
* Document site search feature
* Update CHANGELOG and history

LICENSE.txt

@@ -21,7 +21,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 Minimal Mistakes incorporates icons from [The Noun Project](https://thenounproject.com/)
-creators Garrett Knoll, Arthur Shlain, and tracy tam.
+creators Garrett Knoll, Arthur Shlain, and Tracy Tam.
 Icons are distributed under Creative Commons Attribution 3.0 United States (CC BY 3.0 US).
 
 Minimal Mistakes incorporates [Font Awesome](http://fontawesome.io/),

_config.yml

@@ -51,13 +51,13 @@ reCaptcha:
   secret                 :
 atom_feed:
   path                   : # blank (default) uses feed.xml
+search                   : # true, false (default)
 
 # SEO Related
 google_site_verification :
 bing_site_verification   :
-alexa_site_verification  :
 yandex_site_verification :
-naver-site-verification  :
+naver_site_verification  :
 
 # Social Sharing
 twitter:

_data/ui-text.yml

@@ -314,7 +314,7 @@ it-IT:
 
 # Chinese  (zh-CN Chinese - China)
 # -----------------
-zh: &DEFAULT_ZH
+zh: &DEFAULT_ZH_HANS
   page                       : "页面"
   pagination_previous        : "向前"
   pagination_next            : "向后"
@@ -353,13 +353,11 @@ zh: &DEFAULT_ZH
   comment_error_msg          : "很抱歉，您的提交存在错误。请确保所有必填字段都已填写正确，然后再试一次。"
   loading_label              : "正在加载..."
 zh-CN:
-  <<: *DEFAULT_ZH
+  <<: *DEFAULT_ZH_HANS
-zh-HK:
-  <<: *DEFAULT_ZH
 zh-SG:
-  <<: *DEFAULT_ZH
+  <<: *DEFAULT_ZH_HANS
 # Taiwan (Traditional Chinese)
-zh-TW:
+zh-TW: &DEFAULT_ZH_HANT
   page                       : "頁面"
   pagination_previous        : "較舊"
   pagination_next            : "較新"
@@ -397,7 +395,8 @@ zh-TW:
   comment_success_msg        : "感謝您的留言！ 審核後將會顯示在站上。"
   comment_error_msg          : "抱歉，部份資料輸入有問題。請確認資料填寫正確後再試一次。"
   loading_label              : "載入中..."
-
+zh-HK:
+  <<: *DEFAULT_ZH_HANT
 # German / Deutsch
 # -----------------
 de: &DEFAULT_DE

_includes/analytics.html

@@ -1,4 +1,4 @@
-{% if site.analytics.provider and page.analytics != false %}
+{% if jekyll.environment == 'production' and site.analytics.provider and page.analytics != false %}
 
 {% case site.analytics.provider %}
 {% when "google" %}

_includes/masthead.html

@@ -10,10 +10,19 @@
             {% else %}
               {% assign domain = site.url | append: site.baseurl %}
             {% endif %}
-            <li class="masthead__menu-item"><a href="{{ domain }}{{ link.url }}">{{ link.title }}</a></li>
+            <li class="masthead__menu-item">
+              <a href="{{ domain }}{{ link.url }}" {% if link.description %}title="{{ link.description }}"{% endif %}>{{ link.title }}</a>
+            </li>
           {% endfor %}
         </ul>
-        <button type="button">
+        {% if site.search == true %}
+        <button class="search__toggle" type="button">
+          <svg class="icon" width="16" height="16" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 15.99 16">
+            <path d="M15.5,13.12L13.19,10.8a1.69,1.69,0,0,0-1.28-.55l-0.06-.06A6.5,6.5,0,0,0,5.77,0,6.5,6.5,0,0,0,2.46,11.59a6.47,6.47,0,0,0,7.74.26l0.05,0.05a1.65,1.65,0,0,0,.5,1.24l2.38,2.38A1.68,1.68,0,0,0,15.5,13.12ZM6.4,2A4.41,4.41,0,1,1,2,6.4,4.43,4.43,0,0,1,6.4,2Z" transform="translate(-.01)"></path>
+          </svg>
+        </button>
+        {% endif %}
+        <button class="greedy-nav__toggle" type="button">
           <span class="visually-hidden">{{ site.data.ui-text[site.locale].menu_label | default: "Toggle Menu" }}</span>
           <div class="navicon"></div>
         </button>

_includes/scripts.html

@@ -11,7 +11,7 @@
   <script src="{{ '/assets/js/main.min.js' | absolute_url }}"></script>
 {% endif %}
 
-{% if page.layout == 'search' %}
+{% if site.search == true or page.layout == 'search' %}
   <script src="{{ '/assets/js/lunr.min.js' | absolute_url }}"></script>
   <script src="{{ '/assets/js/lunr-en.js' | absolute_url }}"></script>
 {% endif %}

_includes/search_form.html

@@ -0,0 +1,4 @@
+<div class="search-content__inner-wrap">
+  <input type="text" id="search" class="search-input" tabindex="-1" placeholder="{{ site.data.ui-text[site.locale].search_placeholder_text | default: 'Enter your search term...' }}" />
+  <div id="results" class="results"></div>
+</div>

_includes/social-share.html

@@ -3,11 +3,11 @@
     <h4 class="page__share-title">{{ site.data.ui-text[site.locale].share_on_label | default: "Share on" }}</h4>
   {% endif %}
 
-  <a href="https://twitter.com/intent/tweet?{% if site.twitter.username %}via={{ site.twitter.username | url_encode }}&{% endif %}text={{ page.title | url_encode }}%20{{ page.url | absolute_url | url_encode }}" class="btn btn--twitter" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Twitter"><i class="fa fa-fw fa-twitter" aria-hidden="true"></i><span> Twitter</span></a>
+  <a href="https://twitter.com/intent/tweet?{% if site.twitter.username %}via={{ site.twitter.username | url_encode }}&{% endif %}text={{ page.title | url_encode }}%20{{ page.url | absolute_url | url_encode }}" class="btn btn--twitter" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Twitter"><i class="fa fa-fw fa-twitter" aria-hidden="true"></i><span> Twitter</span></a>
 
-  <a href="https://www.facebook.com/sharer/sharer.php?u={{ page.url | absolute_url | url_encode }}" class="btn btn--facebook" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Facebook"><i class="fa fa-fw fa-facebook" aria-hidden="true"></i><span> Facebook</span></a>
+  <a href="https://www.facebook.com/sharer/sharer.php?u={{ page.url | absolute_url | url_encode }}" class="btn btn--facebook" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Facebook"><i class="fa fa-fw fa-facebook" aria-hidden="true"></i><span> Facebook</span></a>
 
-  <a href="https://plus.google.com/share?url={{ page.url | absolute_url | url_encode }}" class="btn btn--google-plus" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Google Plus"><i class="fa fa-fw fa-google-plus" aria-hidden="true"></i><span> Google+</span></a>
+  <a href="https://plus.google.com/share?url={{ page.url | absolute_url | url_encode }}" class="btn btn--google-plus" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Google Plus"><i class="fa fa-fw fa-google-plus" aria-hidden="true"></i><span> Google+</span></a>
 
-  <a href="https://www.linkedin.com/shareArticle?mini=true&url={{ page.url | absolute_url | url_encode }}" class="btn btn--linkedin" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} LinkedIn"><i class="fa fa-fw fa-linkedin" aria-hidden="true"></i><span> LinkedIn</span></a>
+  <a href="https://www.linkedin.com/shareArticle?mini=true&url={{ page.url | absolute_url | url_encode }}" class="btn btn--linkedin" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} LinkedIn"><i class="fa fa-fw fa-linkedin" aria-hidden="true"></i><span> LinkedIn</span></a>
 </section>

_layouts/default.html

@@ -3,7 +3,7 @@
 
 <!doctype html>
 <!--
-  Minimal Mistakes Jekyll Theme 4.7.1 by Michael Rose
+  Minimal Mistakes Jekyll Theme 4.8.0 by Michael Rose
   Copyright 2017 Michael Rose - mademistakes.com | @mmistakes
   Free for personal and commercial use under the MIT license
   https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE.txt
@@ -19,7 +19,15 @@
     {% include browser-upgrade.html %}
     {% include masthead.html %}
 
+    <div class="initial-content">
       {{ content }}
+    </div>
+
+    {% if site.search == true %}
+      <div class="search-content">
+        {% include search_form.html %}
+      </div>
+    {% endif %}
 
     <div class="page__footer">
       <footer>

_layouts/search.html

@@ -23,7 +23,7 @@ layout: default
     {{ content }}
 
     <form>
-      <input placeholder="{{ site.data.ui-text[site.locale].search_placeholder_text | default: "Enter your search term..." }}" type="search" id="search" class="search-input">
+      <input type="input" id="search" class="search-input" placeholder="{{ site.data.ui-text[site.locale].search_placeholder_text | default: 'Enter your search term...' }}" />
     </form>
 
     <div id="results"></div>

_layouts/single.html

@@ -63,7 +63,7 @@ layout: default
       {% include post_pagination.html %}
     </div>
 
-    {% if site.comments.provider and page.comments %}
+    {% if jekyll.environment == 'production' and site.comments.provider and page.comments %}
       {% include comments.html %}
     {% endif %}
   </article>

_sass/minimal-mistakes.scss

@@ -1,5 +1,5 @@
 /*!
- * Minimal Mistakes Jekyll Theme 4.7.1 by Michael Rose
+ * Minimal Mistakes Jekyll Theme 4.8.0 by Michael Rose
  * Copyright 2017 Michael Rose - mademistakes.com | @mmistakes
  * Licensed under MIT (https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE.txt)
 */

_sass/minimal-mistakes/_archive.scss

@@ -37,6 +37,7 @@
 .archive__item-title {
   margin-bottom: 0.25em;
   font-family: $sans-serif-narrow;
+  line-height: initial;
   overflow: hidden;
   text-overflow: ellipsis;
 
@@ -47,7 +48,6 @@
 
 /* remove border*/
 .page__content {
-
   .archive__item-title {
     margin-top: 1em;
     border-bottom: none;
@@ -72,7 +72,6 @@
 }
 
 .archive__item:hover {
-
   .archive__item-teaser {
     box-shadow: 0 0 10px rgba(#000, 0.25);
   }
@@ -82,25 +81,21 @@
   }
 }
 
-
 /*
    List view
    ========================================================================== */
 
 .list__item {
-
   .page__meta {
     margin: 0 0 4px;
   }
 }
 
-
 /*
    Grid view
    ========================================================================== */
 
 .archive {
-
   .grid__wrapper {
     /* extend grid elements to the right */
 
@@ -121,12 +116,12 @@
     float: left;
     width: span(5 of 10);
 
-    &:nth-child(2n+1) {
+    &:nth-child(2n + 1) {
       clear: both;
       margin-left: 0;
     }
 
-    &:nth-child(2n+2) {
+    &:nth-child(2n + 2) {
       clear: none;
       margin-left: gutter(of 10);
     }
@@ -137,25 +132,25 @@
     margin-right: 0; /* override margin*/
     width: span(3 of 12);
 
-    &:nth-child(2n+1) {
+    &:nth-child(2n + 1) {
       clear: none;
     }
 
-    &:nth-child(4n+1) {
+    &:nth-child(4n + 1) {
       clear: both;
     }
 
-    &:nth-child(4n+2) {
+    &:nth-child(4n + 2) {
       clear: none;
       margin-left: gutter(1 of 12);
     }
 
-    &:nth-child(4n+3) {
+    &:nth-child(4n + 3) {
       clear: none;
       margin-left: gutter(1 of 12);
     }
 
-    &:nth-child(4n+4) {
+    &:nth-child(4n + 4) {
       clear: none;
       margin-left: gutter(1 of 12);
     }
@@ -180,7 +175,6 @@
   }
 
   .archive__item-teaser {
-
     @include breakpoint($small) {
       max-height: 200px;
     }
@@ -191,7 +185,6 @@
   }
 }
 
-
 /*
    Features
    ========================================================================== */
@@ -211,17 +204,17 @@
     margin-bottom: 0;
     width: span(4 of 12);
 
-    &:nth-child(3n+1) {
+    &:nth-child(3n + 1) {
       clear: both;
       margin-left: 0;
     }
 
-    &:nth-child(3n+2) {
+    &:nth-child(3n + 2) {
       clear: none;
       margin-left: gutter(of 12);
     }
 
-    &:nth-child(3n+3) {
+    &:nth-child(3n + 3) {
       clear: none;
       margin-left: gutter(of 12);
     }
@@ -245,7 +238,6 @@
     }
 
     @include breakpoint($small) {
-
       .archive__item-teaser {
         float: left;
         width: span(5 of 12);

_sass/minimal-mistakes/_base.scss

@@ -21,7 +21,12 @@ body {
   }
 }
 
-h1, h2, h3, h4, h5, h6 {
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
   margin: 2em 0 0.5em;
   line-height: 1.2;
   font-family: $header-font-family;
@@ -53,7 +58,8 @@ h6 {
   font-size: $type-size-6;
 }
 
-small, .small {
+small,
+.small {
   font-size: $type-size-6;
 }
 
@@ -76,7 +82,15 @@ del a {
 
 /* reduce orphans and widows when printing */
 
-p, pre, blockquote, ul, ol, dl, figure, table, fieldset {
+p,
+pre,
+blockquote,
+ul,
+ol,
+dl,
+figure,
+table,
+fieldset {
   orphans: 3;
   widows: 3;
 }
@@ -127,9 +141,19 @@ a {
   }
 }
 
+/* buttons */
+
+button:focus {
+  @extend %tab-focus;
+}
+
 /* code */
 
-tt, code, kbd, samp, pre {
+tt,
+code,
+kbd,
+samp,
+pre {
   font-family: $monospace;
 }
 
@@ -150,7 +174,8 @@ td > code {
   border-radius: $border-radius;
   box-shadow: $box-shadow;
 
-  &:before, &:after {
+  &:before,
+  &:after {
     letter-spacing: -0.2em;
     content: "\00a0"; /* non-breaking space*/
   }
@@ -255,14 +280,12 @@ figcaption {
   }
 }
 
-
 /* Fix IE9 SVG bug */
 
 svg:not(:root) {
   overflow: hidden;
 }
 
-
 /*
    Navigation lists
    ========================================================================== */
@@ -310,7 +333,28 @@ nav {
    Global animation transition
    ========================================================================== */
 
-b, i, strong, em, blockquote, p, q, span, figure, img, h1, h2, header, input, a, tr, td, form button, input[type="submit"], .btn, .highlight, .archive__item-teaser {
+b,
+i,
+strong,
+em,
+blockquote,
+p,
+q,
+span,
+figure,
+img,
+h1,
+h2,
+header,
+input,
+a,
+tr,
+td,
+form button,
+input[type="submit"],
+.btn,
+.highlight,
+.archive__item-teaser {
   -webkit-transition: $global-transition;
   transition: $global-transition;
 }

_sass/minimal-mistakes/_navigation.scss

@@ -6,7 +6,7 @@
    Breadcrumb navigation links
    ========================================================================== */
 
-   .breadcrumbs {
+.breadcrumbs {
   @include clearfix;
   margin: 0 auto;
   max-width: 100%;
@@ -15,8 +15,8 @@
   font-family: $sans-serif;
   -webkit-animation: $intro-transition;
   animation: $intro-transition;
-    -webkit-animation-delay: 0.30s;
+  -webkit-animation-delay: 0.3s;
-            animation-delay: 0.30s;
+  animation-delay: 0.3s;
 
   @include breakpoint($large) {
     padding-left: 1em;
@@ -49,14 +49,13 @@
   .current {
     font-weight: bold;
   }
-  }
+}
 
-
+/*
-  /*
      Post pagination navigation links
      ========================================================================== */
 
-  .pagination {
+.pagination {
   @include clearfix();
   float: left;
   margin-top: 1em;
@@ -159,23 +158,22 @@
       cursor: not-allowed;
     }
   }
-  }
+}
 
-  .page__content + .pagination,
+.page__content + .pagination,
-  .page__meta + .pagination,
+.page__meta + .pagination,
-  .page__share + .pagination,
+.page__share + .pagination,
-  .page__comments + .pagination {
+.page__comments + .pagination {
   margin-top: 2em;
   padding-top: 2em;
   border-top: 1px solid $border-color;
-  }
+}
 
-
+/*
-  /*
      Priority plus navigation
      ========================================================================== */
 
-  .greedy-nav {
+.greedy-nav {
   position: relative;
   display: -webkit-box;
   display: flex;
@@ -199,7 +197,7 @@
     }
   }
 
-    button {
+  &__toggle {
     padding: 0 0.5rem;
     align-self: stretch;
     border: 0;
@@ -216,18 +214,11 @@
     justify-content: flex-end;
     -webkit-box-flex: 1;
     flex: 1;
-      padding-right: 2rem;
     overflow: hidden;
 
     li {
       -webkit-box-flex: 0;
       flex: none;
-
-        &:last-child {
-          a {
-            margin-right: 0;
-          }
-        }
     }
 
     a {
@@ -243,8 +234,8 @@
         width: 100%;
         -webkit-transition: $global-transition;
         transition: $global-transition;
-          -webkit-transform: scaleX(0) translate3d(0, 0 , 0);
+        -webkit-transform: scaleX(0) translate3d(0, 0, 0);
-                  transform: scaleX(0) translate3d(0, 0 , 0); /* hide*/
+        transform: scaleX(0) translate3d(0, 0, 0); /* hide*/
       }
 
       &:hover:before {
@@ -316,14 +307,13 @@
       }
     }
   }
-  }
+}
 
-
+/*
-  /*
      Navigation list
      ========================================================================== */
 
-  .nav__list {
+.nav__list {
   margin-bottom: 1.5em;
 
   input[type="checkbox"],
@@ -332,7 +322,6 @@
   }
 
   @include breakpoint(max-width ($large - 1px)) {
-
     label {
       position: relative;
       display: inline-block;
@@ -349,7 +338,7 @@
 
       &:before,
       &:after {
-          content: '';
+        content: "";
         position: absolute;
         right: 1em;
         top: 1.25em;
@@ -421,9 +410,9 @@
       }
     }
   }
-  }
+}
 
-  .nav__list .nav__items {
+.nav__list .nav__items {
   margin: 0;
   font-size: 1.25rem;
 
@@ -450,9 +439,9 @@
     -ms-transform: translate(0, 10%);
     transform: translate(0, 10%);
   }
-  }
+}
 
-  @include breakpoint(max-width ($large - 1px)) {
+@include breakpoint(max-width ($large - 1px)) {
   .nav__list input:checked ~ .nav__items {
     -webkit-transition: 0.5s ease-in-out;
     transition: 0.5s ease-in-out;
@@ -464,17 +453,17 @@
     -ms-transform: translate(0, 0);
     transform: translate(0, 0);
   }
-  }
+}
 
-  .nav__title {
+.nav__title {
   margin: 0;
   padding: 0.5rem 1rem;
   font-family: $sans-serif-narrow;
   font-size: $type-size-5;
   font-weight: bold;
-  }
+}
 
-  .nav__sub-title {
+.nav__sub-title {
   display: block;
   margin: 0.5rem 0;
   padding: 0.5rem 0;
@@ -483,14 +472,13 @@
   font-weight: bold;
   text-transform: uppercase;
   border-bottom: 1px solid $border-color;
-  }
+}
 
-
+/*
-  /*
      Table of contents navigation
      ========================================================================== */
 
-  .toc {
+.toc {
   font-family: $sans-serif-narrow;
   color: $gray;
   text-transform: uppercase;
@@ -507,9 +495,9 @@
     border-top-left-radius: $border-radius;
     border-top-right-radius: $border-radius;
   }
-  }
+}
 
-  .toc__menu {
+.toc__menu {
   margin: 0;
   padding: 0;
   width: 100%;
@@ -549,4 +537,4 @@
       display: block;
     }
   }
-  }
+}

_sass/minimal-mistakes/_page.scss

@@ -12,8 +12,8 @@
   -webkit-animation: $intro-transition;
   animation: $intro-transition;
   max-width: 100%;
-  -webkit-animation-delay: 0.35s;
+  -webkit-animation-delay: 0.15s;
-          animation-delay: 0.35s;
+  animation-delay: 0.15s;
 
   @include breakpoint($x-large) {
     max-width: $x-large;
@@ -21,7 +21,6 @@
 }
 
 .page {
-
   @include breakpoint($large) {
     float: right;
     width: calc(100% - #{$right-sidebar-width-narrow});
@@ -68,13 +67,14 @@
 }
 
 .page__content {
-
   h2 {
     padding-bottom: 0.5em;
     border-bottom: 1px solid $border-color;
   }
 
-  p, li, dl {
+  p,
+  li,
+  dl {
     font-size: 1em;
   }
 
@@ -92,7 +92,6 @@
   }
 
   a:not(.btn) {
-
     &:hover {
       text-decoration: underline;
 
@@ -242,7 +241,6 @@
   text-transform: uppercase;
 }
 
-
 /*
    Page meta
    ========================================================================== */
@@ -268,7 +266,6 @@
   text-transform: uppercase;
 }
 
-
 /*
    Page taxonomy
    ========================================================================== */
@@ -298,7 +295,6 @@
   }
 }
 
-
 /*
    Comments
    ========================================================================== */
@@ -397,7 +393,6 @@
   }
 }
 
-
 /*
    Related
    ========================================================================== */

_sass/minimal-mistakes/_search.scss

@@ -7,3 +7,101 @@
     margin-bottom: 0.25em;
   }
 }
+
+.search__toggle {
+  margin-left: 1rem;
+  margin-right: 1rem;
+  border: 0;
+  outline: none;
+  color: $muted-text-color;
+  background-color: transparent;
+  cursor: pointer;
+  -webkit-transition: 0.2s;
+  transition: 0.2s;
+
+  &:hover {
+    color: $text-color;
+  }
+}
+
+.search-icon {
+  width: 100%;
+  height: 100%;
+}
+
+.search-content {
+  display: none;
+  visibility: hidden;
+  padding-top: 1em;
+  padding-bottom: 1em;
+
+  &__inner-wrap {
+    width: 100%;
+    margin-left: auto;
+    margin-right: auto;
+    padding-left: 1em;
+    padding-right: 1em;
+    -webkit-animation: $intro-transition;
+    animation: $intro-transition;
+    -webkit-animation-delay: 0.15s;
+    animation-delay: 0.15s;
+
+    @include breakpoint($x-large) {
+      max-width: $x-large;
+    }
+  }
+
+  .search-input {
+    display: block;
+    margin-bottom: 0;
+    padding: 0;
+    border: none;
+    outline: none;
+    box-shadow: none;
+    background-color: transparent;
+    font-size: $type-size-3;
+
+    @include breakpoint($large) {
+      font-size: $type-size-2;
+    }
+
+    @include breakpoint($x-large) {
+      font-size: $type-size-1;
+    }
+  }
+
+  &.is--visible {
+    display: block;
+    visibility: visible;
+
+    &::after {
+      content: "";
+      display: block;
+    }
+  }
+
+  .results__found {
+    margin-top: 0.5em;
+    font-size: $type-size-6;
+  }
+
+  .archive__item {
+    margin-bottom: 2em;
+
+    @include breakpoint($large) {
+      width: 75%;
+    }
+
+    @include breakpoint($x-large) {
+      width: 50%;
+    }
+  }
+
+  .archive__item-title {
+    margin-top: 0;
+  }
+
+  .archive__item-excerpt {
+    margin-bottom: 0;
+  }
+}

_sass/minimal-mistakes/_utilities.scss

@@ -8,7 +8,8 @@
 
 /* http://www.456bereastreet.com/archive/200711/screen_readers_sometimes_ignore_displaynone/ */
 
-.hidden {
+.hidden,
+.is--hidden {
   display: none;
   visibility: hidden;
 }
@@ -60,7 +61,6 @@ body:hover .visually-hidden button {
   box-shadow: 0 0 2px 2px rgba(0, 0, 0, 0.6);
 }
 
-
 /*
    Skip links
    ========================================================================== */
@@ -79,7 +79,6 @@ body:hover .visually-hidden button {
   list-style: none;
 }
 
-
 /*
    Type
    ========================================================================== */
@@ -104,14 +103,15 @@ body:hover .visually-hidden button {
   white-space: nowrap;
 }
 
-
 /*
    Alignment
    ========================================================================== */
 
 /* clearfix */
 
-.cf { clear: both; }
+.cf {
+  clear: both;
+}
 
 .wrapper {
   margin-left: auto;
@@ -119,7 +119,6 @@ body:hover .visually-hidden button {
   width: 100%;
 }
 
-
 /*
    Images
    ========================================================================== */
@@ -161,7 +160,7 @@ body:hover .visually-hidden button {
 /* file page content container */
 
 .full {
-  @include breakpoint($large){
+  @include breakpoint($large) {
     margin-right: -1 * span(2.5 of 12) !important;
   }
 }
@@ -291,7 +290,6 @@ body:hover .visually-hidden button {
   }
 }
 
-
 /*
    Navicons
    ========================================================================== */
@@ -331,7 +329,8 @@ body:hover .visually-hidden button {
   background: transparent;
 
   /* overlay the lines by setting both their top values to 0*/
-  &:before, &:after{
+  &:before,
+  &:after {
     -webkit-transform-origin: 50% 50%;
     -ms-transform-origin: 50% 50%;
     transform-origin: 50% 50%;
@@ -340,17 +339,16 @@ body:hover .visually-hidden button {
   }
 
   /* rotate the lines to form the x shape*/
-  &:before{
+  &:before {
-    -webkit-transform: rotate3d(0,0,1,45deg);
+    -webkit-transform: rotate3d(0, 0, 1, 45deg);
-            transform: rotate3d(0,0,1,45deg);
+    transform: rotate3d(0, 0, 1, 45deg);
   }
-  &:after{
+  &:after {
-    -webkit-transform: rotate3d(0,0,1,-45deg);
+    -webkit-transform: rotate3d(0, 0, 1, -45deg);
-            transform: rotate3d(0,0,1,-45deg);
+    transform: rotate3d(0, 0, 1, -45deg);
   }
 }
 
-
 /*
    Sticky, fixed to top content
    ========================================================================== */
@@ -368,7 +366,6 @@ body:hover .visually-hidden button {
   }
 }
 
-
 /*
    Wells
    ========================================================================== */
@@ -383,7 +380,6 @@ body:hover .visually-hidden button {
   box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05);
 }
 
-
 /*
    Modals
    ========================================================================== */
@@ -438,7 +434,6 @@ body:hover .visually-hidden button {
   }
 }
 
-
 /*
    Footnotes
    ========================================================================== */
@@ -451,7 +446,9 @@ body:hover .visually-hidden button {
 .footnotes {
   color: mix(#fff, $gray, 25%);
 
-  ol, li, p {
+  ol,
+  li,
+  p {
     margin-bottom: 0;
     font-size: $type-size-6;
   }
@@ -466,7 +463,6 @@ a.reversefootnote {
   }
 }
 
-
 /*
    Required
    ========================================================================== */
@@ -476,14 +472,14 @@ a.reversefootnote {
   font-weight: bold;
 }
 
-
 /*
    Google Custom Search Engine
    ========================================================================== */
 
 .gsc-control-cse {
-
+  table,
-  table, tr, td {
+  tr,
+  td {
     border: 0; /* remove table borders widget */
   }
 }

assets/js/_main.js

@@ -2,11 +2,10 @@
    jQuery plugin settings and other scripts
    ========================================================================== */
 
-$(document).ready(function(){
+$(document).ready(function() {
-
   // Sticky footer
   var bumpIt = function() {
-      $('body').css('margin-bottom', $('.page__footer').outerHeight(true));
+      $("body").css("margin-bottom", $(".page__footer").outerHeight(true));
     },
     didResize = false;
 
@@ -16,7 +15,7 @@ $(document).ready(function(){
     didResize = true;
   });
   setInterval(function() {
-    if(didResize) {
+    if (didResize) {
       didResize = false;
       bumpIt();
     }
@@ -31,11 +30,23 @@ $(document).ready(function(){
     $(".author__urls-wrapper button").toggleClass("open");
   });
 
+  // Search toggle
+  $(".search__toggle").on("click", function() {
+    $(".search-content").toggleClass("is--visible");
+    $(".initial-content").toggleClass("is--hidden");
+    // set focus on input
+    setTimeout(function() {
+      $("#search").focus();
+    }, 400);
+  });
+
   // init smooth scroll
-  $("a").smoothScroll({offset: -20});
+  $("a").smoothScroll({ offset: -20 });
 
   // add lightbox class to all image links
-  $("a[href$='.jpg'],a[href$='.jpeg'],a[href$='.JPG'],a[href$='.png'],a[href$='.gif']").addClass("image-popup");
+  $(
+    "a[href$='.jpg'],a[href$='.jpeg'],a[href$='.JPG'],a[href$='.png'],a[href$='.gif']"
+  ).addClass("image-popup");
 
   // Magnific-Popup options
   $(".image-popup").magnificPopup({
@@ -45,28 +56,30 @@ $(document).ready(function(){
     //   }
     //   return true;
     // },
-    type: 'image',
+    type: "image",
-    tLoading: 'Loading image #%curr%...',
+    tLoading: "Loading image #%curr%...",
     gallery: {
       enabled: true,
       navigateByImgClick: true,
-      preload: [0,1] // Will preload 0 - before current, and 1 after the current image
+      preload: [0, 1] // Will preload 0 - before current, and 1 after the current image
     },
     image: {
-      tError: '<a href="%url%">Image #%curr%</a> could not be loaded.',
+      tError: '<a href="%url%">Image #%curr%</a> could not be loaded.'
     },
     removalDelay: 500, // Delay in milliseconds before popup is removed
     // Class that is added to body when popup is open.
     // make it unique to apply your CSS animations just to this exact popup
-    mainClass: 'mfp-zoom-in',
+    mainClass: "mfp-zoom-in",
     callbacks: {
       beforeOpen: function() {
         // just a hack that adds mfp-anim class to markup
-        this.st.image.markup = this.st.image.markup.replace('mfp-figure', 'mfp-figure mfp-with-anim');
+        this.st.image.markup = this.st.image.markup.replace(
+          "mfp-figure",
+          "mfp-figure mfp-with-anim"
+        );
       }
     },
     closeOnContentClick: true,
     midClick: true // allow opening popup on middle mouse click. Always set it to true if you don't provide alternative source.
   });
-
 });

assets/js/lunr-en.js

@@ -1,4 +1,5 @@
 ---
+layout: null
 ---
 
 var idx = lunr(function () {
@@ -11,11 +12,11 @@ var idx = lunr(function () {
 
 {% assign count = 0 %}
 {% for c in site.collections %}
-  {% assign docs = c.docs %}
+  {% assign docs = c.docs | where_exp:'doc','doc.search != false' %}
   {% for doc in docs %}
     idx.add({
       title: {{ doc.title | jsonify }},
-      excerpt: {{ doc.excerpt | strip_html | truncatewords: 20 | jsonify }},
+      excerpt: {{ doc.content | strip_html | truncatewords: 20 | jsonify }},
       categories: {{ doc.categories | jsonify }},
       tags: {{ doc.tags | jsonify }},
       id: {{ count }}
@@ -31,7 +32,7 @@ var store = [
     {% if forloop.last %}
       {% assign l = true %}
     {% endif %}
-    {% assign docs = c.docs %}
+    {% assign docs = c.docs | where_exp:'doc','doc.search != false' %}
     {% for doc in docs %}
       {% if doc.header.teaser %}
         {% capture teaser %}{{ doc.header.teaser }}{% endcapture %}
@@ -58,7 +59,7 @@ $(document).ready(function() {
     var query = $(this).val();
     var result = idx.search(query);
     resultdiv.empty();
-    resultdiv.prepend('<p>'+result.length+' {{ site.data.ui-text[site.locale].results_found | default: "Result(s) found" }}</p>');
+    resultdiv.prepend('<p class="results__found">'+result.length+' {{ site.data.ui-text[site.locale].results_found | default: "Result(s) found" }}</p>');
     for (var item in result) {
       var ref = result[item].ref;
       if(store[ref].teaser){

assets/js/plugins/jquery.greedy-navigation.js

@@ -4,11 +4,10 @@ Licensed under the MIT license - http://opensource.org/licenses/MIT
 Copyright (c) 2015 Luke Jackson
 */
 
-$(document).ready(function(){
+$(document).ready(function() {
-
+  var $btn = $("nav.greedy-nav .greedy-nav__toggle");
-  var $btn = $('nav.greedy-nav button');
+  var $vlinks = $("nav.greedy-nav .visible-links");
-  var $vlinks = $('nav.greedy-nav .visible-links');
+  var $hlinks = $("nav.greedy-nav .hidden-links");
-  var $hlinks = $('nav.greedy-nav .hidden-links');
 
   var numOfItems = 0;
   var totalSpace = 0;
@@ -25,7 +24,6 @@ $(document).ready(function(){
   var availableSpace, numOfVisibleItems, requiredSpace, timer;
 
   function check() {
-
     // Get instant state
     availableSpace = $vlinks.width() - 10;
     numOfVisibleItems = $vlinks.children().length;
@@ -33,21 +31,27 @@ $(document).ready(function(){
 
     // There is not enough space
     if (requiredSpace > availableSpace) {
-      $vlinks.children().last().prependTo($hlinks);
+      $vlinks
+        .children()
+        .last()
+        .prependTo($hlinks);
       numOfVisibleItems -= 1;
       check();
       // There is more than enough space
     } else if (availableSpace > breakWidths[numOfVisibleItems]) {
-      $hlinks.children().first().appendTo($vlinks);
+      $hlinks
+        .children()
+        .first()
+        .appendTo($vlinks);
       numOfVisibleItems += 1;
       check();
     }
     // Update the button accordingly
     $btn.attr("count", numOfItems - numOfVisibleItems);
     if (numOfVisibleItems === numOfItems) {
-      $btn.addClass('hidden');
+      $btn.addClass("hidden");
     } else {
-      $btn.removeClass('hidden');
+      $btn.removeClass("hidden");
     }
   }
 
@@ -56,23 +60,24 @@ $(document).ready(function(){
     check();
   });
 
-  $btn.on('click', function() {
+  $btn.on("click", function() {
-    $hlinks.toggleClass('hidden');
+    $hlinks.toggleClass("hidden");
-    $(this).toggleClass('close');
+    $(this).toggleClass("close");
     clearTimeout(timer);
   });
 
-  $hlinks.on('mouseleave', function() {
+  $hlinks
+    .on("mouseleave", function() {
       // Mouse has left, start the timer
       timer = setTimeout(function() {
-      $hlinks.addClass('hidden');
+        $hlinks.addClass("hidden");
-      $btn.toggleClass('close');
+        $btn.toggleClass("close");
       }, closingTime);
-  }).on('mouseenter', function() {
+    })
+    .on("mouseenter", function() {
       // Mouse is back, cancel the timer
       clearTimeout(timer);
-  })
+    });
 
   check();
-
 });

docs/_config.yml

@@ -55,12 +55,13 @@ reCaptcha:
 atom_feed:
   path                   : # blank (default) uses feed.xml
 
+search                   : true # true, false (default)
+
 # SEO Related
 google_site_verification : "UQj93ERU9zgECodaaXgVpkjrFn9UrDMEzVamacSoQ8Y" # Replace this with your ID, or delete
 bing_site_verification   :
-alexa_site_verification  :
 yandex_site_verification :
-naver-site-verification  :
+naver_site_verification  :
 
 # Social Sharing
 twitter:
@@ -109,7 +110,7 @@ author:
   linkedin         :
   pinterest        :
   soundcloud       :
-  stackoverflow    : # http://stackoverflow.com/users/123456/username
+  stackoverflow    : # https://stackoverflow.com/users/123456/username
   steam            :
   tumblr           :
   twitter          : *twitter
@@ -260,7 +261,7 @@ sass:
 permalink: /:categories/:title/
 # paginate: 5 # amount of posts to show
 # paginate_path: /page:num/
-timezone: America/New_York # http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+timezone: America/New_York # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
 
 
 # Plugins (previously gems:)

docs/_data/comments/layout-table-of-contents-post/comment-1512118683486.yml

@@ -0,0 +1,9 @@
+_id: bc6cbcd0-d675-11e7-920e-d53b2bdd726d
+message: >-
+  it would be nice if the table of content was sticky so it scrolls down with
+  the user to ease navigation
+name: jean
+email: c569662e2d1490cd1d090450d8b5babc
+url: ''
+hidden: ''
+date: '2017-12-01T08:58:03.485Z'

docs/_data/navigation.yml

@@ -22,8 +22,6 @@ foo:
 main:
   - title: "Quick-Start Guide"
     url: /docs/quick-start-guide/
-  - title: "Search"
-    url: /search/
   - title: "About"
     url: /about/
   - title: "Sample Posts"

docs/_data/ui-text.yml

@@ -314,7 +314,7 @@ it-IT:
 
 # Chinese  (zh-CN Chinese - China)
 # -----------------
-zh: &DEFAULT_ZH
+zh: &DEFAULT_ZH_HANS
   page                       : "页面"
   pagination_previous        : "向前"
   pagination_next            : "向后"
@@ -353,13 +353,11 @@ zh: &DEFAULT_ZH
   comment_error_msg          : "很抱歉，您的提交存在错误。请确保所有必填字段都已填写正确，然后再试一次。"
   loading_label              : "正在加载..."
 zh-CN:
-  <<: *DEFAULT_ZH
+  <<: *DEFAULT_ZH_HANS
-zh-HK:
-  <<: *DEFAULT_ZH
 zh-SG:
-  <<: *DEFAULT_ZH
+  <<: *DEFAULT_ZH_HANS
 # Taiwan (Traditional Chinese)
-zh-TW:
+zh-TW: &DEFAULT_ZH_HANT
   page                       : "頁面"
   pagination_previous        : "較舊"
   pagination_next            : "較新"
@@ -397,7 +395,8 @@ zh-TW:
   comment_success_msg        : "感謝您的留言！ 審核後將會顯示在站上。"
   comment_error_msg          : "抱歉，部份資料輸入有問題。請確認資料填寫正確後再試一次。"
   loading_label              : "載入中..."
-
+zh-HK:
+  <<: *DEFAULT_ZH_HANT
 # German / Deutsch
 # -----------------
 de: &DEFAULT_DE

docs/_docs/05-configuration.md

@@ -2,7 +2,7 @@
 title: "Configuration"
 permalink: /docs/configuration/
 excerpt: "Settings for configuring and customizing the theme."
-last_modified_at: 2017-11-12T17:19:32-05:00
+last_modified_at: 2017-11-27T12:11:11-05:00
 toc: true
 ---
 
@@ -119,7 +119,7 @@ minimal_mistakes_skin: "default" # "air", "aqua", "contrast", "dark", "dirt", "n
 
 `site.locale` is used to declare the primary language for each web page within the site.
 
-*Example:* `locale: "en-US"` sets the `lang` attribute for the site to the *United States* flavor of English, while `en-GB` would be for the `United Kingdom` style of English. Country codes are optional and the shorter variation `locale: "en"` is also acceptable. To find your language and country codes check this [reference table](https://msdn.microsoft.com/en-us/library/ee825488(v=cs.20).aspx). 
+_Example:_ `locale: "en-US"` sets the `lang` attribute for the site to the _United States_ flavor of English, while `en-GB` would be for the `United Kingdom` style of English. Country codes are optional and the shorter variation `locale: "en"` is also acceptable. To find your language and country codes check this [reference table](<https://msdn.microsoft.com/en-us/library/ee825488(v=cs.20).aspx>).
 
 Properly setting the locale is important for associating localized text found in the [**UI Text**]({{ "/docs/ui-text/" | absolute_url }}) data file. An improper match will cause parts of the UI to disappear (eg. button labels, section headings, etc).
 
@@ -130,11 +130,11 @@ Properly setting the locale is important for associating localized text found in
 
 The name of your site. Is used throughout the theme in places like the site masthead and `<title>` tags.
 
-*Example:* `title: "My Awesome Site"`
+_Example:_ `title: "My Awesome Site"`
 
 You also have the option of customizing the separation character used in SEO-friendly page titles.
 
-*Example:* `title_separator: "|"` would produce page titles like `Sample Page | My Awesome Site`.
+_Example:_ `title_separator: "|"` would produce page titles like `Sample Page | My Awesome Site`.
 
 **Note:** Long site titles have been known to break the masthead layout. Avoid adding a long "tagline" to the title prevent this from happening eg. `My Awesome Site is the Best Because I Say So".
 {: .notice--warning}
@@ -143,7 +143,7 @@ You also have the option of customizing the separation character used in SEO-fri
 
 Used to assign a site author. Don't worry, you can override the site author with different ones on specific posts, pages, or collection documents.
 
-*Example:* `name: "Michael Rose"`.
+_Example:_ `name: "Michael Rose"`.
 
 **ProTip:** If you want to get crafty with your YAML you can use [anchors](http://www.yaml.org/spec/1.2/spec.html#id2785586) to reuse values. For example `foo: &var "My String"` allows you to reuse `"My String"` elsewhere in `_config.yml` like so... `bar: *var`. You'll see a few examples of this in the provided Jekyll config.
 {: .notice--info}
@@ -152,7 +152,7 @@ Used to assign a site author. Don't worry, you can override the site author with
 
 Fairly obvious. `site.description` describes the site. Used predominantly in meta descriptions for improving SEO.
 
-*Example:* `description: "A flexible Jekyll theme for your blog or site with a minimalist aesthetic."`
+_Example:_ `description: "A flexible Jekyll theme for your blog or site with a minimalist aesthetic."`
 
 ### Site URL
 
@@ -171,7 +171,7 @@ In the case of the Minimal Mistakes demo site it's hosted on GitHub at <https://
 
 For more information on how to properly use `site.url` and `site.baseurl` as intended by the Jekyll maintainers, check [Parker Moore's post on the subject](https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/).
 
-**Note:** When using `baseurl` remember to include it as part of your path when testing your site locally. Values of `url: ` and `baseurl: "/blog"` would make your local site visible at `http://localhost:4000/blog` and not `http://localhost:4000`.
+**Note:** When using `baseurl` remember to include it as part of your path when testing your site locally. Values of `url:` and `baseurl: "/blog"` would make your local site visible at `http://localhost:4000/blog` and not `http://localhost:4000`.
 {: .notice--warning}
 
 ### Site Repository
@@ -245,7 +245,7 @@ Breadcrumb start link text and separator character can both be changed in the [U
 
 ### Reading Time
 
-Enable estimated reading time snippets with `read_time: true` in YAML Front Matter. `200` has been set as the default words per minute value --- which can be changed by adjusting `words_per_minute: ` in `_config.yml`.
+Enable estimated reading time snippets with `read_time: true` in YAML Front Matter. `200` has been set as the default words per minute value --- which can be changed by adjusting `words_per_minute:` in `_config.yml`.
 
 ![reading time example]({{ "/assets/images/mm-read-time-example.jpg" | absolute_url }})
 
@@ -268,7 +268,7 @@ To disable reading time for a post, add `read_time: false` its YAML Front Matter
 [**Disqus**](https://disqus.com/), [**Discourse**](https://www.discourse.org/), [**Facebook**](https://developers.facebook.com/docs/plugins/comments), **Google+**, and static-based commenting via [**Staticman**](https://staticman.net/) are built into the theme. First set the comment provider you'd like to use:
 
 | Name             | Comment Provider          |
-| ----             | ----------------          |
+| ---------------- | ------------------------- |
 | **disqus**       | Disqus                    |
 | **discourse**    | Discourse                 |
 | **facebook**     | Facebook Comments         |
@@ -293,6 +293,10 @@ defaults:
 
 If you add `comments: false` to a post's YAML Front Matter it will override the default and disable comments for just that post.
 
+**Note:** Comments are disabled by default in `development`. To enable when testing/building locally be sure to set
+`JEKYLL_ENV=production` to [force the environment](http://jekyllrb.com/docs/configuration/#specifying-a-jekyll-environment-at-build-time) to production.
+{: .notice--info}
+
 ##### Disqus
 
 To use Disqus you'll need to create an account and [shortname](https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname-). Once you have both update `_config.yml` to:
@@ -335,7 +339,7 @@ comments:
 
 Transform user comments into `_data` files that live inside of your GitHub repository by enabling Staticman.
 
-**Note:** Looking to migrate comments from a Wordpress based site? Give [this tool](https://github.com/arthurlacoste/wordpress-comments-jekyll-staticman) a try.
+**Note:** Looking to migrate comments from a WordPress based site? Give [this tool](https://github.com/arthurlacoste/wordpress-comments-jekyll-staticman) a try. 
 {: .notice--info}
 
 ###### Add Staticman as a Collaborator
@@ -453,6 +457,16 @@ atom_feed:
 **Note:** By default the site feed is linked in two locations: inside the [`<head>` element](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/head.html) and at the bottom of every page in the [site footer](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/footer.html). 
 {: .notice--info}
 
+### Site Search
+
+Enable basic site search powered by [Lunr](https://lunrjs.com/) by adding the following to `_config.yml`:
+
+```yaml
+search: true
+```
+
+![masthead search example]({{ "/assets/images/masthead-search.gif" | absolute_url }})
+
 ### SEO, Social Sharing, and Analytics Settings
 
 All optional, but a good idea to take the time setting up to improve SEO and links shared from the site.
@@ -493,13 +507,9 @@ Much like Google and Bing you'll be provided with a meta description:
 Which you can add to your `_config.yml` like so:
 
 ```yaml
-naver-site-verification: "6BF5A01C0E650B479B612AC5A2184144"
+naver_site_verification: "6BF5A01C0E650B479B612AC5A2184144"
 ```
 
-#### Alexa
-
-To [claim your site](http://www.alexa.com/siteowners/claim) with Alexa add the provided verification ID `alexa_site_verification: "yourVerificationID"`.
-
 #### Yandex
 
 To verify site ownership copy and paste the string inside of `content`:
@@ -600,7 +610,7 @@ social:
 Analytics is disabled by default. To enable globally select one of the following:
 
 | Name                 | Analytics Provider                                              |
-| ----                 | ------------------                                              |
+| -------------------- | --------------------------------------------------------------- |
 | **google**           | [Google Standard Analytics](https://www.google.com/analytics/)  |
 | **google-universal** | [Google Universal Analytics](https://www.google.com/analytics/) |
 | **custom**           | Other analytics providers                                       |
@@ -616,6 +626,10 @@ analytics:
 
 To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/analytics-providers/custom.html`.
 
+**Note:** Analytics are disabled by default in `development`. To enable when testing/building locally be sure to set
+`JEKYLL_ENV=production` to [force the environment](http://jekyllrb.com/docs/configuration/#specifying-a-jekyll-environment-at-build-time) to production.
+{: .notice--info}
+
 ## Site Author
 
 Used as the defaults for defining what appears in the author sidebar.
@@ -732,9 +746,9 @@ timezone: America/New_York
 When hosting with GitHub Pages a small [set of gems](https://pages.github.com/versions/) have been whitelisted for use. The theme uses a few of them which can be found under `gems`. Additional settings and configurations are documented in the links below.
 
 | Plugin                             | Description                                                                               |
-| ------                             | ----------- |
+| ---------------------------------- | ----------------------------------------------------------------------------------------- |
 | [jekyll-paginate][jekyll-paginate] | Pagination Generator for Jekyll.                                                          |
-| [jekyll-sitemap][jekyll-sitemap] |Jekyll plugin to silently generate a sitemaps.org compliant sitemap for your Jekyll site. |
+| [jekyll-sitemap][jekyll-sitemap]   | Jekyll plugin to silently generate a sitemaps.org compliant sitemap for your Jekyll site. |
 | [jekyll-gist][jekyll-gist]         | Liquid tag for displaying GitHub Gists in Jekyll sites.                                   |
 | [jekyll-feed][jekyll-feed]         | A Jekyll plugin to generate an Atom (RSS-like) feed of your Jekyll posts.                 |
 | [jemoji][jemoji]                   | GitHub-flavored emoji plugin for Jekyll.                                                  |
@@ -749,7 +763,7 @@ If you're hosting elsewhere then you don't really have to worry about what is wh
 
 ## Archive Settings
 
-The theme ships with support for taxonomy (category and tag) pages. GitHub Pages hosted sites need to use a *Liquid only* approach while those hosted elsewhere can use plugins like [**jekyll-archives**][jekyll-archives] to generate these pages automatically.
+The theme ships with support for taxonomy (category and tag) pages. GitHub Pages hosted sites need to use a _Liquid only_ approach while those hosted elsewhere can use plugins like [**jekyll-archives**][jekyll-archives] to generate these pages automatically.
 
 [jekyll-archives]: https://github.com/jekyll/jekyll-archives
 
@@ -775,6 +789,7 @@ Which would create category and tag links in the breadcrumbs and page meta like:
 If you have the luxury of using Jekyll Plugins, then [**jekyll-archives**][jekyll-archives] will create a better experience as discrete taxonomy pages would be generated, and their corresponding links would be "real" (not just hash/fragment links into a larger index). However, the plugin will not generate the taxonomy index pages (`category-archive.html` and `_pages/tag-archive.html`) so you'd still need to manually create them if you'd like to have them (see note above).
 
 First, you'll need to make sure that the `jekyll-archives` plugin is installed. Either run `gem install jekyll-archives` or add the following to your `Gemfile`:
+
 ```
 group :jekyll_plugins do
   gem "jekyll-archives"

docs/_docs/07-navigation.md

@@ -34,6 +34,8 @@ Which will give you a responsive masthead similar to this:
 
 ![priority plus masthead animation]({{ "/assets/images/mm-priority-plus-masthead.gif" | absolute_url }})
 
+Optionally, you can add a `description` key per title in the `main` key. This `description` will show up like a tooltip, when the user hovers over the link on a desktop browser.
+
 **ProTip:** Put the most important links first so they're always visible and not hidden behind the **menu toggle**.
 {: .notice--info}
 

docs/_docs/10-layouts.md

@@ -7,7 +7,7 @@ single_layout_gallery:
     alt: "single layout with header example"
   - image_path: /assets/images/mm-layout-single-meta.png
     alt: "single layout with comments and related posts"
-last_modified_at: 2017-11-15T15:01:40-05:00
+last_modified_at: 2017-12-06T14:58:04-05:00
 toc: true
 toc_label: "Included Layouts"
 toc_icon: "columns"
@@ -275,6 +275,17 @@ A page with a search form. Add `layout: search` to the YAML Front Matter similar
 
 ![search page layout example]({{ "/assets/images/search-layout-example.png" | absolute_url }})
 
+**Note:** A page using the `layout: search` isn't compatible with the new [site search feature]({{ "/docs/configuration/#site-search" | absolute_url }}) incorporated in the masthead.
+{: .notice--warning}
+
+### Exclusions
+
+If you would like to exclude specific pages/posts from the search index set the search flag to `false` in the YAML Front Matter for the page/post.
+
+```yaml
+search: false
+```
+
 **ProTip:** Add a link to this page in the masthead navigation.
 {: .notice--info}
 

docs/_pages/home.md

@@ -7,7 +7,7 @@ header:
   cta_label: "<i class='fa fa-download'></i> Install Now"
   cta_url: "/docs/quick-start-guide/"
   caption:
-excerpt: 'A flexible two-column Jekyll theme. Perfect for personal sites, blogs, and portfolios hosted on GitHub or your own server.<br /> <small><a href="https://github.com/mmistakes/minimal-mistakes/releases/tag/4.7.1">Latest release v4.7.1</a></small><br /><br /> {::nomarkdown}<iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=star&count=true&size=large" frameborder="0" scrolling="0" width="160px" height="30px"></iframe> <iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=fork&count=true&size=large" frameborder="0" scrolling="0" width="158px" height="30px"></iframe>{:/nomarkdown}'
+excerpt: 'A flexible two-column Jekyll theme. Perfect for personal sites, blogs, and portfolios hosted on GitHub or your own server.<br /> <small><a href="https://github.com/mmistakes/minimal-mistakes/releases/tag/4.8.0">Latest release v4.8.0</a></small><br /><br /> {::nomarkdown}<iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=star&count=true&size=large" frameborder="0" scrolling="0" width="160px" height="30px"></iframe> <iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=fork&count=true&size=large" frameborder="0" scrolling="0" width="158px" height="30px"></iframe>{:/nomarkdown}'
 feature_row:
   - image_path: /assets/images/mm-customizable-feature.png
     alt: "customizable"

docs/_pages/search.md

@@ -1,5 +0,0 @@
----
-layout: search
-title: "Search"
-permalink: /search/
----

docs/_posts/2012-01-03-layout-table-of-contents-post.md

@@ -83,7 +83,7 @@ HTML and CSS are our tools. Mauris a ante. Suspendisse quam sem, consequat at, c
 Make any link standout more when applying the `.btn` class.
 
 ```html
-<a href="#" class="btn btn-success">Success Button</a>
+<a href="#" class="btn btn--success">Success Button</a>
 ```
 
 <div markdown="0"><a href="#" class="btn">Primary Button</a></div>

docs/_posts/2017-11-28-post-exclude-search.md

@@ -0,0 +1,12 @@
+---
+title:  "Exclude Post from Search Index"
+search: false
+categories: 
+  - Jekyll
+---
+
+This post should not appear in the search index because it has the following YAML Front Matter:
+
+```yaml
+search: false
+```

minimal-mistakes-jekyll.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name                    = "minimal-mistakes-jekyll"
-  spec.version                 = "4.7.1"
+  spec.version                 = "4.8.0"
   spec.authors                 = ["Michael Rose"]
 
   spec.summary                 = %q{A flexible two-column Jekyll theme.}
@@ -15,9 +15,9 @@ Gem::Specification.new do |spec|
     f.match(%r{^(assets|_(data|includes|layouts|sass)/|(LICENSE|README|CHANGELOG)((\.(txt|md|markdown)|$)))}i)
   end
 
-  spec.add_runtime_dependency "jekyll", "~> 3.5", ">= 3.5.1"
+  spec.add_runtime_dependency "jekyll", "~> 3.6"
   spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
-  spec.add_runtime_dependency "jekyll-sitemap", "~> 1.0"
+  spec.add_runtime_dependency "jekyll-sitemap", "~> 1.1"
   spec.add_runtime_dependency "jekyll-gist", "~> 1.4"
   spec.add_runtime_dependency "jekyll-feed", "~> 0.9.2"
   spec.add_runtime_dependency "jekyll-data", "~> 1.0"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-mistakes",
-  "version": "4.7.1",
+  "version": "4.8.0",
   "description": "Minimal Mistakes Jekyll theme npm build scripts",
   "repository": {
     "type": "git",

test/_config.yml

@@ -49,11 +49,11 @@ staticman:
         format           : "iso8601" # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds"
 atom_feed:
   path                   : # blank (default) uses feed.xml
+search                   : true # true, false (default)
 
 # SEO Related
 google_site_verification :
 bing_site_verification   :
-alexa_site_verification  :
 yandex_site_verification :
 
 # Social Sharing

test/_data/navigation.yml

@@ -2,8 +2,6 @@
 main:
   - title: "Quick-Start Guide"
     url: https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
-  - title: "Search"
-    url: /search/
   - title: "About"
     url: https://mmistakes.github.io/minimal-mistakes/about/
   - title: "Sample Posts"

test/_pages/search.md

@@ -1,5 +0,0 @@
----
-layout: search
-title: "Search"
-permalink: /search/
----

test/_posts/2012-01-03-layout-table-of-contents-post.md

@@ -83,7 +83,7 @@ HTML and CSS are our tools. Mauris a ante. Suspendisse quam sem, consequat at, c
 Make any link standout more when applying the `.btn` class.
 
 ```html
-<a href="#" class="btn btn-success">Success Button</a>
+<a href="#" class="btn btn--success">Success Button</a>
 ```
 
 <div markdown="0"><a href="#" class="btn">Primary Button</a></div>

test/_posts/2017-11-28-post-exclude-search.md

@@ -0,0 +1,12 @@
+---
+title:  "Exclude Post from Search Index"
+search: false
+categories: 
+  - Jekyll
+---
+
+This post should not appear in the search index because it has the following YAML Front Matter:
+
+```yaml
+search: false
+```