Mistake on file navigation.yml (#1079)

Previous wrong name was `navigations.yml`

.gitattributes

@@ -1,6 +1,5 @@
+_assets/css/vendor/* linguist-vendored
+_assets/js/plugins/* linguist-vendored
+_assets/js/vendor/* linguist-vendored
 assets/fonts/* linguist-vendored
-assets/js/main.min.js linguist-vendored
+assets/js/vendor/* linguist-vendored
-assets/js/lunr/* linguist-vendored
-assets/js/plugins/* linguist-vendored
-assets/js/vendor/* linguist-vendored
-_sass/minimal-mistakes/vendor/* linguist-vendored

.github/CONTRIBUTING.md

@@ -8,8 +8,4 @@ This goes for author sidebar links and "share button" additions -- I have no int
 
 ## Pull Requests
 
-When submitting a pull request:
+To help me out try to avoid creating pull requests on `master` and instead branch off of `develop`. It's much easier for me to test, merge, and roll them into new releases this way.
-
-1. Clone the repo.
-2. Create a branch off of `master` and give it a meaningful name (e.g. `my-awesome-new-feature`) and describe the feature or fix.
-3. Open a pull request on GitHub.

.github/ISSUE_TEMPLATE.md

@@ -1,63 +0,0 @@
-<!--
-  Before opening a new issue please:
-  
-  - Verify you have the latest versions of Jekyll and Minimal Mistakes 
-    installed by running `bundle update`.
-  - Thoroughly read the theme's documentation at
-    https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
-  - Search all issues at https://github.com/mmistakes/minimal-mistakes/issues 
-    for solutions and to avoid duplication.
-  - Ask for help at https://talk.jekyllrb.com/
-  
-  After exhausting these suggestions use the format below.
--->
-
-## Description
-
-<!--
-  Describe the issue or proposed feature enhancement.
--->
-
-## Environment
-
-<!--
-  Please include theme version, Jekyll version, public git repository, whether 
-  you are hosting with GitHub Pages, and the operating system you tested with.
-
-  Issues without a link to a public repository or ZIP file will likely go ignored.
-  Being able to see your actual files is necessary to troubleshoot, as most 
-  issues stem from invalid/missing YAML Front Matter, a mis-configured _config.sys 
-  file, or problematic site content. 
--->
-
-- Minimal Mistakes version:
-- Ruby gem or remote theme version:
-- Jekyll version:
-- Git repository URL:
-- Operating system:
-- GitHub Pages hosted (if yes provide URL to site):
-
----
-
-## Expected behavior
-
-<!--
-  Describe the intended output or what you expected to see.
--->
-
-## Steps to reproduce the behavior
-
-<!--
-  Describe the steps you took for this problem to exist. Such as: you installed
-  the theme, customized _config.yml, added your own posts, and started up a 
-  Jekyll server locally.
-
-  If an error occurred on GitHub Pages when pushing, please test a local version
-  following these setup instructions: 
-  https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
-
-  Then provide a complete log by running `bundle exec jekyll build --trace --verbose` 
-  and include this output in the filed issue.
-
-  Screenshots can also be included if they help illustrate a behavior.
--->

.github/stale.yml

@@ -1,21 +0,0 @@
-# Number of days of inactivity before an issue becomes stale
-daysUntilStale: 30
-# Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
-# Issues with these labels will never be considered stale
-exemptLabels:
-  - "Status: Accepted"
-  - "Status: Under Consideration"
-# Label to use when marking an issue as stale
-staleLabel: "Status: Stale"
-# Comment to post when marking an issue as stale. Set to `false` to disable
-markComment: |
-  This issue has been automatically marked as stale because it has not had recent activity.
-
-  If this is a **bug** and you can still reproduce this error on the `master` branch, please reply with any additional information you have about it in order to keep the issue open.
-
-  If this is a feature request, please consider whether it can be accomplished in another way. If it cannot, please elaborate on why it is core to this project and why you feel more than 80% of users would find this beneficial.
-
-  This issue will automatically be closed in 7 days if no further activity occurs. Thank you for all your contributions.
-# Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false

.gitignore

@@ -1,14 +1,10 @@
-*.gem
 *.sublime-project
 *.sublime-workspace
-.bundle
 .DS_Store
 .jekyll-metadata
 .sass-cache
 _asset_bundler_cache
 _site
 codekit-config.json
-example/_site
-Gemfile.lock
 node_modules
 npm-debug.log*

.travis.yml

@@ -1,11 +0,0 @@
-language: ruby
-cache: bundler
-gemfile: docs/Gemfile
-script:
-  - bundle exec jekyll algolia --source docs --destination docs/_site --config docs/_config.yml
-branches:
-  only:
-    # Change this to gh-pages if you're deploying using the gh-pages branch
-    - master
-rvm:
- - 2.4

Gemfile

@@ -1,2 +1,25 @@
 source "https://rubygems.org"
-gemspec
+
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+
+gem "github-pages", group: :jekyll_plugins
+
+# If you want to use Jekyll native, uncomment the line below.
+# To upgrade, run `bundle update`.
+
+# gem "jekyll"
+
+gem "wdm", "~> 0.1.0" if Gem.win_platform?
+
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+  # gem "jekyll-archives"
+  gem "jekyll-feed"
+end

Gemfile.lock

@@ -0,0 +1,147 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.2.7)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    addressable (2.4.0)
+    coffee-script (2.4.1)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.10.0)
+    colorator (1.1.0)
+    ethon (0.9.0)
+      ffi (>= 1.3.0)
+    execjs (2.7.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    ffi (1.9.14)
+    ffi (1.9.14-x64-mingw32)
+    forwardable-extended (2.6.0)
+    gemoji (2.1.0)
+    github-pages (96)
+      activesupport (= 4.2.7)
+      github-pages-health-check (= 1.2.0)
+      jekyll (= 3.2.1)
+      jekyll-coffeescript (= 1.0.1)
+      jekyll-feed (= 0.5.1)
+      jekyll-gist (= 1.4.0)
+      jekyll-github-metadata (= 2.0.2)
+      jekyll-mentions (= 1.2.0)
+      jekyll-paginate (= 1.1.0)
+      jekyll-redirect-from (= 0.11.0)
+      jekyll-sass-converter (= 1.3.0)
+      jekyll-seo-tag (= 2.0.0)
+      jekyll-sitemap (= 0.10.0)
+      jemoji (= 0.7.0)
+      kramdown (= 1.11.1)
+      liquid (= 3.0.6)
+      listen (= 3.0.6)
+      mercenary (~> 0.3)
+      minima (= 1.2.0)
+      rouge (= 1.11.1)
+      terminal-table (~> 1.4)
+    github-pages-health-check (1.2.0)
+      addressable (~> 2.3)
+      net-dns (~> 0.8)
+      octokit (~> 4.0)
+      public_suffix (~> 1.4)
+      typhoeus (~> 0.7)
+    html-pipeline (2.4.2)
+      activesupport (>= 2)
+      nokogiri (>= 1.4)
+    i18n (0.7.0)
+    jekyll (3.2.1)
+      colorator (~> 1.0)
+      jekyll-sass-converter (~> 1.0)
+      jekyll-watch (~> 1.1)
+      kramdown (~> 1.3)
+      liquid (~> 3.0)
+      mercenary (~> 0.3.3)
+      pathutil (~> 0.9)
+      rouge (~> 1.7)
+      safe_yaml (~> 1.0)
+    jekyll-coffeescript (1.0.1)
+      coffee-script (~> 2.2)
+    jekyll-feed (0.5.1)
+    jekyll-gist (1.4.0)
+      octokit (~> 4.2)
+    jekyll-github-metadata (2.0.2)
+      jekyll (~> 3.1)
+      octokit (~> 4.0)
+    jekyll-mentions (1.2.0)
+      activesupport (~> 4.0)
+      html-pipeline (~> 2.3)
+      jekyll (~> 3.0)
+    jekyll-paginate (1.1.0)
+    jekyll-redirect-from (0.11.0)
+      jekyll (>= 2.0)
+    jekyll-sass-converter (1.3.0)
+      sass (~> 3.2)
+    jekyll-seo-tag (2.0.0)
+      jekyll (~> 3.1)
+    jekyll-sitemap (0.10.0)
+    jekyll-watch (1.5.0)
+      listen (~> 3.0, < 3.1)
+    jemoji (0.7.0)
+      activesupport (~> 4.0)
+      gemoji (~> 2.0)
+      html-pipeline (~> 2.2)
+      jekyll (>= 3.0)
+    json (1.8.3)
+    kramdown (1.11.1)
+    liquid (3.0.6)
+    listen (3.0.6)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9.7)
+    mercenary (0.3.6)
+    mini_portile2 (2.1.0)
+    minima (1.2.0)
+    minitest (5.9.0)
+    multipart-post (2.0.0)
+    net-dns (0.8.0)
+    nokogiri (1.6.8)
+      mini_portile2 (~> 2.1.0)
+      pkg-config (~> 1.1.7)
+    nokogiri (1.6.8-x64-mingw32)
+      mini_portile2 (~> 2.1.0)
+      pkg-config (~> 1.1.7)
+    octokit (4.3.0)
+      sawyer (~> 0.7.0, >= 0.5.3)
+    pathutil (0.14.0)
+      forwardable-extended (~> 2.6)
+    pkg-config (1.1.7)
+    public_suffix (1.5.3)
+    rb-fsevent (0.9.7)
+    rb-inotify (0.9.7)
+      ffi (>= 0.5.0)
+    rouge (1.11.1)
+    safe_yaml (1.0.4)
+    sass (3.4.22)
+    sawyer (0.7.0)
+      addressable (>= 2.3.5, < 2.5)
+      faraday (~> 0.8, < 0.10)
+    terminal-table (1.7.2)
+      unicode-display_width (~> 1.1.1)
+    thread_safe (0.3.5)
+    typhoeus (0.8.0)
+      ethon (>= 0.8.0)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.1.1)
+    wdm (0.1.1)
+
+PLATFORMS
+  ruby
+  x64-mingw32
+
+DEPENDENCIES
+  github-pages
+  jekyll-feed
+  wdm (~> 0.1.0)
+
+BUNDLED WITH
+   1.12.5

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Michael Rose
+
+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.

LICENSE.txt

@@ -1,63 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2013-2018 Michael Rose and contributors
-
-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.
-
-Minimal Mistakes incorporates icons from [The Noun Project](https://thenounproject.com/)
-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/),
-Copyright (c) 2017 Dave Gandy.
-Font Awesome is distributed under the terms of the [SIL OFL 1.1](http://scripts.sil.org/OFL)
-and [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates photographs from [Unsplash](https://unsplash.com).
-
-Minimal Mistakes incorporates [Susy](http://susy.oddbird.net/),
-Copyright (c) 2017, Miriam Eric Suzanne.
-Susy is distributed under the terms of the [BSD 3-clause "New" or "Revised" License](https://opensource.org/licenses/BSD-3-Clause).
-
-Minimal Mistakes incorporates [Breakpoint](http://breakpoint-sass.com/).
-Breakpoint is distributed under the terms of the [MIT/GPL Licenses](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [FitVids.js](https://github.com/davatron5000/FitVids.js/),
-Copyright (c) 2013 Dave Rubert and Chris Coyier.
-FitVids is distributed under the terms of the [WTFPL License](http://sam.zoy.org/wtfpl/).
-
-Minimal Mistakes incorporates [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/),
-Copyright (c) 2014-2016 Dmitry Semenov, http://dimsemenov.com.
-Magnific Popup is distributed under the terms of the MIT License.
-
-Minimal Mistakes incorporates [jQuery Smooth Scroll](https://github.com/kswedberg/jquery-smooth-scroll),
-Copyright (c) 2017 Karl Swedberg.
-jQuery Smooth Scroll is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [GreedyNav.js](https://github.com/lukejacksonn/GreedyNav),
-Copyright (c) 2015 Luke Jackson.
-GreedyNav.js is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [Jekyll Group-By-Array](https://github.com/mushishi78/jekyll-group-by-array),
-Copyright (c) 2015 Max White <mushishi78@gmail.com>.
-Jekyll Group-By-Array is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [Lunr](http://lunrjs.com),
-Copyright (c) 2017 Oliver Nightingale.
-Lunr is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).

README.md

@@ -1,51 +1,36 @@
 # [Minimal Mistakes Jekyll Theme](https://mmistakes.github.io/minimal-mistakes/)
 
-[![LICENSE](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/LICENSE.txt)
+[![GitHub release](https://img.shields.io/github/release/mmistakes/minimal-mistakes.svg)](https://github.com/mmistakes/minimal-mistakes/releases) [![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/LICENSE)
-[![Jekyll](https://img.shields.io/badge/jekyll-%3E%3D%203.6-blue.svg)](https://jekyllrb.com/)
-[![Ruby gem](https://img.shields.io/gem/v/minimal-mistakes-jekyll.svg)](https://rubygems.org/gems/minimal-mistakes-jekyll)
-[![Tip Me via PayPal](https://img.shields.io/badge/PayPal-tip%20me-green.svg?logo=paypal)](https://www.paypal.me/mmistakes)
 
 Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your personal site, blog, or portfolio on GitHub or self-hosting on your own server. As the name implies --- styling is purposely minimalistic to be enhanced and customized by you :smile:.
 
-:sparkles: See what's new in the [CHANGELOG](CHANGELOG.md).
+See what's new in the [CHANGELOG](CHANGELOG.md).
+
+Interested in testing out a [**pre-release "gemified" version**](https://github.com/mmistakes/minimal-mistakes/tree/feature/theme-gem) of the theme? Read this blog post to [learn how](https://mmistakes.github.io/minimal-mistakes/jekyll/gemified-theme-beta/).
 
 [![Minimal Mistakes live preview][2]][1]
 
 [1]: https://mmistakes.github.io/minimal-mistakes/
-[2]: screenshot.png (live preview)
+[2]: images/mm-browser-mockups.png (live preview)
 
-![layout examples](screenshot-layouts.png)
+The theme includes responsive layouts (`single`, `archive`, and `splash` pages) that look great on mobile and desktop browsers.
 
-## Notable Features
+![layout examples](images/mm-layout-examples.png)
 
-- Bundled as a "theme gem" for easier install/upgrading.
+## [Installation and Setup](https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/) / [Preview the Theme](https://mmistakes.github.io/minimal-mistakes/)
-- Compatible with GitHub Pages.
-- Support for Jekyll's built-in Sass/SCSS preprocessor.
-- Nine different skins (color variations).
-- Several responsive layout options (single, archive index, search, splash, and paginated home page).
-- Optimized for search engines with support for [Twitter Cards](https://dev.twitter.com/cards/overview) and [Open Graph](http://ogp.me/) data
-- Optional [header images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#headers), [custom sidebars](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#sidebars), [table of contents](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#table-of-contents), [galleries](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery), related posts, [breadcrumb links](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#breadcrumb-navigation-beta), [navigation lists](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list), and more.
-- Commenting support (powered by [Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), Google+, [Discourse](https://www.discourse.org/), static-based via [Staticman v1 and v2](https://staticman.net/), and custom).
-- [Google Analytics](https://www.google.com/analytics/) support.
-- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
 
-## Skins (Color Variations)
+### Notable Features
 
-This theme comes in nine different skins (including the default one).
+- Compatible with Jekyll 3.x and GitHub Pages
+- Support for Jekyll's built-in Sass/SCSS preprocessor
+- Several layout options (single, archive, splash pages)
+- SEO optimized with support for [Twitter Cards](https://dev.twitter.com/cards/overview) and [Open Graph](http://ogp.me/) data
+- Optional header images, sidebars, table of contents, galleries, related posts, breadcrumb links, and more.
+- Optional comments ([Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), Google+, [Discourse](https://www.discourse.org/), static-based via [Staticman](https://staticman.net/), and custom).
+- Optional analytics ([Google Analytics](https://www.google.com/analytics/) and custom).
+- UI localized text: English (default), Spanish, French, and Turkish.
 
-| `air` | `contrast` | `dark` |
+#### Demo Pages
-| --- | --- | --- |
-| ![air skin](https://mmistakes.github.io/minimal-mistakes/assets/images/air-skin-archive.png) | ![contrast skin](https://mmistakes.github.io/minimal-mistakes/assets/images/contrast-skin-archive.png) | ![dark skin](https://mmistakes.github.io/minimal-mistakes/assets/images/dark-skin-archive.png) |
-
-| `dirt` | `mint` | `sunrise` |
-| --- | --- | --- |
-| ![dirt skin](https://mmistakes.github.io/minimal-mistakes/assets/images/dirt-skin-archive.png) | ![mint skin](https://mmistakes.github.io/minimal-mistakes/assets/images/mint-skin-archive.png) | ![sunrise skin](https://mmistakes.github.io/minimal-mistakes/assets/images/sunrise-skin-archive.png) |
-
-| `aqua` | `neon` | `plum` |
-| --- | --- | --- |
-| ![aqua skin](https://mmistakes.github.io/minimal-mistakes/assets/images/aqua-skin-archive.png) | ![neon skin](https://mmistakes.github.io/minimal-mistakes/assets/images/neon-skin-archive.png) | ![plum skin](https://mmistakes.github.io/minimal-mistakes/assets/images/plum-skin-archive.png) |
-
-## Demo Pages
 
 | Name                                        | Description                                           |
 | ------------------------------------------- | ----------------------------------------------------- |
@@ -55,9 +40,9 @@ This theme comes in nine different skins (including the default one).
 | [Post with a Gallery][gallery-post] | A post showing several images wrapped in `<figure>` elements. |
 | [Sample Collection Page][sample-collection] | Single page from a collection. |
 | [Categories Archive][categories-archive] | Posts grouped by category. |
-| [Tags Archive][tags-archive] | Posts grouped by tag. |
+| [Tags Archive][tags-archive] | Posts grouped by tags. |
 
-Additional sample posts are available under [posts archive][year-archive] on the demo site. Source files for these (and the entire demo site) can be found in [`/docs`](docs).
+For even more demo pages check the [posts archive][year-archive].
 
 [header-image-post]: https://mmistakes.github.io/minimal-mistakes/layout-header-image-text-readability/
 [gallery-post]: https://mmistakes.github.io/minimal-mistakes/post%20formats/post-gallery/
@@ -68,54 +53,6 @@ Additional sample posts are available under [posts archive][year-archive] on the
 [tags-archive]: https://mmistakes.github.io/minimal-mistakes/tags/
 [year-archive]: https://mmistakes.github.io/minimal-mistakes/year-archive/
 
-## Installation
-
-There are three ways to install the theme: as a Ruby gem (for self-hosted sites), as a Ruby gem + jekyll-remote-theme plugin (GitHub Pages hosted sites), or forking/directly copying all of the theme files into your project.
-
-### Ruby Gem Method
-
-1. Install the theme as a Ruby Gem by adding it to your `Gemfile` like so:
-
-   ```ruby
-   gem "minimal-mistakes-jekyll"
-   ```
-
-2. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
-
-   ```bash
-   bundle
-   ```
-
-3. Set the `theme` in your project's Jekyll `_config.yml` file:
-
-   ```yaml
-   theme: minimal-mistakes-jekyll
-   ```
-
-To update the theme run `bundle update`.
-
-### GitHub Pages Method
-
-1. Create/replace the contents of your `Gemfile` with the following:
-
-   ```ruby
-   source "https://rubygems.org"
-
-   gem "github-pages", group: :jekyll_plugins
-   ```
-
-2. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
-
-   ```bash
-   bundle
-   ```
-
-3. Add `remote_theme: "mmistakes/minimal-mistakes"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
-
-## Usage
-
-For detailed instructions on how to configure, customize, add/migrate content, and more read the [theme's documentation](https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/).
-
 ---
 
 ## Contributing
@@ -128,19 +65,7 @@ This goes for author sidebar links and "share button" additions -- I have no int
 
 ### Pull Requests
 
-When submitting a pull request:
+To help me out try to avoid creating pull requests on `master` and instead branch off of `develop`. It's much easier for me to test, merge, and roll them into new releases this way.
-
-1. Clone the repo.
-2. Create a branch off of `master` and give it a meaningful name (e.g. `my-awesome-new-feature`).
-3. Open a pull request on GitHub and describe the feature or fix.
-
-Theme documentation and demo pages can be found in the [`/docs`](docs) if submitting improvements, typo corrections, etc.
-
-## Development
-
-To set up your environment to develop this theme, run `bundle install`.
-
-To test the theme, run `bundle exec rake preview` and open your browser at `http://localhost:4000/test/`. This starts a Jekyll server using content in the `test/` directory. As modifications are made to the theme and test site, it will regenerate and you should see the changes in the browser after a refresh.
 
 ---
 
@@ -157,7 +82,7 @@ To test the theme, run `bundle exec rake preview` and open your browser at `http
 ### Icons + Demo Images:
 
 - [The Noun Project](https://thenounproject.com) -- Garrett Knoll, Arthur Shlain, and [tracy tam](https://thenounproject.com/tracytam)
-- [Font Awesome](http://fontawesome.io/)
+- [Font Awesome](http://fortawesome.github.io/Font-Awesome/)
 - [Unsplash](https://unsplash.com/)
 
 ### Other:
@@ -168,9 +93,9 @@ To test the theme, run `bundle exec rake preview` and open your browser at `http
 - [Breakpoint](http://breakpoint-sass.com/)
 - [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/)
 - [FitVids.JS](http://fitvidsjs.com/)
-- [GreedyNav.js](https://github.com/lukejacksonn/GreedyNav)
+- Greedy Navigation - [lukejacksonn](http://codepen.io/lukejacksonn/pen/PwmwWV)
 - [jQuery Smooth Scroll](https://github.com/kswedberg/jquery-smooth-scroll)
-- [Lunr](http://lunrjs.com)
+- [Stickyfill](https://github.com/wilddeer/stickyfill)
 
 ---
 
@@ -178,7 +103,7 @@ To test the theme, run `bundle exec rake preview` and open your browser at `http
 
 The MIT License (MIT)
 
-Copyright (c) 2013-2018 Michael Rose and contributors
+Copyright (c) 2016 Michael Rose
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -197,49 +122,3 @@ 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.
-
-Minimal Mistakes incorporates icons from [The Noun Project](https://thenounproject.com/) 
-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/),
-Copyright (c) 2017 Dave Gandy.
-Font Awesome is distributed under the terms of the [SIL OFL 1.1](http://scripts.sil.org/OFL) 
-and [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates photographs from [Unsplash](https://unsplash.com).
-
-Minimal Mistakes incorporates [Susy](http://susy.oddbird.net/),
-Copyright (c) 2017, Miriam Eric Suzanne.
-Susy is distributed under the terms of the [BSD 3-clause "New" or "Revised" License](https://opensource.org/licenses/BSD-3-Clause).
-
-Minimal Mistakes incorporates [Breakpoint](http://breakpoint-sass.com/).
-Breakpoint is distributed under the terms of the [MIT/GPL Licenses](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [FitVids.js](https://github.com/davatron5000/FitVids.js/),
-Copyright (c) 2013 Dave Rubert and Chris Coyier.
-FitVids is distributed under the terms of the [WTFPL License](http://sam.zoy.org/wtfpl/).
-
-Minimal Mistakes incorporates [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/),
-Copyright (c) 2014-2016 Dmitry Semenov, http://dimsemenov.com.
-Magnific Popup is distributed under the terms of the MIT License.
-
-Minimal Mistakes incorporates [jQuery Smooth Scroll](https://github.com/kswedberg/jquery-smooth-scroll),
-Copyright (c) 2017 Karl Swedberg.
-jQuery Smooth Scroll is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [GreedyNav.js](https://github.com/lukejacksonn/GreedyNav),
-Copyright (c) 2015 Luke Jackson.
-GreedyNav.js is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [Jekyll Group-By-Array](https://github.com/mushishi78/jekyll-group-by-array),
-Copyright (c) 2015 Max White <mushishi78@gmail.com>.
-Jekyll Group-By-Array is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [@allejo's Pure Liquid Jekyll Table of Contents](https://allejo.io/blog/a-jekyll-toc-in-liquid-only/),
-Copyright (c) 2017 Vladimir Jimenez.
-Pure Liquid Jekyll Table of Contents is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-Minimal Mistakes incorporates [Lunr](http://lunrjs.com),
-Copyright (c) 2017 Oliver Nightingale.
-Lunr is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT).

Rakefile

@@ -1,76 +0,0 @@
-require "bundler/gem_tasks"
-require "jekyll"
-require "listen"
-
-def listen_ignore_paths(base, options)
-  [
-    /_config\.ya?ml/,
-    /_site/,
-    /\.jekyll-metadata/
-  ]
-end
-
-def listen_handler(base, options)
-  site = Jekyll::Site.new(options)
-  Jekyll::Command.process_site(site)
-  proc do |modified, added, removed|
-    t = Time.now
-    c = modified + added + removed
-    n = c.length
-    relative_paths = c.map{ |p| Pathname.new(p).relative_path_from(base).to_s }
-    print Jekyll.logger.message("Regenerating:", "#{relative_paths.join(", ")} changed... ")
-    begin
-      Jekyll::Command.process_site(site)
-      puts "regenerated in #{Time.now - t} seconds."
-    rescue => e
-      puts "error:"
-      Jekyll.logger.warn "Error:", e.message
-      Jekyll.logger.warn "Error:", "Run jekyll build --trace for more information."
-    end
-  end
-end
-
-task :preview do
-  base = Pathname.new('.').expand_path
-  options = {
-    "source"        => base.join('test').to_s,
-    "destination"   => base.join('test/_site').to_s,
-    "force_polling" => false,
-    "serving"       => true,
-    "theme"         => "minimal-mistakes-jekyll"
-  }
-
-  options = Jekyll.configuration(options)
-
-  ENV["LISTEN_GEM_DEBUGGING"] = "1"
-  listener = Listen.to(
-    base.join("_data"),
-    base.join("_includes"),
-    base.join("_layouts"),
-    base.join("_sass"),
-    base.join("assets"),
-    options["source"],
-    :ignore => listen_ignore_paths(base, options),
-    :force_polling => options['force_polling'],
-    &(listen_handler(base, options))
-  )
-
-  begin
-    listener.start
-    Jekyll.logger.info "Auto-regeneration:", "enabled for '#{options["source"]}'"
-
-    unless options['serving']
-      trap("INT") do
-        listener.stop
-        puts "     Halting auto-regeneration."
-        exit 0
-      end
-
-      loop { sleep 1000 }
-    end
-  rescue ThreadError
-    # You pressed Ctrl-C, oh my!
-  end
-
-  Jekyll::Commands::Serve.process(options)
-end

_config.yml

@@ -5,31 +5,22 @@
 # For technical reasons, this file is *NOT* reloaded automatically when you use
 # `jekyll serve`. If you change this file, please restart the server process.
 
-# Theme Settings
-#
-# Review documentation to determine if you should use `theme` or `remote_theme`
-# https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/#installing-the-theme
-
-# theme                  : "minimal-mistakes-jekyll"
-# remote_theme           : "mmistakes/minimal-mistakes"
-minimal_mistakes_skin    : "default" # "air", "aqua", "contrast", "dark", "dirt", "neon", "mint", "plum", "sunrise"
-
 # Site Settings
 locale                   : "en-US"
-title                    : "Site Title"
+title                    : "Minimal Mistakes"
 title_separator          : "-"
-name                     : "Your Name"
+name                     : &name "Michael Rose"
-description              : "An amazing website."
+description              : &description "A flexible Jekyll theme for your blog or site with a minimalist aesthetic."
-url                      : # the base hostname & protocol for your site e.g. "https://mmistakes.github.io"
+url                      : https://mmistakes.github.io # the base hostname & protocol for your site e.g. "https://mmistakes.github.io"
-baseurl                  : # the subpath of your site, e.g. "/blog"
+baseurl                  : "/minimal-mistakes" # the subpath of your site, e.g. "/blog"
-repository               : # GitHub username/repo-name e.g. "mmistakes/minimal-mistakes"
+repository               : "mmistakes/minimal-mistakes"
-teaser                   : # path of fallback teaser image, e.g. "/assets/images/500x300.png"
+teaser                   : # filename of teaser fallback teaser image placed in /images/, .e.g. "500x300.png"
 # breadcrumbs            : false # true, false (default)
 words_per_minute         : 200
 comments:
-  provider               : # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman", "staticman_v2" "custom"
+  provider               : "staticman" # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman", "custom"
   disqus:
-    shortname            : # https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname-
+    shortname            :
   discourse:
     server               : # https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963 , e.g.: meta.discourse.org
   facebook:
@@ -38,98 +29,84 @@ comments:
     num_posts            : # 5 (default)
     colorscheme          : # "light" (default), "dark"
 staticman:
-  allowedFields          : # ['name', 'email', 'url', 'message']
+  allowedFields          : ['name', 'email', 'url', 'message']
-  branch                 : # "master"
+  branch                 : "gh-pages" # "master", "gh-pages"
-  commitMessage          : # "New comment."
+  commitMessage          : "New comment."
-  filename               : # comment-{@timestamp}
+  filename               : comment-{@timestamp}
-  format                 : # "yml"
+  format                 : "yml"
-  moderation             : # true
+  moderation             : true
-  path                   : # "/_data/comments/{options.slug}" (default)
+  path                   : "_data/comments/{options.slug}"
-  requiredFields         : # ['name', 'email', 'message']
+  requiredFields         : ['name', 'email', 'message']
   transforms:
-    email                : # "md5"
+    email                : "md5"
   generatedFields:
     date:
-      type               : # "date"
+      type               : "date"
       options:
-        format           : # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds"
+        format           : "iso8601" # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds"
-reCaptcha:
-  siteKey                :
-  secret                 :
 atom_feed:
   path                   : # blank (default) uses feed.xml
-search                   : # true, false (default)
+
-search_full_content      : # true, false (default)
-search_provider          : # lunr (default), algolia, google
-algolia:
-  application_id         : # YOUR_APPLICATION_ID
-  index_name             : # YOUR_INDEX_NAME
-  search_only_api_key    : # YOUR_SEARCH_ONLY_API_KEY
-  powered_by             : # true (default), false
-google:
-  search_engine_id       : # YOUR_SEARCH_ENGINE_ID
-  instant_search         : # false (default), true
 # SEO Related
-google_site_verification :
+google_site_verification : "UQj93ERU9zgECodaaXgVpkjrFn9UrDMEzVamacSoQ8Y"
 bing_site_verification   :
+alexa_site_verification  :
 yandex_site_verification :
-naver_site_verification  :
 
 # Social Sharing
 twitter:
-  username               :
+  username               : &twitter "mmistakes"
 facebook:
-  username               :
+  username               : &facebook "michaelrose"
   app_id                 :
   publisher              :
-og_image                 : # Open Graph/Twitter default site image
+og_image                 : "site-logo.png" # Open Graph/Twitter default site image
 # For specifying social profiles
 # - https://developers.google.com/structured-data/customize/social-profiles
 social:
   type                   : # Person or Organization (defaults to Person)
   name                   : # If the user or organization name differs from the site's name
   links: # An array of links to social media profiles
+    - "https://twitter.com/mmistakes"
+    - "https://facebook.com/michaelrose"
 
 # Analytics
 analytics:
-  provider               : false # false (default), "google", "google-universal", "custom"
+  provider               : "google-universal" # false (default), "google", "google-universal", "custom"
   google:
-    tracking_id          :
+    tracking_id          : "UA-2011187-3"
-    anonymize_ip         : # true, false (default)
 
 
 # Site Author
 author:
-  name             : "Your Name"
+  name             : *name
-  avatar           : # path of avatar image, e.g. "/assets/images/bio-photo.jpg"
+  avatar           : "michael-rose.jpg"
-  bio              : "I am an amazing person."
+  bio              : "Just another boring, tattooed, time traveling, designer."
-  location         : "Somewhere"
+  location         : "Buffalo, NY"
   email            :
-  uri              :
+  uri              : "https://mademistakes.com"
-  home             : # null (default), "absolute or relative url to link to author home"
   bitbucket        :
   codepen          :
   dribbble         :
   flickr           :
-  facebook         :
+  facebook         : *facebook
   foursquare       :
-  github           :
+  github           : "mmistakes"
-  gitlab           :
   google_plus      :
   keybase          :
-  instagram        :
+  instagram        : "mmistakes"
   lastfm           :
-  linkedin         : # "john-doe-12345678" (the last part of your profile url, e.g. https://www.linkedin.com/in/john-doe-12345678)
+  linkedin         :
   pinterest        :
   soundcloud       :
-  stackoverflow    : # "123456/username" (the last part of your profile url, e.g. https://stackoverflow.com/users/123456/username)
+  stackoverflow    : # http://stackoverflow.com/users/123456/username
-  steam            : # "steamId" (the last part of your profile url, e.g. https://steamcommunity.com/id/steamId/)
+  steam            :
   tumblr           :
-  twitter          :
+  twitter          : *twitter
   vine             :
   weibo            :
   xing             :
-  youtube          : # "https://youtube.com/c/MichaelRoseDesign"
+  youtube          :
 
 
 # Reading Files
@@ -160,8 +137,6 @@ exclude:
   - Rakefile
   - README
   - tmp
-  - /docs # ignore Minimal Mistakes /docs
-  - /test # ignore Minimal Mistakes /test
 keep_files:
   - .git
   - .svn
@@ -189,6 +164,82 @@ kramdown:
   enable_coderay: false
 
 
+# Collections
+collections:
+  docs:
+    output: true
+    permalink: /:collection/:path/
+  recipes:
+    output: true
+    permalink: /:collection/:path/
+  pets:
+    output: true
+    permalink: /:collection/:path/
+  portfolio:
+    output: true
+    permalink: /:collection/:path/
+
+
+# Defaults
+defaults:
+  # _posts
+  - scope:
+      path: ""
+      type: posts
+    values:
+      layout: single
+      author_profile: true
+      read_time: true
+      comments: true
+      share: true
+      related: true
+  # _pages
+  - scope:
+      path: ""
+      type: pages
+    values:
+      layout: single
+      author_profile: true
+  # _docs
+  - scope:
+      path: ""
+      type: docs
+    values:
+      layout: single
+      read_time: false
+      author_profile: false
+      share: false
+      comments: false
+      sidebar:
+        nav: "docs"
+  # _recipes
+  - scope:
+      path: ""
+      type: recipes
+    values:
+      layout: single
+      author_profile: true
+      share: true
+      comments: true
+  # _pets
+  - scope:
+      path: ""
+      type: pets
+    values:
+      layout: single
+      author_profile: true
+      share: true
+      comment: true
+  # _portfolio
+  - scope:
+      path: ""
+      type: portfolio
+    values:
+      layout: single
+      author_profile: false
+      share: true
+
+
 # Sass/SCSS
 sass:
   sass_dir: _sass
@@ -197,13 +248,13 @@ sass:
 
 # Outputting
 permalink: /:categories/:title/
-paginate: 5 # amount of posts to show
+# paginate: 5 # amount of posts to show
-paginate_path: /page:num/
+# paginate_path: /page:num/
-timezone: # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+timezone: America/New_York # http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
 
 
-# Plugins (previously gems:)
+# Plugins
-plugins:
+gems:
   - jekyll-paginate
   - jekyll-sitemap
   - jekyll-gist
@@ -254,18 +305,3 @@ compress_html:
   clippings: all
   ignore:
     envs: development
-
-
-# Defaults
-defaults:
-  # _posts
-  - scope:
-      path: ""
-      type: posts
-    values:
-      layout: single
-      author_profile: true
-      read_time: true
-      comments: # true
-      share: true
-      related: true

_data/authors.yml

@@ -5,7 +5,7 @@ Billy Rick:
   uri         : "http://thewhip.com"
   email       : "billy@rick.com"
   bio         : "What do you want, jewels? I am a very extravagant man."
-  avatar      : "/assets/images/bio-photo-2.jpg"
+  avatar      : "bio-photo-2.jpg"
   twitter     : "extravagantman"
   google_plus : "BillyRick"
 
@@ -13,6 +13,6 @@ Cornelius Fiddlebone:
   name        : "Cornelius Fiddlebone"
   email       : "cornelius@thewhip.com"
   bio         : "I ordered what?"
-  avatar      : "/assets/images/bio-photo.jpg"
+  avatar      : "bio-photo.jpg"
   twitter     : "rhymeswithsackit"
   google_plus : "CorneliusFiddlebone"

_data/comments/layout-header-image-text-readability/comment-1477487160398.yml

@@ -0,0 +1,6 @@
+message: How does comments feature work?
+name: Vaibhav
+email: 0dbb98b5a3576e50b33808f3577447b2
+url: 'http://vaibhavkaushal.com'
+hidden: ''
+date: '2016-10-26T13:05:59.708Z'

_data/comments/layout-header-image-text-readability/comment-1477488813575.yml

@@ -0,0 +1,12 @@
+message: >-
+  @Vaibhav - Comments on the demo site are powered by
+  [Staticman](https://staticman.net/) that generates `_data` files for each. You
+  can read the theme's docs on [how to set it
+  up](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#static-based-comments-via-staticman)
+  and check out a more detailed post on my site explaining [how it all
+  works](https://mademistakes.com/articles/jekyll-static-comments/).
+name: Michael Rose
+email: 1ce71bc10b86565464b612093d89707e
+url: 'https://mademistakes.com'
+hidden: ''
+date: '2016-10-26T13:33:32.881Z'

_data/comments/post-future-date/comment-1476970895811.yml

@@ -0,0 +1,6 @@
+message: this is a test
+name: meee
+email: 232a9dcb3a6c5207768a6ee567a7bfac
+url: ''
+hidden: ''
+date: '2016-10-20T13:41:35.070Z'

_data/navigation.yml

@@ -1,12 +1,97 @@
-# main links
+# example navigation
+foo:
+  - title: "Parent Link 1"
+    url: /parent-1-page-url/
+    children:
+      - title: "Child Link 1"
+        url: /child-1-page-url/
+      - title: "Child Link 2"
+        url: /child-2-page-url/
+
+  - title: "Parent Link 2"
+    url: /parent-2-page-url/
+    children:
+      - title: "Child Link 1"
+        url: /child-1-page-url/
+      - title: "Child Link 2"
+        url: /child-2-page-url/
+      - title: "Child Link 3"
+        url: /child-3-page-url/
+
+
+# main links links
 main:
   - title: "Quick-Start Guide"
-    url: https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
+    url: /docs/quick-start-guide/
-  # - title: "About"
+
-  #   url: https://mmistakes.github.io/minimal-mistakes/about/
+  - title: "About"
-  # - title: "Sample Posts"
+    url: /about/
-  #   url: /year-archive/
+
-  # - title: "Sample Collections"
+  - title: "Sample Posts"
-  #   url: /collection-archive/
+    url: /year-archive/
-  # - title: "Sitemap"
+
-  #   url: /sitemap/
+  - title: "Sample Collections"
+    url: /collection-archive/
+
+  - title: "Terms & Privacy Policy"
+    url: /terms/
+
+
+# documentation links
+docs:
+  - title: Getting Started
+    children:
+      - title: "Quick-Start Guide"
+        url: /docs/quick-start-guide/
+      - title: "Structure"
+        url: /docs/structure/
+      - title: "Installation"
+        url: /docs/installation/
+      - title: "Upgrading"
+        url: /docs/upgrading/
+
+  - title: Customization
+    children:
+      - title: "Configuration"
+        url: /docs/configuration/
+      - title: "Navigation"
+        url: /docs/navigation/
+      - title: "UI Text"
+        url: /docs/ui-text/
+      - title: "Authors"
+        url: /docs/authors/
+      - title: "Layouts"
+        url: /docs/layouts/
+
+  - title: Content
+    children:
+      - title: "Working with Posts"
+        url: /docs/posts/
+      - title: "Working with Pages"
+        url: /docs/pages/
+      - title: "Working with Collections"
+        url: /docs/collections/
+      - title: "Helpers"
+        url: /docs/helpers/
+      - title: "Utility Classes"
+        url: /docs/utility-classes/
+
+  - title: Extras
+    children:
+      - title: "Stylesheets"
+        url: /docs/stylesheets/
+      - title: "JavaScript"
+        url: /docs/javascript/
+
+  - title: Meta
+    children:
+      - title: "History"
+        url: /docs/history/
+      - title: "Contributing"
+        url: /docs/contributing/
+      - title: "Old 2.2 Docs"
+        url: /docs/docs-2-2/
+      - title: "License"
+        url: /docs/license/
+      - title: "Terms & Privacy Policy"
+        url: /terms/

_data/ui-text.yml

@@ -8,7 +8,6 @@ en: &DEFAULT_EN
   pagination_next            : "Next"
   breadcrumb_home_label      : "Home"
   breadcrumb_separator       : "/"
-  menu_label                 : "Toggle Menu"
   toc_label                  : "On This Page"
   ext_link_label             : "Direct Link"
   less_than                  : "less than"
@@ -40,9 +39,6 @@ en: &DEFAULT_EN
   comment_success_msg        : "Thanks for your comment! It will show on the site once it has been approved."
   comment_error_msg          : "Sorry, there was an error with your submission. Please make sure all required fields have been completed and try again."
   loading_label              : "Loading..."
-  search_placeholder_text    : "Enter your search term..."
-  results_found              : "Result(s) found"
-  back_to_top                : "Back to top"
 en-US:
   <<: *DEFAULT_EN
 en-CA:
@@ -53,14 +49,13 @@ en-AU:
   <<: *DEFAULT_EN
 
 # Spanish
-# -------
+# --------------
 es: &DEFAULT_ES
   page                       : "Página"
   pagination_previous        : "Anterior"
   pagination_next            : "Siguiente"
   breadcrumb_home_label      : "Inicio"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "Contenidos"
   ext_link_label             : "Enlace"
   less_than                  : "menos de"
@@ -81,34 +76,33 @@ es: &DEFAULT_ES
   email_label                : "Email"
   recent_posts               : "Entradas recientes"
   undefined_wpm              : "Parametro words_per_minute (Palabras por minuto) no definido en _config.yml"
-  comment_form_info          : "Su dirección de correo no será publicada. Se han resaltado los campos requeridos"
+  comment_form_info          :
-  comment_form_comment_label : "Comentario"
+  comment_form_comment_label :
-  comment_form_md_info       : "Markdown está soportado."
+  comment_form_md_info       :
-  comment_form_name_label    : "Nombre"
+  comment_form_name_label    :
-  comment_form_email_label   : "Dirección de E-mail"
+  comment_form_email_label   :
-  comment_form_website_label : "Sitio web (opcional)"
+  comment_form_website_label :
-  comment_btn_submit         : "Enviar Commentario"
+  comment_btn_submit         :
-  comment_btn_submitted      : "Enviado"
+  comment_btn_submitted      :
-  comment_success_msg        : "Gracias por su comentario!, Este se visualizará en el sitio una vez haya sido aprobado"
+  comment_success_msg        :
-  comment_error_msg          : "Lo sentimos, ha ocurrido un error al enviar su comentario. Por favor asegurese que todos los campos han sido diligenciados e intente de nuevo"
+  comment_error_msg          :
-  loading_label              : "Cargando..."
+  loading_label              :
 es-ES:
   <<: *DEFAULT_ES
 es-CO:
   <<: *DEFAULT_ES
 
 # French
-# ------
+# -----------------
 fr: &DEFAULT_FR
   page                       : "Page"
   pagination_previous        : "Précédent"
   pagination_next            : "Suivant"
   breadcrumb_home_label      : "Accueil"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "Sur cette page"
   ext_link_label             : "Lien direct"
-  less_than                  : "moins de"
+  less_than                  : "plus petit que"
   minute_read                : "minute de lecture"
   share_on_label             : "Partager sur"
   meta_label                 :
@@ -118,8 +112,8 @@ fr: &DEFAULT_FR
   comments_label             : "Laisser un commentaire"
   comments_title             :
   more_label                 : "Lire plus"
-  related_label              : "Vous pourriez aimer aussi"
+  related_label              : "Vous pourriez aimer"
-  follow_label               : "Contact"
+  follow_label               : "Suivez moi"
   feed_label                 : "Flux"
   powered_by                 : "Propulsé par"
   website_label              : "Site"
@@ -135,7 +129,7 @@ fr: &DEFAULT_FR
   comment_form_website_label : "Site web (optionnel)"
   comment_btn_submit         : "Envoyer"
   comment_btn_submitted      : "Envoyé"
-  comment_success_msg        : "Merci pour votre commentaire, il sera visible sur le site une fois approuvé."
+  comment_success_msg        : "Merci pour votre comentaire, il sera visible sur le site une fois approuvé."
   comment_error_msg          : "Désolé, une erreur est survenue lors de la soumission. Vérifiez que les champs obligatoires ont été remplis et réessayez."
   loading_label              : "Chargement..."
 fr-FR:
@@ -146,14 +140,13 @@ fr-CH:
   <<: *DEFAULT_FR
 
 # Turkish
-# -------
+# -----------------
 tr: &DEFAULT_TR
   page                       : "Sayfa"
   pagination_previous        : "Önceki"
   pagination_next            : "Sonraki"
   breadcrumb_home_label      : "Ana Sayfa"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "İçindekiler"
   ext_link_label             : "Doğrudan Bağlantı"
   less_than                  : "Şu süreden az: "
@@ -189,14 +182,13 @@ tr-TR:
   <<: *DEFAULT_TR
 
 # Portuguese
-# ----------
+# -----------------
 pt: &DEFAULT_PT
   page                       : "Página"
   pagination_previous        : "Anterior"
   pagination_next            : "Seguinte"
   breadcrumb_home_label      : "Início"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "Nesta Página"
   ext_link_label             : "Link Direto"
   less_than                  : "menos de"
@@ -228,8 +220,6 @@ pt: &DEFAULT_PT
   comment_success_msg        : "Obrigado pelo seu comentário! Será visível no site logo que aprovado."
   comment_error_msg          : "Lamento, ocorreu um erro na sua submissão. Por favor verifique se todos os campos obrigatórios estão corretamente preenchidos e tente novamente."
   loading_label              : "A carregar..."
-pt-PT:
-  <<: *DEFAULT_PT
 # Brazilian Portuguese
 pt-BR:
   page                       : "Página"
@@ -237,11 +227,10 @@ pt-BR:
   pagination_next            : "Próxima"
   breadcrumb_home_label      : "Home"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "Nesta página"
   ext_link_label             : "Link direto"
-  less_than                  : "menos que"
+  less_than                  : "meno que"
-  minute_read                : "minuto(s) de leitura"
+  minute_read                : "minutos de leitura"
   share_on_label             : "Compartilhe em"
   meta_label                 :
   tags_label                 : "Tags:"
@@ -249,36 +238,37 @@ pt-BR:
   date_label                 : "Atualizado em:"
   comments_label             : "Deixe um comentário"
   comments_title             :
-  more_label                 : "Aprenda mais"
+  more_label                 : "Aprenda Mais"
-  related_label              : "Talvez você goste também"
+  related_label              : "Você Talvez Goste Também"
   follow_label               : "Acompanhe em"
   feed_label                 : "Feed"
   powered_by                 : "Feito com"
   website_label              : "Site"
   email_label                : "Email"
   recent_posts               : "Postagens recentes"
-  undefined_wpm              : "Parâmetro indefinido em words_per_minute no _config.yml"
+  undefined_wpm              : "Parâmetro indefinido em word_per_minute no _config.yml"
-  comment_form_info          : "Seu email não será publicado. Os campos obrigatórios estão marcados"
+  comment_form_info          :
-  comment_form_comment_label : "Comentário"
+  comment_form_comment_label :
-  comment_form_md_info       : "Markdown é suportado."
+  comment_form_md_info       :
-  comment_form_name_label    : "Nome"
+  comment_form_name_label    :
-  comment_form_email_label   : "Email"
+  comment_form_email_label   :
-  comment_form_website_label : "Site (opcional)"
+  comment_form_website_label :
-  comment_btn_submit         : "Enviar Comentário"
+  comment_btn_submit         :
-  comment_btn_submitted      : "Enviado"
+  comment_btn_submitted      :
-  comment_success_msg        : "Obrigado pelo seu comentário! Ele aparecerá no site assim que for aprovado."
+  comment_success_msg        :
-  comment_error_msg          : "Desculpe, ocorreu um erro no envio. Por favor verifique se todos os campos obrigatórios foram preenchidos e tente novamente."
+  comment_error_msg          :
-  loading_label              : "Carregando..."
+  loading_label              :
+pt-PT:
+  <<: *DEFAULT_PT
 
 # Italian
-# -------
+# -----------------
 it: &DEFAULT_IT
   page                       : "Pagina"
   pagination_previous        : "Precedente"
   pagination_next            : "Prossima"
   breadcrumb_home_label      : "Home"
   breadcrumb_separator       : "/"
-  menu_label                 :
   toc_label                  : "Indice della pagina"
   ext_link_label             : "Link"
   less_than                  : "meno di"
@@ -314,767 +304,52 @@ it-IT:
   <<: *DEFAULT_IT
 
 # Chinese  (zh-CN Chinese - China)
-# --------------------------------
+# -----------------
-zh: &DEFAULT_ZH_HANS
+zh: &DEFAULT_ZH
   page                       : "页面"
   pagination_previous        : "向前"
   pagination_next            : "向后"
   breadcrumb_home_label      : "首页"
   breadcrumb_separator       : "/"
-  menu_label                 : "切换菜单"
   toc_label                  : "在本页上"
   ext_link_label             : "直接链接"
   less_than                  : "少于"
-  minute_read                : "分钟读完"
+  minute_read                : "分钟 阅读"
   share_on_label             : "分享"
   meta_label                 :
   tags_label                 : "标签:"
   categories_label           : "分类:"
-  date_label                 : "更新时间:"
+  date_label                 : "最新的:"
   comments_label             : "留下评论"
   comments_title             : "评论"
   more_label                 : "了解更多"
   related_label              : "猜您还喜欢"
   follow_label               : "关注:"
   feed_label                 : "Feed"
-  powered_by                 : "技术来自于"
+  powered_by                 : "Powered by"
   website_label              : "网站"
-  email_label                : "电子邮箱"
+  email_label                : "Email"
   recent_posts               : "最新文章"
-  undefined_wpm              : "_config.yml配置中words_per_minute字段未定义"
-  comment_form_info          : "您的电子邮箱地址并不会被展示。请填写标记为必须的字段。"
-  comment_form_comment_label : "评论"
-  comment_form_md_info       : "Markdown语法已支持。"
-  comment_form_name_label    : "姓名"
-  comment_form_email_label   : "电子邮箱"
-  comment_form_website_label : "网站（可选）"
-  comment_btn_submit         : "提交评论"
-  comment_btn_submitted      : "已提交"
-  comment_success_msg        : "感谢您的评论！被批准后它会立即在此站点展示。"
-  comment_error_msg          : "很抱歉，您的提交存在错误。请确保所有必填字段都已填写正确，然后再试一次。"
-  loading_label              : "正在加载..."
-zh-CN:
-  <<: *DEFAULT_ZH_HANS
-zh-SG:
-  <<: *DEFAULT_ZH_HANS
-# Taiwan (Traditional Chinese)
-zh-TW: &DEFAULT_ZH_HANT
-  page                       : "頁面"
-  pagination_previous        : "較舊"
-  pagination_next            : "較新"
-  breadcrumb_home_label      : "首頁"
-  breadcrumb_separator       : "/"
-  menu_label                 : "切換選單"
-  toc_label                  : "本頁"
-  ext_link_label             : "外部連結"
-  less_than                  : "少於"
-  minute_read                : "分鐘閱讀"
-  share_on_label             : "分享到"
-  meta_label                 :
-  tags_label                 : "標籤:"
-  categories_label           : "分類:"
-  date_label                 : "更新時間:"
-  comments_label             : "留言"
-  comments_title             : "留言內容"
-  more_label                 : "了解更多"
-  related_label              : "猜您有與趣"
-  follow_label               : "追蹤:"
-  feed_label                 : "RSS Feed"
-  powered_by                 : "Powered by"
-  website_label              : "網站"
-  email_label                : "電子信箱"
-  recent_posts               : "最新文章"
-  undefined_wpm              : "_config.yml 中未定義 words_per_minute"
-  comment_form_info          : "您的電子信箱不會被公開. 必填部份已標記"
-  comment_form_comment_label : "留言內容"
-  comment_form_md_info       : "支援Markdown語法。"
-  comment_form_name_label    : "名字"
-  comment_form_email_label   : "電子信箱帳號"
-  comment_form_website_label : "網頁 (可選填)"
-  comment_btn_submit         : "送出留言"
-  comment_btn_submitted      : "已送出"
-  comment_success_msg        : "感謝您的留言！ 審核後將會顯示在站上。"
-  comment_error_msg          : "抱歉，部份資料輸入有問題。請確認資料填寫正確後再試一次。"
-  loading_label              : "載入中..."
-zh-HK:
-  <<: *DEFAULT_ZH_HANT
-
-# German / Deutsch
-# ----------------
-de: &DEFAULT_DE
-  page                       : "Seite"
-  pagination_previous        : "Vorherige"
-  pagination_next            : "Nächste"
-  breadcrumb_home_label      : "Start"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menü ein-/ausschalten"
-  toc_label                  : "Auf dieser Seite"
-  ext_link_label             : "Direkter Link"
-  less_than                  : "weniger als"
-  minute_read                : "Minuten zum lesen"
-  share_on_label             : "Teilen auf"
-  meta_label                 :
-  tags_label                 : "Tags:"
-  categories_label           : "Kategorien:"
-  date_label                 : "Aktualisiert:"
-  comments_label             : "Hinterlassen Sie einen Kommentar"
-  comments_title             : "Kommentare"
-  more_label                 : "Mehr anzeigen"
-  related_label              : "Ihnen gefällt vielleicht auch"
-  follow_label               : "Folgen:"
-  feed_label                 : "Feed"
-  powered_by                 : "Möglich durch"
-  website_label              : "Webseite"
-  email_label                : "E-Mail"
-  recent_posts               : "Aktuelle Beiträge"
-  undefined_wpm              : "Undefinierter Parameter words_per_minute in _config.yml"
-  comment_form_info          : "Ihre E-Mail Adresse wird nicht veröffentlicht. Benötigte Felder sind markiert"
-  comment_form_comment_label : "Kommentar"
-  comment_form_md_info       : "Markdown wird unterstützt."
-  comment_form_name_label    : "Name"
-  comment_form_email_label   : "E-Mail-Addresse"
-  comment_form_website_label : "Webseite (optional)"
-  comment_btn_submit         : "Kommentar absenden"
-  comment_btn_submitted      : "Versendet"
-  comment_success_msg        : "Danke für Ihren Kommentar! Er wird auf der Seite angezeigt, nachdem er geprüft wurde."
-  comment_error_msg          : "Entschuldigung, es gab einen Fehler. Bitte füllen Sie alle benötigten Felder aus und versuchen Sie es erneut."
-  loading_label              : "Lade..."
-  search_placeholder_text    : "Suchbegriff eingeben..."
-  results_found              : "Ergebnis(se) gefunden"
-de-DE:
-  <<: *DEFAULT_DE
-de-AT:
-  <<: *DEFAULT_DE
-de-CH:
-  <<: *DEFAULT_DE
-de-BE:
-  <<: *DEFAULT_DE
-de-LI:
-  <<: *DEFAULT_DE
-de-LU:
-  <<: *DEFAULT_DE
-
-# Nepali (Nepal)
-# --------------
-ne: &DEFAULT_NE
-  page                       : "पृष्‍ठ"
-  pagination_previous        : "अघिल्लो"
-  pagination_next            : "अर्को"
-  breadcrumb_home_label      : "गृह"
-  breadcrumb_separator       : "/"
-  menu_label                 : "टगल मेनु"
-  toc_label                  : "यो पृष्‍ठमा"
-  ext_link_label             : "सिधा सम्पर्क"
-  less_than                  : "कम्तिमा"
-  minute_read                : "मिनेट पढ्नुहोस्"
-  share_on_label             : "शेयर गर्नुहोस्"
-  meta_label                 :
-  tags_label                 : "ट्यागहरू:"
-  categories_label           : "वर्गहरु:"
-  date_label                 : "अद्यावधिक:"
-  comments_label             : "टिप्पणी दिनुहोस्"
-  comments_title             : "टिप्पणीहरू"
-  more_label                 : "अझै सिक्नुहोस्"
-  related_label              : "तपाईं रुचाउन सक्नुहुन्छ "
-  follow_label               : "पछ्याउनुहोस्:"
-  feed_label                 : "फिड"
-  powered_by                 : "Powered by"
-  website_label              : "वेबसाइट"
-  email_label                : "इमेल"
-  recent_posts               : "ताजा लेखहरु"
-  undefined_wpm              : "अपरिभाषित प्यारामिटर शब्दहरू_प्रति_मिनेट at _config.yml"
-  comment_form_info          : "तपाइँको इमेल ठेगाना प्रकाशित गरिने छैन।आवश्यक जानकारीहरुमा चिन्ह लगाइको छ"
-  comment_form_comment_label : "टिप्पणी"
-  comment_form_md_info       : "मार्कडाउन  समर्थित छ।"
-  comment_form_name_label    : "नाम"
-  comment_form_email_label   : "इमेल ठेगाना"
-  comment_form_website_label : "वेबसाइट (वैकल्पिक)"
-  comment_btn_submit         : "टिप्पणी दिनुहोस् "
-  comment_btn_submitted      : "टिप्पणी भयो"
-  comment_success_msg        : "तपाईंको टिप्पणीको लागि धन्यवाद! एक पटक यो अनुमोदन गरेपछी यो साइटमा देखाउनेछ।"
-  comment_error_msg          : "माफ गर्नुहोस्, तपाईंको टिप्पणी त्रुटि थियो।सबै आवश्यक जानकारीहरु पूरा गरिएको छ भने निश्चित गर्नुहोस् र फेरि प्रयास गर्नुहोस्।"
-  loading_label              : "लोड हुँदैछ ..."
-ne-NP:
-  <<: *DEFAULT_NE
-
-# Korean
-# ------
-ko: &DEFAULT_KO
-  page                       : "페이지"
-  pagination_previous        : "이전"
-  pagination_next            : "다음"
-  breadcrumb_home_label      : "Home"
-  breadcrumb_separator       : "/"
-  menu_label                 : "토글 메뉴"
-  toc_label                  : "On This Page"
-  ext_link_label             : "직접 링크"
-  less_than                  : "최대"
-  minute_read                : "분 소요"
-  share_on_label             : "공유하기"
-  meta_label                 :
-  tags_label                 : "태그:"
-  categories_label           : "카테고리:"
-  date_label                 : "업데이트:"
-  comments_label             : "댓글남기기"
-  comments_title             : "댓글"
-  more_label                 : "더 보기"
-  related_label              : "참고"
-  follow_label               : "팔로우:"
-  feed_label                 : "피드"
-  powered_by                 : "Powered by"
-  website_label              : "웹사이트"
-  email_label                : "이메일"
-  recent_posts               : "최근 포스트"
   undefined_wpm              : "Undefined parameter words_per_minute at _config.yml"
-  comment_form_info          : "이메일은 공개되지 않습니다. 작성 필요 필드:"
+  comment_form_info          : "Your email address will not be published. Required fields are marked"
-  comment_form_comment_label : "댓글"
+  comment_form_comment_label : "Comment"
-  comment_form_md_info       : "마크다운을 지원합니다."
+  comment_form_md_info       : "Markdown is supported."
-  comment_form_name_label    : "이름"
+  comment_form_name_label    : "Name"
-  comment_form_email_label   : "이메일"
+  comment_form_email_label   : "Email address"
-  comment_form_website_label : "웹사이트(선택사항)"
+  comment_form_website_label : "Website (optional)"
-  comment_btn_submit         : "댓글 등록"
+  comment_btn_submit         : "Submit Comment"
-  comment_btn_submitted      : "등록됨"
+  comment_btn_submitted      : "Submitted"
-  comment_success_msg        : "감사합니다! 댓글이 머지된 후 확인하실 수 있습니다."
+  comment_success_msg        : "Thanks for your comment! It will show on the site once it has been approved."
-  comment_error_msg          : "댓글 등록에 문제가 있습니다. 필요 필드를 작성했는지 확인하고 다시 시도하세요."
+  comment_error_msg          : "Sorry, there was an error with your submission. Please make sure all required fields have been completed and try again."
-  loading_label              : "로딩중..."
+  loading_label              : "Loading..."
-ko-KR:
+  zh-CN:
-  <<: *DEFAULT_KO
+    <<: *DEFAULT_ZH
-
+  zh-HK:
-# Russian / Русский
+    <<: *DEFAULT_ZH
-# -----------------
+  zh-SG:
-ru: &DEFAULT_RU
+    <<: *DEFAULT_ZH
-  page                       : "Страница"
+  zh-TW:
-  pagination_previous        : "Предыдущая"
+    <<: *DEFAULT_ZH
-  pagination_next            : "Следующая"
-  breadcrumb_home_label      : "Главная"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Выпадающее меню"
-  toc_label                  : "Содержание"
-  ext_link_label             : "Прямая ссылка"
-  less_than                  : "менее"
-  minute_read                : "мин на чтение"
-  share_on_label             : "Поделиться"
-  meta_label                 :
-  tags_label                 : "Метки:"
-  categories_label           : "Разделы:"
-  date_label                 : "Дата изменения:"
-  comments_label             : "Оставить комментарий"
-  comments_title             : "Комментарии"
-  more_label                 : "Читать далее"
-  related_label              : "Вам также может понравиться"
-  follow_label               : "Связаться со мной:"
-  feed_label                 : "RSS-лента"
-  powered_by                 : "Сайт работает на"
-  website_label              : "Сайт"
-  email_label                : "Электронная почта"
-  recent_posts               : "Свежие записи"
-  undefined_wpm              : "Не определён параметр words_per_minute в _config.yml"
-  comment_form_info          : "Ваш адрес электронной почты не будет опубликован. Обязательные поля помечены"
-  comment_form_comment_label : "Комментарий"
-  comment_form_md_info       : "Поддерживается синтаксис Markdown."
-  comment_form_name_label    : "Имя"
-  comment_form_email_label   : "Электронная почта"
-  comment_form_website_label : "Ссылка на сайт (необязательно)"
-  comment_btn_submit         : "Оставить комментарий"
-  comment_btn_submitted      : "Отправлено"
-  comment_success_msg        : "Спасибо за Ваш комментарий! Он будет опубликован на сайте после проверки."
-  comment_error_msg          : "К сожалению, произошла ошибка с отправкой комментария. Пожалуйста, убедитесь, что все обязательные поля заполнены и попытайтесь снова."
-  loading_label              : "Отправка..."
-  search_placeholder_text    : "Введите поисковый запрос..."
-  results_found              : "Найдено"
-ru-RU:
-  <<: *DEFAULT_RU
-
-# Lithuanian / Lietuviškai
-# ------------------------
-lt: &DEFAULT_LT
-  page                       : "Puslapis"
-  pagination_previous        : "Ankstesnis"
-  pagination_next            : "Sekantis"
-  breadcrumb_home_label      : "Pagrindinis"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Meniu rodymas"
-  toc_label                  : "Turinys"
-  ext_link_label             : "Tiesioginė nuoroda"
-  less_than                  : "mažiau nei"
-  minute_read                : "min. skaitymo"
-  share_on_label             : "Pasidalinti"
-  meta_label                 :
-  tags_label                 : "Žymės:"
-  categories_label           : "Kategorijos:"
-  date_label                 : "Atnaujinta:"
-  comments_label             : "Palikti komentarą"
-  comments_title             : "Komentaras"
-  more_label                 : "Skaityti daugiau"
-  related_label              : "Taip pat turėtų patikti"
-  follow_label               : "Sekti:"
-  feed_label                 : "Šaltinis"
-  powered_by                 : "Sukurta su"
-  website_label              : "Tinklapis"
-  email_label                : "El. paštas"
-  recent_posts               : "Naujausi įrašai"
-  undefined_wpm              : "Nedeklaruotas parametras words_per_minute faile _config.yml"
-  comment_form_info          : "El. pašto adresas nebus viešinamas. Būtini laukai pažymėti."
-  comment_form_comment_label : "Komentaras"
-  comment_form_md_info       : "Markdown palaikomas."
-  comment_form_name_label    : "Vardas"
-  comment_form_email_label   : "El. paštas"
-  comment_form_website_label : "Tinklapis (nebūtina)"
-  comment_btn_submit         : "Komentuoti"
-  comment_btn_submitted      : "Įrašytas"
-  comment_success_msg        : "Ačiū už komentarą! Jis bus parodytas kai bus patvirtintas."
-  comment_error_msg          : "Atleiskite, įvyko netikėta klaida įrašant komentarą. Pasitikrinkite ar užpildėte visus būtinus laukus ir pamėginkite dar kartą."
-  loading_label              : "Kraunama..."
-lt-LT:
-  <<: *DEFAULT_LT
-
-# Greek
-# -----
-gr: &DEFAULT_GR
-  page                       : "Σελίδα"
-  pagination_previous        : "Προηγούμενo"
-  pagination_next            : "Επόμενo"
-  breadcrumb_home_label      : "Αρχική"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Μενού"
-  toc_label                  : "Περιεχόμενα"
-  ext_link_label             : "Εξωτερικός Σύνδεσμος"
-  less_than                  : "Λιγότερο από"
-  minute_read                : "λεπτά ανάγνωσης"
-  share_on_label             : "Μοιραστείτε το"
-  meta_label                 :
-  tags_label                 : "Ετικέτες:"
-  categories_label           : "Κατηγορίες:"
-  date_label                 : "Ενημερώθηκε:"
-  comments_label             : "Αφήστε ένα σχόλιο"
-  comments_title             : "Σχόλια"
-  more_label                 : "Διάβαστε περισσότερα"
-  related_label              : "Σχετικές αναρτήσεις"
-  follow_label               : "Ακολουθήστε:"
-  feed_label                 : "RSS Feed"
-  powered_by                 : "Δημιουργήθηκε με"
-  website_label              : "Ιστοσελίδα"
-  email_label                : "Email"
-  recent_posts               : "Τελευταίες αναρτήσεις"
-  undefined_wpm              : "Δεν έχει οριστεί η παράμετρος words_per_minute στο αρχείο _config.yml"
-  comment_form_info          : "Η διεύθυνση email σας δεν θα δημοσιευθεί. Τα απαιτούμενα πεδία εμφανίζονται με αστερίσκο"
-  comment_form_comment_label : "Σχόλιο"
-  comment_form_md_info       : "Το πεδίο υποστηρίζει Markdown."
-  comment_form_name_label    : "Όνομα"
-  comment_form_email_label   : "Διεύθυνση email"
-  comment_form_website_label : "Ιστοσελίδα (προαιρετικό)"
-  comment_btn_submit         : "Υπόβαλε ένα σχόλιο"
-  comment_btn_submitted      : "Έχει υποβληθεί"
-  comment_success_msg        : "Ευχαριστούμε για το σχόλιό σας! Θα εμφανιστεί στην ιστοσελίδα αφού εγκριθεί."
-  comment_error_msg          : "Λυπούμαστε, παρουσιάστηκε σφάλμα με την υποβολή σας. Παρακαλούμε βεβαιωθείτε ότι έχετε όλα τα απαιτούμενα πεδία συμπληρωμένα και δοκιμάστε ξανά."
-  loading_label              : "Φόρτωση..."
-  search_placeholder_text    : "Εισάγετε όρο αναζήτησης..."
-  results_found              : "Αποτελέσματα"
-gr-GR:
-  <<: *DEFAULT_GR
-
-# Swedish
-# -------
-sv: &DEFAULT_SV
-  page                       : "Sidan"
-  pagination_previous        : "Föregående"
-  pagination_next            : "Nästa"
-  breadcrumb_home_label      : "Hem"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Meny ridå"
-  toc_label                  : "På denna sida"
-  ext_link_label             : "Direkt länk"
-  less_than                  : "mindre än"
-  minute_read                : "minut läsning"
-  share_on_label             : "Dela på"
-  meta_label                 :
-  tags_label                 : "Taggar:"
-  categories_label           : "Kategorier:"
-  date_label                 : "Uppdaterades:"
-  comments_label             : "Lämna en kommentar"
-  comments_title             : "Kommentarer"
-  more_label                 : "Lär dig mer"
-  related_label              : "Du kanske vill även läsa:"
-  follow_label               : "Följ:"
-  feed_label                 : "Flöde"
-  powered_by                 : "Framställd med"
-  website_label              : "Webbsida"
-  email_label                : "E-post"
-  recent_posts               : "Senaste inlägg"
-  undefined_wpm              : "Odefinerade parametrar words_per_minute i _config.yml"
-  comment_form_info          : "Din e-post adress kommer inte att publiceras. Obligatoriska fält är markerade."
-  comment_form_comment_label : "Kommentar"
-  comment_form_md_info       : "Använd Markdown för text-formateringen."
-  comment_form_name_label    : "Namn"
-  comment_form_email_label   : "E-post adress"
-  comment_form_website_label : "Webdsida (valfritt)"
-  comment_btn_submit         : "Skicka en kommentar"
-  comment_btn_submitted      : "Kommentaren har tagits emot"
-  comment_success_msg        : "Tack för din kommentar! Den kommer att visas på sidan så fort den har godkännts."
-  comment_error_msg          : "Tyvärr det har blivit något fel i en av fälten, se till att du fyller i alla rutor och försök igen."
-  loading_label              : "Laddar..."
-sv-SE:
-  <<: *DEFAULT_SV
-sv-FI:
-  <<: *DEFAULT_SV
-
-# Dutch
-# -----
-nl: &DEFAULT_NL
-  page                       : "Pagina"
-  pagination_previous        : "Vorige"
-  pagination_next            : "Volgende"
-  breadcrumb_home_label      : "Home"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Wissel Menu"
-  toc_label                  : "Op deze pagina"
-  ext_link_label             : "Directe Link"
-  less_than                  : "minder dan"
-  minute_read                : "minuut gelezen"
-  share_on_label             : "Deel op"
-  meta_label                 :
-  tags_label                 : "Labels:"
-  categories_label           : "Categorieën:"
-  date_label                 : "Bijgewerkt:"
-  comments_label             : "Laat een reactie achter"
-  comments_title             : "Commentaren"
-  more_label                 : "Meer informatie"
-  related_label              : "Bekijk ook eens"
-  follow_label               : "Volg:"
-  feed_label                 : "Feed"
-  powered_by                 : "Aangedreven door"
-  website_label              : "Website"
-  email_label                : "Email"
-  recent_posts               : "Recente berichten"
-  undefined_wpm              : "Niet gedefinieerde parameter words_per_minute bij _config.yml"
-  comment_form_info          : "Uw e-mailadres wordt niet gepubliceerd. Verplichte velden zijn gemarkeerd"
-  comment_form_comment_label : "Commentaar"
-  comment_form_md_info       : "Markdown wordt ondersteund."
-  comment_form_name_label    : "Naam"
-  comment_form_email_label   : "E-mailadres"
-  comment_form_website_label : "Website (optioneel)"
-  comment_btn_submit         : "Commentaar toevoegen"
-  comment_btn_submitted      : "Toegevoegd"
-  comment_success_msg        : "Bedankt voor uw reactie! Het zal op de site worden weergegeven zodra het is goedgekeurd."
-  comment_error_msg          : "Sorry, er is een fout opgetreden bij uw inzending. Zorg ervoor dat alle vereiste velden zijn voltooid en probeer het opnieuw."
-  loading_label              : "Laden..."
-nl-BE:
-  <<: *DEFAULT_NL
-nl-NL:
-  <<: *DEFAULT_NL
-
-# Indonesian
-# ----------
-id: &DEFAULT_ID
-  page                       : "Halaman"
-  pagination_previous        : "Kembali"
-  pagination_next            : "Maju"
-  breadcrumb_home_label      : "Home"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menu Toggle"
-  toc_label                  : "Pada Halaman Ini"
-  ext_link_label             : "Link langsung"
-  less_than                  : "Kurang dari"
-  minute_read                : "Waktu baca"
-  share_on_label             : "Berbagi di"
-  meta_label                 :
-  tags_label                 : "Golongan:"
-  categories_label           : "Kategori:"
-  date_label                 : "Diupdate:"
-  comments_label             : "Tinggalkan komentar"
-  comments_title             : "Komentar"
-  more_label                 : "Pelajari lagi"
-  related_label              : "Anda juga akan suka"
-  follow_label               : "Ikuti:"
-  feed_label                 : "Feed"
-  powered_by                 : "Didukung oleh"
-  website_label              : "Website"
-  email_label                : "Email"
-  recent_posts               : "Posting terbaru"
-  undefined_wpm              : "Parameter terdeskripsi words_per_minute di _config.yml"
-  comment_form_info          : "Email Anda tidak akan dipublish. Kolom yang diperlukan ditandai"
-  comment_form_comment_label : "Komentar"
-  comment_form_md_info       : "Markdown disupport."
-  comment_form_name_label    : "Nama"
-  comment_form_email_label   : "Alamat email"
-  comment_form_website_label : "Website (opsional)"
-  comment_btn_submit         : "Submit Komentar"
-  comment_btn_submitted      : "Telah disubmit"
-  comment_success_msg        : "Terimakasih atas komentar Anda! Komentar ini akan tampil setelah disetujui."
-  comment_error_msg          : "Maaf, ada kesalahan pada submisi Anda. Pastikan seluruh kolom sudah dilengkapi dan coba kembali."
-  loading_label              : "Sedang meload..."
-id-ID:
-  <<: *DEFAULT_ID
-
-# Vietnamese
-# ----------
-vi: &DEFAULT_VI
-  page                       : "Trang"
-  pagination_previous        : "Trước"
-  pagination_next            : "Sau"
-  breadcrumb_home_label      : "Trang chủ"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menu"
-  toc_label                  : "Tại trang này"
-  ext_link_label             : "Đường dẫn trực tiếp"
-  less_than                  : "nhỏ hơn"
-  minute_read                : "phút đọc"
-  share_on_label             : "Chia sẻ tại"
-  meta_label                 :
-  tags_label                 : "Nhãn:"
-  categories_label           : "Chủ đề:"
-  date_label                 : "Cập nhật:"
-  comments_label             : "Để lại bình luận"
-  comments_title             : "Bình luận"
-  more_label                 : "Mở rộng"
-  related_label              : "Có thể bạn cũng thích"
-  follow_label               : "Theo dõi:"
-  feed_label                 : "Feed"
-  powered_by                 : "Được hỗ trợ bởi"
-  website_label              : "Website"
-  email_label                : "Email"
-  recent_posts               : "Bài viết mới"
-  undefined_wpm              : "Chưa định nghĩa thông số words_per_minute tại _config.yml"
-  comment_form_info          : "Email của bạn sẽ được giữ bí mật. Các phần bắt buộc được đánh dấu."
-  comment_form_comment_label : "Bình luận"
-  comment_form_md_info       : "Hỗ trợ Markdown."
-  comment_form_name_label    : "Tên"
-  comment_form_email_label   : "Địa chỉ email"
-  comment_form_website_label : "Website (không bắt buộc)"
-  comment_btn_submit         : "Gửi bình luận"
-  comment_btn_submitted      : "Đã được gửi"
-  comment_success_msg        : "Cảm ơn bạn đã bình luận! Bình luận sẽ xuất hiện sau khi được duyệt."
-  comment_error_msg          : "Rất tiếc, có lỗi trong việc gửi bình luận. Hãy đảm bảo toàn bộ các phần bắt buộc đã được điền đầy đủ và thử lại."
-  loading_label              : "Đang tải..."
-vi-VN:
-  <<: *DEFAULT_VI
-
-# Danish
-# ------
-da: &DEFAULT_DA
-  page                       : "Side"
-  pagination_previous        : "Forrige"
-  pagination_next            : "Næste"
-  breadcrumb_home_label      : "Home"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Vis/skjul menu"
-  toc_label                  : "På denne side"
-  ext_link_label             : "Direkte link"
-  less_than                  : "mindre end"
-  minute_read                : "minutters læsning"
-  share_on_label             : "Del på"
-  meta_label                 :
-  tags_label                 : "Nøgleord:"
-  categories_label           : "Kategorier:"
-  date_label                 : "Opdateret:"
-  comments_label             : "Skriv en kommentar"
-  comments_title             : "Kommentarer"
-  more_label                 : "Lær mere"
-  related_label              : "Måske kan du også lide"
-  follow_label               : "Følg:"
-  feed_label                 : "Feed"
-  powered_by                 : "Drives af"
-  website_label              : "Website"
-  email_label                : "E-mail"
-  recent_posts               : "Seneste indlæg"
-  undefined_wpm              : "Parameteren words_per_minute er ikke defineret i _config.yml"
-  comment_form_info          : "Din e-mail bliver ikke offentliggjort. Obligatoriske felter er markeret"
-  comment_form_comment_label : "Kommentar"
-  comment_form_md_info       : "Markdown er understøttet."
-  comment_form_name_label    : "Navn"
-  comment_form_email_label   : "E-mail"
-  comment_form_website_label : "Website (frivillig)"
-  comment_btn_submit         : "Send kommentar"
-  comment_btn_submitted      : "Sendt"
-  comment_success_msg        : "Tak for din kommentar! Den bliver vist på siden, så snart den er godkendt."
-  comment_error_msg          : "Desværre skete der en fejl. Prøv igen, mens du sørger for at alle obligatoriske felter er udfyldt."
-  loading_label              : "Indlæser..."
-  search_placeholder_text    : "Hvad leder du efter..."
-  results_found              : "Resultat(er) fundet"
-  back_to_top                : "Tilbage til toppen"
-da-DK:
-  <<: *DEFAULT_DA
-
-# Polish
-# ------
-pl: &DEFAULT_PL
-  page                       : "Strona"
-  pagination_previous        : "Poprzednia"
-  pagination_next            : "Następna"
-  breadcrumb_home_label      : "Strona główna"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Przełącz menu"
-  toc_label                  : "Spis treści"
-  ext_link_label             : "Link bezpośredni"
-  less_than                  : "mniej niż"
-  minute_read                : "minut(y)"
-  share_on_label             : "Udostępnij"
-  meta_label                 :
-  tags_label                 : "Tagi:"
-  categories_label           : "Kategorie:"
-  date_label                 : "Ostatnia aktualizacja:"
-  comments_label             : "Zostaw komentarz"
-  comments_title             : "Komentarze"
-  more_label                 : "Dowiedz się więcej"
-  related_label              : "Także może Ci się spodobać"
-  follow_label               : "Śledź:"
-  feed_label                 : "Feed"
-  powered_by                 : "Powstało dzięki"
-  website_label              : "Strona"
-  email_label                : "Email"
-  recent_posts               : "Najnowsze wpisy"
-  undefined_wpm              : "Parametr words_per_minute nie został zdefiniowany w _config.yml."
-  comment_form_info          : "Twój adres email nie będzie udostępiony. Wymagane pola są oznaczone."
-  comment_form_comment_label : "Skomentuj"
-  comment_form_md_info       : "Markdown jest wspierany"
-  comment_form_name_label    : "Imię"
-  comment_form_email_label   : "Adres email"
-  comment_form_website_label : "Strona www (opcjonalna)"
-  comment_btn_submit         : "Skomentuj"
-  comment_btn_submitted      : "Komentarz dodany"
-  comment_success_msg        : "Dziękuję za Twój komentarz! Zostanie dodany po akceptacji."
-  comment_error_msg          : "Niestety wystąpił błąd. Proszę upewnij się, że wszystkie wymagane pola zostały wypełnione i spróbuj ponownie."
-  loading_label              : "Trwa ładowanie strony..."
-pl-PL:
-  <<: *DEFAULT_PL
-
-# Japanese
-# --------
-ja: &DEFAULT_JA
-  page                       : "ページ"
-  pagination_previous        : "前へ"
-  pagination_next            : "次へ"
-  breadcrumb_home_label      : "ホーム"
-  breadcrumb_separator       : "/"
-  menu_label                 : "メニュー"
-  toc_label                  : "目次"
-  ext_link_label             : "リンク"
-  less_than                  :
-  minute_read                :
-  share_on_label             : "共有"
-  meta_label                 :
-  tags_label                 : "タグ:"
-  categories_label           : "カテゴリー:"
-  date_label                 : "更新日時:"
-  comments_label             : "コメントする"
-  comments_title             : "コメント"
-  more_label                 : "さらに詳しく"
-  related_label              : "関連記事"
-  follow_label               : "フォロー"
-  feed_label                 :
-  powered_by                 :
-  website_label              :
-  email_label                :
-  recent_posts               : "最近の投稿"
-  undefined_wpm              : "パラメータ words_per_minute が _config.yml で定義されていません"
-  comment_form_info          : "メールアドレスが公開されることはありません。次の印のある項目は必ず入力してください:"
-  comment_form_comment_label : "コメント"
-  comment_form_md_info       : "Markdown を使用できます"
-  comment_form_name_label    : "名前"
-  comment_form_email_label   : "メールアドレス"
-  comment_form_website_label : "URL (任意)"
-  comment_btn_submit         : "コメントを送信する"
-  comment_btn_submitted      : "送信しました"
-  comment_success_msg        : "コメントありがとうございます！　コメントは承認されるとページに表示されます。"
-  comment_error_msg          : "送信エラーです。必須項目がすべて入力されていることを確認して再送信してください。"
-  loading_label              : "読み込み中..."
-  search_placeholder_text    : "検索キーワードを入力してください..."
-  results_found              : "件"
-ja-JP:
-  <<: *DEFAULT_JA
-
-# Slovak
-# -----------------
-sk: &DEFAULT_SK
-  page                       : "Stránka"
-  pagination_previous        : "Predošlá"
-  pagination_next            : "Ďalšia"
-  breadcrumb_home_label      : "Domov"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menu"
-  toc_label                  : "Obsah"
-  ext_link_label             : "Priamy odkaz"
-  less_than                  : "menej ako"
-  minute_read                : "minút"
-  share_on_label             : "Zdieľaj na"
-  meta_label                 :
-  tags_label                 : "Tagy:"
-  categories_label           : "Kategórie:"
-  date_label                 : "Aktualizované:"
-  comments_label             : "Zanechaj odkaz"
-  comments_title             : "Komentáre"
-  more_label                 : "Dozvedieť sa viac"
-  related_label              : "Podobné články"
-  follow_label               : "Sleduj:"
-  feed_label                 : "Zoznam"
-  powered_by                 : "Stránka vytvorená pomocou"
-  website_label              : "Web stránka"
-  email_label                : "Email"
-  recent_posts               : "Najnovšie príspevky"
-  undefined_wpm              : "Nedefinovaný parameter words_per_minute v _config.yml"
-  comment_form_info          : "Tvoja emailová adresa nebude publikovaná. Požadované polia sú označené"
-  comment_form_comment_label : "Komentár"
-  comment_form_md_info       : "Markdown je podporovaný."
-  comment_form_name_label    : "Meno"
-  comment_form_email_label   : "Emailová adresa"
-  comment_form_website_label : "Webstránka (voliteľné)"
-  comment_btn_submit         : "Vlož komentár"
-  comment_btn_submitted      : "Vložený"
-  comment_success_msg        : "Ďakujem za tvoj komentár! Po schválení bude zobrazený na stránke."
-  comment_error_msg          : "Prepáč, pri ukladaní nastala chyba. Ubezpeč sa prosím, že si vyplnil všetky požadované polia a skús znova."
-  loading_label              : "Načítava sa..."
-  search_placeholder_text    : "Zadaj hľadaný výraz..."
-  results_found              : "Nájdených výsledkov"
-  back_to_top                : "Na začiatok stránky"
-sk-SK:
-  <<: *DEFAULT_SK
-
-# Hungarian
-# -----------------
-hu: &DEFAULT_HU
-  page                       : "Oldal"
-  pagination_previous        : "Előző"
-  pagination_next            : "Következő"
-  breadcrumb_home_label      : "Kezdőlap"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menü nyit/zár"
-  toc_label                  : "Ezen az oldalon"
-  ext_link_label             : "Közvetlen Link"
-  less_than                  : "kevesebb mint"
-  minute_read                : "eltöltött percek"
-  share_on_label             : "Megosztás"
-  meta_label                 :
-  tags_label                 : "Tagek:"
-  categories_label           : "Kategóriák:"
-  date_label                 : "Frissítve:"
-  comments_label             : "Szólj hozzá!"
-  comments_title             : "Hozzászólások"
-  more_label                 : "Tovább"
-  related_label              : "Ajánlások"
-  follow_label               : "Követés:"
-  feed_label                 : "Folyam"
-  powered_by                 : "Powered by"
-  website_label              : "Honlap"
-  email_label                : "Email"
-  recent_posts               : "Friss cikkek"
-  undefined_wpm              : "Ismeretlen paraméter words_per_minute : _config.yml"
-  comment_form_info          : "Az e-mail címed nem lesz publikus. A csillagozott mezők kitöltése kötelező."
-  comment_form_comment_label : "Hozzászólás"
-  comment_form_md_info       : "Támogatott formázási mód: Markdown"
-  comment_form_name_label    : "Név"
-  comment_form_email_label   : "Email cím"
-  comment_form_website_label : "Honlap (nem kötelező):"
-  comment_btn_submit         : "Hozzászólás elküldése"
-  comment_btn_submitted      : "Hozzászólás elküldve"
-  comment_success_msg        : "Köszönjük a Hozzászólást! A Hozzászólások csak előzetes moderáció után lesznek publikusak."
-  comment_error_msg          : "Hoppá, hiba történt a beküldés közben. Kérlek ellenőrizd hogy minden kötelező mező ki van-e töltve."
-  loading_label              : "Betöltés..."
-  search_placeholder_text    : "Keresendő szöveg..."
-  results_found              : "Találatok:"
-  back_to_top                : "Oldal tetejére"
-hu-HU:
-  <<: *DEFAULT_HU
 
 # Another locale
 # --------------
-#

_docs/01-quick-start-guide.md

@@ -0,0 +1,47 @@
+---
+title: "Quick-Start Guide"
+permalink: /docs/quick-start-guide/
+excerpt: "How to quickly install and setup Minimal Mistakes for use with GitHub Pages."
+modified: 2016-04-13T15:54:02-04:00
+redirect_from:
+  - /theme-setup/
+---
+
+{% include base_path %}
+
+Minimal Mistakes has been developed to be 100% compatible with hosting a site on [GitHub Pages](https://pages.github.com/). To get up and running with a new GitHub repository quickly, follow these steps or jump ahead to the [full installation guide]({{ base_path }}/docs/installation/).
+
+## Fork the Theme
+
+Fork the [Minimal Mistakes theme](https://github.com/mmistakes/minimal-mistakes/fork), then rename the repo to **USERNAME.github.io** --- replacing **USERNAME** with your GitHub username.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-theme-fork-repo.png" alt="fork Minimal Mistakes">
+</figure>
+
+**Note:** Your Jekyll site should be viewable immediately at <http://USERNAME.github.io>. If it's not, you can force a rebuild by **Customizing Your Site** (see below for more details).
+{: .notice--warning}
+
+If you're hosting several Jekyll based sites under the same GitHub username you will have to use Project Pages instead of User Pages. Essentially you rename the repo to something other than **USERNAME.github.io** and create a `gh-pages` branch off of `master`. For more details on how to set things up check [GitHub's documentation](https://help.github.com/articles/user-organization-and-project-pages/).
+
+<figure>
+  <img src="{{ base_path }}/images/mm-gh-pages.gif" alt="creating a new branch on GitHub">
+</figure>
+
+**ProTip:** Be sure to [delete](https://github.com/blog/1377-create-and-delete-branches) the `gh-pages` branch if you forked Minimal Mistakes. This branch contains the documentation and demo site for the theme and you probably don't want that showing up in your repo.
+{: .notice--info}
+
+## Customize Your Site
+
+Open up `_config.yml` found in the root of the repo and edit anything under **Site Settings**. For a full explanation of every setting be sure to read the [**Configuration**]({{ base_path }}/docs/configuration/) section, but for now let's just change the site's title.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-github-edit-config.gif" alt="editing _config.yml file">
+  <figcaption>Edit text files without leaving GitHub.com</figcaption>
+</figure>
+
+Committing a change to `_config.yml` (or any file in your repository) will force GitHub Pages to rebuild your site with Jekyll. It should then be viewable a few seconds later at `https://USERNAME.github.io`.
+
+---
+
+Congratulations! You've successfully forked the theme and are up an running with GitHub Pages. Now you're ready to add content and customize the site further.

_docs/02-structure.md

@@ -2,14 +2,11 @@
 title: "Structure"
 permalink: /docs/structure/
 excerpt: "How the theme is organized and what all of the files are for."
-last_modified_at: 2018-03-20T15:19:22-04:00
+modified: 2016-08-08T16:25:30-04:00
 ---
 
 Nothing clever here :wink:. Layouts, data files, and includes are all placed in their default locations. Stylesheets and scripts in `assets`, and a few development related files in the project's root directory.
 
-**Please note:** If you installed Minimal Mistakes via the Ruby Gem method, theme files like `_layouts`, `_includes`, `_sass`, and `/assets/` will be missing. This is normal as they are bundled with the [`minimal-mistakes-jekyll`](https://rubygems.org/gems/minimal-mistakes-jekyll) Ruby gem.
-{: .notice--info}
-
 ```bash
 minimal-mistakes
 ├── _data                      # data files for customizing the theme
@@ -29,31 +26,26 @@ minimal-mistakes
 |  └── ...
 ├── _layouts
 |  ├── archive-taxonomy.html   # tag/category archive for Jekyll Archives plugin
-|  ├── archive.html            # archive base
+|  ├── archive.html            # archive listing documents in an array
-|  ├── categories.html         # archive listing posts grouped by category
-|  ├── category.html           # archive listing posts grouped by specific category
-|  ├── collection.html         # archive listing documents in a specific collection
 |  ├── compress.html           # compresses HTML in pure Liquid
 |  ├── default.html            # base for all other layouts
-|  ├── home.html               # home page
-|  ├── posts.html              # archive listing posts grouped by year
-|  ├── search.html             # search page
 |  ├── single.html             # single document (post/page/etc)
-|  ├── tag.html                # archive listing posts grouped by specific tag
-|  ├── tags.html               # archive listing posts grouped by tags
 |  └── splash.html             # splash page
 ├── _sass                      # SCSS partials
 ├── assets
 |  ├── css
 |  |  └── main.scss            # main stylesheet, loads SCSS partials from _sass
-|  ├── images                  # image assets for posts/pages/collections/etc.
+|  ├── fonts
+|  |  └── fontawesome-webfont  # Font Awesome webfonts
 |  ├── js
 |  |  ├── plugins              # jQuery plugins
 |  |  ├── vendor               # vendor scripts
 |  |  ├── _main.js             # plugin settings and other scripts to load after jQuery
 |  |  └── main.min.js          # optimized and concatenated script file loaded before </body>
+├── images                     # image assets for posts/pages/collections/etc.
 ├── _config.yml                # site configuration
 ├── Gemfile                    # gem file dependencies
+├── Gemfile.lock               # gem file dependencies
 ├── index.html                 # paginated home page showing recent posts
 └── package.json               # NPM build scripts
 ```

_docs/03-installation.md

@@ -2,26 +2,32 @@
 title: "Installation"
 permalink: /docs/installation/
 excerpt: "Instructions for installing the theme for new and existing Jekyll based sites."
-last_modified_at: 2018-03-20T15:59:00-04:00
+modified: 2016-08-01T09:36:36-04:00
-toc: true
 ---
 
+{% include base_path %}
+
 ## Install the Theme
 
-**1.** For a **new site**, install the `minimal-mistakes-jekyll` theme gem or fork the Minimal Mistakes repo on GitHub following the steps outlined in the [*Quick-Start Guide*]({{ "/docs/quick-start-guide/" | relative_url }}).
+There are several ways to install the theme:
 
-If you plan to host with GitHub Pages be sure to properly setup [**jekyll-remote-theme**](https://github.com/benbalter/jekyll-remote-theme) as it is required for the theme to work properly. 
+**1.** For a **new site**, fork the Minimal Mistakes repo on GitHub. If you plan on hosting your site with GitHub Pages follow the steps outlined in the [*Quick-Start Guide*]({{ base_path }}/docs/quick-start-guide/).
 
-**2.** For an **existing site** follow the steps outlined in the [*Quick-Start Guide*]({{ "/docs/quick-start-guide/" | relative_url }}). Then work through the guidelines below for migration and setup.
+**2.** For an **existing site** you have some more work ahead of you. What I suggest is to fork and rename the theme's repo as before, then clone it locally by running `git clone https://github.com/USERNAME/REPONAME.git` --- replacing **USERNAME** and **REPONAME** with your own.
 
-**3.** And for those who'd like to make substantial edits to the theme, it can be downloaded as a ZIP file to customize.
+<figure>
+  <img src="{{ base_path }}/images/mm-github-copy-repo-url.jpg" alt="copy GitHub repo URL">
+  <figcaption>Tap the copy to clipboard button (outlined in red above) to grab your GitHub repo's path.</figcaption>
+</figure>
 
-[<i class="fas fa-download"></i> Download Minimal Mistakes Theme](https://github.com/mmistakes/minimal-mistakes/archive/master.zip){: .btn .btn--success}
+**3.** And for those who don't want to mess with Git, you can download the theme as a ZIP file to work with locally.
 
-**ProTip:** Be sure to remove `/docs` and `/test` if you forked or downloaded Minimal Mistakes. These folders contain documentation and test pages for the theme and you probably don't littering up in your repo.
+[<i class="fa fa-download"></i> Download Minimal Mistakes Theme](https://github.com/mmistakes/minimal-mistakes/archive/master.zip){: .btn .btn--success}
+
+**ProTip:** Be sure to [delete](https://github.com/blog/1377-create-and-delete-branches) the `gh-pages` branch if you forked Minimal Mistakes. This branch contains the documentation and demo site for the theme and you probably don't want that showing up in your repo.
 {: .notice--info}
 
-## Theme Migration
+---
 
 To move over any existing content you'll want to copy the contents of your `_posts` folder to the new site. Along with any pages, collections, data files, images, or other assets you may have.
 
@@ -52,54 +58,19 @@ defaults:
 
 If this is your first time using Jekyll be sure to read through the [official documentation](https://jekyllrb.com/docs/home/) before jumping in. This guide assumes you have Ruby v2 installed and a basic understanding of how Jekyll works.
 
-To keep your sanity and better manage dependencies I strongly urge you to [install Bundler](http://bundler.io/) with `gem install bundler` and use the following `Gemfile`:
+To keep your sanity and better manage dependencies I strongly urge you to [install Bundler](http://bundler.io/) with `gem install bundler` and use the included [`Gemfile`](https://github.com/{{ site.repository }}/blob/master/Gemfile). The theme's Gemfile includes the `github-pages` gem to maintain a local Jekyll environment in sync with GitHub Pages.
 
-```ruby
+If you're not planning to host with GitHub Pages and want to leverage features found in the latest version of Jekyll, uncomment the `gem "jekyll"` line in your `Gemfile`. In either case run the following:
-source "https://rubygems.org"
-
-# Hello! This is where you manage which Jekyll version is used to run.
-# When you want to use a different version, change it below, save the
-# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
-#
-#     bundle exec jekyll serve
-#
-# This will help ensure the proper Jekyll version is running.
-# Happy Jekylling!
-
-# gem "github-pages", group: :jekyll_plugins
-
-# To upgrade, run `bundle update`.
-
-gem "jekyll", "~> 3.5"
-gem "minimal-mistakes-jekyll"
-
-# The following plugins are automatically loaded by the theme-gem:
-#   gem "jekyll-paginate"
-#   gem "jekyll-sitemap"
-#   gem "jekyll-gist"
-#   gem "jekyll-feed"
-#   gem "jemoji"
-#   gem "jekyll-data"
-#
-# If you have any other plugins, put them here!
-group :jekyll_plugins do
-end
-```
-
-**ProTip:** To be bleeding edge install the latest (unreleased) version of Minimal Mistakes by adding this line to your `Gemfile`: `gem "minimal-mistakes-jekyll", :github => "mmistakes/minimal-mistakes"`.
-{: .notice--info}
-
-To maintain a local Jekyll environment in sync with GitHub Pages replace the `gem "jekyll"` line with `gem "github-pages", group: :jekyll_plugins` and run the following:
 
 ```bash
 $ bundle install
 ```
 
-**Note:** The [GitHub Pages gem](https://github.com/github/pages-gem) installs additional dependencies that may need to be added to your `Gemfile` if you decide to remove the `gem "github-pages"` eg. `jekyll-paginate`, `jekyll-sitemap`, `jekyll-feed`, etc.
+**Note:** The [GitHub Pages gem](https://github.com/github/pages-gem) installs additional dependencies that may need to be added to your `Gemfile` if you decide to remove the `gem "github-pages"`.
 {: .notice--warning}
 
 <figure>
-  <img src="{{ '/assets/images/mm-bundle-install.gif' | relative_url }}" alt="bundle install in Terminal window">
+  <img src="{{ base_path }}/images/mm-bundle-install.gif" alt="bundle install in Terminal window">
 </figure>
 
 Depending on what gems you already have installed you may have to run `bundle update` to clear up any dependency issues. Bundler is usually pretty good at letting you know what gems need updating or have issues installing, to further investigate.

_docs/04-upgrading.md

@@ -0,0 +1,50 @@
+---
+title: "Upgrading"
+permalink: /docs/upgrading/
+excerpt: "Instructions and suggestions for upgrading the theme."
+modified: 2016-08-01T09:43:46-04:00
+---
+
+{% include base_path %}
+
+Currently there is no good way of upgrading the theme without doing a bit of manual work. The future looks promising now that [**gem based themes**](https://jekyllrb.com/docs/themes/) have landed with Jekyll `v3.2`, but for now here's some suggestions on how to handle updates.
+
+**Gemified Theme**: A future version of Minimal Mistakes will suppor the new Jekyll theme system. A few key features like theme assets (eg. fonts, images, and JavaScript) and support for GitHub Pages are currently missing for this enhancement to happen now. Stay tuned!
+{: .notice--info}
+
+## Use Git
+
+If you want to get the most out of the Jekyll + GitHub Pages workflow, then you'll need to utilize Git. To pull down theme updates you must first ensure there's an upstream remote. If you forked the theme's repo then you're likely good to go.
+
+To double check, run `git remote -v` and verify that you can fetch from `origin https://github.com/{{ site.repository }}.git`.
+
+To add it you can do the following:
+
+```bash
+$ git remote add upstream https://github.com/{{ site.repository }}.git
+```
+
+### Pull Down Updates
+
+Now you can pull any commits made to theme's `master` branch with:
+
+```bash
+$ git pull upstream master
+```
+
+Depending on the amount of customizations you've made after forking, there's likely to be merge conflicts. Work through any conflicting files Git flags, staging the changes you wish to keep, and then commit them.
+
+## Update Files Manually
+
+Another way of dealing with updates is [downloading the theme](https://github.com/{{ site.repository }}/archive/master.zip) --- replacing your layouts, includes, and assets with the newer ones manually. To be sure that you don't miss any changes it's probably a good idea to review the theme's [commit history](https://github.com/{{ site.repository }}/commits/master) to see what's changed since.
+
+Here's a quick checklist of the important folders/files you'll want to be mindful of:
+
+| Name                   |     |
+| ----                   | --- |
+| `_layouts`             | Replace all. Apply edits if you customized any layouts. |
+| `_includes`            | Replace all. Apply edits if you customized any includes. |
+| `assets`               | Replace all. Apply edits if you customized stylesheets or scripts. |
+| `_data/navigation.yml` | Safe to keep. Verify that there were no major structural changes or additions. |
+| `_data/ui-text.yml`    | Safe to keep. Verify that there were no major structural changes or additions. |
+| `_config.yml`          | Safe to keep. Verify that there were no major structural changes or additions. |

_docs/05-configuration.md

@@ -0,0 +1,613 @@
+---
+title: "Configuration"
+permalink: /docs/configuration/
+excerpt: "Settings for configuring and customizing the theme."
+modified: 2016-08-21T17:19:29-04:00
+---
+
+{% include base_path %}
+
+Settings that affect your entire site can be changed in [Jekyll's configuration file](https://jekyllrb.com/docs/configuration/): `_config.yml`, found in the root of your project.
+
+**Note:** for technical reasons, `_config.yml` is NOT reloaded automatically when used with `jekyll serve`. If you make any changes to this file, please restart the server process for them to be applied.
+{: .notice--warning}
+
+Take a moment to look over the configuration file included with the theme. Comments have been added to provide examples and default values for most settings. Detailed explanations of each can be found below.
+
+## Site Settings
+
+### Site Locale
+
+`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 `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**]({{ base_path }}/docs/ui-text/) data file. An improper match will cause parts of the UI to disappear (eg. button labels, section headings, etc).
+
+**Note:** The theme comes with localized text in English (`en`, `en-US`, `en-GB`). If you change `locale` in `_config.yml` to something else, most of the UI text will go blank. Be sure to add the corresponding locale key and translated text to `_data/ui-text.yml` to avoid this.
+{: .notice--warning}
+
+### Site Title
+
+The name of your site. Is used throughout the theme in places like the site masthead and `<title>` tags.
+
+*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`.
+
+### Site Name
+
+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"`.
+
+**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}
+
+### Site Description
+
+Fairly obvious. `site.description` describes the site. Used predominantly in meta descriptions as part of SEO efforts.
+
+*Example:* `description: "A flexible Jekyll theme for your blog or site with a minimalist aesthetic."`
+
+### Site URL
+
+The base hostname and protocol for your site. If you're hosting with GitHub Pages this will be something like `url: "https://github.io.mmistakes"` or `url: "https://mademistakes.com"` if you have a custom domain name.
+
+**Note:** It's important to remember that when testing locally you need to change the `site.url`, I recommend `url: "http://localhost:4000"` to keep paths pointing to local pages and assets. Ideally you'd use [multiple config files](https://mademistakes.com/articles/using-jekyll-2016/#environments-and-configurations) with `bundle exec jekyll serve --config _config.yml,_config.dev.yml` to apply development overrides.
+{: .notice--warning}
+
+**ProTip:** To force GitHub hosted sites to [redirect http traffic to https](https://konklone.com/post/github-pages-now-sorta-supports-https-so-use-it) use a service like [Cloudflare](https://www.cloudflare.com/).
+{: .notice--info}
+
+### Site Base URL
+
+This little option causes all kinds of confusion in the Jekyll community. If you're not hosting your site as a GitHub Pages Project or in a subfolder (eg: `/blog`), then don't mess with it.
+
+In the case of the Minimal Mistakes demo site it's hosted on GitHub at <https://mmistakes.github.io/minimal-mistakes>. To correctly set this base path I'd use `url: "https://mmistakes.github.io"` and `baseurl: "/minimal-mistakes"`.
+
+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`.
+{: .notice--warning}
+
+### Site Repository
+
+Add your repository name with organization to your site's configuration file, `_config.yml`.
+
+```yaml
+repository: "username/repo-name"
+```
+
+"NWO" stands for "name with owner." It is GitHub lingo for the username of the owner of the repository plus a forward slash plus the name of the repository, e.g. '**mmistakes/minimal-mistakes**', where '**mmistakes**' is the owner and **'minimal-mistakes**' is the repository name.
+
+Your `site.github.*` fields should fill in like normal. If you run Jekyll with the --verbose flag, you should be able to see all the API calls made.
+
+If you don't set `repository` correctly you may see the following error when trying to `serve` or `build` your Jekyll site:
+
+**Liquid Exceptions:** No repo name found. Specify using `PAGES_REPO_NWO` environment variables, `repository` in your configuration, or set up `origin` git remote pointing to your github.com repository.
+{: .notice--danger}
+
+For more information on how `site.github` data can be used with Jekyll check out [`github-metadata`'s documentation](https://github.com/jekyll/github-metadata).
+
+### Site Default Teaser Image
+
+To assign a fallback teaser image used in the "**Related Posts**" module, place a graphic in the `/images/` directory and add the filename to `_config.yml` like so:
+
+```yaml
+teaser: "500x300.png"
+```
+
+This image can be overridden at anytime by applying the following to a document's YAML Front Matter.
+
+```yaml
+header:
+  teaser: my-awesome-post-teaser.jpg
+```
+
+<figure>
+  <img src="{{ base_path }}/images/mm-teaser-images-example.jpg" alt="teaser image example">
+  <figcaption>Example of teaser images found in the related posts module.</figcaption>
+</figure>
+
+### Breadcrumb Navigation (Beta)
+
+Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results:
+
+1. Use a category based permalink structure e.g. `permalink: /:categories/:title/`
+2. Manually create pages for each category or use a plugin like [jekyll-archives][jekyll-archives] to auto-generate them. If these pages don't exist breadcrumb links to them will be broken.
+
+![breadcrumb navigation example]({{ base_path }}/images/mm-breadcrumbs-example.jpg)
+
+```yaml
+breadcrumbs: true  # disabled by default
+```
+
+Breadcrumb start link text and separator character can both be changed in the [UI Text data file]({{ base_path }}/docs/ui-text/).
+
+### 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_minutes: ` in `_config.yml`.
+
+![reading time example]({{ base_path }}/images/mm-read-time-example.jpg)
+
+Instead of adding `read_time: true` to each post, apply as a default in `_config.yml` like so:
+
+```yaml
+defaults:
+  # _posts
+  - scope:
+      path: ""
+      type: posts
+    values:
+      read_time: true
+```
+
+To disable reading time for a post, add `read_time: false` its YAML Front Matter to override what was set in `_config.yml`.
+
+### Comments
+
+[**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 |
+| **google-plus** | Google+ Comments  |
+| **staticman**   | Staticman         |
+| **custom**      | Other             |
+
+Then add `comments: true` to each document you want comments visible on.
+
+Instead of adding YAML Front Matter to each document, apply as a default in `_config.yml`. To enable comments for all posts:
+
+```yaml
+defaults:
+  # _posts
+  - scope:
+      path: ""
+      type: posts
+    values:
+      comments: true
+```
+
+If you add `comments: false` to a post's YAML Front Matter it will override the default and disable comments for just that post.
+
+##### 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:
+
+```yaml
+comments:
+  provider: "disqus"
+  disqus:
+    shortname: "your-disqus-shortname"
+```
+
+##### Discourse
+
+For guidance on how to set up Discourse for embedding comments from a topic on a post page, [consult this guide](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963).
+
+```yaml
+comments:
+  provider               : "discourse"
+  discourse:
+    server               : # meta.discourse.org
+```
+  
+
+##### Facebook Comments
+
+To enable Facebook Comments choose how many comments you'd like visible per post and the color scheme of the widget.
+
+```yaml
+comments:
+  provider               : "facebook"
+  facebook:
+    appid                : # optional
+    num_posts            : # 5 (default)
+    colorscheme          : # "light" (default), "dark"
+```
+
+##### Static-Based Comments via Staticman
+
+Transform user comments into `_data` files that live inside of your GitHub repository by enabling Staticman.
+
+###### Add Staticman as a Collaborator
+
+1. Allow Staticman push access to your GitHub repository by clicking on **Settings**, then the **Collaborators** tab and adding `staticmanapp` as a collaborator.
+2. To accept the pending invitation visit: `https://api.staticman.net/v1/connect/{your GitHub username}/{your repository name}`. Consult the Staticman "[Get Started](https://staticman.net/get-started)" guide for more info.
+
+###### Configure Staticman
+
+Default settings have been provided in `_config.yml`. The important ones to set are  `provider: "staticman"` and `branch`. View the [full list of configurations](https://github.com/eduardoboucas/staticman#jekyll-configuration).
+
+**Branch setting:** This is the branch comment files will be sent to via pull requests. If you host your site on GitHub Pages it will likely be `master` unless your repo is setup as a project --- use `gh-pages` in that case.
+{: .notice--info}
+
+```yaml
+comments:
+  provider: "staticman"
+staticman:
+  allowedFields          : ['name', 'email', 'url', 'message']
+  branch                 : # "master", "gh-pages"
+  commitMessage          : "New comment."
+  filename               : comment-{@timestamp}
+  format                 : "yml"
+  moderation             : true
+  path                   : "_data/comments/{options.slug}"
+  requiredFields         : ['name', 'email', 'message']
+  transforms:
+    email                : "md5"
+  generatedFields:
+    date:
+      type               : "date"
+      options:
+        format           : "iso8601" # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds"
+```
+
+###### Comment Moderation
+
+By default comment moderation is enabled in `_config.yml`. As new comments are submitted Staticman will send a pull request. Merging these in will approve the comment, close the issue, and automatically rebuild your site (if hosted on GitHub Pages).
+
+To skip this moderation step simply set `moderation: false`.
+
+**ProTip:** Create a GitHub webhook that sends a `POST` request to the following payload URL `https://api.staticman.net/v1/webhook` and triggers a "Pull request" event to delete Staticman branches on merge.
+{: .notice--info}
+
+![pull-request webhook]({{ base_path }}/images/mm-staticman-pr-webhook.jpg)
+
+##### Other Comment Providers
+
+To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/comments-providers/custom.html`.
+
+### Custom Feed URL
+
+By default the theme links to `feed.xml` generated in the root of your site by the **jekyll-feed** plugin. To link to an externally hosted feed update `atom_feed` in `_config.yml` like so:
+
+```yaml
+atom_feed:
+  path: "http://feeds.feedburner.com/youFeedname"
+```
+
+**Note:** By default the site feed is linked in two locations: inside the [`<head>` element]({{ gh_repo }}/master/_includes/head.html) and at the bottom of every page in the [site footer](https://github.com/{{ site.repository }}/master/_includes/footer.html).
+{: .notice--info}
+
+### 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.
+
+#### Google Search Console
+
+Formerly known as [Google Webmaster Tools](https://www.google.com/webmasters/tools/), add your [verification code](https://support.google.com/analytics/answer/1142414?hl=en) like so: `google_site_verification: "yourVerificationCode"`.
+
+**Note:** You likely won't have to do this if you verify site ownership through **Google Analytics** instead.
+{: .notice--warning}
+
+#### Bing Webmaster Tools
+
+There are several ways to [verify site ownership](https://www.bing.com/webmaster/help/how-to-verify-ownership-of-your-site-afcfefc6) --- the easiest adding an authentication code to your config file.
+
+Copy and paste the string inside of `content`:
+
+```html
+<meta name="msvalidate.01" content="0FC3FD70512616B052E755A56F8952D" />
+```
+
+Into `_config.yml`
+
+```yaml
+bing_site_verification: "0FC3FD70512616B052E755A56F8952D"
+```
+
+#### 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 `name`:
+
+```html
+<meta name='yandex-verification' content='2132801JL' />
+```
+
+Into `_config.yml`
+
+```yaml
+yandex_site_verification: "2132801JL"
+```
+
+#### Twitter Cards and Facebook Open Graph
+
+To improve the appearance of links shared from your site to social networks like Twitter and Facebook be sure to configure the following.
+
+##### Site Twitter Username
+
+Twitter username for the site. For pages that have custom author Twitter accounts assigned in their YAML Front Matter or data file, they will be attributed as a **creator** in the Twitter Card. 
+
+For example if my site's Twitter account is `@mmistakes-theme` I would add the following to `_config.yml`
+
+```yaml
+twitter:
+  username: "mmistakes-theme"
+```
+
+And if I assign `@mmistakes` as an author account it will appear in the Twitter Card along with `@mmistakes-theme`, attributed as a creator of the page being shared.
+
+**Note**: You need to [apply for Twitter Cards](https://dev.twitter.com/docs/cards) and validate they're working on your site before they will begin showing up.
+{: .notice--warning}
+
+##### Facebook Open Graph
+
+If you have a Facebook ID or publisher page add them:
+
+```yaml
+facebook:
+  app_id:  # A Facebook app ID
+  publisher:  # A Facebook page URL or ID of the publishing entity
+```
+
+While not part a part of Open Graph, you can also add your Facebook username for use in the sidebar and footer.
+
+```yaml
+facebook:
+  username: "michaelrose"  # https://www.facebook.com/michaelrose
+```
+
+**ProTip:** To debug Open Graph data use [this tool](https://developers.facebook.com/tools/debug/og/object?q=https%3A%2F%2Fmademistakes.com) to test your pages. If content changes aren't reflected you will probably have to hit the **Fetch new scrape information** button to refresh.
+{: .notice--info}
+
+##### Open Graph Default Image
+
+For pages that don't have a `header.image` assigned in their YAML Front Matter, `site.og_image` will be used as a fallback. Use your logo, icon, avatar or something else that is meaningful. Just make sure it is place in the `/images/` folder, a minimum size of 120px by 120px, and less than 1MB in file size.
+
+```yaml
+og_image: "site-logo.png"
+```
+
+<figure>
+  <img src="{{ base_path }}/images/mm-twitter-card-summary-image.jpg" alt="Twitter Card summary example">
+  <figcaption>Example of a image placed in a Summary Card.</figcaption>
+</figure>
+
+Documents who have a `header.image` assigned in their YAML Front Matter will appear like this when shared on Twitter and Facebook.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-twitter-card-summary-large.jpg" alt="page shared on Twitter">
+  <figcaption>Shared page on Twitter with header image assigned.</figcaption>
+</figure>
+
+<figure>
+  <img src="{{ base_path}}/images/facebook-share-example.jpg" alt="page shared on Facebook">
+  <figcaption>Shared page on Facebook with header image assigned.</figcaption>
+</figure>
+
+##### Include your social profile in search results
+
+Use markup on your official website to add your [social profile information](https://developers.google.com/structured-data/customize/social-profiles#adding_structured_markup_to_your_site) to the Google Knowledge panel in some searches. Knowledge panels can prominently display your social profile information.
+
+```yaml
+social:
+  type:  # Person or Organization (defaults to Person)
+  name:  # If the user or organization name differs from the site's name
+  links:
+    - "https://twitter.com/yourTwitter"
+    - "https://facebook.com/yourFacebook"
+    - "https://instagram.com/yourProfile"
+    - "https://www.linkedin.com/in/yourprofile"
+    - "https://plus.google.com/your_profile"
+```
+
+#### Analytics
+
+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                                       |
+
+For Google Analytics add your Tracking Code:
+
+```yaml
+analytics:
+  provider: "google-universal"
+    tracking_id: "UA-1234567-8"
+```
+
+To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/analytics-providers/custom.html`.
+
+## Site Author
+
+Used as the defaults for defining what appears in the author sidebar.
+
+![author sidebar example]({{ base_path }}/images/mm-author-sidebar-example.jpg)
+
+**Note:** For sites with multiple authors these values can be overridden post by post with custom YAML Front Matter and a data file. For more information on how that works see below.
+{: .notice--info}
+
+```yaml
+author:
+  name   : "Your Name"
+  avatar : "bio-photo.jpg"  # placed in /images/
+  bio    : "My awesome biography constrained to a sentence or two goes here."
+  email  : # optional
+  uri    : "http://your-site.com"
+```
+
+Social media links are all optional, include the ones you want visible. In most cases you just need to add the username. If you're unsure double check `_includes/author-profile.html` to see how the URL is constructed.
+
+To add social media links not included with the theme or customize the author sidebar further, read the full [layout documentation]({{ base_path }}/docs/layouts/#author-profile).
+
+## Reading Files
+
+Nothing out of the ordinary here. `include` and `exclude` may be the only things you need to alter.
+
+## Conversion and Markdown Processing
+
+Again nothing out of the ordinary here as the theme adheres to the defaults used by GitHub Pages. [**Kramdown**](http://kramdown.gettalong.org/) for Markdown conversion, [**Rouge**](http://rouge.jneen.net/) syntax highlighting, and incremental building disabled. Change them if you need to.
+
+## Front Matter Defaults
+
+To save yourself time setting [Front Matter Defaults](https://jekyllrb.com/docs/configuration/#front-matter-defaults) for posts, pages, and collections is the way to go. Sure you can assign layouts and toggle settings like **reading time**, **comments**, and **social sharing** in each file, but that's not ideal.
+
+Using the `default` key in `_config.yml` you could set the layout and enable author profiles, reading time, comments, social sharing, and related posts for all posts --- in one shot.
+
+```yaml
+defaults:
+  # _posts
+  - scope:
+      path: ""
+      type: posts
+    values:
+      layout: single
+      author_profile: true
+      read_time: true
+      comments: true
+      share: true
+      related: true
+```
+
+Pages Front Matter defaults can be scoped like this:
+
+```yaml
+defaults:
+  # _pages
+  - scope:
+      path: ""
+      type: pages
+    values:
+      layout: single
+```
+
+And collections like this:
+
+```yaml
+defaults:
+  # _foo
+  - scope:
+      path: ""
+      type: foo
+    values:
+      layout: single
+```
+
+And of course any default value can be overridden by settings in a post, page, or collection file. All you need to do is specify the settings in the YAML Front Matter. For more examples be sure to check out the demo site's [`_config.yml`](https://github.com/{{ site.repository }}/gh-pages/_config.yml).
+
+## Outputting
+
+The default permalink style used by the theme is `permalink: /:categories/:title/`. If you have a post named `2016-01-01-my-post.md` with `categories: foo` in the YAML Front Matter, Jekyll will generate `_site/foo/my-post/index.html`.
+
+**Note:** If you plan on enabling breadcrumb links --- including category names in permalinks is a big part of how those are created.
+{: .notice--warning}
+
+### Paginate
+
+If [using pagination](https://github.com/jekyll/jekyll-paginate) on the homepage you can change the amount of posts shown with:
+
+```yaml
+paginate: 5
+```
+
+You'll also need to include some Liquid and HTML to properly use the paginator, which you can find in the **Layouts** section under [Home Page]({{ base_path }}/docs/layouts/#home-page).
+
+### Timezone
+
+This sets the timezone environment variable, which Ruby uses to handle time and date creation and manipulation. Any entry from the [IANA Time Zone Database](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones) is valid. The default is the local time zone, as set by your operating system.
+
+```yaml
+timezone: America/New_York
+```
+
+## Plugins
+
+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-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. |
+
+[jekyll-paginate]: https://github.com/jekyll/jekyll-paginate
+[jekyll-sitemap]: https://github.com/jekyll/jekyll-sitemap
+[jekyll-gist]: https://github.com/jekyll/jekyll-gist
+[jekyll-feed]: https://github.com/jekyll/jekyll-feed
+[jemoji]: https://github.com/jekyll/jemoji
+
+If you're hosting elsewhere then you don't really have to worry about what is whitelisted as you are free to include whatever [Jekyll plugins](https://jekyllrb.com/docs/plugins/) you desire.
+
+## 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.
+
+[jekyll-archives]: https://github.com/jekyll/jekyll-archives
+
+The default `type` is set to use Liquid.
+
+**Note:** `category_archive` and `tag_archive` were previously named `categories` and `tags`. Names were changed to avoid possible conflicts with `site.categories` and `site.tags`.
+{: .notice--danger}
+
+```yaml
+category_archive:
+  type: liquid
+  path: /categories/
+tag_archive:
+  type: liquid
+  path: /tags/
+```
+
+Which would create category and tag links in the breadcrumbs and page meta like: `/categories/#foo` and `/tags/#foo`.
+
+**Note:** for these links to resolve properly, category and tag index pages need to exist at [`/categories/index.html`](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/category-archive.html) and [`/tags/index.html`](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/tag-archive.html). The necessary Liquid code to build these pages can be taken from the demo site.
+{: .notice--warning}
+
+If you have the luxury of using Jekyll Plugins then [**jekyll-archives**][jekyll-archives] will make your life much easier as category and tag pages are created for you.
+
+Change `type` to `jekyll-archives` and apply the following [configurations](https://github.com/jekyll/jekyll-archives/blob/master/docs/configuration.md):
+
+```yaml
+category_archive:
+  type: jekyll-archives
+  path: /categories/
+tag_archive:
+  type: jekyll-archives
+  path: /tags/
+jekyll-archives:
+  enabled:
+    - categories
+    - tags
+  layouts:
+    category: archive-taxonomy
+    tag: archive-taxonomy
+  permalinks:
+    category: /categories/:name/
+    tag: /tags/:name/
+```
+
+**Note:** The `archive-taxonomy` layout used by jekyll-archives is provided with the theme and can be found in the `_layouts` folder.
+{: .notice--info}
+
+## HTML Compression
+
+If you care at all about performance (and really who doesn't) compressing the HTML files generated by Jekyll is a good thing to do.
+
+If you're hosting with GitHub Pages there aren't many options afforded to you for optimizing the HTML Jekyll generates. Thankfully there is some Liquid wizardry you can use to strip whitespace and comments to reduce file size.
+
+There's a variety of configurations and cavets to using the `compress` layout, so be sure to read through the [documentation](http://jch.penibelst.de/) if you decide to make change the defaults set in the theme's `_config.yml`.
+
+```yaml
+compress_html:
+  clippings: all
+  ignore:
+    envs: development  # disable compression in dev environment
+```
+
+**Caution:** Inline JavaScript comments can cause problems with `compress.html`, so be sure to `/* comment this way */` and avoid `// these sorts of comments`.

_docs/06-navigation.md

@@ -2,10 +2,11 @@
 title: "Navigation"
 permalink: /docs/navigation/
 excerpt: "Instructions on how to customize the main navigation and enabling breadcrumb links."
-last_modified_at: 2018-03-20T15:59:40-04:00
+modified: 2016-08-31T11:00:35-04:00
-toc: true
 ---
 
+{% include base_path %}
+
 ## Masthead
 
 The masthead links use a "priority plus" design pattern. Meaning, show as many navigation items that will fit horizontally with a toggle to reveal the rest.
@@ -16,25 +17,29 @@ To define these links add titles and URLs under the `main` key in `_data/navigat
 main:
   - title: "Quick-Start Guide"
     url: /docs/quick-start-guide/
+
   - title: "Posts"
     url: /year-archive/
+
   - title: "Categories"
     url: /categories/
+
   - title: "Tags"
     url: /tags/
+
   - title: "Pages"
     url: /page-archive/
+
   - title: "Collections"
     url: /collection-archive/
+
   - title: "External Link"
     url: https://google.com
 ```
 
 Which will give you a responsive masthead similar to this:
 
-![priority plus masthead animation]({{ "/assets/images/mm-priority-plus-masthead.gif" | relative_url }})
+![priority plus masthead animation]({{ base_path }}/images/mm-priority-plus-masthead.gif)
-
-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}
@@ -46,7 +51,7 @@ Enable breadcrumb links to help visitors better navigate deep sites. Because of
 1. Use a category based permalink structure e.g. `permalink: /:categories/:title/`
 2. Manually create pages for each category or use a plugin like [jekyll-archives](https://github.com/jekyll/jekyll-archives) to auto-generate them. If these pages don't exist breadcrumb links to them will be broken.
 
-![breadcrumb navigation example]({{ "/assets/images/mm-breadcrumbs-example.jpg" | relative_url }})
+![breadcrumb navigation example]({{ base_path }}/images/mm-breadcrumbs-example.jpg)
 
 ```yaml
 breadcrumbs: true  # disabled by default
@@ -68,4 +73,4 @@ breadcrumb_separator  : ">"
 
 ## Custom Sidebar Navigation Menu
 
-See the [**sidebars** documentation]({{ "/docs/layouts/#custom-sidebar-navigation-menu" | relative_url }}) for information on setting up a custom navigation menu.
+See the [**sidebars** documentation]({{ base_path }}/docs/layouts/#custom-sidebar-navigation-menu) for information on setting up a custom navigation menu.

_docs/07-ui-text.md

@@ -0,0 +1,31 @@
+---
+title: "UI Text"
+permalink: /docs/ui-text/
+excerpt: "Text for customizing various user interface elements found in the theme."
+modified: 2016-04-27T10:35:05-04:00
+---
+
+{% include base_path %}
+
+Text for various UI elements, `_layouts`, and `_includes` have all been grouped together as a set of translation keys. This is by no means a full-on i18n solution, but it does help make customizing things a bit easier.
+
+Currently the English[^yaml-anchors] main keys in `_data/ui-text.yml` are translated to the following languages:
+
+* Brazilian Portguese (Português brasileiro)
+* Chinese
+* French (Français)
+* German (Deutsch)
+* Italian (Italiano)
+* Spanish (Español)
+* Turkish (Türkçe)
+
+If you're are interested in localizing them into other languages feel free to submit a pull request and I will be happy to look it over.
+
+[^yaml-anchors]: `en-US`, and `en-GB` use [YAML anchors](http://www.yaml.org/spec/1.2/spec.html#id2785586) to reference the values in `en` as to not repeat them.
+
+Many of the label based keys like `meta_label`, `categories_label`, `tags_label`, `share_on_label`, and `follow_label` can be left blank if you'd like to omit them from view. It really depends on you and if you want an even more minimal look to your site.
+
+![UI text labels]({{ base_path }}/images/mm-ui-text-labels.jpg)
+
+**Note:** The theme comes with localized text in English (`en`, `en-US`, `en-GB`). If you change `locale` in `_config.yml` to something else, most of the UI text will go blank. Be sure to add the corresponding locale key and translated text to `_data/ui-text.yml` to avoid this.
+{: .notice--warning}

_docs/08-authors.md

@@ -2,9 +2,11 @@
 title: "Authors"
 permalink: /docs/authors/
 excerpt: "Instructions and settings for working with multiple site authors."
-last_modified_at: 2016-11-03T10:55:15-04:00
+modified: 2016-04-13T15:54:02-04:00
 ---
 
+{% include base_path %}
+
 Sites that may have content authored from various individuals can be accommodated by using [data files](https://jekyllrb.com/docs/datafiles/).
 
 To assign an author to a post or page that is different from the site author specified in `_config.yml`:
@@ -19,14 +21,14 @@ Billy Rick:
   uri: "http://thewhip.com"
   email: "billy@rick.com"
   bio: "What do you want, jewels? I am a very extravagant man."
-  avatar: "/assets/images/bio-photo-2.jpg"
+  avatar: "bio-photo-2.jpg"
   twitter: "extravagantman"
 
 Cornelius Fiddlebone:
   name: "Cornelius Fiddlebone"
   email: "cornelius@thewhip.com"
   bio: "I ordered what?"
-  avatar: "/assets/images/bio-photo.jpg"
+  avatar: "bio-photo.jpg"
   twitter: "rhymeswithsackit"
 ```
 

_docs/09-layouts.md

@@ -0,0 +1,573 @@
+---
+title: "Layouts"
+permalink: /docs/layouts/
+excerpt: "Descriptions and samples of all layouts included with the theme and how to best use them."
+single_layout_gallery:
+  - image_path: mm-layout-single-header.png
+    alt: "single layout with header example"
+  - image_path: mm-layout-single-meta.png
+    alt: "single layout with comments and related posts"
+modified: 2016-09-15T15:09:22-04:00
+---
+
+{% include base_path %}
+{% include toc icon="columns" title="Included Layouts" %}
+
+The bread and butter of any theme. Below you'll find the layouts included with Minimal Mistakes, what they look like and the type of content they've been built for.
+
+## Default Layout
+
+The base layout all other layouts inherit from. There's not much to this layout apart from pulling in several `_includes`:
+
+* `<head>` elements
+* masthead navigation links
+* {% raw %}`{{ content }}`{% endraw %}
+* page footer
+* scripts
+
+**Note:** You won't ever assign this layout directly to a post or page. Instead all other layouts will build off of it by setting `layout: default` in their YAML Front Matter.
+{: .notice--warning}
+
+### Layout Based and User-Defined Classes
+
+Class names corresponding to each layout are automatically added to the `<body>` element eg. `<body class="layout--single">`.
+
+| layout | class name |
+| ------ | ---------- |
+| archive | `.layout--archive` |
+| archive-taxonomy | `.layout--archive-taxonomy` |
+| single | `.layout--single` |
+| splash | `.layout--splash` |
+
+Using YAML Front Matter you can also assign custom classes to target with CSS or JavaScript. Perfect for "art directed" posts or adding custom styles to specific pages.
+
+Example:
+
+```yaml
+---
+layout: splash
+classes:
+  - landing
+  - dark-theme
+---
+```
+
+Outputs:
+
+```html
+<body class="layout--splash landing dark-theme">
+```
+
+## Compress Layout
+
+A Jekyll layout that compresses HTML in pure Liquid. To enable add `layout: compress` to `_layouts/default.html`.
+
+**Note:** Has been known to mangle markup and break JavaScript... especially if inline `// comments` are present. For this reason it has been disabled by default.
+{: .notice--danger}
+
+* [Documentation](http://jch.penibelst.de/)
+
+## Single Layout
+
+The layout you'll likely use the most --- sidebar and main content combo.
+
+**Includes:**
+
+* Optional header image with caption
+* Optional header overlay (solid color/image) + text and optional "call to action" button
+* Optional social sharing links module
+* Optional comments module
+* Optional related posts module
+
+{% include gallery id="single_layout_gallery" caption="Image header and meta info examples for `single` layout" %}
+
+Assign with `layout: single`, or better yet apply as a [Front Matter default]({{ base_path }}/docs/configuration/#front-matter-defaults) in `_config.yml`.
+
+## Archive Layout
+
+Essentially the same as `single` with markup adjustments and some modules removed.
+
+**Includes:**
+
+* Optional header image with caption
+* Optional header overlay (solid color/image) + text and optional "call to action" button
+* List and grid views
+
+<figure>
+  <img src="{{ base_path }}/images/mm-layout-archive.png" alt="archive layout example">
+  <figcaption>List view example.</figcaption>
+</figure>
+
+Below are sample archive pages you can easily drop into your project, taking care to rename `permalink`, `title`, or the filename to fit your site. Each is 100% compatible with GitHub Pages.
+
+* [All Posts Grouped by Category -- List View][posts-categories]
+* [All Posts Grouped by Tags -- List View][posts-tags]
+* [All Posts Grouped by Year -- List View][posts-year]
+* [All Posts Grouped by Collection -- List View][posts-collection]
+* [Portfolio Collection -- Grid View][portfolio-collection]
+
+[posts-categories]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/category-archive.html
+[posts-tags]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/tag-archive.html
+[posts-year]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/year-archive.html
+[posts-collection]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/collection-archive.html
+[portfolio-collection]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/portfolio-archive.html
+
+Post and page excerpts are auto-generated by Jekyll which grabs the first paragraph of text. To override this text with something more specific use the following YAML Front Matter:
+
+```yaml
+excerpt: "A unique line of text to describe this post that will display in an archive listing and meta description with SEO benefits."
+```
+
+### Grid View
+
+Adding `type=grid` to the `archive-single` helper will display archive posts in a 4 column grid. For example to create an archive displaying all documents in the portfolio collection:
+
+**Step 1:** Create a portfolio archive page (eg. `_pages/portfolio-archive.html`) with the following YAML Front Matter:
+
+```yaml
+---
+layout: archive
+title: "Portfolio"
+permalink: /portfolio/
+author_profile: false
+---
+```
+
+**Step 2:** Loop over all documents in the portfolio collection and output in a grid:
+
+```html
+{% raw %}{% include base_path %}
+
+<div class="grid__wrapper">
+  {% for post in site.portfolio %}
+    {% include archive-single.html type="grid" %}
+  {% endfor %}{% endraw %}
+</div>
+```
+
+To produce something like this:
+
+<figure>
+  <img src="{{ base_path }}/images/mm-archive-grid-view-example.jpg" alt="archive grid view example">
+  <figcaption>Grid view example.</figcaption>
+</figure>
+
+**Note:** More information on using this `_include` can be found under [**Helpers**]({{ base_path }}/docs/helpers/).
+{: .notice--info}
+
+### Taxonomy Archive
+
+If you have the luxury of using Jekyll plugins the creation of category and tag archives is greatly simplified. Enable support for the [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) plugin with a few `_config.yml` settings as noted in the [**Configuration**]({{ base_path }}/docs/configuration/#archive-settings) section.
+
+![archive taxonomy layout example]({{ base_path }}/images/mm-layout-archive-taxonomy.png)
+
+### Home Page
+
+Minimal Mistakes ships with an [`index.html`](https://github.com/{{ site.repository }}/blob/master/index.html) in the root of the project for displaying recent posts. 
+
+**Includes:**
+
+* Optional header image with caption
+* Optional header overlay (solid color/image) + text and optional "call to action" button
+* Paginated posts
+
+Post pagination is achieved by assigning `layout: archive` in the YAML Front Matter and including the following Liquid in the body:
+
+```html
+{% raw %}<!-- start index.html body -->
+{% include base_path %}
+
+<h3 class="archive__subtitle">Recent Posts</h3>
+
+{% for post in paginator.posts %}
+  {% include archive-single.html %}
+{% endfor %}
+
+{% include paginator.html %}
+<!-- end index.html body -->{% endraw %}
+```
+
+<figure>
+  <img src="{{ base_path }}/images/mm-home-post-pagination-example.jpg" alt="home page post pagination example">
+  <figcaption>Home page post pagination example.</figcaption>
+</figure>
+
+**Note:** For more pagination related settings check the [**Configuration**]({{ base_path }}/docs/configuration/#paginate) section.
+{: .notice--info}
+
+## Splash Page Layout
+
+For full-width landing pages that need a little something extra add `layout: splash` to the YAML Front Matter.
+
+**Includes:**
+
+* Optional header image with caption
+* Optional header overlay (solid color/image) + text and optional "call to action" button
+* Feature blocks (`left`, `center`, and `right` alignment options)
+
+![splash page layout example]({{ base_path }}/images/mm-layout-splash.png)
+
+Feature blocks can be assigned and aligned to the `left`, `right`, or `center` with a sprinkling of YAML. For full details on how to use the `feature_row` helper check the [**Content**]({{ base_path }}/docs/helpers/) section or review a [sample splash page](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/splash-page.md).
+
+
+---
+
+## Headers
+
+To add some visual punch to a post or page, a large full-width header image can be included.
+
+**Note:** Be sure to resize your header images. `~1280px` is a good width if you aren't [responsively serving up images](http://alistapart.com/article/responsive-images-in-practice). Through the magic of CSS they will scale up or down to fill the container. If you go with something too small it will look like garbage when upscaled, and something too large will hurt performance.
+{: .notice--warning}
+
+![single layout header image example]({{ base_path }}/images/mm-single-header-example.jpg)
+
+Place your images in the `/images/` folder and add the following YAML Front Matter:
+
+```yaml
+header:
+  image: image-filename.jpg
+```
+
+For externally hosted images include the full image path instead of just the filename:
+
+```yaml
+header:
+  image: http://some-site.com/image.jpg
+```
+
+To include a caption or attribution for the image:
+
+```yaml
+header:
+  image: unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+```
+
+**ProTip:** Captions written in Markdown are supported, so feel free to add links, or style text. Just be sure to wrap it in quotes.
+{: .notice--info}
+
+### Header Overlay
+
+To overlay text on top of a header image you have a few more options:
+
+| Name               | Description | Default |
+| ----               | ----------- | ------- |
+| **overlay_image**  | Header image you'd like to overlay. Same rules as `header.image` from above. | |
+| **overlay_filter** | Color/opacity to overlay on top of the header image eg: `0.5` or `rgba(255, 0, 0, 0.5)`. |
+| **excerpt**        | Auto-generated page excerpt is added to the overlay text or can be overridden. | |
+| **cta_label**      | Call to action button text label. | `more_label` in UI Text data file |
+| **cta_url**        | Call to action button URL. | |
+
+With this YAML Front Matter:
+
+```yaml
+excerpt: "This post should display a **header with an overlay image**, if the theme supports it."
+header:
+  overlay_image: unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+  cta_label: "More Info"
+  cta_url: "https://unsplash.com"
+```
+
+You'd get a header image overlaid with text and a call to action button like this:
+
+![single layout header overlay example]({{ base_path }}/images/mm-single-header-overlay-example.jpg)
+
+You also have the option of specifying a solid background-color to use instead of an image.
+
+![single layout header overlay with background fill]({{ base_path }}/images/mm-single-header-overlay-fill-example.jpg)
+
+```yaml
+excerpt: "This post should display a **header with a solid background color**, if the theme supports it."
+header:
+  overlay_color: "#333"
+```
+
+You can also specifying the opacity (between `0` and `1`) of a black overlay like so:
+
+![transparent black overlay]({{ base_path }}/images/mm-header-overlay-black-filter.jpg)
+
+```yaml
+excerpt: "This post should [...]"
+header:
+  overlay_image: unsplash-image-1.jpg
+  overlay_filter: 0.5 # same as adding an opacity of 0.5 to a black background
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+  cta_label: "More Info"
+  cta_url: "https://unsplash.com"
+```
+
+Or if you want to do more fancy things, go full rgba:
+
+![transparent red overlay]({{ base_path }}/images/mm-header-overlay-red-filter.jpg)
+
+```yaml
+excerpt: "This post should [...]"
+header:
+  overlay_image: unsplash-image-1.jpg
+  overlay_filter: rgba(255, 0, 0, 0.5)
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+  cta_label: "More Info"
+  cta_url: "https://unsplash.com"
+```
+
+---
+
+## Sidebars
+
+The space to the left of a page's main content is blank by default, but has the ability to show an author profile (name, short biography, social media links), custom content, or both.
+
+### Author Profile
+
+Add `author_profile: true` to a post or page's YAML Front Matter.
+
+![single layout example]({{ base_path }}/images/mm-layout-single.png)
+
+Better yet, enable it with Front Matter Defaults set in `_config.yml`.
+
+```yaml
+defaults:
+  # _posts
+  - scope:
+      path: ""
+      type: posts
+    values:
+      author_profile: true
+```
+
+**Note:** To disable the author sidebar profile for a specific post or page, add `author_profile: false` to the YAML Front Matter instead.
+{: .notice--warning}
+
+The theme comes pre-built with a selection of links for the most common social media networks. These are all optional and can be [assigned in `_config.yml`]({{ base_path }}/docs/configuration/).
+
+To add more links you'll need to crack open [`_includes/author-profile.html`](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/author-profile.html) and make some edits.
+
+Inside of `<ul class="author__urls">` you'll find `<li>` elements wrapped in Liquid conditionals. These represent each of the possible links you can currently add to the sidebar.
+
+#### Example of Twitter link
+
+```html
+{% raw %}{% if author.twitter %}
+  <li><a href="https://twitter.com/{{ author.twitter }}"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li>
+{% endif %}{% endraw %}
+```
+
+To add a new link you'll need three things:
+
+1. Destination URL
+2. [Font Awesome icon](http://fontawesome.io/icons/) (`fa-` class)
+3. Label for the link
+
+It's up to you if you want to wrap it in a `{% raw %}{% if %} ... {% endif %}{% endraw %}`conditional and add variables to `_config.yml`. If you don't plan to change it then hard-coding the strings is perfectly acceptable.
+
+Let's run through how you'd add a new link that points to a Reddit profile. Starting with the three things from above:
+
+1. `https://www.reddit.com/user/username`
+2. [`fa-reddit`](http://fontawesome.io/icon/reddit/)
+3. `Reddit`
+
+And plug them into the appropriate locations:
+
+```html
+<li><a href="[1]"><i class="fa fa-fw [2]" aria-hidden="true"></i> [3]</a></li>
+```
+
+To end up with:
+
+```html
+<li><a href="https://www.reddit.com/user/username"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i> Reddit</a></li>
+```
+
+![Reddit link in author profile]({{ base_path }}/images/mm-author-profile-reddit-gs.png)
+
+To add a touch of color to the default black (`#000`) icon a few more steps are necessary.
+
+Start by opening `/assets/_scss/_utilities.scss` to the icon section (it's near the bottom). You'll want to nest a new class beneath `.social-icons` that matches the one used to declare the Font Awesome icon. In our case `.fa-reddit`.
+
+Simply add a `color` declaration and the corresponding hex code and recompile `main.css` following the steps outlined in the [stylesheet documentation]({{ base_path }}/docs/stylesheets/).
+
+```scss
+.social-icons {
+  
+  .fa-reddit {
+    color: #ff4500;
+  }
+}
+``` 
+
+![Reddit link in author profile with color]({{ base_path }}/images/mm-author-profile-reddit-color.png)
+
+**ProTip:** For bonus points you can add it as a Sass `$variable` that you set in `_variables.scss` like the other ["brand" colors](http://brandcolors.net/).
+{: .notice--info}
+
+**Please please please** don't submit [pull requests]({{ base_path }}/docs/contributing/) adding in support for "missing" social media links. I'm trying to keep things down to the minimum (hence the theme's name) and have no interest in merging such PRs :expressionless:.
+{: .notice--warning}
+
+### Custom Sidebar Content
+
+Blocks of content can be added by using the following under `sidebar`:
+
+| Name          | Description                                                |
+| ----          | -----------                                                |
+| **title**     | Title or heading.                                          |
+| **image**     | Image path placed in `/images/` folder or an external URL. |
+| **image_alt** | Alternate description for image.                           |
+| **text**      | Text. Markdown is allowed.                                 |
+
+Multiple blocks can also be added by following the example below:
+
+```yaml
+sidebar:
+  - title: "Title"
+    image: http://placehold.it/350x250
+    image_alt: "image"
+    text: "Some text here."
+  - title: "Another Title"
+    text: "More text here."
+```
+
+<figure>
+  <img src="{{ base_path }}/images/mm-custom-sidebar-example.jpg" alt="custom sidebar content example">
+  <figcaption>Example of custom sidebar content added as YAML Front Matter.</figcaption>
+</figure>
+
+**Note:** Custom sidebar content added to a post or page's YAML Front Matter will appear below the author profile if enabled with `author_profile: true`.
+{: .notice--info}
+
+### Custom Sidebar Navigation Menu
+
+To create a sidebar menu[^sidebar-menu] similar to the one found in the theme's documentation pages you'll need to modify a `_data` file and some YAML Front Matter.
+
+[^sidebar-menu]: Sidebar menu supports 1 level of nested links.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-custom-sidebar-nav.jpg" alt="sidebar navigation example">
+  <figcaption>Custom sidebar navigation menu example.</figcaption>
+</figure>
+
+To start, add a new key to `_data/navigation.yml`. This will be referenced later in via YAML Front Matter so keep it short and memorable. In the case of the theme's documentation menu I used `docs`.
+
+**Sample sidebar menu links:**
+
+```yaml 
+docs:
+  - title: Getting Started
+    children:
+      - title: "Quick-Start Guide"
+        url: /docs/quick-start-guide/
+      - title: "Structure"
+        url: /docs/structure/
+      - title: "Installation"
+        url: /docs/installation/
+      - title: "Upgrading"
+        url: /docs/upgrading/
+
+  - title: Customization
+    children:
+      - title: "Configuration"
+        url: /docs/configuration/
+      - title: "Navigation"
+        url: /docs/navigation/
+      - title: "UI Text"
+        url: /docs/ui-text/
+      - title: "Authors"
+        url: /docs/authors/
+      - title: "Layouts"
+        url: /docs/layouts/
+
+  - title: Content
+    children:
+      - title: "Working with Posts"
+        url: /docs/posts/
+      - title: "Working with Pages"
+        url: /docs/pages/
+      - title: "Working with Collections"
+        url: /docs/collections/
+      - title: "Helpers"
+        url: /docs/helpers/
+      - title: "Utility Classes"
+        url: /docs/utility-classes/
+
+  - title: Extras
+    children:
+      - title: "Stylesheets"
+        url: /docs/stylesheets/
+      - title: "JavaScript"
+        url: /docs/javascript/
+```
+
+Now you can pull these links into any page by adding the following YAML Front Matter.
+
+```yaml
+sidebar:
+  nav: "docs"
+```
+
+**Note:** `nav: "docs"` references the `docs` key in `_data/navigation.yml` so make sure they match.
+{: .notice--info}
+
+If you're adding a sidebar navigation menu to several pages the use of Front Matter Defaults is a better option. You can define them in `_config.yml` to avoid adding it to every page or post.
+
+**Sample sidebar nav default:**
+
+```yaml
+defaults:
+  # _docs
+  - scope:
+      path: ""
+      type: docs
+    values:
+      sidebar:
+        nav: "docs"
+```
+
+---
+
+## Social Sharing Links
+
+The `single` layout has an option to enable social links at the bottom of posts for sharing on Twitter, Facebook, Google+, and LinkedIn. Similar to the links found in the author sidebar, the theme ships with defaults for the most common social networks.
+
+![default social share link buttons]({{ base_path }}/images/mm-social-share-links-default.png)
+
+To enable these links add `share: true` to a post or page's YAML Front Matter or use a [default](https://jekyllrb.com/docs/configuration/#front-matter-defaults) in your `_config.yml` to apply more globally.
+
+If you'd like to add, remove, or change the order of these default links you can do so by editing [`_includes/social-share.html`](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/social-share.html).
+
+Let's say you wanted to replace the Google+ button with a Reddit one. Simply replace the HTML with the following:
+
+```html
+{% raw %}<a href="https://www.reddit.com/submit?url={{ base_path }}{{ page.url }}&title={{ page.title }}" class="btn" title="{{ site.data.ui-text[site.locale].share_on_label }} Reddit"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i><span> Reddit</span></a>{% endraw %}
+```
+
+The important parts to change are:
+
+1. Share point URL *eg. `https://www.reddit.com/submit?url=`
+2. Link `title`
+3. [Font Awesome icon](http://fontawesome.io/icons/) (`fa-` class)
+4. Link label
+
+![Reddit social share link button]({{ base_path }}/images/mm-social-share-links-reddit-gs.png)
+
+To change the color of the button use one of the built in [utility classes]({{ base_path }}/docs/utility-classes/#buttons). Or you can create a new button class to match whatever color you want.
+
+Under the `$social` color map in `assets/_scss/_buttons.scss` simply add a name (this will be appened to `btn--`) that matches the new button class. In our case `reddit` ~> `.btn--reddit`.
+
+```scss
+$social:
+(facebook, $facebook-color),
+(twitter, $twitter-color),
+(google-plus, $google-plus-color),
+(linkedin, $linkedin-color);
+(reddit, #ff4500;)
+```
+
+**ProTip:** For bonus points you can add it as a Sass `$variable` that you set in `_variables.scss` like the other ["brand" colors](http://brandcolors.net/).
+{: .notice--info}
+
+Add the new `.btn--reddit` class to the `<a>` element from earlier, [compile `main.css`]({{ base_path }}/docs/stylesheets/) and away you go.
+
+```html
+{% raw %}<a href="https://www.reddit.com/submit?url={{ base_path }}{{ page.url }}&title={{ page.title }}" class="btn btn--reddit" title="{{ site.data.ui-text[site.locale].share_on_label }} Reddit"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i><span> Reddit</span></a>{% endraw %}
+```
+
+![Reddit social share link button]({{ base_path }}/images/mm-social-share-links-reddit-color.png)

_docs/10-posts.md

@@ -2,9 +2,11 @@
 title: "Working with Posts"
 permalink: /docs/posts/
 excerpt: "Suggestions and Front Matter defaults for working with posts."
-last_modified_at: 2018-03-20T15:59:57-04:00
+modified: 2016-07-20T08:17:57-04:00
 ---
 
+{% include base_path %}
+
 Posts are stored in the `_posts` directory and named according to the `YEAR-MONTH-DAY-title.MARKUP` format as per [the usual](https://jekyllrb.com/docs/posts/).
 
 Where `YEAR` is a four-digit number, `MONTH` and `DAY` are both two-digit numbers, and `MARKUP` is the file extension representing the format used in the file. For example, the following are examples of valid post filenames:
@@ -31,7 +33,7 @@ defaults:
       related: true
 ```
 
-Adding the above to `_config.yml` will assign the `single` layout and enable: *author profile*, *reading time*, *comments*, [*social sharing links*]({{ "/docs/layouts/#social-sharing-links" | relative_url }}), and *related posts*, for all posts.
+Adding the above to `_config.yml` will assign the `single` layout and enable: *author profile*, *reading time*, *comments*, [*social sharing links*]({{ base_path }}/docs/layouts/#social-sharing-links), and *related posts*, for all posts.
 
 **ProTip:** Remember to write unique `excerpt` descriptions for each post for improved SEO and archive listings.
 {: .notice--info}

_docs/11-pages.md

@@ -2,9 +2,11 @@
 title: "Working with Pages"
 permalink: /docs/pages/
 excerpt: "Suggestions and Front Matter defaults for working with pages."
-last_modified_at: 2016-11-03T11:13:12-04:00
+modified: 2016-04-13T15:54:02-04:00
 ---
 
+{% include base_path %}
+
 To better organize all of your pages you can centralize them into a single location similar to posts and collections.
 
 **Step 1:** Start by placing pages (`.md` or `.html` files) into a `_pages` directory. Meaningfully naming files should be the goal. Avoid patterns like `/about/index.md` as it makes distinguishing between multiple `index.md` files harder.

_docs/12-collections.md

@@ -2,14 +2,16 @@
 title: "Working with Collections"
 permalink: /docs/collections/
 excerpt: "Suggestions and Front Matter defaults for working with collections."
-last_modified_at: 2018-03-20T16:00:02-04:00
+modified: 2016-04-13T15:54:02-04:00
 ---
 
+{% include base_path %}
+
 Collections like posts and pages work as you'd expect. If you're new to them be sure to read [Jekyll's documentation](https://jekyllrb.com/docs/collections/).
 
-The theme has been built with collections in mind and you will find [several examples]({{ "/collection-archive/" | relative_url }}) on the demo site ([portfolio]({{ "/portfolio/" | relative_url }}), [recipes]({{ "/recipes/" | relative_url }}), [pets]({{ "/pets/" | relative_url }})). 
+The theme has been built with collections in mind and you will find [several examples]({{ base_path }}/collection-archive/) on the demo site ([portfolio]({{ base_path }}/portfolio/), [recipes]({{ base_path }}/recipes/), pets). 
 
-**Collections in the Wild:** This set of documentation is also [built as a collection](https://github.com/{{ site.repository }}/blob/master/docs/_docs/) if you're looking for a fully fleshed out example to inspect.
+**Collections in the Wild:** This set of documentation is also [built as a collection](https://github.com/{{ site.repository }}/blob/gh-pages/_docs/) if you're looking for a fully fleshed out example to inspect.
 {: .notice--info}
 
 ---
@@ -41,6 +43,6 @@ defaults:
       share: true
 ```
 
-And then create portfolio content like [`_portfolio/foo-bar-website.md`](https://github.com/{{ site.repository }}/blob/master/docs/_portfolio/foo-bar-website.md), to end up with something like this.
+And then create portfolio content like [`_portfolio/foo-bar-website.md`](https://github.com/{{ site.repository }}/blob/gh-pages/_portfolio/foo-bar-website.md), to end up with something like this.
 
-![portfolio collection example]({{ "/assets/images/mm-portfolio-collection-example.jpg" | relative_url }})
+![portfolio collection example]({{ base_path }}/images/mm-portfolio-collection-example.jpg)

_docs/13-helpers.md

@@ -0,0 +1,255 @@
+---
+title: "Helpers"
+permalink: /docs/helpers/
+excerpt: "Jekyll `_includes` and other helpers to use as shortcuts for creating archives, galleries, table of contents, and more."
+gallery:
+  - url: unsplash-gallery-image-1.jpg
+    image_path: unsplash-gallery-image-1-th.jpg
+    alt: "placeholder image 1"
+    title: "Image 1 title caption"
+  - url: unsplash-gallery-image-2.jpg
+    image_path: unsplash-gallery-image-2-th.jpg
+    alt: "placeholder image 2"
+    title: "Image 2 title caption"
+  - url: unsplash-gallery-image-3.jpg
+    image_path: unsplash-gallery-image-3-th.jpg
+    alt: "placeholder image 3"
+    title: "Image 3 title caption"
+feature_row:
+  - image_path: unsplash-gallery-image-1-th.jpg
+    alt: "placeholder image 1"
+    title: "Placeholder 1"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+  - image_path: unsplash-gallery-image-2-th.jpg
+    alt: "placeholder image 2"
+    title: "Placeholder 2"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+    url: "#test-link"
+    btn_label: "Read More"
+    btn_class: "btn--inverse"
+  - image_path: unsplash-gallery-image-3-th.jpg
+    title: "Placeholder 3"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+modified: 2016-06-01
+---
+
+{% include base_path %}
+{% include toc icon="gears" title="Helpers" %}
+
+You can think of these Jekyll helpers as little shortcuts. Since GitHub Pages doesn't allow most plugins --- [custom tags](https://jekyllrb.com/docs/plugins/#tags) are out. Instead the theme leverages [**includes**](https://jekyllrb.com/docs/templates/#includes) to do something similar.
+
+## Base Path
+
+Instead of repeating `{% raw %}{{ site.url }}{{ site.baseurl }}{% endraw %}` over and over again to create absolute URLs, you can use `{% raw %}{{ base_path }}{% endraw %}` instead. Simply add `{% raw %}{% include base_path %}{% endraw %}` to layouts, posts, pages, collections, or other includes and you're good to go.
+
+**ProTip:** It's a good practice to prepend all assets links (especially post images) with `{% raw %}{{ base_path }}{% endraw %}` so they correctly resolve in the site's XML feeds.
+{: .notice--info}
+
+## Group by Array
+
+[Jekyll Group-By-Array](https://github.com/mushishi78/jekyll-group-by-array) by Max White.
+
+  A liquid include file for Jekyll that allows an object to be grouped by an array.
+
+The Liquid based taxonomy archives found amongst the demo pages rely on this helper.
+
+| Description                   |                          |                             |
+| -----------                   | ------------------------ | --------------------------- |
+| All posts grouped by category | [Source][category-array] | [Demo][category-array-demo] |
+| All posts grouped by tags     | [Source][tag-array]      | [Demo][tag-array-demo]      |
+
+[category-array]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/category-archive.html
+[category-array-demo]: {{ base_path }}/categories/
+[tag-array]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/tag-archive.html
+[tag-array-demo]: {{ base_path }}/tags/
+
+## Gallery
+
+Generate a `<figure>` element with optional caption of arrays with two or more images.
+
+To place a gallery add the necessary YAML Front Matter.
+
+| Name           | Required     | Description |
+| ----           | --------     | ----------- |
+| **url**        | Optional     | URL to link gallery image to (eg. a larger detail image). |
+| **image_path** | **Required** | For images placed in the `/images/` directory just add the filename and extension. Use absolute URLS for those hosted externally. |
+| **alt**        | Optional     | Alternate text for image. |
+| **title**      | Optional     | Title text for image. Will display as a caption in a Magnific Popup overlay when linked to a larger image with `url`. |
+
+```yaml
+gallery:
+  - url: unsplash-gallery-image-1.jpg
+    image_path: unsplash-gallery-image-1-th.jpg
+    alt: "placeholder image 1"
+    title: "Image 1 title caption"
+  - url: unsplash-gallery-image-2.jpg
+    image_path: unsplash-gallery-image-2-th.jpg
+    alt: "placeholder image 2"
+    title: "Image 2 title caption"
+  - url: unsplash-gallery-image-3.jpg
+    image_path: unsplash-gallery-image-3-th.jpg
+    alt: "placeholder image 3"
+    title: "Image 3 title caption"
+```
+
+And then drop-in the gallery include in the body where you'd like it to appear. 
+
+| Include Parameter | Required    | Description | Default |
+| ----------------- | --------    | ----------- | ------- | 
+| **id**            | Optional    | To add multiple galleries to a document uniquely name them in the YAML Front Matter and reference in `{% raw %}{% include gallery id="gallery_id" %}{% endraw %}` | `gallery` |
+| **class**         | Optional    | Use to add a `class` attribute to the surrounding `<figure>` element for additional styling needs. | |
+| **caption**       | Optional    | Gallery caption description. Markdown is allowed. | |
+
+```liquid
+{% raw %}{% include gallery caption="This is a sample gallery with **Markdown support**." %}{% endraw %}
+```
+
+**Gallery example with caption:**
+
+{% include gallery caption="This is a sample gallery with **Markdown support**." %}
+
+**More Gallery Goodness:** A few more examples and [source code](https://github.com/{{ site.repository }}/blob/gh-pages/_posts/2010-09-09-post-gallery.md) can be seen in [this sample gallery post]({{ base_path }}{% post_url 2010-09-09-post-gallery %}).
+{: .notice--info}
+
+## Feature Row
+
+Designed to compliment the [`splash`]({{ base_path }}/docs/layouts/#splash-page-layout) page layout as a way of arranging and aligning "feature blocks" containing text or image.
+
+To add a feature row containing three content blocks with text and image, add the following YAML Front Matter
+
+| Name           | Required     | Description | Default |
+| ----           | -----------  | ----------- | ------- |
+| **image_path** | **Required** | For images placed in the `/images/` directory just add the filename and extension. Use absolute URLS for those hosted externally. | |
+| **alt**        | Optional     | Alternate text for image. | |
+| **title**      | Optional     | Content block title. | |
+| **excerpt**    | Optional     | Content block excerpt text. Markdown is allowed. | |
+| **url**        | Optional     | URL that the button should link to. | |
+| **btn_label**  | Optional     | Button text label. | `more_label` in UI Text data file. |
+| **btn_class**  | Optional     | Button style. See [utility classes]({{ base_path }}/docs/utility-classes/#buttons) for options. | `btn` |
+
+```yaml
+feature_row:
+  - image_path: unsplash-gallery-image-1-th.jpg
+    alt: "placeholder image 1"
+    title: "Placeholder 1"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+  - image_path: unsplash-gallery-image-2-th.jpg
+    alt: "placeholder image 2"
+    title: "Placeholder 2"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+    url: "#test-link"
+    btn_label: "Read More"
+    btn_class: "btn--inverse"
+  - image_path: unsplash-gallery-image-3-th.jpg
+    title: "Placeholder 3"
+    excerpt: "This is some sample content that goes here with **Markdown** formatting."
+```
+
+And then drop-in the feature row include in the body where you'd like it to appear.
+
+| Include Parameter   | Required | Description | Default |
+| -----------------   | -------- | ----------- | ------- |
+| **id**              | Optional | To add multiple rows to a document uniquely name them in the YAML Front Matter and reference in `{% raw %}{% include feature_row id="row2" %}{% endraw %}` | `feature_row` |
+| **type**            | Optional | Alignment of the featured blocks in the row. Options include: `left`, `center`, or `right` aligned. | |
+
+```liquid
+{% raw %}{% include feature_row %}{% endraw %}
+```
+
+{% include feature_row %}
+
+**More Feature Row Goodness:** A [few more examples]({{ base_path }}/splash-page/) and [source code](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/splash-page.md) can be seen in the demo site.
+{: .notice--info}
+
+## Table of Contents
+
+To include an [auto-generated table of contents](http://kramdown.rubyforge.org/converter/html.html#toc) for posts and pages, add the following helper before any actual content in your post or page.
+
+```liquid
+{% raw %}{% include toc %}{% endraw %}
+```
+
+![table of contents example]({{ base_path }}/images/mm-toc-helper-example.jpg)
+
+| Parameter   | Required | Description | Default |
+| ---------   | -------- | ----------- | ------- |
+| **title**   | Optional | Table of contents title. | `toc_label` in UI Text data file. |
+| **icon**    | Optional | Table of contents icon (shows before the title). | [Font Awesome](https://fortawesome.github.io/Font-Awesome/icons/) <i class="fa fa-file-text"></i> **file-text** icon. Any other FA icon can be used instead. |
+
+**TOC example with custom title and icon**
+
+```liquid
+{% raw %}{% include toc icon="gears" title="My Table of Contents" %}{% endraw %}
+```
+
+## Navigation List
+
+Include an unordered list of links to be used as sidebar navigation with the `nav_list` helper.
+
+**1.** Start by adding a set of titles and URLs to `_data/navigation.yml` in the same way the [`main` navigation]({{ base_path }}/docs/navigation/) is built.
+
+`foo` navigation example:
+
+```yaml
+# _data/navigation.yml
+foo:
+  - title: "Link 1 Title"
+    url: /link-1-page-url/
+
+  - title: "Link 2 Title"
+    url: http://external-link.com
+
+  - title: "Link 3 Title"
+    url: /link-3-page-url/
+
+  - title: "Link 4 Title"
+    url: /link-4-page-url/
+```
+
+For a navigation list that has child pages you'd structure the YAML like this:
+
+```yaml
+# _data/navigation.yml
+foo:
+  - title: "Parent Link 1"
+    url: /parent-1-page-url/
+    children:
+      - title: "Child Link 1"
+        url: /child-1-page-url/
+      - title: "Child Link 2"
+        url: /child-2-page-url/
+
+  - title: "Parent Link 2"
+    url: /parent-2-page-url/
+    children:
+      - title: "Child Link 1"
+        url: /child-1-page-url/
+      - title: "Child Link 2"
+        url: /child-2-page-url/
+      - title: "Child Link 3"
+        url: /child-3-page-url/
+```
+
+**2:** On the page(s) you'd like the `foo` sidebar nav add the following YAML Front Matter, referencing the same key name.
+
+```yaml
+sidebar:
+  nav: "foo"
+```
+
+**ProTip:** If you're applying the same navigation list to several pages setting it as a [Front Matter default](https://jekyllrb.com/docs/configuration/#front-matter-defaults) is the better option.
+{: .notice--info}
+
+The theme's documentation is built with the `nav_list` helper so if you'd like an example to dissect take a look at `navigation.yml`, `_config.yml` and `_doc/` in the [`gh-pages` branch](https://github.com/{{ site.repository }}/tree/gh-pages/) of this repo.
+
+To add a navigation list to a post or page's main content instead of the sidebar use the include this way:
+
+```liquid
+{% raw %}{% include nav_list nav="foo" %}{% endraw %}
+```
+
+{% include nav_list nav="foo" %}
+
+| Parameter | Required     | Description |
+| --------- | --------     | ----------- |
+| items     | **Required** | Name of the links array found in `_data/navigation.yml`. |

_docs/14-utility-classes.md

@@ -2,15 +2,15 @@
 title: "Utility Classes"
 permalink: /docs/utility-classes/
 excerpt: "CSS classes for aligning text/image, styling buttons and notices, and more."
-last_modified_at: 2018-03-20T16:00:15-04:00
+modified: 2016-04-13T15:54:02-04:00
-toc: true
-toc_label: "Utility Classes"
-toc_icon: "gears"
 ---
 
+{% include base_path %}
+{% include toc icon="gears" title="Utility Classes" %}
+
 Using the Kramdown Markdown renderer with Jekyll allows you to add [block](http://kramdown.gettalong.org/quickref.html#block-attributes) and [inline attributes](http://kramdown.gettalong.org/quickref.html#inline-attributes). This is nice if you want to add custom styling to text and image, and still write in Markdown.
 
-**Jekyll 3:** Kramdown is the default for `jekyll new` sites and those hosted on GitHub Pages. Not using Kramdown? That's OK. The following classes are still available when used with standard HTML.
+**Jekyll 3:** Kramdown is the default for `jekyll new` sites and those hosted on GitHub Pages. Not using Kramdonw? That's OK. The following classes are still available when used with standard HTML.
 {: .notice--warning}
 
 ## Text Alignment
@@ -69,56 +69,55 @@ No wrap text.
 
 Position images with the following classes.
 
-![image-center]({{ "/assets/images/image-alignment-580x300.jpg" | relative_url }}){: .align-center}
+![image-center]({{ site.url }}{{ site.baseurl }}/images/image-alignment-580x300.jpg){: .align-center}
 
 The image above happens to be **centered**.
 
 ```markdown
-![image-center](/assets/images/filename.jpg){: .align-center}
+![image-center](/images/filename.jpg){: .align-center}
 ```
 
 ---
 
-![image-left]({{ "/assets/images/image-alignment-150x150.jpg" | relative_url }}){: .align-left} The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**. There should be plenty of room above, below, and to the right of the image. Just look at him there --- Hey guy! Way to rock that left side. I don't care what the right aligned image says, you look great. Don't let anyone else tell you differently.
+![image-left]({{ site.url }}{{ site.baseurl }}/images/image-alignment-150x150.jpg){: .align-left} The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**. There should be plenty of room above, below, and to the right of the image. Just look at him there --- Hey guy! Way to rock that left side. I don't care what the right aligned image says, you look great. Don't let anyone else tell you differently.
 
 ```markdown
-![image-left](/assets/images/filename.jpg){: .align-left}
+![image-left](/images/filename.jpg){: .align-left}
 ```
 
 ---
 
-![image-right]({{ "/assets/images/image-alignment-300x200.jpg" | relative_url }}){: .align-right}
+![image-right]({{ site.url }}{{ site.baseurl }}/images/image-alignment-300x200.jpg){: .align-right}
 
 And now we're going to shift things to the **right align**. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there --- Hey guy! Way to rock that right side. I don't care what the left aligned image says, you look great. Don't let anyone else tell you differently.
 
 ```markdown
-![image-right](/assets/images/filename.jpg){: .align-right}
+![image-right](/images/filename.jpg){: .align-right}
 ```
 
 ---
 
-![full]({{ "/assets/images/image-alignment-1200x4002.jpg" | relative_url }})
+![full]({{ site.url }}{{ site.baseurl }}/images/image-alignment-1200x4002.jpg)
 {: .full}
 
 The image above should extend outside of the parent container on right.
 
 ```markdown
-![full](/assets/images/filename.jpg)
+![full](/images/filename.jpg)
 {: .full}
 ```
 
 ## Buttons
 
-Make any link standout more when applying the `.btn .btn--primary` classes.
+Make any link standout more when applying the `.btn` class.
 
 ```html
-<a href="#" class="btn btn--primary">Link Text</a>
+<a href="#" class="btn">Link Text</a>
 ```
 
 | Button Type   | Example | Class | Kramdown |
 | ------        | ------- | ----- | ------- |
 | Default       | [Text](#link){: .btn} | `.btn` | `[Text](#link){: .btn}` |
-| Primary       | [Text](#link){: .btn .btn--primary} | `.btn .btn--primary` | `[Text](#link){: .btn .btn--primary}` |
 | Success       | [Text](#link){: .btn .btn--success} | `.btn .btn--success` | `[Text](#link){: .btn .btn--success}` |
 | Warning       | [Text](#link){: .btn .btn--warning} | `.btn .btn--warning` | `[Text](#link){: .btn .btn--warning}` |
 | Danger        | [Text](#link){: .btn .btn--danger} | `.btn .btn--danger` | `[Text](#link){: .btn .btn--danger}` |
@@ -128,10 +127,10 @@ Make any link standout more when applying the `.btn .btn--primary` classes.
 
 | Button Size | Example | Class | Kramdown |
 | ----------- | ------- | ----- | -------- |
-| X-Large     | [X-Large Button](#){: .btn .btn--primary .btn--x-large} | `.btn .btn--primary .btn--x-large` | `[Text](#link){: .btn .btn--primary .btn--x-large}` |
+| X-Large     | [X-Large Button](#){: .btn .btn--x-large} | `.btn .btn--x-large` | `[Text](#link){: .btn .btn--x-large}` |
-| Large       | [Large Button](#){: .btn .btn--primary .btn--large} | `.btn .btn--primary .btn--large` | `[Text](#link){: .btn .btn--primary .btn--large}` |
+| Large       | [Large Button](#){: .btn .btn--large} | `.btn .btn--large` | `[Text](#link){: .btn .btn--large}` |
-| Default     | [Default Button](#){: .btn .btn--primary} | `.btn .btn--primary` | `[Text](#link){: .btn .btn--primary }` |
+| Default     | [Default Button](#){: .btn} | `.btn` | `[Text](#link){: .btn}` |
-| Small       | [Small Button](#){: .btn .btn--primary .btn--small} | `.btn .btn--primary .btn--small` | `[Text](#link){: .btn .btn--primary .btn--small}` |
+| Small       | [Small Button](#){: .btn .btn--small} | `.btn .btn--small` | `[Text](#link){: .btn .btn--small}` |
 
 ## Notices
 
@@ -146,22 +145,22 @@ Call attention to a block of text.
 | Success     | `.notice--success` |
 | Danger      | `.notice--danger`  |
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice}` class.
 {: .notice}
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--primary}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice--primary}` class.
 {: .notice--primary}
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--info}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice--info}` class.
 {: .notice--info}
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--warning}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice--warning}` class.
 {: .notice--warning}
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--success}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice--success}` class.
 {: .notice--success}
 
-**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--danger}` class.
+**Watch out!** This paragraph of text has been emphasized with the `{: .notice--danger}` class.
 {: .notice--danger}
 
 {% capture notice-text %}
@@ -174,4 +173,4 @@ You can also add the `.notice` class to a `<div>` element.
 <div class="notice--info">
   <h4>Notice Headline:</h4>
   {{ notice-text | markdownify }}
-</div>
+</div>

_docs/15-stylesheets.md

@@ -0,0 +1,135 @@
+---
+title: "Stylesheets"
+permalink: /docs/stylesheets/
+excerpt: "Instructions for customizing and building the theme's stylesheets."
+modified: 2016-08-08T16:28:26-04:00
+---
+
+{% include base_path %}
+
+The theme's `main.css` stylesheet is built from several SCSS partials located in `/_sass/` and is structured as follows:
+
+```bash
+minimal mistakes
+├── _sass
+|  ├── vendor               # vendor SCSS partials
+|  |   ├── breakpoint       # media query mixins
+|  |   ├── font-awesome     # Font Awesome icons
+|  |   ├── magnific-popup   # Magnific Popup lightbox
+|  |   └── susy             # Susy grid system
+|  ├── _animations.scss     # animations
+|  ├── _archive.scss        # archives (list, grid, feature views)
+|  ├── _base.scss           # base HTML elements
+|  ├── _buttons.scss        # buttons
+|  ├── _footer.scss         # footer
+|  ├── _masthead.scss       # masthead
+|  ├── _mixins.scss         # mixins (em function, clearfix)
+|  ├── _navigation.scss     # nav links (breadcrumb, priority+, toc, pagination, etc.)
+|  ├── _notices.scss        # notices
+|  ├── _page.scss           # pages
+|  ├── _print.scss          # print styles
+|  ├── _reset.scss          # reset
+|  ├── _sidebar.scss        # sidebar
+|  ├── _syntax.scss         # syntax highlighting
+|  ├── _tables.scss         # tables
+|  ├── _utilities.scss      # utility classes (text/image alignment)
+|  └── _variables.scss      # theme defaults (fonts, colors, etc.)
+├── assets
+|  ├── css
+|  |  └── main.scss         # main stylesheet, loads SCSS partials in _sass
+```
+
+## Customizing
+
+The variables and settings found in `/_sass/_variables.scss` can be used to modify the following aspects of the theme:
+
+### Paragraph Indention 
+
+To mimic the look of type set in a printed book or manuscript you may want to enable paragraph indention. When `$paragraph-indent` is set to `true` indents are added to each sibling and the margin below each paragraph is removed.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-paragraph-indent-example.jpg" alt="indented paragraph example">
+  <figcaption>Example of indented paragraphs.</figcaption>
+</figure>
+
+The size of the indent can also be customized by changing the value of `$indent-var`.
+
+### Font Stacks
+
+By default the theme uses [system fonts](https://medium.com/designing-medium/system-shock-6b1dc6d6596f#.rb81vgn7i) for all of the font stacks (serif, sans-serif, and monospace). This is done in part to provide a clean base for you to build off of and to improve performance since we aren't loading any custom webfonts[^font-awesome] by default.
+
+```scss
+/* system typefaces */
+$serif      : Georgia, Times, serif;
+$sans-serif : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif;
+$monospace  : Monaco, Consolas, "Lucida Console", monospace;
+```
+
+[^font-awesome]: Apart from [Font Awesome](https://fortawesome.github.io/Font-Awesome/) icon webfonts.
+
+Sans-serif fonts have been used for most of the type, with serifs reserved for captions. If you wish to change this you'll need to poke around the various `SCSS` partials and modify `font-family` declarations.
+
+**ProTip:** To use webfonts from services like [Adobe TypeKit](https://typekit.com/) or [Google Fonts](https://www.google.com/fonts) simply update the font stacks and then add their scripts to `_includes/head/custom.html`.
+{: .notice--info}
+
+#### Typography from Older Versions
+
+Not a fan of the refreshed typography of the theme and want to revert back an older version? Easy enough.
+
+**1.** Add this Google Fonts script to `_includes/head/custom.html`:
+
+```html
+<link href="https://fonts.googleapis.com/css?family=PT+Sans+Narrow:400,700|PT+Serif:400,700,400italic" rel="stylesheet" type="text/css">
+```
+
+**2.** Update the following variables in `/_sass/_variables.scss`:
+
+```scss
+$serif              : "PT Serif", Georgia, Times, serif;
+$sans-serif-narrow  : "PT Sans Narrow", $sans-serif;
+
+$global-font-family : $serif;
+$header-font-family : $sans-serif-narrow;
+```
+
+### Type Scale
+
+Wherever possible type scale variables have been used instead of writing out fixed sizes. This makes updating much easier by changing values in one file, `_variables.scss`. 
+
+Example:
+
+```scss
+.page__lead {
+  font-family: $global-font-family;
+  font-size: $type-size-4;
+}
+```
+
+Type sizes are set in ems to proportional scale as the screen size changes. Large headlines that look great on desktop monitors will shrink ever so slightly as to not be too big on mobile devices. To adjust this hierarchy simply edit the default values:
+
+```scss
+/* type scale */
+$type-size-1 : 2.441em;  // ~39.056px
+$type-size-2 : 1.953em;  // ~31.248px
+$type-size-3 : 1.563em;  // ~25.008px
+$type-size-4 : 1.25em;   // ~20px
+$type-size-5 : 1em;      // ~16px
+$type-size-6 : 0.75em;   // ~12px
+$type-size-7 : 0.6875em; // ~11px
+$type-size-8 : 0.625em;  // ~10px
+```
+
+### Colors
+
+Change the mood of your site by altering a few color variables. `$body-color`, `$background-color`, `$text-color`, `$link-color`, and `$masthead-link-color` will have the most affect when changed.
+
+### Breakpoints and Grid Stuff
+
+Probably won't need to touch these, but they're there if you need to. Width variables are used with the [`@include breakpoint()`](http://breakpoint-sass.com/) mixin to adapt the design of certain elements.
+
+And `$susy` is used for setting [the grid](http://susy.oddbird.net/) the theme uses. Uncommenting the lines under `debug` can be useful if you want to show the columns when adjusting the layout.
+
+<figure>
+  <img src="{{ base_path }}/images/mm-susy-grid-overlay.jpg" alt="Susy grid overlay for debugging">
+  <figcaption>Susy grid debug overlay enabled.</figcaption>
+</figure>

_docs/16-javascript.md

@@ -2,10 +2,12 @@
 title: "JavaScript"
 permalink: /docs/javascript/
 excerpt: "Instructions for customizing and building the theme's scripts."
-last_modified_at: 2018-01-03T19:12:35-05:00
+modified: 2016-07-14T09:39:49-04:00
 ---
 
-The theme's `assets/js/main.min.js` script is built from several vendor, jQuery plugins, and other scripts found in [`assets/js/`](https://github.com/mmistakes/minimal-mistakes/tree/master/assets/js).
+{% include base_path %}
+
+The theme's `main.js` script is built from several vendor, jQuery plugins, and other scripts found in `/assets/js/`.
 
 ```bash
 minimal mistakes
@@ -15,34 +17,20 @@ minimal mistakes
 |  |  |   ├── jquery.fitvids.js            # fluid width video embeds
 |  |  |   ├── jquery.greedy-navigation.js  # priority plus navigation
 |  |  |   ├── jquery.magnific-popup.js     # responsive lightbox
-|  |  |   └── jquery.smooth-scroll.min.js  # make same-page links scroll smoothly
+|  |  |   ├── jquery.smooth-scroll.min.js  # make same-page links scroll smoothly
+|  |  |   └── stickyfill.min.js            # `position: sticky` polyfill
 |  |  ├── vendor
 |  |  |   └── jquery
-|  |  |       └── jquery-3.3.1.min.js
+|  |  |       └── jquery-1.12.1.min.js
 |  |  ├── _main.js                         # jQuery plugin settings and other scripts
 |  |  └── main.min.js                      # concatenated and minified scripts
 ```
 
 ## Customizing
 
-To modify or add your own scripts include them in [`assets/js/_main.js`](https://github.com/mmistakes/minimal-mistakes/blob/master/assets/js/_main.js) and then rebuild using `npm run build:js`. See below for more details.
+To modify or add your own scripts include them in `/assets/js/_main.js` and then rebuild using `npm run build:js`. See below for more details.
 
-If you add additional scripts to `assets/js/plugins/` and would like them concatenated with the others, be sure to update the `uglify` script in [`package.json`](https://github.com/mmistakes/minimal-mistakes/blob/master/package.json). Same goes for scripts that you remove.
+If you add additional scripts to `/assets/js/plugins/` and would like them concatenated with the others, be sure to update the `uglify` script in `package.json`. Same goes for scripts that you remove.
-
-You can also add scripts to the `<head>` or closing `</body>` elements by adding paths to following arrays in `_config.yml`.
-
-**Example:**
-
-```yaml
-head_scripts:
-  - https://code.jquery.com/jquery-3.3.1.min.js
-  - /assets/js/your-custom-head-script.js
-footer_scripts:
-  - /assets/js/your-custom-footer-script.js
-```
-
-**Note:** If you assign `footer_scripts` the theme's `/assets/js/main.min.js` file will be deactivated. This script includes jQuery and various other plugins that you'll need to find replacements for and include separately.
-{: .notice--warning}
 
 ---
 
@@ -59,4 +47,4 @@ To get started:
 **Note:** If you upgraded from a previous version of the theme be sure you copied over [`package.json`](https://github.com/{{ site.repository }}/blob/master/package.json) prior to running `npm install`.
 {: .notice--warning}
 
-If all goes well, running `npm run build:js` will compress/concatenate `_main.js` and all plugin scripts into `main.min.js`.
+If all goes well, running `npm run build:js` will compress/concatenate `_main.js` and all plugin scripts into `main.min.js`.

_docs/17-history.md

@@ -0,0 +1,588 @@
+---
+title: "History"
+permalink: /docs/history/
+excerpt: "Change log of enhancements and bug fixes made to the theme."
+sidebar:
+  nav: docs
+modified: 2016-09-19T10:12:46-04:00
+---
+
+## [3.4.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.8)
+
+### Enhancements
+
+- Improve type readability for larger viewports by bumping up base `font-size`. [#533](https://github.com/mmistakes/minimal-mistakes/issues/533)
+- Update Portuguese localized UI text. [#541](https://github.com/mmistakes/minimal-mistakes/pull/541)
+- Add `page.title` and via parameter to Twitter share link. [#538](https://github.com/mmistakes/minimal-mistakes/pull/538)
+
+### Bug Fixes
+
+- Fix Last.fm author profile URL. [#540](https://github.com/mmistakes/minimal-mistakes/pull/540)
+
+### Maintenance
+
+- Move Brazilian Portuguese localized text under `pt-BR` key.
+
+## [3.4.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.7)
+
+### Enhancements
+
+- Add `layout` based and user-defined class names to `<body>` element for added CSS hooks. [#526](https://github.com/mmistakes/minimal-mistakes/pull/526)
+- Add simplified Chinese localized UI text. [#532](https://github.com/mmistakes/minimal-mistakes/pull/532)
+
+### Bug Fixes
+
+- Remove duplicate include of `base_path` in category-list.html [#522](https://github.com/mmistakes/minimal-mistakes/pull/522)
+
+## [3.4.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.6)
+
+### Enhancements
+
+- Add Italian "comments" related localized UI text. [#514](https://github.com/mmistakes/minimal-mistakes/pull/514)
+
+### Bug Fixes
+
+- Disable `compress` HTML layout by default. To enable add `layout: compress` to `_layouts/default.html`.
+
+## [3.4.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.5)
+
+### Enhancements
+
+- Improve line numbered code block styling when using `{% raw %}{% highlight linenos %}{% endraw %}` tag. [#513](https://github.com/mmistakes/minimal-mistakes/issues/513)
+- Add English fallback to "Follow" button label. [#496](https://github.com/mmistakes/minimal-mistakes/pull/496)
+
+### Bug Fixes
+
+- Fix Firefox alignment issues with code blocks generated with the `{% raw %}{% highlight %}{% endraw %}` tag. [#512](https://github.com/mmistakes/minimal-mistakes/issues/512)
+
+### Maintenance
+
+- Clarified comment for `author.stackoverflow` value used in author sidebar links. [#487](https://github.com/mmistakes/minimal-mistakes/pull/487)
+- Add list of localized text strings. [#488](https://github.com/mmistakes/minimal-mistakes/pull/488)
+- Add `{% raw %}{% highlight %}{% endraw %}` code block examples to demo site.
+- Add documentation for using custom sidebar navigation menus. [#476](https://github.com/mmistakes/minimal-mistakes/issues/476)
+
+## [3.4.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.4)
+
+### Enhancements
+
+- Add French "comments" related localized UI text. [#472](https://github.com/mmistakes/minimal-mistakes/pull/472)
+
+### Bug Fixes
+
+- Exclude `vendor` in Jekyll config file.
+- Fix Liquid syntax error for offending parenthesis. [#479](https://github.com/mmistakes/minimal-mistakes/issues/479)
+
+### Maintenance
+
+- Update gems: `colorator` (1.1.0), `forwardable-extended` (2.6.0), `github-pages` (93), `jekyll` (= 3.2.1), `minima` (= 1.0.1).
+
+## [3.4.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.3)
+
+### Enhancements
+
+- Make ["honeypot" `input`](https://github.com/mmistakes/minimal-mistakes/commit/06a8249a69a37dddda7e2a5bfbe32056c1a9a607) in Staticman comment form less obvious to spam bots
+- Add padding to `.highlight` code blocks to better [align `overflow` scrollbar](https://github.com/mmistakes/minimal-mistakes/commit/e4abec0a6f7f8cff72505ca0754615df294fd5b3) to the bottom.
+- Add additional image options for Twitter card social sharing meta tags. [#466](https://github.com/mmistakes/minimal-mistakes/pull/466)
+- Add structured data markup for Staticman comments. [#458](https://github.com/mmistakes/minimal-mistakes/issues/458)
+
+### Bug Fixes
+
+- Format `og:locale` tag with `_` instead of `-`. [#462](https://github.com/mmistakes/minimal-mistakes/issues/462)
+
+### Maintenance
+
+- Add note to docs about using `url: http://localhost:4000` when working locally.
+
+## [3.4.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.2)
+
+### Enhancements
+
+- Improve UX of static comment forms. [#448](https://github.com/mmistakes/minimal-mistakes/issues/448)
+
+## [3.4.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.1)
+
+### Enhancements
+
+- Add `staticman.filename` configuration with UNIX timestamp for sorting data files. example ~> `comment-1470943149`.
+
+### Bug Fixes
+
+- Don't add `<a>` to author name if URL is blank.
+
+## [3.4.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.4.0)
+
+### Enhancements
+
+- Support static-based commenting via [Staticman](https://staticman.net/) for sites hosted with GitHub Pages. [#424](https://github.com/mmistakes/minimal-mistakes/issues/424)
+
+## [3.3.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.7)
+
+### Bug Fixes
+
+- Re-enabled Jekyll plugins in `_config.yml` in case they aren't autoloaded in `Gemfile`. [#417](https://github.com/mmistakes/minimal-mistakes/issues/417)
+
+### Enhancements
+
+- Fallback to `site.github.url` for use in `{{ base_path }}` when `site.url` is `nil`.
+- Replace Sass and Autoprefixer `npm` build scripts with [Jekyll's built-in asset support](https://jekyllrb.com/docs/assets/). [#333](https://github.com/mmistakes/minimal-mistakes/issues/333)
+
+### Maintenance
+
+- Document `site.repository` and its role with [`github-metadata`](https://github.com/jekyll/github-metadata) gem.
+- Add sample [archive page with content](https://mmistakes.github.io/minimal-mistakes/archive-layout-with-content/) for testing styles on demo site.
+
+## [3.3.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.6)
+
+### Bug Fixes
+
+- Fix blank `site.teaser` bug [#412](https://github.com/mmistakes/minimal-mistakes/issues/412)
+
+## [3.3.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.5)
+
+### Enhancements
+
+- Add English default text `site.locale` strings [#407](https://github.com/mmistakes/minimal-mistakes/issues/407)
+- Add Portuguese localized UI text. [#411](https://github.com/mmistakes/minimal-mistakes/pull/411)
+- Add Italian localized UI text. [#409](https://github.com/mmistakes/minimal-mistakes/pull/409)
+
+### Maintenance
+
+- Remove unused Google AdSense variables in `_config.yml` [#404](https://github.com/mmistakes/minimal-mistakes/issues/404)
+- Update `Gemfile` instructions for using `github-pages` vs. native `jekyll` gems.
+- Disable `gems:` in `_config.yml` and enable plugins with Bundler instead.
+- Add `repository` to `_config.yml` to suppress GitHub Pages error `Liquid Exception: No repo name found.`
+
+## [3.3.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.4)
+
+### Enhancements
+
+- Add support for configurable feed URL to use a service like FeedBurner instead of linking directly to `feed.xml` in `<head>` and the site footer. [#378](https://github.com/mmistakes/minimal-mistakes/issues/378), [#379](https://github.com/mmistakes/minimal-mistakes/pull/379), [#406](https://github.com/mmistakes/minimal-mistakes/pull/406)
+- Add Turkish localized UI text. [#403](https://github.com/mmistakes/minimal-mistakes/pull/403)
+
+### Maintenance
+
+- Update gems: `activesupport` (4.2.7), `ffi` (1.9.14), `github-pages` (88), `jekyll-redirect-from` (0.11.0), `jekyll-watch` (1.5.0).
+
+## [3.3.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.3)
+
+### Enhancements
+
+- Make footer stick to the bottom of the page.
+
+### Bug Fixes
+
+- Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402)
+
+### Maintenance
+
+- Set default `lang` to `en`.
+
+### Enhancements
+
+- Make footer stick to the bottom of the page.
+
+### Bug Fixes
+
+- Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402)
+
+### Maintenance
+
+- Set default `lang` to `en`.
+
+## [3.3.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.2)
+
+### Bug Fixes
+
+- Fix JavaScript that triggers "sticky" sidebar to avoid layout issues on screen sizes < `1024px`. [#396](https://github.com/mmistakes/minimal-mistakes/issues/396)
+
+## [3.3.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.1)
+
+### Enhancements
+
+- Enable image popup on < 500px wide screens. [#385](https://github.com/mmistakes/minimal-mistakes/issues/385)
+- Indicate the relationship between component URLs in a paginated series by applying `rel="prev"` and `rel="next"` to pages that use `site.paginator`. [#253](https://github.com/mmistakes/minimal-mistakes/issues/253)
+- Improve link posts in archive listings. [#276](https://github.com/mmistakes/minimal-mistakes/issues/276)
+
+### Maintenance
+
+- Update gems: `github-pages` (86), `ffi` 1.9.13, `jekyll-mentions` 1.1.3, and `rouge` 1.11.1
+- Fix note about custom sidebar content appearing below author profile. [#388](https://github.com/mmistakes/minimal-mistakes/issues/388)
+
+## [3.2.13](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.13)
+
+### Enhancement
+
+- Add English default UI text for Canada, Great Britain, and Australia. [#377](https://github.com/mmistakes/minimal-mistakes/issues/377)
+- Switch default locale from `en-US` to `en`.
+
+## [3.2.12](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.12)
+
+### Enhancements
+
+- Remove window width "magic number" from sticky sidebar check in `main.js` for improved flexibility. [#375](https://github.com/mmistakes/minimal-mistakes/pull/375)
+
+### Bug Fixes
+
+- Fix author override conditional where a missing `authors.yml` would show broken sidebar content. Defaults to `site.author`. [#376](https://github.com/mmistakes/minimal-mistakes/pull/376)
+
+## [3.2.11](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.11)
+
+### Bug Fixes
+
+- Fix disappearing author sidebar links [#372](https://github.com/mmistakes/minimal-mistakes/issues/372)
+
+### Maintenance
+
+- Update gems: `github-pages` (84), `jekyll-github-metadata` 2.0.2, and `kramdown` 1.11.1
+- Update vendor JavaScript: jQuery 1.12.4, Stickyfill.js 1.1.4
+- Update Font Awesome 4.6.3
+
+## [3.2.10](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.10)
+
+### Maintenance
+
+- Add `CONTRIBUTING.md`
+
+## [3.2.9](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.9)
+
+### Enhancements
+
+- Add support for [header overlay images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#header-overlay) for Open Graph images. [#358](https://github.com/mmistakes/minimal-mistakes/pull/358)
+
+### Bug Fixes
+
+- Fix `Person` typo Schema.org type [#358](https://github.com/mmistakes/minimal-mistakes/pull/358)
+
+### Maintenance
+
+- Update `github-pages` gem and dependencies.
+- Remove `minutes_read` to avoid awkward reading time wording [#356](https://github.com/mmistakes/minimal-mistakes/issues/356)
+
+## [3.2.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.8)
+
+### Bug Fixes
+
+- Remove `cursor: pointer` that appears on white-space surrounding author side list items and links. [#354](https://github.com/mmistakes/minimal-mistakes/pull/354)
+
+### Maintenance
+
+- Add contributing information to `README.md`. [#357](https://github.com/mmistakes/minimal-mistakes/issues/357)
+
+## [3.2.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.7)
+
+### Enhancements
+
+- Add French localized UI text. [#346](https://github.com/mmistakes/minimal-mistakes/pull/346)
+
+### Bug Fixes
+
+- Fix branch logic for Yandex and Alexa in `seo.html`. [#348](https://github.com/mmistakes/minimal-mistakes/pull/348)
+
+## [3.2.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.6)
+
+### Bug Fixes
+
+- Fix error `Liquid Exception: divided by 0 in _includes/archive-single.html, included in _layouts/single.html` caused by null `words_per_minute` in `_config.yml`. [#345](https://github.com/mmistakes/minimal-mistakes/pull/345)
+
+## [3.2.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.5)
+
+### Bug Fixes
+
+- Fix link color in hero overlay to be white.
+- Remove underlines from archive item titles.
+
+## [3.2.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.4)
+
+### Enhancements
+
+- Improve text alignment of masthead, hero overlay, page footer to be flush left and remove awkward white-space gaps. [#342](https://github.com/mmistakes/minimal-mistakes/issues/342)
+- Add Spanish localized UI text. [#338](https://github.com/mmistakes/minimal-mistakes/pull/338)
+
+### Bug Fixes
+
+- Fix alignment of icons in author sidebar [#341](https://github.com/mmistakes/minimal-mistakes/issues/341)
+
+### Maintenance
+
+- Add background color to page footer to set it apart from main content. [#342](https://github.com/mmistakes/minimal-mistakes/issues/342)
+- Add terms and privacy policy to theme's demo site. [#343](https://github.com/mmistakes/minimal-mistakes/issues/343)
+- Update screenshots found in theme documentation.
+
+## [3.2.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.3)
+
+### Enhancement
+
+- Add [Discourse](https://www.discourse.org/) as a commenting provider [#335](https://github.com/mmistakes/minimal-mistakes/pull/335)
+
+## [3.2.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.2)
+
+### Enhancement
+
+- Add support for image captions in Magnific Popup overlays via the [`gallery`](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery) helper [#334](https://github.com/mmistakes/minimal-mistakes/issues/334)
+
+## [3.2.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.1)
+
+### Bug Fixes
+
+- Remove need for "double tapping" masthead menu links on iOS devices. [#315](https://github.com/mmistakes/minimal-mistakes/issues/315)
+
+### Maintenance
+
+- Add `ISSUE_TEMPLATE.md` for improve issue submission process.
+
+## [3.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.0)
+
+### Bug Fixes
+
+- Fix missing category/tag links in post footer due to possible conflict with `site.tags` and `site.categories`. [#329](https://github.com/mmistakes/minimal-mistakes/issues/329#issuecomment-222375568)
+
+## [3.1.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.8)
+
+### Bug Fixes
+
+- Fix `Liquid Exception: undefined method 'gsub' for nil:NilClass in _layouts/single.html` error when `page.title` is null. `<h1>` element is now conditional if `title: ` is not set for a `page` or collection item. [#312](https://github.com/mmistakes/minimal-mistakes/issues/312)
+
+### Maintenance
+
+- Remove duplicate `fa-twitter` and `fa-twitter-square` classes from `_utilities.scss`. [#302](https://github.com/mmistakes/minimal-mistakes/issues/302)
+
+- Document installing additional Jekyll gem dependencies when using `gem "jekyll"` instead of `gem "github-pages"` to avoid any errors on run. [#305](https://github.com/mmistakes/minimal-mistakes/issues/305)
+
+## [3.1.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.7)
+
+### Enhancement
+
+- Add translation key for "Recent Posts" used in home page `index.html`. [#316](https://github.com/mmistakes/minimal-mistakes/pull/316)
+
+### Maintenance
+
+- Small fix to avoid underlying the whitespace between icons and related text when hovering. [#303](https://github.com/mmistakes/minimal-mistakes/pull/303)
+
+## [3.1.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.6)
+
+### Maintenance
+
+- Update gem dependencies. Run `bundle` to update `Gemfile.lock`.
+
+## [3.1.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.5)
+
+### Maintenance
+
+- Fix `www` and `https` links in author profile include [#293](https://github.com/mmistakes/minimal-mistakes/pull/293)
+
+## [3.1.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.4)
+
+### Enhancements
+
+- Add `overlay_filter` param to hero headers [#298](https://github.com/mmistakes/minimal-mistakes/pull/298)
+
+## [3.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.3)
+
+### Enhancements
+
+- Improve `site.locale` documentation [#284](https://github.com/mmistakes/minimal-mistakes/issues/284)
+- Remove ProTip note about protocol-less `site.url` as it is an anti-pattern [#288](https://github.com/mmistakes/minimal-mistakes/issues/288)
+
+### Bug Fixes
+
+- Fix `og_image` URL in seo.html [#277](https://github.com/mmistakes/minimal-mistakes/issues/277)
+- Fix `author_profile` toggle when assigned in a `_layout` [#285](https://github.com/mmistakes/minimal-mistakes/issues/285)
+- Fix typo in `build:all` npm script [#283](https://github.com/mmistakes/minimal-mistakes/pull/283)
+- Fix URL typo documentation [#287](https://github.com/mmistakes/minimal-mistakes/issues/287)
+- SEO author bug. If `twitter.username` is set and `author.twitter` is `nil` bad things happen. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289)
+
+## [3.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.2)
+
+### Enhancement
+
+- Explain how to use `nav_list` helper in [documentation](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list).
+- Reduce left/right padding on smaller screens to increase width of main content column.
+
+## [3.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.1)
+
+### Bug Fix
+
+- Fixed reading time bug when `words_per_minute` wasn't set in `_config.yml` [#271](https://github.com/mmistakes/minimal-mistakes/issues/271)
+
+## [3.1.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.0)
+
+### Enhancements
+
+- Updated [Font Awesome](https://fortawesome.github.io/Font-Awesome/whats-new/) to version 4.6.1
+- Added optional GitHub and Bitbucket links to footer if set on `site.author` in `_config.yml`.
+
+### Bug Fixes
+- Fixed Bitbucket URL typo in author sidebar.
+
+## [3.0.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.0.3)
+
+### Enhancements
+
+- Rebuilt the entire theme: layouts, includes, stylesheets, scripts, you name it.
+- Refreshed the look and feel while staying true to the original design of the theme (author sidebar/main content).
+- Replaced grid system with [Susy](http://susy.oddbird.net/).
+- Replaced Grunt tasks with `npm` scripts.
+- Removed Google Fonts and replaced with system fonts to improve performance (they can be [added back](https://mmistakes.github.io/minimal-mistakes/docs/stylesheets/) if desired)
+- Greatly improved [theme documentation](https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/).
+- Increased the amount of sample posts, sample pages, and sample collections to throughly test the theme and edge-cases.
+- Moved all sample content and assets out of `master` to keep it as clean as possible for forking.
+- Added new layouts for `splash` pages, archives for [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) if enabled, and [`compress.html`](https://github.com/penibelst/jekyll-compress-html) to improve performance.
+- Added taxonomy links to posts (tags and categories).
+- Added optional "reading time" meta data.
+- Improved Liquid used for Twitter Cards and Open Graph data in `<head>`.
+- Improved `gallery` include helper and added `feature_row` for use with splash page layout.
+- Added Keybase.io, author web URI, and Bitbucket optional links to sidebar.
+- Add `feed.xml` link to footer.
+- Added a [UI text data file](https://mmistakes.github.io/minimal-mistakes/docs/ui-text/) to easily change all text found in the theme.
+- Added LinkedIn to optional social share buttons.
+- Added Facebook, Google+, and custom commenting options in addition to Disqus.
+- Added optional breadcrumb links.
+
+## [2.2.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.2.1)
+
+## [2.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.2.0)
+
+### Enhancements
+
+- Add support for Jekyll 3.0
+- Minor updates to syntax highlighting CSS and theme documentation
+
+## [2.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.3)
+
+### Enhancements
+
+- Cleaner print styles that remove the top navigation, social sharing buttons, and other elements not needed when printed.
+
+## [2.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.2)
+
+### Enhancements
+
+- Add optional CodePen icon/url to author side bar [#156](https://github.com/mmistakes/minimal-mistakes/pull/156)
+- Documented Stackoverflow username explanation in `_config.yml` [#157](https://github.com/mmistakes/minimal-mistakes/pull/157)
+- Simplified Liquid in `post-index.html` to better handle year listings [#166](https://github.com/mmistakes/minimal-mistakes/pull/166)
+
+### Bug Fixes
+
+- Cleanup Facebook related Open Graph meta tags [#149](https://github.com/mmistakes/minimal-mistakes/issues/149)
+- Corrected minor typos [#158](https://github.com/mmistakes/minimal-mistakes/pull/158) [#175](https://github.com/mmistakes/minimal-mistakes/issues/175)
+
+## [2.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.1)
+
+### Enhancements
+
+- Add optional XING profile link to author sidebar
+- Include open graph meta tags for feature image (if assigned) [#149](https://github.com/mmistakes/minimal-mistakes/issues/149)
+- Create an include for feed footer
+
+### Bug Fixes
+
+- Remove http protocol from Google search form on sample 404 page
+- Only show related posts if there are one or more available
+- Fix alignment of email address link in author sidebar
+
+## [2.1.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.0)
+
+### Enhancements
+
+- Add optional social sharing buttons ([#42](https://github.com/mmistakes/minimal-mistakes/issues/42))
+
+![social sharing buttons](https://cloud.githubusercontent.com/assets/1376749/5860522/d9f28a96-a22f-11e4-9b83-940a3a9a766a.png)
+
+- Add Soundcloud, YouTube ([#95](https://github.com/mmistakes/minimal-mistakes/pull/95)), Flickr ([#119](https://github.com/mmistakes/minimal-mistakes/pull/119)), and Weibo ([#116](https://github.com/mmistakes/minimal-mistakes/pull/116)) icons for use in author sidebar.
+- Fix typos in posts and documentation and remove references to Less
+- Include note about Octopress gem being optional
+- Post author override support extended to the Atom feed ([#71](https://github.com/mmistakes/minimal-mistakes/pull/71))
+- Only include email address in feed if specified in `_config.yml` or author `_data`
+- Wrap all page content in `#main` to harmonize article and post index styles ([#86](https://github.com/mmistakes/minimal-mistakes/issues/86))
+- Include new sample feature images for posts and pages
+- Table of contents improvements: fix collapse toggle, indent nested elements, show on small screens, and create an `_include` for reusing in posts and pages.
+- Include note about running Jekyll with `bundle exec` when using Bundler
+- Fix home page path in top navigation
+- Remove Google Authorship ([#120](https://github.com/mmistakes/minimal-mistakes/issues/120))
+- Remove duplicate author content that displayed in `div.article-author-bottom`
+- Removed unused `_sass/print.scss` styles
+- Improve comments in `.scss` files
+
+## [2.0.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/v2.0)
+
+## [1.3.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.3.3)
+
+### Enhancements
+
+- Added new icons and profile links for Stackoverflow, Dribbble, Pinterest, Foursquare, and Steam to the author bio sidebar.
+- Cleaned up the Kramdown auto table of contents styling to be more readable
+- Removed page width specific .less stylesheets and created mixins for easier updating
+- Removed Modernizr since it wasn't being used
+- Added pages to sitemap.xml
+- Added category: to rake new_post task
+- Minor typographic changes
+
+### Bug Fixes
+
+- Corrected various broken links in README and Theme Setup.
+
+## [1.3.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.3.1)
+
+### Enhancements
+
+- Cleaned up table of contents styling
+- Reworked top navigation to be a better experience on small screens. Nav items now display vertically when the menu button is tapped, revealing links with larger touch targets.
+
+![menu animation](https://camo.githubusercontent.com/3fbd8c1326485f4b1ab32c0005c0fca7660b5d31/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313337363734392f323136343037352f31653366303663322d393465372d313165332d383961612d6436623636376562306564662e676966)
+
+## [1.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.2.0)
+
+### Bug Fixes
+
+- Table weren't filling the entire width of the content container. They now scale at 100%. Thanks [@dhruvbhatia](https://github.com/dhruvbhatia)
+
+### Enhancements
+
+- Decreased spacing between Markdown footnotes
+- Removed dark background on footer
+- Removed UPPERCASE styling on post titles in the index listing
+
+## [1.1.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.4)
+
+### Bug Fixes
+
+- Fix top navigation bug issue ([#10](https://github.com/mmistakes/minimal-mistakes/issues/10)) for real this time. Remember to clear your floats kids.
+
+## [1.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.3)
+
+### Bug Fixes
+
+- Fix top navigation links that weren't click able on small viewports (Issue [#10](https://github.com/mmistakes/minimal-mistakes/issues/10)).
+- Remove line wrap from top navigation links that may span multiple lines.
+
+## [1.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.2)
+
+### Enhancements
+
+- Added Grunt build script for compiling Less/JavaScript and optimizing image assets.
+- Added support for large image summary Twitter card.
+- Stylesheet adjustments
+
+## [1.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.1)
+
+### Bug Fixes
+
+- Removed [Typeplate](http://typeplate.com/) styles. Was [causing issues with newer versions of Less](https://github.com/typeplate/typeplate.github.io/issues/108) and is no longer maintained.
+
+### Enhancements
+
+- Added [image attribution](http://mmistakes.github.io/minimal-mistakes/theme-setup/#feature-images) for post and page feature images.
+- Added [404 page](http://mmistakes.github.io/minimal-mistakes/404.html).
+- Cleaned up various Less variables to better align with naming conventions used in other MM Jekyll themes.
+- Removed Chrome Frame references.
+- Added global CSS3 transitions to text and block elements.
+- Improved typography in a few places.
+
+## [1.0.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/v1.0.2)
+
+### Enhancements
+
+- Google Analytics, Google Authorship, webmaster verifies, and Twitter card meta are now optional.
+
+## [1.0.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/v1.0.1)

_docs/18-contributing.md

@@ -2,7 +2,7 @@
 title: "Contributing"
 permalink: /docs/contributing/
 excerpt: "How you can contribute to make this theme better."
-last_modified_at: 2017-03-22T09:51:05-04:00
+modified: 2016-06-12
 ---
 
 Having trouble working with the theme? Found a typo in the documentation? Interested in adding a feature or [fixing a bug](https://github.com/mmistakes/minimal-mistakes/issues)? Then by all means [submit an issue](https://github.com/mmistakes/minimal-mistakes/issues/new) or [pull request](https://help.github.com/articles/using-pull-requests/). If this is your first pull request, it may be helpful to read up on the [GitHub Flow](https://guides.github.com/introduction/flow/) first.
@@ -13,10 +13,4 @@ This goes for author sidebar links and "share button" additions -- I have no int
 
 ## Pull Requests
 
-When submitting a pull request:
+To help me out try to avoid creating pull requests on `master` and instead branch off of `develop`. It's much easier for me to test, merge, and roll them into new releases this way.
-
-1. Clone the repo.
-2. Create a branch off of `master` and give it a meaningful name (e.g. `my-awesome-new-feature`) and describe the feature or fix.
-3. Open a pull request on GitHub.
-
-Theme documentation and demo pages can be found in the [`/docs`](https://github.com/{{ site.repository }}/blob/master/docs) folder if you'd like to tackle any "low-hanging fruit" like fixing typos, bad grammar, etc.

_docs/19-docs-2-2.md

@@ -2,10 +2,12 @@
 title: "2.2 Documentation"
 permalink: /docs/docs-2-2/
 excerpt: "Setup and installation instructions for Minimal Mistakes 2.2 (deprecated)."
-last_modified_at: 2018-03-20T16:00:34-04:00
+modified: 2016-04-13T15:54:02-04:00
-toc: true
 ---
 
+{% include base_path %}
+{% include toc %}
+
 ## Installation
 
 Minimal Mistakes now requires [Jekyll](http://jekyllrb.com/) 3.0. Make sure to run `bundle update` if you aren't on the latest version to update all gem dependencies.
@@ -256,7 +258,7 @@ To include an auto-generated **table of contents** for posts and pages, add the
 By default the margin below paragraphs has been removed and indent added to each. This is an intentional design decision to mimic the look of type set in a printed book or manuscript.
 
 <figure>
-  <img src="{{ '/assets/images/paragraph-indent.png' | relative_url }}" alt="screen shot of paragraphs with default indent style set">
+  <img src="{{ base_path }}/images/paragraph-indent.png" alt="screen shot of paragraphs with default indent style set">
   <figcaption>Example of the default paragraph style (indented first line and bottom margin removed).</figcaption>
 </figure>
 
@@ -267,7 +269,7 @@ $paragraph-indent: false;
 ```
 
 <figure>
-  <img src="{{ '/assets/images/paragraph-no-indent.png' | relative_url }}" alt="screen shot of paragraphs with indent style disabled">
+  <img src="{{ base_path }}/images/paragraph-no-indent.png" alt="screen shot of paragraphs with indent style disabled">
   <figcaption>Example of paragraphs with $paragraph-indent disabled.</figcaption>
 </figure>
 

_docs/20-license.md

@@ -0,0 +1,28 @@
+---
+title: "License"
+permalink: /docs/license/
+excerpt: "License for Minimal Mistakes Jekyll Theme."
+modified: 2016-04-13T15:05:12-04:00
+---
+
+The MIT License (MIT)
+
+Copyright (c) {{ site.time | date: '%Y' }} Michael Rose
+
+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.

_includes/analytics-providers/google-gtag.html

@@ -1,9 +0,0 @@
-<!-- Global site tag (gtag.js) - Google Analytics -->
-<script async src="https://www.googletagmanager.com/gtag/js?id={{ site.analytics.google.tracking_id }}"></script>
-<script>
-  window.dataLayer = window.dataLayer || [];
-  function gtag(){dataLayer.push(arguments);}
-  gtag('js', new Date());
-
-  gtag('config', '{{ site.analytics.google.tracking_id }}', { 'anonymize_ip': {{ site.analytics.google.anonymize_ip | default: false }}});
-</script>

_includes/analytics-providers/google-universal.html

@@ -2,9 +2,8 @@
   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
 
   ga('create', '{{ site.analytics.google.tracking_id }}', 'auto');
-  ga('set', 'anonymizeIp', {{ site.analytics.google.anonymize_ip | default: false }})
   ga('send', 'pageview');
-</script>
+</script>

_includes/analytics-providers/google.html

@@ -1,9 +1,6 @@
 <script type="text/javascript">
   var _gaq = _gaq || [];
   _gaq.push(['_setAccount', '{{ site.analytics.google.tracking_id }}']);
-  {% if site.analytics.google.anonymize_ip == true %}
-    _gaq.push(['_gat._anonymizeIp']);
-  {% endif %}
   _gaq.push(['_trackPageview']);
 
   (function() {

_includes/analytics.html

@@ -1,12 +1,10 @@
-{% if jekyll.environment == 'production' and site.analytics.provider and page.analytics != false %}
+{% if site.analytics.provider and page.analytics != false %}
 
 {% case site.analytics.provider %}
 {% when "google" %}
   {% include /analytics-providers/google.html %}
 {% when "google-universal" %}
   {% include /analytics-providers/google-universal.html %}
-{% when "google-gtag" %}
-  {% include /analytics-providers/google-gtag.html %}
 {% when "custom" %}
   {% include /analytics-providers/custom.html %}
 {% endcase %}

_includes/archive-single.html

@@ -1,3 +1,5 @@
+{% include base_path %}
+
 {% if post.header.teaser %}
   {% capture teaser %}{{ post.header.teaser }}{% endcapture %}
 {% else %}
@@ -18,20 +20,20 @@
           {% if teaser contains "://" %}
             "{{ teaser }}"
           {% else %}
-            "{{ teaser | relative_url }}"
+            "{{ teaser | prepend: "/images/" | prepend: base_path }}"
           {% endif %}
           alt="">
       </div>
     {% endif %}
     <h2 class="archive__item-title" itemprop="headline">
       {% if post.link %}
-        <a href="{{ post.link }}">{{ title }}</a> <a href="{{ post.url | relative_url }}" rel="permalink"><i class="fas fa-link" aria-hidden="true" title="permalink"></i><span class="sr-only">Permalink</span></a>
+        <a href="{{ post.link }}">{{ title }}</a> <a href="{{ base_path }}{{ post.url }}" rel="permalink"><i class="fa fa-link" aria-hidden="true" title="permalink"></i><span class="sr-only">Permalink</span></a>
       {% else %}
-        <a href="{{ post.url | relative_url }}" rel="permalink">{{ title }}</a>
+        <a href="{{ base_path }}{{ post.url }}" rel="permalink">{{ title }}</a>
       {% endif %}
     </h2>
     {% if post.read_time %}
-      <p class="page__meta"><i class="far fa-clock" aria-hidden="true"></i> {% include read-time.html %}</p>
+      <p class="page__meta"><i class="fa fa-clock-o" aria-hidden="true"></i> {% include read-time.html %}</p>
     {% endif %}
     {% if post.excerpt %}<p class="archive__item-excerpt" itemprop="description">{{ post.excerpt | markdownify | strip_html | truncate: 160 }}</p>{% endif %}
   </article>

_includes/author-profile-custom-links.html

@@ -1,7 +0,0 @@
-<!--
-  <li>
-    <a href="http://link-to-whatever-social-network.com/user/" itemprop="sameAs">
-      <i class="fas fa-fw" aria-hidden="true"></i> Custom Social Profile Link
-    </a>
-  </li>
--->

_includes/author-profile.html

@@ -1,263 +1,102 @@
-{% assign author = page.author | default: page.authors[0] | default: site.author %}
+{% include base_path %}
-{% assign author = site.data.authors[author] | default: author %}
+
+{% if page.author and site.data.authors[page.author] %}
+  {% assign author = site.data.authors[page.author] %}{% else %}{% assign author = site.author %}
+{% endif %}
 
 <div itemscope itemtype="http://schema.org/Person">
 
-  {% if author.avatar %}
+  <div class="author__avatar">
-    <div class="author__avatar">
+    {% if author.avatar contains "://" %}
-      {% if author.avatar contains "://" %}
+    	<img src="{{ author.avatar }}" alt="{{ author.name }}">
-        {% assign author_src = author.avatar %}
+    {% else %}
-      {% else %}
+    	<img src="{{ author.avatar | prepend: "/images/" | prepend: base_path }}" class="author__avatar" alt="{{ author.name }}">
-        {% assign author_src = author.avatar | relative_url %}
+    {% endif %}
-      {% endif %}
+  </div>
-
-      {% if author.home %}
-        {% if author.home contains "://" %}
-          {% assign author_link = author.home %}
-        {% else %}
-          {% assign author_link = author.home | relative_url %}
-        {% endif %}
-        <a href="{{ author_link }}">
-          <img src="{{ author_src }}" alt="{{ author.name }}" itemprop="image">
-        </a>
-      {% else %}
-        <img src="{{ author_src }}" alt="{{ author.name }}" itemprop="image">
-      {% endif %}
-    </div>
-  {% endif %}
 
   <div class="author__content">
-    {% if author.home %}
+    <h3 class="author__name">{{ author.name }}</h3>
-      <a href="{{ author_link }}"><h3 class="author__name" itemprop="name">{{ author.name }}</h3></a>
+    {% if author.bio %}<p class="author__bio">{{ author.bio }}</p>{% endif %}
-    {% else %}
-      <h3 class="author__name" itemprop="name">{{ author.name }}</h3>
-    {% endif %}
-    {% if author.bio %}
-      <p class="author__bio" itemprop="description">
-        {{ author.bio }}
-      </p>
-    {% endif %}
   </div>
 
   <div class="author__urls-wrapper">
-    <button class="btn btn--inverse">{{ site.data.ui-text[site.locale].follow_label | remove: ":" | default: "Follow" }}</button>
+    <button class="btn btn--inverse">Follow</button>
     <ul class="author__urls social-icons">
       {% if author.location %}
-        <li itemprop="homeLocation" itemscope itemtype="http://schema.org/Place">
+        <li><i class="fa fa-fw fa-map-marker" aria-hidden="true"></i> {{ author.location }}</li>
-          <i class="fas fa-fw fa-map-marker-alt" aria-hidden="true"></i> <span itemprop="name">{{ author.location }}</span>
-        </li>
       {% endif %}
-
       {% if author.uri %}
-        <li>
+        <li><a href="{{ author.uri }}"><i class="fa fa-fw fa-chain" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].website_label | default: "Website" }}</a></li>
-          <a href="{{ author.uri }}" itemprop="url">
-            <i class="fas fa-fw fa-link" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].website_label | default: "Website" }}
-          </a>
-        </li>
       {% endif %}
-
       {% if author.email %}
-        <li>
+        <li><a href="mailto:{{ author.email }}"><i class="fa fa-fw fa-envelope-square" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].email_label | default: "Email" }}</a></li>
-          <a href="mailto:{{ author.email }}">
-            <meta itemprop="email" content="{{ author.email }}" />
-            <i class="fas fa-fw fa-envelope-square" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].email_label | default: "Email" }}
-          </a>
-        </li>
       {% endif %}
-
       {% if author.keybase %}
-        <li>
+        <li><a href="https://keybase.io/{{ author.keybase }}"><i class="fa fa-fw fa-key" aria-hidden="true"></i> Keybase</a></li>
-          <a href="https://keybase.io/{{ author.keybase }}" itemprop="sameAs">
-            <i class="fas fa-fw fa-key" aria-hidden="true"></i> Keybase
-          </a>
-        </li>
       {% endif %}
-
       {% if author.twitter %}
-        <li>
+        <li><a href="https://twitter.com/{{ author.twitter }}"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li>
-          <a href="https://twitter.com/{{ author.twitter }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter
-          </a>
-        </li>
       {% endif %}
-
       {% if author.facebook %}
-        <li>
+        <li><a href="https://www.facebook.com/{{ author.facebook }}"><i class="fa fa-fw fa-facebook-square" aria-hidden="true"></i> Facebook</a></li>
-          <a href="https://www.facebook.com/{{ author.facebook }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-facebook-square" aria-hidden="true"></i> Facebook
-          </a>
-        </li>
       {% endif %}
-
       {% if author.google_plus %}
-        <li>
+        <li><a href="https://plus.google.com/+{{ author.google_plus }}"><i class="fa fa-fw fa-google-plus-square" aria-hidden="true"></i> Google+</a></li>
-          <a href="https://plus.google.com/{{ author.google_plus }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-google-plus-square" aria-hidden="true"></i> Google+
-          </a>
-        </li>
       {% endif %}
-
       {% if author.linkedin %}
-        <li>
+        <li><a href="https://www.linkedin.com/in/{{ author.linkedin }}"><i class="fa fa-fw fa-linkedin-square" aria-hidden="true"></i> LinkedIn</a></li>
-          <a href="https://www.linkedin.com/in/{{ author.linkedin }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-linkedin" aria-hidden="true"></i> LinkedIn
-          </a>
-        </li>
       {% endif %}
-
       {% if author.xing %}
-        <li>
+        <li><a href="https://www.xing.com/profile/{{ author.xing }}"><i class="fa fa-fw fa-xing-square" aria-hidden="true"></i> XING</a></li>
-          <a href="https://www.xing.com/profile/{{ author.xing }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-xing-square" aria-hidden="true"></i> XING
-          </a>
-        </li>
       {% endif %}
-
       {% if author.instagram %}
-        <li>
+        <li><a href="https://instagram.com/{{ author.instagram }}"><i class="fa fa-fw fa-instagram" aria-hidden="true"></i> Instagram</a></li>
-          <a href="https://instagram.com/{{ author.instagram }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-instagram" aria-hidden="true"></i> Instagram
-          </a>
-        </li>
       {% endif %}
-
       {% if author.tumblr %}
-        <li>
+        <li><a href="https://{{ author.tumblr }}.tumblr.com"><i class="fa fa-fw fa-tumblr-square" aria-hidden="true"></i> Tumblr</a></li>
-          <a href="https://{{ author.tumblr }}.tumblr.com" itemprop="sameAs">
-            <i class="fab fa-fw fa-tumblr-square" aria-hidden="true"></i> Tumblr
-          </a>
-        </li>
       {% endif %}
-
       {% if author.bitbucket %}
-        <li>
+        <li><a href="https://bitbucket.org/{{ author.bitbucket }}"><i class="fa fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket</a></li>
-          <a href="https://bitbucket.org/{{ author.bitbucket }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket
-          </a>
-        </li>
       {% endif %}
-
       {% if author.github %}
-        <li>
+        <li><a href="https://github.com/{{ author.github }}"><i class="fa fa-fw fa-github" aria-hidden="true"></i> Github</a></li>
-          <a href="https://github.com/{{ author.github }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-github" aria-hidden="true"></i> GitHub
-          </a>
-        </li>
       {% endif %}
-
-      {% if author.gitlab %}
-        <li>
-          <a href="https://gitlab.com/{{ author.gitlab }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-gitlab" aria-hidden="true"></i> GitLab
-          </a>
-        </li>
-      {% endif %}
-
       {% if author.stackoverflow %}
-        <li>
+        <li><a href="https://www.stackoverflow.com/users/{{ author.stackoverflow }}"><i class="fa fa-fw fa-stack-overflow" aria-hidden="true"></i> Stackoverflow</a></li>
-          <a href="https://www.stackoverflow.com/users/{{ author.stackoverflow }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-stack-overflow" aria-hidden="true"></i> Stack Overflow
-          </a>
-        </li>
       {% endif %}
-
       {% if author.lastfm %}
-        <li>
+        <li><a href="https://last.fm/user/{{ author.lastfm }}"><i class="fa fa-fw fa-lastfm-square" aria-hidden="true"></i> Last.fm</a></li>
-          <a href="https://last.fm/user/{{ author.lastfm }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-lastfm-square" aria-hidden="true"></i> Last.fm
-          </a>
-        </li>
       {% endif %}
-
       {% if author.dribbble %}
-        <li>
+        <li><a href="https://dribbble.com/{{ author.dribbble }}"><i class="fa fa-fw fa-dribbble" aria-hidden="true"></i> Dribbble</a></li>
-          <a href="https://dribbble.com/{{ author.dribbble }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-dribbble" aria-hidden="true"></i> Dribbble
-          </a>
-        </li>
       {% endif %}
-
       {% if author.pinterest %}
-        <li>
+        <li><a href="https://www.pinterest.com/{{ author.pinterest }}"><i class="fa fa-fw fa-pinterest" aria-hidden="true"></i> Pinterest</a></li>
-          <a href="https://www.pinterest.com/{{ author.pinterest }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-pinterest" aria-hidden="true"></i> Pinterest
-          </a>
-        </li>
       {% endif %}
-
       {% if author.foursquare %}
-        <li>
+        <li><a href="https://foursquare.com/{{ author.foursquare }}"><i class="fa fa-fw fa-foursquare" aria-hidden="true"></i> Foursquare</a></li>
-          <a href="https://foursquare.com/{{ author.foursquare }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-foursquare" aria-hidden="true"></i> Foursquare
-          </a>
-        </li>
       {% endif %}
-
       {% if author.steam %}
-        <li>
+        <li><a href="https://steamcommunity.com/id/{{ author.steam }}"><i class="fa fa-fw fa-steam-square" aria-hidden="true"></i> Steam</a></li>
-          <a href="https://steamcommunity.com/id/{{ author.steam }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-steam" aria-hidden="true"></i> Steam
-          </a>
-        </li>
       {% endif %}
-
       {% if author.youtube %}
-        {% if author.youtube contains "://" %}
+        <li><a href="https://www.youtube.com/user/{{ author.youtube }}"><i class="fa fa-fw fa-youtube-square" aria-hidden="true"></i> YouTube</a></li>
-          <li>
-            <a href="{{ author.youtube }}" itemprop="sameAs">
-              <i class="fab fa-fw fa-youtube" aria-hidden="true"></i> YouTube
-            </a>
-          </li>
-        {% else author.youtube %}
-          <li>
-            <a href="https://www.youtube.com/user/{{ author.youtube }}" itemprop="sameAs">
-              <i class="fab fa-fw fa-youtube" aria-hidden="true"></i> YouTube
-            </a>
-          </li>
-        {% endif %}
       {% endif %}
-
       {% if author.soundcloud %}
-        <li>
+        <li><a href="https://soundcloud.com/{{ author.soundcloud }}"><i class="fa fa-fw fa-soundcloud" aria-hidden="true"></i> Soundcloud</a></li>
-          <a href="https://soundcloud.com/{{ author.soundcloud }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-soundcloud" aria-hidden="true"></i> SoundCloud
-          </a>
-        </li>
       {% endif %}
-
       {% if author.weibo %}
-        <li>
+        <li><a href="https://www.weibo.com/{{ author.weibo }}"><i class="fa fa-fw fa-weibo" aria-hidden="true"></i> Weibo</a></li>
-          <a href="https://www.weibo.com/{{ author.weibo }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-weibo" aria-hidden="true"></i> Weibo
-          </a>
-        </li>
       {% endif %}
-
       {% if author.flickr %}
-        <li>
+        <li><a href="https://www.flickr.com/{{ author.flickr }}"><i class="fa fa-fw fa-flickr" aria-hidden="true"></i> Flickr</a></li>
-          <a href="https://www.flickr.com/{{ author.flickr }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-flickr" aria-hidden="true"></i> Flickr
-          </a>
-        </li>
       {% endif %}
-
       {% if author.codepen %}
-        <li>
+        <li><a href="https://codepen.io/{{ author.codepen }}"><i class="fa fa-fw fa-codepen" aria-hidden="true"></i> CodePen</a></li>
-          <a href="https://codepen.io/{{ author.codepen }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-codepen" aria-hidden="true"></i> CodePen
-          </a>
-        </li>
       {% endif %}
-
       {% if author.vine %}
-        <li>
+        <li><a href="https://vine.co/u/{{ author.vine }}"><i class="fa fa-fw fa-vine" aria-hidden="true"></i> Vine</a></li>
-          <a href="https://vine.co/u/{{ author.vine }}" itemprop="sameAs">
-            <i class="fab fa-fw fa-vine" aria-hidden="true"></i> Vine
-          </a>
-        </li>
       {% endif %}
-
-      {% include author-profile-custom-links.html %}
     </ul>
   </div>
 </div>

_includes/breadcrumbs.html

@@ -1,4 +1,6 @@
-{% case site.category_archive.type %}
+{% include base_path %}
+
+{% case site.categories.type %}
   {% when "liquid" %}
     {% assign path_type = "#" %}
   {% when "jekyll-archives" %}
@@ -9,7 +11,7 @@
   {% assign path_type = nil %}
   {% assign crumb_path = '/' %}
 {% else %}
-  {% assign crumb_path = site.category_archive.path %}
+  {% assign crumb_path = site.categories.path %}
 {% endif %}
 
 <nav class="breadcrumbs">
@@ -19,7 +21,7 @@
     {% for crumb in crumbs offset: 1 %}
       {% if forloop.first %}
         <li itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem">
-          <a href="{{ site.url }}{{ site.baseurl }}/" itemprop="item"><span itemprop="name">{{ site.data.ui-text[site.locale].breadcrumb_home_label | default: "Home" }}</span></a>
+          <a href="{{ base_path }}/" itemprop="item"><span itemprop="name">{{ site.data.ui-text[site.locale].breadcrumb_home_label | default: "Home" }}</span></a>
           <meta itemprop="position" content="{{ i }}" />
         </li>
         <span class="sep">{{ site.data.ui-text[site.locale].breadcrumb_separator | default: "/" }}</span>
@@ -29,11 +31,11 @@
       {% else %}
         {% assign i = i | plus: 1 %}
         <li itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem">
-          <a href="{{ crumb | downcase | replace: '%20', '-' | prepend: path_type | prepend: crumb_path | relative_url }}" itemprop="item"><span itemprop="name">{{ crumb | replace: '-', ' ' | replace: '%20', ' ' | capitalize }}</span></a>
+          <a href="{{ base_path }}{{ crumb | downcase | replace: '%20', '-' | prepend: path_type | prepend: crumb_path }}" itemprop="item"><span itemprop="name">{{ crumb | replace: '-', ' ' | replace: '%20', ' ' | capitalize }}</span></a>
           <meta itemprop="position" content="{{ i }}" />
         </li>
         <span class="sep">{{ site.data.ui-text[site.locale].breadcrumb_separator | default: "/" }}</span>
       {% endif %}
     {% endfor %}
   </ol>
-</nav>
+</nav>

_includes/browser-upgrade.html

@@ -1,3 +1,3 @@
 <!--[if lt IE 9]>
-<div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="https://browsehappy.com/">upgrade your browser</a> to improve your experience.</div>
+<div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</div>
-<![endif]-->
+<![endif]-->

_includes/category-list.html

@@ -1,3 +1,5 @@
+{% include base_path %}
+
 {% case site.category_archive.type %}
   {% when "liquid" %}
     {% assign path_type = "#" %}
@@ -11,15 +13,15 @@
     <!-- modified from http://www.codeofclimber.ru/2015/sorting-site-tags-in-jekyll/ -->
   {% endcomment %}
   {% capture page_categories %}{% for category in page.categories %}{{ category | downcase }}#{{ category }}{% unless forloop.last %},{% endunless %}{% endfor %}{% endcapture %}
-  {% assign category_hashes = page_categories | split: ',' | sort %}
+  {% assign category_hashes = (page_categories | split: ',' | sort:0) %}
 
   <p class="page__taxonomy">
-    <strong><i class="fas fa-fw fa-folder-open" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].categories_label | default: "Categories:" }} </strong>
+    <strong><i class="fa fa-fw fa-folder-open" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].categories_label | default: "Categories:" }} </strong>
     <span itemprop="keywords">
     {% for hash in category_hashes %}
       {% assign keyValue = hash | split: '#' %}
       {% capture category_word %}{{ keyValue[1] | strip_newlines }}{% endcapture %}
-      <a href="{{ category_word | slugify | prepend: path_type | prepend: site.category_archive.path | relative_url }}" class="page__taxonomy-item" rel="tag">{{ category_word }}</a>{% unless forloop.last %}<span class="sep">, </span>{% endunless %}
+      <a href="{{ base_path }}{{ category_word | slugify | prepend: path_type | prepend: site.category_archive.path }}" class="page__taxonomy-item" rel="tag">{{ category_word }}</a>{% unless forloop.last %}<span class="sep">, </span>{% endunless %}
     {% endfor %}
     </span>
   </p>

_includes/comment.html

@@ -1,6 +1,6 @@
 <article id="comment{{ include.index }}" class="js-comment comment" itemprop="comment" itemscope itemtype="http://schema.org/Comment">
   <div class="comment__avatar-wrapper">
-    <img class="comment__avatar" src="https://www.gravatar.com/avatar/{{ include.email }}?d=mm&s=80" alt="{{ include.name }}">
+    <img class="comment__avatar" src="https://www.gravatar.com/avatar/{{ include.email }}?d=mm&s=80">
   </div>
   <div class="comment__content-wrapper">
     <h3 class="comment__author" itemprop="author" itemscope itemtype="http://schema.org/Person">
@@ -19,4 +19,4 @@
     </p>
     <div itemprop="text">{{ include.message | markdownify }}</div>
   </div>
-</article>
+</article>

_includes/comments-providers/discourse.html

@@ -1,5 +1,6 @@
 {% if site.comments.discourse.server %}
-{% capture canonical %}{% if site.permalink contains '.html' %}{{ page.url | absolute_url }}{% else %}{{ page.url | absolute_url | remove:'index.html' | strip_slash }}{% endif %}{% endcapture %}
+{% include base_path %}
+{% capture canonical %}{{ base_path }}{% if site.permalink contains '.html' %}{{ page.url }}{% else %}{{ page.url | remove:'index.html' | strip_slash }}{% endif %}{% endcapture %}
 <script type="text/javascript">
     DiscourseEmbed = { discourseUrl: '//{{ site.comments.discourse.server }}/',
                        discourseEmbedUrl: '{{ canonical }}' };
@@ -9,5 +10,5 @@
      (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);
    })();
 </script>
-<noscript>Please enable JavaScript to view the comments powered by <a href="https://www.discourse.org/">Discourse.</a></noscript>
+<noscript>Please enable JavaScript to view the comments powered by [Discourse](http://forum.beta-europe.org/c/beta/website).</a></noscript>
-{% endif %}
+{% endif %}

_includes/comments-providers/disqus.html

@@ -1,15 +1,22 @@
 {% if site.comments.disqus.shortname %}
-  <script>
+  <script type="text/javascript">
-    var disqus_config = function () {
+  	/* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
-      this.page.url = "{{ page.url | absolute_url }}";  // Replace PAGE_URL with your page's canonical URL variable
+  	var disqus_shortname = '{{ site.comments.disqus.shortname }}';
-      this.page.identifier = "{{ page.id }}"; // Replace PAGE_IDENTIFIER with your page's unique identifier variable
+
-    };
+  	/* * * DON'T EDIT BELOW THIS LINE * * */
-    (function() { // DON'T EDIT BELOW THIS LINE
+  	(function() {
-      var d = document, s = d.createElement('script');
+  		var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
-      s.src = 'https://{{ site.comments.disqus.shortname }}.disqus.com/embed.js';
+  		dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
-      s.setAttribute('data-timestamp', +new Date());
+  		(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
-      (d.head || d.body).appendChild(s);
+  	})();
-    })();
+
+  	/* * * DON'T EDIT BELOW THIS LINE * * */
+  	(function () {
+  		var s = document.createElement('script'); s.async = true;
+  		s.type = 'text/javascript';
+  		s.src = '//' + disqus_shortname + '.disqus.com/count.js';
+  		(document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
+  	}());
   </script>
-<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+  <noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
-{% endif %}
+{% endif %}

_includes/comments-providers/scripts.html

@@ -1,18 +1,18 @@
 {% if site.comments.provider and page.comments %}
+
 {% case site.comments.provider %}
-  {% when "disqus" %}
+{% when "disqus" %}
-    {% include /comments-providers/disqus.html %}
+  {% include /comments-providers/disqus.html %}
-  {% when "discourse" %}
+{% when "discourse" %}
-    {% include /comments-providers/discourse.html %}
+  {% include /comments-providers/discourse.html %}
-  {% when "facebook" %}
+{% when "facebook" %}
-    {% include /comments-providers/facebook.html %}
+  {% include /comments-providers/facebook.html %}
-  {% when "google-plus" %}
+{% when "google-plus" %}
-    {% include /comments-providers/google-plus.html %}
+  {% include /comments-providers/google-plus.html %}
-  {% when "staticman" %}
+{% when "staticman" %}
-    {% include /comments-providers/staticman.html %}
+  {% include /comments-providers/staticman.html %}
-  {% when "staticman_v2" %}
+{% when "custom" %}
-    {% include /comments-providers/staticman_v2.html %}
+  {% include /comments-providers/custom.html %}
-  {% when "custom" %}
-    {% include /comments-providers/custom.html %}
 {% endcase %}
+
 {% endif %}

_includes/comments-providers/staticman.html

@@ -7,7 +7,7 @@
       var form = this;
 
       $(form).addClass('disabled');
-      $('#comment-form-submit').html('<i class="fas fa-spinner fa-spin fa-fw"></i> {{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}');
+      $('#comment-form-submit').html('<i class="fa fa-spinner fa-spin fa-fw"></i> {{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}');
 
       $.ajax({
         type: $(this).attr('method'),

_includes/comments-providers/staticman_v2.html

@@ -1,42 +0,0 @@
-{% if site.repository and site.staticman.branch %}
-  <script>
-    (function ($) {
-    var $comments = $('.js-comments');
-
-    $('#new_comment').submit(function () {
-      var form = this;
-
-      $(form).addClass('disabled');
-      $('#comment-form-submit').html('<i class="fas fa-spinner fa-spin fa-fw"></i> {{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}');
-
-      $.ajax({
-        type: $(this).attr('method'),
-        url: $(this).attr('action'),
-        data: $(this).serialize(),
-        contentType: 'application/x-www-form-urlencoded',
-        success: function (data) {
-          $('#comment-form-submit').html('{{ site.data.ui-text[site.locale].comment_btn_submitted | default: "Submitted" }}');
-          $('.page__comments-form .js-notice').removeClass('notice--danger');
-          $('.page__comments-form .js-notice').addClass('notice--success');
-          showAlert('{{ site.data.ui-text[site.locale].comment_success_msg | default: "Thanks for your comment! It will show on the site once it has been approved." }}');
-        },
-        error: function (err) {
-          console.log(err);
-          $('#comment-form-submit').html('{{ site.data.ui-text[site.locale].comment_btn_submit  | default: "Submit Comment" }}');
-          $('.page__comments-form .js-notice').removeClass('notice--success');
-          $('.page__comments-form .js-notice').addClass('notice--danger');
-          showAlert('{{ site.data.ui-text[site.locale].comment_error_msg | default: "Sorry, there was an error with your submission. Please make sure all required fields have been completed and try again." }}');
-          $(form).removeClass('disabled');
-        }
-      });
-
-      return false;
-    });
-
-    function showAlert(message) {
-      $('.page__comments-form .js-notice').removeClass('hidden');
-      $('.page__comments-form .js-notice-text').html(message);
-    }
-  })(jQuery);
-  </script>
-{% endif %}

_includes/comments.html

@@ -1,171 +1,82 @@
+{% include base_path %}
+
 <div class="page__comments">
   {% capture comments_label %}{{ site.data.ui-text[site.locale].comments_label | default: "Comments" }}{% endcapture %}
   {% case site.comments.provider %}
-    {% when "discourse" %}
+  {% when "disqus" %}
-      <h4 class="page__comments-title">{{ comments_label }}</h4>
+    <h4 class="page__comments-title">{{ comments_label }}</h4>
-      <section id="discourse-comments"></section>
+    <section id="disqus_thread"></section>
-    {% when "disqus" %}
+  {% when "facebook" %}
-      <h4 class="page__comments-title">{{ comments_label }}</h4>
+    <h4 class="page__comments-title">{{ comments_label }}</h4>
-      <section id="disqus_thread"></section>
+    <section class="fb-comments" data-href="{{ base_path }}{{ page.url }}" data-mobile="true" data-num-posts="{{ site.comments.facebook.num_posts | default: 5 }}" data-width="100%" data-colorscheme="{{ site.comments.facebook.colorscheme | default: 'light' }}"></section>
-    {% when "facebook" %}
+  {% when "google-plus" %}
-      <h4 class="page__comments-title">{{ comments_label }}</h4>
+    <h4 class="page__comments-title">{{ comments_label }}</h4>
-      <section class="fb-comments" data-href="{{ page.url | absolute_url }}" data-mobile="true" data-num-posts="{{ site.comments.facebook.num_posts | default: 5 }}" data-width="100%" data-colorscheme="{{ site.comments.facebook.colorscheme | default: 'light' }}"></section>
+    <section class="g-comments" data-href="{{ base_path }}{{ page.url }}" data-first_party_property="BLOGGER" data-view_type="FILTERED_POSTMOD">Loading Google+ Comments ...</section>
-    {% when "google-plus" %}
+  {% when "staticman" %}
-      <h4 class="page__comments-title">{{ comments_label }}</h4>
+    <section id="comments">
-      <section id="g-comments" class="g-comments">Loading Google+ Comments ...</section>
+      {% if site.repository and site.staticman.branch %}
-      <script>
+        <!-- Start static comments -->
-        function initComment() {
+        <div class="js-comments">
-          gapi.comments.render("g-comments", {
+          {% if site.data.comments[page.slug] %}
-            href: "{{ page.url | absolute_url }}",
+            <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_title | default: "Comments" }}</h4>
-            width: "624",
+            {% assign comments = site.data.comments[page.slug] | sort %}
-            first_party_property: "BLOGGER",
-            view_type: "FILTERED_POSTMOD"
-          })
-        }
-      </script>
-      <script async type="text/javascript" src="https://apis.google.com/js/plusone.js" onload="initComment()" />
-      <noscript>Please enable JavaScript to view the <a href="https://plus.google.com/">comments powered by Google+.</a></noscript>-->
-    {% when "staticman_v2" %}
-      <section id="static-comments">
-        {% if site.repository and site.staticman.branch %}
-          <!-- Start static comments -->
-          <div class="js-comments">
-            {% if site.data.comments[page.slug] %}
-              <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_title | default: "Comments" }}</h4>
-              {% assign comments = site.data.comments[page.slug] | sort %}
 
-              {% for comment in comments %}
+            {% for comment in comments %}
-                {% assign email = comment[1].email %}
+              {% assign email = comment[1].email %}
-                {% assign name = comment[1].name %}
+              {% assign name = comment[1].name %}
-                {% assign url = comment[1].url %}
+              {% assign url = comment[1].url %}
-                {% assign date = comment[1].date %}
+              {% assign date = comment[1].date %}
-                {% assign message = comment[1].message %}
+              {% assign message = comment[1].message %}
-                {% include comment.html index=forloop.index email=email name=name url=url date=date message=message %}
+              {% include comment.html index=forloop.index email=email name=name url=url date=date message=message %}
-              {% endfor %}
+            {% endfor %}
-            {% endif %}
+          {% endif %}
+        </div>
+        <!-- End static comments -->
+
+        <!-- Start new comment form -->
+        <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_label | default: "Leave a Comment" }}</h4>
+        <p class="small">{{ site.data.ui-text[site.locale].comment_form_info | default: "Your email address will not be published. Required fields are marked" }} <span class="required">*</span></p>
+        <form id="new_comment" class="page__comments-form js-form form" method="post" action="https://api.staticman.net/v1/entry/{{ site.repository }}/{{ site.staticman.branch }}">
+          <div class="form__spinner">
+            <i class="fa fa-spinner fa-spin fa-3x fa-fw"></i>
+            <span class="sr-only">{{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}</span>
           </div>
-          <!-- End static comments -->
 
-          <!-- Start new comment form -->
+          <fieldset>
-          <div class="page__comments-form">
+            <label for="comment-form-message">{{ site.data.ui-text[site.locale].comment_form_comment_label | default: "Comment" }} <small class="required">*</small></label>
-            <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_label | default: "Leave a Comment" }}</h4>
+            <textarea type="text" rows="3" id="comment-form-message" name="fields[message]" tabindex="1"></textarea>
-            <p class="small">{{ site.data.ui-text[site.locale].comment_form_info | default: "Your email address will not be published. Required fields are marked" }} <span class="required">*</span></p>
+            <div class="small help-block"><a href="https://daringfireball.net/projects/markdown/">{{ site.data.ui-text[site.locale].comment_form_md_info | default: "Markdown is supported." }}</a></div>
-            <form id="new_comment" class="page__comments-form js-form form" method="post" action="https://api.staticman.net/v2/entry/{{ site.repository }}/{{ site.staticman.branch }}/comments">
+          </fieldset>
-              <div class="form__spinner">
+          <fieldset>
-                <i class="fas fa-spinner fa-spin fa-3x fa-fw"></i>
+            <label for="comment-form-name">{{ site.data.ui-text[site.locale].comment_form_name_label | default: "Name" }} <small class="required">*</small></label>
-                <span class="sr-only">{{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}</span>
+            <input type="text" id="comment-form-name" name="fields[name]" tabindex="2" />
-              </div>
+          </fieldset>
-
+          <fieldset>
-              <div class="form-group">
+            <label for="comment-form-email">{{ site.data.ui-text[site.locale].comment_form_email_label | default: "Email address" }} <small class="required">*</small></label>
-                <label for="comment-form-message">{{ site.data.ui-text[site.locale].comment_form_comment_label | default: "Comment" }} <small class="required">*</small></label>
+            <input type="email" id="comment-form-email" name="fields[email]" tabindex="3" />
-                <textarea type="text" rows="3" id="comment-form-message" name="fields[message]" tabindex="1"></textarea>
+          </fieldset>
-                <div class="small help-block"><a href="https://daringfireball.net/projects/markdown/">{{ site.data.ui-text[site.locale].comment_form_md_info | default: "Markdown is supported." }}</a></div>
+          <fieldset>
-              </div>
+            <label for="comment-form-url">{{ site.data.ui-text[site.locale].comment_form_website_label | default: "Website (optional)" }}</label>
-              <div class="form-group">
+            <input type="url" id="comment-form-url" name="fields[url]" tabindex="4"/>
-                <label for="comment-form-name">{{ site.data.ui-text[site.locale].comment_form_name_label | default: "Name" }} <small class="required">*</small></label>
+          </fieldset>
-                <input type="text" id="comment-form-name" name="fields[name]" tabindex="2" />
+          <fieldset class="hidden" style="display: none;">
-              </div>
+            <input type="hidden" name="options[slug]" value="{{ page.slug }}">
-              <div class="form-group">
+            <label for="comment-form-location">Not used. Leave blank if you are a human.</label>
-                <label for="comment-form-email">{{ site.data.ui-text[site.locale].comment_form_email_label | default: "Email address" }} <small class="required">*</small></label>
+            <input type="text" id="comment-form-location" name="fields[hidden]" autocomplete="off"/>
-                <input type="email" id="comment-form-email" name="fields[email]" tabindex="3" />
+          </fieldset>
-              </div>
+          <!-- Start comment form alert messaging -->
-              <div class="form-group">
+          <p class="hidden js-notice">
-                <label for="comment-form-url">{{ site.data.ui-text[site.locale].comment_form_website_label | default: "Website (optional)" }}</label>
+            <strong class="js-notice-text"></strong>
-                <input type="url" id="comment-form-url" name="fields[url]" tabindex="4"/>
+          </p>
-              </div>
+          <!-- End comment form alert messaging -->
-              <div class="form-group hidden" style="display: none;">
+          <fieldset>
-                <input type="hidden" name="options[slug]" value="{{ page.slug }}">
+            <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
-                <label for="comment-form-location">Not used. Leave blank if you are a human.</label>
+          </fieldset>
-                <input type="text" id="comment-form-location" name="fields[hidden]" autocomplete="off"/>
+        </form>
-                {% if site.reCaptcha.siteKey %}<input type="hidden" name="options[reCaptcha][siteKey]" value="{{ site.reCaptcha.siteKey }}">{% endif %}
+        <!-- End new comment form -->
-                {% if site.reCaptcha.secret %}<input type="hidden" name="options[reCaptcha][secret]" value="{{ site.reCaptcha.secret }}">{% endif %}
+      {% endif %}
-              </div>
+    </section>
-              <!-- Start comment form alert messaging -->
+  {% when "custom" %}
-              <p class="hidden js-notice">
+    <section id="comments"></section>
-                <strong class="js-notice-text"></strong>
-              </p>
-              <!-- End comment form alert messaging -->
-              {% if site.reCaptcha.siteKey %}
-                <div class="form-group">
-                  <div class="g-recaptcha" data-sitekey="{{ site.reCaptcha.siteKey }}"></div>
-                </div>
-              {% endif %}
-              <div class="form-group">
-                <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--primary btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
-              </div>
-            </form>
-          </div>
-          <!-- End new comment form -->
-          {% if site.reCaptcha.siteKey %}<script async src="https://www.google.com/recaptcha/api.js"></script>{% endif %}
-        {% endif %}
-      </section>
-    {% when "staticman" %}
-      <section id="static-comments">
-        {% if site.repository and site.staticman.branch %}
-          <!-- Start static comments -->
-          <div class="js-comments">
-            {% if site.data.comments[page.slug] %}
-              <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_title | default: "Comments" }}</h4>
-              {% assign comments = site.data.comments[page.slug] | sort %}
-
-              {% for comment in comments %}
-                {% assign email = comment[1].email %}
-                {% assign name = comment[1].name %}
-                {% assign url = comment[1].url %}
-                {% assign date = comment[1].date %}
-                {% assign message = comment[1].message %}
-                {% include comment.html index=forloop.index email=email name=name url=url date=date message=message %}
-              {% endfor %}
-            {% endif %}
-          </div>
-          <!-- End static comments -->
-
-          <!-- Start new comment form -->
-          <div class="page__comments-form">
-            <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_label | default: "Leave a Comment" }}</h4>
-            <p class="small">{{ site.data.ui-text[site.locale].comment_form_info | default: "Your email address will not be published. Required fields are marked" }} <span class="required">*</span></p>
-            <form id="new_comment" class="page__comments-form js-form form" method="post" action="https://api.staticman.net/v1/entry/{{ site.repository }}/{{ site.staticman.branch }}">
-              <div class="form__spinner">
-                <i class="fas fa-spinner fa-spin fa-3x fa-fw"></i>
-                <span class="sr-only">{{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}</span>
-              </div>
-
-              <div class="form-group">
-                <label for="comment-form-message">{{ site.data.ui-text[site.locale].comment_form_comment_label | default: "Comment" }} <small class="required">*</small></label>
-                <textarea type="text" rows="3" id="comment-form-message" name="fields[message]" tabindex="1"></textarea>
-                <div class="small help-block"><a href="https://daringfireball.net/projects/markdown/">{{ site.data.ui-text[site.locale].comment_form_md_info | default: "Markdown is supported." }}</a></div>
-              </div>
-              <div class="form-group">
-                <label for="comment-form-name">{{ site.data.ui-text[site.locale].comment_form_name_label | default: "Name" }} <small class="required">*</small></label>
-                <input type="text" id="comment-form-name" name="fields[name]" tabindex="2" />
-              </div>
-              <div class="form-group">
-                <label for="comment-form-email">{{ site.data.ui-text[site.locale].comment_form_email_label | default: "Email address" }} <small class="required">*</small></label>
-                <input type="email" id="comment-form-email" name="fields[email]" tabindex="3" />
-              </div>
-              <div class="form-group">
-                <label for="comment-form-url">{{ site.data.ui-text[site.locale].comment_form_website_label | default: "Website (optional)" }}</label>
-                <input type="url" id="comment-form-url" name="fields[url]" tabindex="4"/>
-              </div>
-              <div class="form-group hidden" style="display: none;">
-                <input type="hidden" name="options[slug]" value="{{ page.slug }}">
-                <label for="comment-form-location">Not used. Leave blank if you are a human.</label>
-                <input type="text" id="comment-form-location" name="fields[hidden]" autocomplete="off"/>
-              </div>
-              <!-- Start comment form alert messaging -->
-              <p class="hidden js-notice">
-                <strong class="js-notice-text"></strong>
-              </p>
-              <!-- End comment form alert messaging -->
-              <div class="form-group">
-                <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--primary btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
-              </div>
-            </form>
-          </div>
-          <!-- End new comment form -->
-        {% endif %}
-      </section>
-    {% when "custom" %}
-      <section id="custom-comments"></section>
   {% endcase %}
 </div>

_includes/documents-collection.html

@@ -1,19 +0,0 @@
-{% assign entries = site[include.collection] %}
-
-{% if include.sort_by == 'title' %}
-  {% if include.sort_order == 'reverse' %}
-    {% assign entries = entries | sort: 'title' | reverse %}
-  {% else %}
-    {% assign entries = entries | sort: 'title' %}
-  {% endif %}
-{% elsif include.sort_by == 'date' %}
-  {% if include.sort_order == 'reverse' %}
-    {% assign entries = entries | sort: 'date' | reverse %}
-  {% else %}
-    {% assign entries = entries | sort: 'date' %}
-  {% endif %}
-{% endif %}
-
-{%- for post in entries -%}
-  {% include archive-single.html %}
-{%- endfor -%}

_includes/feature_row

@@ -1,5 +1,7 @@
+{% include base_path %}
+
 {% if include.id %}
-  {% assign feature_row = page[include.id] %}
+  {% assign feature_row = page.[include.id] %}
 {% else %}
   {% assign feature_row = page.feature_row %}
 {% endif %}
@@ -11,7 +13,7 @@
     {% if f.url contains "://" %}
       {% capture f_url %}{{ f.url }}{% endcapture %}
     {% else %}
-      {% capture f_url %}{{ f.url | relative_url }}{% endcapture %}
+      {% capture f_url %}{{ f.url | prepend: base_path }}{% endcapture %}
     {% endif %}
 
     <div class="feature__item{% if include.type %}--{{ include.type }}{% endif %}">
@@ -22,12 +24,9 @@
               {% if f.image_path contains "://" %}
                 "{{ f.image_path }}"
               {% else %}
-                "{{ f.image_path | relative_url }}"
+                "{{ f.image_path | prepend: "/images/" | prepend: base_path }}"
               {% endif %}
             alt="{% if f.alt %}{{ f.alt }}{% endif %}">
-            {% if f.image_caption %}
-              <span class="archive__item-caption">{{ f.image_caption | markdownify | remove: "<p>" | remove: "</p>" }}</span>
-            {% endif %}
           </div>
         {% endif %}
 

_includes/figure

@@ -1,12 +0,0 @@
-<figure class="{{ include.class }}">
-  <img src=
-    {% if include.image_path contains "://" %}
-      "{{ include.image_path }}"
-    {% else %}
-      "{{ include.image_path | relative_url }}"
-    {% endif %}
-    alt="{% if include.alt %}{{ include.alt }}{% endif %}">
-  {% if include.caption %}
-    <figcaption>{{ include.caption | markdownify | remove: "<p>" | remove: "</p>" }}</figcaption>
-  {% endif %}
-</figure>

_includes/footer.html

@@ -1,25 +1,24 @@
+{% include base_path %}
+
 <div class="page__footer-follow">
   <ul class="social-icons">
     {% if site.data.ui-text[site.locale].follow_label %}
       <li><strong>{{ site.data.ui-text[site.locale].follow_label }}</strong></li>
     {% endif %}
     {% if site.twitter.username %}
-      <li><a href="https://twitter.com/{{ site.twitter.username }}"><i class="fab fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li>
+      <li><a href="https://twitter.com/{{ site.twitter.username }}"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li>
     {% endif %}
     {% if site.facebook.username %}
-      <li><a href="https://www.facebook.com/{{ site.facebook.username }}"><i class="fab fa-fw fa-facebook-square" aria-hidden="true"></i> Facebook</a></li>
+      <li><a href="https://facebook.com/{{ site.facebook.username }}"><i class="fa fa-fw fa-facebook-square" aria-hidden="true"></i> Facebook</a></li>
     {% endif %}
     {% if site.author.github %}
-      <li><a href="https://github.com/{{ site.author.github }}"><i class="fab fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li>
+      <li><a href="http://github.com/{{ site.author.github }}"><i class="fa fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li>
-    {% endif %}
-    {% if site.author.gitlab %}
-      <li><a href="https://gitlab.com/{{ site.author.gitlab }}"><i class="fab fa-fw fa-gitlab" aria-hidden="true"></i> Gitlab</a></li>
     {% endif %}
     {% if site.author.bitbucket %}
-      <li><a href="https://bitbucket.org/{{ site.author.bitbucket }}"><i class="fab fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket</a></li>
+      <li><a href="http://bitbucket.org/{{ site.author.bitbucket }}"><i class="fa fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket</a></li>
     {% endif %}
-    <li><a href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ '/feed.xml' | relative_url }}{% endif %}"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].feed_label | default: "Feed" }}</a></li>
+    <li><a href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ base_path }}/feed.xml{% endif %}"><i class="fa fa-fw fa-rss-square" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].feed_label | default: "Feed" }}</a></li>
   </ul>
 </div>
 
-<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>
+<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>

_includes/gallery

@@ -1,5 +1,7 @@
+{% include base_path %}
+
 {% if include.id %}
-  {% assign gallery = page[include.id] %}
+  {% assign gallery = page.[include.id] %}
 {% else %}
   {% assign gallery = page.gallery %}
 {% endif %}
@@ -19,7 +21,7 @@
         {% if img.url contains "://" %}
           "{{ img.url }}"
         {% else %}
-          "{{ img.url | relative_url }}"
+          "{{ img.url | prepend: "/images/" | prepend: base_path }}"
         {% endif %}
         {% if img.title %}title="{{ img.title }}"{% endif %}
       >
@@ -27,7 +29,7 @@
           {% if img.image_path contains "://" %}
             "{{ img.image_path }}"
           {% else %}
-            "{{ img.image_path | relative_url }}"
+            "{{ img.image_path | prepend: "/images/" | prepend: base_path }}"
           {% endif %}
           alt="{% if img.alt %}{{ img.alt }}{% endif %}">
       </a>
@@ -36,7 +38,7 @@
         {% if img.image_path contains "://" %}
           "{{ img.image_path }}"
         {% else %}
-          "{{ img.image_path | relative_url }}"
+          "{{ img.image_path | prepend: "/images/" | prepend: base_path }}"
         {% endif %}
         alt="{% if img.alt %}{{ img.alt }}{% endif %}">
     {% endif %}

_includes/group-by-array

@@ -18,7 +18,7 @@
 
 <!-- Uniq -->
 {% assign __names =  __names | sort %}
-{% for name in __names %}
+{% for name in __names | sort %}
 
 <!-- If not equal to previous then it must be unique as sorted -->
 {% unless name == previous %}

_includes/head.html

@@ -1,8 +1,10 @@
+{% include base_path %}
+
 <meta charset="utf-8">
 
 {% include seo.html %}
 
-<link href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ '/feed.xml' | relative_url }}{% endif %}" type="application/atom+xml" rel="alternate" title="{{ site.title }} Feed">
+<link href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ base_path }}/feed.xml{% endif %}" type="application/atom+xml" rel="alternate" title="{{ site.title }} Feed">
 
 <!-- http://t.co/dKP3o1e -->
 <meta name="HandheldFriendly" content="True">
@@ -14,30 +16,6 @@
 </script>
 
 <!-- For all browsers -->
-<link rel="stylesheet" href="{{ '/assets/css/main.css' | relative_url }}">
+<link rel="stylesheet" href="{{ base_path }}/assets/css/main.css">
 
-<!--[if lte IE 9]>
+<meta http-equiv="cleartype" content="on">
-  <style>
-    /* old IE unsupported flexbox fixes */
-    .greedy-nav .site-title {
-      padding-right: 3em;
-    }
-    .greedy-nav button {
-      position: absolute;
-      top: 0;
-      right: 0;
-      height: 100%;
-    }
-  </style>
-<![endif]-->
-
-{% if site.head_scripts %}
-  {% for script in site.head_scripts %}
-    {% if script contains "://" %}
-      {% capture script_path %}{{ script }}{% endcapture %}
-    {% else %}
-      {% capture script_path %}{{ script | relative_url }}{% endcapture %}
-    {% endif %}
-    <script src="{{ script_path }}"></script>
-  {% endfor %}
-{% endif %}

_includes/head/custom.html

@@ -1,5 +1,26 @@
+{% include base_path %}
+
 <!-- start custom head snippets -->
 
-<!-- insert favicons. use https://realfavicongenerator.net/ -->
+<link rel="apple-touch-icon" sizes="57x57" href="{{ base_path }}/images/apple-touch-icon-57x57.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="60x60" href="{{ base_path }}/images/apple-touch-icon-60x60.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="72x72" href="{{ base_path }}/images/apple-touch-icon-72x72.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="76x76" href="{{ base_path }}/images/apple-touch-icon-76x76.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="114x114" href="{{ base_path }}/images/apple-touch-icon-114x114.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="120x120" href="{{ base_path }}/images/apple-touch-icon-120x120.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="144x144" href="{{ base_path }}/images/apple-touch-icon-144x144.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="152x152" href="{{ base_path }}/images/apple-touch-icon-152x152.png?v=M44lzPylqQ">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ base_path }}/images/apple-touch-icon-180x180.png?v=M44lzPylqQ">
+<link rel="icon" type="image/png" href="{{ base_path }}/images/favicon-32x32.png?v=M44lzPylqQ" sizes="32x32">
+<link rel="icon" type="image/png" href="{{ base_path }}/images/android-chrome-192x192.png?v=M44lzPylqQ" sizes="192x192">
+<link rel="icon" type="image/png" href="{{ base_path }}/images/favicon-96x96.png?v=M44lzPylqQ" sizes="96x96">
+<link rel="icon" type="image/png" href="{{ base_path }}/images/favicon-16x16.png?v=M44lzPylqQ" sizes="16x16">
+<link rel="manifest" href="{{ base_path }}/images/manifest.json?v=M44lzPylqQ">
+<link rel="mask-icon" href="{{ base_path }}/images/safari-pinned-tab.svg?v=M44lzPylqQ" color="#000000">
+<link rel="shortcut icon" href="/images/favicon.ico?v=M44lzPylqQ">
+<meta name="msapplication-TileColor" content="#000000">
+<meta name="msapplication-TileImage" content="{{ base_path }}/images/mstile-144x144.png?v=M44lzPylqQ">
+<meta name="msapplication-config" content="{{ base_path }}/images/browserconfig.xml?v=M44lzPylqQ">
+<meta name="theme-color" content="#ffffff">
 
-<!-- end custom head snippets -->
+<!-- end custom head snippets -->

_includes/masthead.html

@@ -1,31 +1,21 @@
+{% include base_path %}
+
 <div class="masthead">
   <div class="masthead__inner-wrap">
     <div class="masthead__menu">
       <nav id="site-nav" class="greedy-nav">
-        <a class="site-title" href="{{ '/' | relative_url }}">{{ site.title }}</a>
+        <button><div class="navicon"></div></button>
         <ul class="visible-links">
+          <li class="masthead__menu-item masthead__menu-item--lg"><a href="{{ base_path }}/">{{ site.title }}</a></li>
           {% for link in site.data.navigation.main %}
             {% if link.url contains 'http' %}
               {% assign domain = '' %}
-            {% else %}
+              {% else %}
-              {% assign domain = site.url | append: site.baseurl %}
+              {% assign domain = base_path %}
             {% endif %}
-            <li class="masthead__menu-item">
+            <li class="masthead__menu-item"><a href="{{ domain }}{{ link.url }}">{{ link.title }}</a></li>
-              <a href="{{ domain }}{{ link.url }}" {% if link.description %}title="{{ link.description }}"{% endif %}>{{ link.title }}</a>
-            </li>
           {% endfor %}
         </ul>
-        {% 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 hidden" type="button">
-          <span class="visually-hidden">{{ site.data.ui-text[site.locale].menu_label | default: "Toggle Menu" }}</span>
-          <div class="navicon"></div>
-        </button>
         <ul class="hidden-links hidden"></ul>
       </nav>
     </div>

_includes/nav_list

@@ -1,21 +1,20 @@
+{% include base_path %}
 {% assign navigation = site.data.navigation[include.nav] %}
 
 <nav class="nav__list">
-  {% if page.sidebar.title %}<h3 class="nav__title" style="padding-left: 0;">{{ page.sidebar.title }}</h3>{% endif %}
+  {% if page.sidebar.title %}<header><h4 class="nav__title" style="padding: 0;">{{ page.sidebar.title }}</h4></header>{% endif %}
-  <input id="ac-toc" name="accordion-toc" type="checkbox" />
+  <ul>
-  <label for="ac-toc">{{ site.data.ui-text[site.locale].menu_label | default: "Toggle Menu" }}</label>
-  <ul class="nav__items">
     {% for nav in navigation %}
       <li>
         {% if nav.url %}
-          {% comment %} internal/external URL check {% endcomment %}
+          {% comment %}internal/external URL check{% endcomment %}
           {% if nav.url contains "://" %}
-            {% assign nav_url = nav.url %}
+            {% assign domain = "" %}
           {% else %}
-            {% assign nav_url = nav.url | relative_url %}
+            {% assign domain = base_path %}
           {% endif %}
 
-          <a href="{{ nav_url }}"><span class="nav__sub-title">{{ nav.title }}</span></a>
+          <a href="{{ domain }}{{ nav.url }}"><span class="nav__sub-title">{{ nav.title }}</span></a>
         {% else %}
           <span class="nav__sub-title">{{ nav.title }}</span>
         {% endif %}
@@ -23,21 +22,21 @@
         {% if nav.children != null %}
         <ul>
           {% for child in nav.children %}
-            {% comment %} internal/external URL check {% endcomment %}
+            {% comment %}internal/external URL check{% endcomment %}
             {% if child.url contains "://" %}
-              {% assign child_url = child.url %}
+              {% assign domain = "" %}
             {% else %}
-              {% assign child_url = child.url | relative_url %}
+              {% assign domain = base_path %}
             {% endif %}
 
-            {% comment %} set "active" class on current page {% endcomment %}
+            {% comment %}set "active" class on current page{% endcomment %}
             {% if child.url == page.url %}
               {% assign active = "active" %}
             {% else %}
               {% assign active = "" %}
             {% endif %}
 
-            <li><a href="{{ child_url }}" class="{{ active }}">{{ child.title }}</a></li>
+            <li><a href="{{ domain }}{{ child.url }}" class="{{ active }}">{{ child.title }}</a></li>
           {% endfor %}
         </ul>
         {% endif %}

_includes/page__hero.html

@@ -1,19 +1,21 @@
+{% include base_path %}
+
 {% if page.header.image contains "://" %}
   {% capture img_path %}{{ page.header.image }}{% endcapture %}
 {% else %}
-  {% capture img_path %}{{ page.header.image | relative_url }}{% endcapture %}
+  {% capture img_path %}{{ page.header.image | prepend: "/images/" | prepend: base_path }}{% endcapture %}
 {% endif %}
 
 {% if page.header.cta_url contains "://" %}
   {% capture cta_path %}{{ page.header.cta_url }}{% endcapture %}
 {% else %}
-  {% capture cta_path %}{{ page.header.cta_url | relative_url }}{% endcapture %}
+  {% capture cta_path %}{{ page.header.cta_url | prepend: base_path }}{% endcapture %}
 {% endif %}
 
 {% if page.header.overlay_image contains "://" %}
   {% capture overlay_img_path %}{{ page.header.overlay_image }}{% endcapture %}
 {% elsif page.header.overlay_image %}
-  {% capture overlay_img_path %}{{ page.header.overlay_image | relative_url }}{% endcapture %}
+  {% capture overlay_img_path %}{{ page.header.overlay_image | prepend: "/images/" | prepend: base_path }}{% endcapture %}
 {% endif %}
 
 {% if page.header.overlay_filter contains "rgba" %}
@@ -22,40 +24,32 @@
   {% capture overlay_filter %}rgba(0, 0, 0, {{ page.header.overlay_filter }}){% endcapture %}
 {% endif %}
 
-{% if page.header.image_description %}
-  {% assign image_description = page.header.image_description %}
-{% else %}
-  {% assign image_description = page.title %}
-{% endif %}
-
-{% assign image_description = image_description | markdownify | strip_html | strip_newlines | escape_once %}
-
 <div class="page__hero{% if page.header.overlay_color or page.header.overlay_image %}--overlay{% endif %}"
   style="{% if page.header.overlay_color %}background-color: {{ page.header.overlay_color | default: 'transparent' }};{% endif %} {% if overlay_img_path %}background-image: {% if overlay_filter %}linear-gradient({{ overlay_filter }}, {{ overlay_filter }}), {% endif %}url('{{ overlay_img_path }}');{% endif %}"
 >
   {% if page.header.overlay_color or page.header.overlay_image %}
     <div class="wrapper">
-      <h1 id="page-title" class="page__title" itemprop="headline">
+      <h1 class="page__title" itemprop="headline">
-        {% if paginator and site.paginate_show_page_num %}
+        {% if paginator %}
           {{ site.title }}{% unless paginator.page == 1 %} {{ site.data.ui-text[site.locale].page | default: "Page" }} {{ paginator.page }}{% endunless %}
         {% else %}
           {{ page.title | default: site.title | markdownify | remove: "<p>" | remove: "</p>" }}
         {% endif %}
       </h1>
-      {% if page.header.show_overlay_excerpt != false and page.excerpt %}
+      {% if page.excerpt %}
         <p class="page__lead">{{ page.excerpt | markdownify | remove: "<p>" | remove: "</p>" }}</p>
       {% endif %}
       {% if site.read_time and page.read_time %}
-        <p class="page__meta"><i class="far fa-clock" aria-hidden="true"></i> {% include read-time.html %}</p>
+        <p class="page__meta"><i class="fa fa-clock-o" aria-hidden="true"></i> {% include read-time.html %}</p>
       {% endif %}
       {% if page.header.cta_url %}
         <p><a href="{{ cta_path }}" class="btn btn--light-outline btn--large">{{ page.header.cta_label | default: site.data.ui-text[site.locale].more_label | default: "Learn More" }}</a></p>
       {% endif %}
     </div>
   {% else %}
-    <img src="{{ img_path }}" alt="{{ image_description }}" class="page__hero-image">
+    <img src="{{ img_path }}" alt="{{ page.title }}" class="page__hero-image">
   {% endif %}
   {% if page.header.caption %}
     <span class="page__hero-caption">{{ page.header.caption | markdownify | remove: "<p>" | remove: "</p>" }}</span>
   {% endif %}
-</div>
+</div>

_includes/page__hero_video.html

@@ -1,4 +0,0 @@
-{% capture video_id %}{{ page.header.video.id }}{% endcapture %}
-{% capture video_provider %}{{ page.header.video.provider }}{% endcapture %}
-
-{% include video id=video_id provider=video_provider %}

_includes/page__taxonomy.html

@@ -1,3 +1,5 @@
+{% include base_path %}
+
 {% if site.tag_archive.type and page.tags[0] %}
   {% include tag-list.html %}
 {% endif %}

_includes/paginator.html

@@ -1,23 +1,24 @@
+{% include base_path %}
+
 {% if paginator.total_pages > 1 %}
 <nav class="pagination">
-  {% assign first_page_path = site.paginate_path | replace: 'page:num', '' | replace: '//', '/' | relative_url %}
   <ul>
     {% comment %} Link for previous page {% endcomment %}
     {% if paginator.previous_page %}
       {% if paginator.previous_page == 1 %}
-        <li><a href="{{ first_page_path }}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a></li>
+        <li><a href="{{ base_path }}/">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a></li>
       {% else %}
-        <li><a href="{{ site.paginate_path | replace: ':num', paginator.previous_page | replace: '//', '/' | relative_url }}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a></li>
+        <li><a href="{{ base_path }}/page{{ paginator.previous_page }}/">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a></li>
       {% endif %}
     {% else %}
-    <li><a href="#" class="disabled"><span aria-hidden="true">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</span></a></li>
+      <li><a href="#" class="disabled"><span aria-hidden="true">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</span></a></li>
     {% endif %}
 
     {% comment %} First page {% endcomment %}
     {% if paginator.page == 1 %}
       <li><a href="#" class="disabled current">1</a></li>
     {% else %}
-      <li><a href="{{ first_page_path }}">1</a></li>
+      <li><a href="{{ base_path }}/">1</a></li>
     {% endif %}
 
     {% assign page_start = 2 %}
@@ -35,7 +36,7 @@
 
     {% for index in (page_start..page_end) %}
       {% if index == paginator.page %}
-        <li><a href="{{ site.paginate_path | replace: ':num', index | replace: '//', '/' | relative_url }}" class="disabled current">{{ index }}</a></li>
+        <li><a href="{{ base_path }}/page{{ index }}/" class="disabled current">{{ index }}</a></li>
       {% else %}
         {% comment %} Distance from current page and this link {% endcomment %}
         {% assign dist = paginator.page | minus: index %}
@@ -43,7 +44,7 @@
           {% comment %} Distance must be a positive value {% endcomment %}
           {% assign dist = 0 | minus: dist %}
         {% endif %}
-        <li><a href="{{ site.paginate_path | replace: ':num', index | relative_url }}">{{ index }}</a></li>
+        <li><a href="{{ base_path }}/page{{ index }}/">{{ index }}</a></li>
       {% endif %}
     {% endfor %}
 
@@ -55,15 +56,15 @@
     {% if paginator.page == paginator.total_pages %}
       <li><a href="#" class="disabled current">{{ paginator.page }}</a></li>
     {% else %}
-      <li><a href="{{ site.paginate_path | replace: ':num', paginator.total_pages | replace: '//', '/' | relative_url }}">{{ paginator.total_pages }}</a></li>
+      <li><a href="{{ base_path }}/page{{ paginator.total_pages }}/">{{ paginator.total_pages }}</a></li>
     {% endif %}
 
     {% comment %} Link next page {% endcomment %}
     {% if paginator.next_page %}
-      <li><a href="{{ site.paginate_path | replace: ':num', paginator.next_page | replace: '//', '/' | relative_url }}">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a></li>
+      <li><a href="{{ base_path }}/page{{ paginator.next_page }}/">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a></li>
     {% else %}
       <li><a href="#" class="disabled"><span aria-hidden="true">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</span></a></li>
     {% endif %}
   </ul>
 </nav>
-{% endif %}
+{% endif %}

_includes/post_pagination.html

@@ -1,12 +1,14 @@
+{% include base_path %}
+
 {% if page.previous or page.next %}
   <nav class="pagination">
     {% if page.previous %}
-      <a href="{{ page.previous.url | relative_url }}" class="pagination--pager" title="{{ page.previous.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
+      <a href="{{ base_path }}{{ page.previous.url }}" class="pagination--pager" title="{{ page.previous.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
     {% else %}
       <a href="#" class="pagination--pager disabled">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
     {% endif %}
     {% if page.next %}
-      <a href="{{ page.next.url | relative_url }}" class="pagination--pager" title="{{ page.next.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
+      <a href="{{ base_path }}{{ page.next.url }}" class="pagination--pager" title="{{ page.next.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
     {% else %}
       <a href="#" class="pagination--pager disabled">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
     {% endif %}

_includes/posts-category.html

@@ -1,3 +0,0 @@
-{%- for post in site.categories[include.taxonomy] -%}
-  {% include archive-single.html %}
-{%- endfor -%}

_includes/posts-tag.html

@@ -1,3 +0,0 @@
-{%- for post in site.tags[include.taxonomy] -%}
-  {% include archive-single.html %}
-{%- endfor -%}

_includes/read-time.html

@@ -1,15 +1,17 @@
-{% assign words_per_minute = site.words_per_minute | default: 200 %}
-
 {% if post.read_time %}
   {% assign words = post.content | strip_html | number_of_words %}
 {% elsif page.read_time %}
   {% assign words = page.content | strip_html | number_of_words %}
 {% endif %}
 
-{% if words < words_per_minute %}
+{% if site.words_per_minute %}
-  {{ site.data.ui-text[site.locale].less_than | default: "less than" }} 1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
+  {% if words < 180 %}
-{% elsif words == words_per_minute %}
+	  {{ site.data.ui-text[site.locale].less_than | default: "less than" }} 1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
-  1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
+	{% elsif words < 360 %}
+	  1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
+	{% else %}
+	  {{ words | divided_by:site.words_per_minute }} {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
+	{% endif %}
 {% else %}
-  {{ words | divided_by:words_per_minute }} {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }}
+  {{ site.data.ui-text[site.locale].undefined_wpm | "Undefined parameter words_per_minute at _config.yml" }}
 {% endif %}

_includes/scripts.html

@@ -1,28 +1,4 @@
-{% if site.footer_scripts %}
+<script src="{{ base_path }}/assets/js/main.min.js"></script>
-  {% for script in site.footer_scripts %}
-    {% if script contains "://" %}
-      {% capture script_path %}{{ script }}{% endcapture %}
-    {% else %}
-      {% capture script_path %}{{ script | relative_url }}{% endcapture %}
-    {% endif %}
-    <script src="{{ script_path }}"></script>
-  {% endfor %}
-{% else %}
-  <script src="{{ '/assets/js/main.min.js' | relative_url }}"></script>
-  <script src="https://use.fontawesome.com/releases/v5.1.0/js/all.js"></script>
-{% endif %}
-
-{% if site.search == true or page.layout == "search" %}
-  {%- assign search_provider = site.search_provider | default: "lunr" -%}
-  {%- case search_provider -%}
-    {%- when "lunr" -%}
-      {% include search/lunr-search-scripts.html %}
-    {%- when "google" -%}
-      {% include search/google-search-scripts.html %}
-    {%- when "algolia" -%}
-      {% include search/algolia-search-scripts.html %}
-  {%- endcase -%}
-{% endif %}
 
 {% include analytics.html %}
 {% include /comments-providers/scripts.html %}

_includes/search/algolia-search-scripts.html

@@ -1,54 +0,0 @@
-<!-- Including InstantSearch.js library and styling -->
-<script src="https://cdn.jsdelivr.net/npm/instantsearch.js@2.3.3/dist/instantsearch.min.js"></script>
-<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/instantsearch.js@2.3.3/dist/instantsearch.min.css">
-<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/instantsearch.js@2.3.3/dist/instantsearch-theme-algolia.min.css">
-
-<script>
-// Instanciating InstantSearch.js with Algolia credentials
-const search = instantsearch({
-  appId: '{{ site.algolia.application_id }}',
-  apiKey: '{{ site.algolia.search_only_api_key }}',
-  indexName: '{{ site.algolia.index_name }}',
-  searchParameters: {
-    restrictSearchableAttributes: [
-      'title',
-      'content'
-    ]
-  }
-});
-
-const hitTemplate = function(hit) {
-  const url = hit.url;
-  const title = hit._highlightResult.title.value;
-  const content = hit._highlightResult.html.value;
-
-  return `
-    <div class="list__item">
-      <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
-        <h2 class="archive__item-title" itemprop="headline"><a href="{{ site.baseurl }}${url}">${title}</a></h2>
-        <div class="archive__item-excerpt" itemprop="description">${content}</div>
-      </article>
-    </div>
-  `;
-}
-
-// Adding searchbar and results widgets
-search.addWidget(
-  instantsearch.widgets.searchBox({
-    container: '.search-searchbar',
-    {% unless site.algolia.powered_by == false %}poweredBy: true,{% endunless %}
-    placeholder: '{{ site.data.ui-text[site.locale].search_placeholder_text | default: "Enter your search term..." }}'
-  })
-);
-search.addWidget(
-  instantsearch.widgets.hits({
-    container: '.search-hits',
-    templates: {
-      item: hitTemplate
-    }
-  })
-);
-
-// Starting the search
-search.start();
-</script>

_includes/search/google-search-scripts.html

@@ -1,30 +0,0 @@
-<script>
-  (function () {
-    var cx = '{{ site.google.search_engine_id }}';
-    var gcse = document.createElement('script');
-    gcse.type = 'text/javascript';
-    gcse.async = true;
-    gcse.src = 'https://cse.google.com/cse.js?cx=' + cx;
-    var s = document.getElementsByTagName('script')[0];
-    s.parentNode.insertBefore(gcse, s);
-  })();
-
-  function googleCustomSearchExecute() {
-    var input = document.getElementById('cse-search-input-box-id');
-    var element = google.search.cse.element.getElement('searchresults-only0');
-    if (input.value == '') {
-      element.clearAllResults();
-    } else {
-      element.execute(input.value);
-    }
-    return false;
-  }
-
-  {% if site.google.instant_search %}
-    $(document).ready(function () {
-      $('input#cse-search-input-box-id').on('keyup', function () {
-        googleCustomSearchExecute();
-      });
-    });
-  {% endif %}
-</script>

_includes/search/lunr-search-scripts.html

@@ -1,10 +0,0 @@
-{% assign lang = site.locale | slice: 0,2 | default: "en" %}
-{% case lang %}
-{% when "gr" %}
-  {% assign lang = "gr" %}
-{% else %}
-  {% assign lang = "en" %}
-{% endcase %}
-<script src="{{ '/assets/js/lunr/lunr.min.js' | relative_url }}"></script>
-<script src="{{ '/assets/js/lunr/lunr-store.js' | relative_url }}"></script>
-<script src="{{ '/assets/js/lunr/lunr-' | append: lang | append: '.js' | relative_url }}"></script>

_includes/search/search_form.html

@@ -1,18 +0,0 @@
-<div class="search-content__inner-wrap">
-{%- assign search_provider = site.search_provider | default: "lunr" -%}
-{%- case search_provider -%}
-  {%- when "lunr" -%}
-    <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>
-  {%- when "google" -%}
-    <form onsubmit="return executeQuery();" id="cse-search-box-form-id">
-    <input type="text" id="cse-search-input-box-id" class="search-input" tabindex="-1" placeholder="{{ site.data.ui-text[site.locale].search_placeholder_text | default: 'Enter your search term...' }}" />
-    </form>
-    <div id="results" class="results">
-        <gcse:searchresults-only></gcse:searchresults-only>    
-    </div>
-  {%- when "algolia" -%}
-    <div class="search-searchbar"></div>
-    <div class="search-hits"></div>
-{%- endcase -%}
-</div>