` and before `` to be added/overridden with `head_scripts` and `footer_scripts` arrays in `_config.yml`. [#1241](https://github.com/mmistakes/minimal-mistakes/pull/1241)
-- Update JavaScript dependencies: jQuery `v3.2.1`, jQuery Smooth Scroll `v2.2.0`, and Magnific Popup `v1.1.0`. [#328690652](https://github.com/mmistakes/minimal-mistakes/pull/1241#issuecomment-328690652)
-
-## [4.5.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.2)
-
-### Enhancements
-
-- Add `.page__comments-form` to "non-printing" selectors in print styles. [#1195](https://github.com/mmistakes/minimal-mistakes/pull/1195)
-- Add LinkedIn and Steam author sidebar examples to `_config.yml`. [#1203](https://github.com/mmistakes/minimal-mistakes/pull/1203) [#1204](https://github.com/mmistakes/minimal-mistakes/pull/1204)
-- Remove the http-equiv="cleartype" meta tag. [#1087](https://github.com/mmistakes/minimal-mistakes/pull/1087)
-- Clarify documentation for `jekyll-archives` plugin and how to install. [#1206](https://github.com/mmistakes/minimal-mistakes/pull/1206)
-- Clarify documentation around taxonomy page and index generation. [#1207](https://github.com/mmistakes/minimal-mistakes/pull/1207)
-- Fix "Posts by tag" grammar in documentation. [#1209](https://github.com/mmistakes/minimal-mistakes/pull/1209)
-- Improve Chinese `date_label` and `minute_read` translations in `ui-text.yml`. [#1205](https://github.com/mmistakes/minimal-mistakes/pull/1205) [#1211](https://github.com/mmistakes/minimal-mistakes/pull/1211)
-- Add note to Quick-Start Guide about GitHub Pages hosting alternatives that allow 3rd party gem themes and Jekyll plugins.
-- Add note to configuration documentation about Cloudflare minification as an alternative to `layout: compress`. [#1217](https://github.com/mmistakes/minimal-mistakes/pull/1217)
-- Show 4 latest posts in "You May Also Enjoy" module when `related: true` and no related posts are found due to `lsi` ([latent semantic indexing](https://en.wikipedia.org/wiki/Latent_semantic_analysis#Latent_semantic_indexing)) being disabled on GitHub Pages. [#554](https://github.com/mmistakes/minimal-mistakes/issues/554)
-- Truncate archive item titles' that overflow with an ellipsis. [#1213](https://github.com/mmistakes/minimal-mistakes/issues/1213)
-
-### Bug Fixes
-
-- Fix license URL in README file. [#1189](https://github.com/mmistakes/minimal-mistakes/pull/1189)
-- Reduce amount of blank pages when printing in Chrome. [#1196](https://github.com/mmistakes/minimal-mistakes/issues/1196)
-- Remove `#disqus_thread` duplicate from `comments-providers/disqus.html` as it is already in `comments.html` include. [#1199](https://github.com/mmistakes/minimal-mistakes/issues/1199)
-- Fix Liquid syntax errors in `tag-list.html` and `category-list.html` includes by removing parenthesis in `assign`s. [#1223](https://github.com/mmistakes/minimal-mistakes/issues/1223)
-- Fix Liquid syntax error: "Expected id but found open_square in `"{{ page.[include.id] }}"`" in `gallery` and `feature_row` includes.
-- Fix Liquid syntax error: "Expected end_of_string but found pipe in `"name in __names | sort"`" in `group-by-array` include.
-
-## [4.5.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.1)
-
-### Enhancements
-
-- Add Greek and Danish localized UI text strings. [#1159](https://github.com/mmistakes/minimal-mistakes/pull/1159) [#1188](https://github.com/mmistakes/minimal-mistakes/pull/1188)
-- Remove blank YAML Front Matter from JavaScript banner. [#1158](https://github.com/mmistakes/minimal-mistakes/issues/1158)
-- Improve `page` and `archive` layouts to visually center main content and harmonize sidebar widths and placement. [#1166](https://github.com/mmistakes/minimal-mistakes/pull/1166)
-- Increase font-size of code blocks.
-- Reduce indent of nested "table of contents" links.
-- Extend [archive grid view](https://mmistakes.github.io/minimal-mistakes/docs/layouts/) to the right to better fill the page.
-- URL encode title and page URL in social share links. [#1177](https://github.com/mmistakes/minimal-mistakes/pull/1177)
-- Replace old Disqus script with new Universal Embed Code. [#1179](https://github.com/mmistakes/minimal-mistakes/pull/1179)
-
-### Bug Fixes
-
-- Fix positioning of sidebar table of contents when using `layout: splash`. [#1169](https://github.com/mmistakes/minimal-mistakes/issues/1169)
-- Fix "follow" links `z-index` order to avoid overlapping issues. [#1167](https://github.com/mmistakes/minimal-mistakes/issues/1167)
-
-### Maintenance
-
-- Fix typo `words_per_minute` typo in documentation. [#1164](https://github.com/mmistakes/minimal-mistakes/pull/1164)
-- Remove outside and right borders in `table`s.
-- Adjust width of `.sidebar` to match `.sidebar__right`.
-- Add sample documents to ["portfolio" collection](https://mmistakes.github.io/minimal-mistakes/portfolio/) for testing grid view.
-- Fix typo in stylesheets documentation. [#1170](https://github.com/mmistakes/minimal-mistakes/pull/1170)
-- Add note about setting Discourse `server` as a scheme-less URL (eg. `meta.discourse.com` and not `http://meta.discourse.com`) in `_config.yml`. [#1182](https://github.com/mmistakes/minimal-mistakes/issues/1182)
-
-## [4.5.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.0)
-
-### Enhancements
-
-- Add scrollbar to sidebars with overflowing content that extends outside the viewport's height. [#706](https://github.com/mmistakes/minimal-mistakes/issues/706)
-- Add missing Spanish UI text strings. [#1118](https://github.com/mmistakes/minimal-mistakes/pull/1118)
-- Update Susy to version 3 and rewrite grid CSS to be more readable.
-- Refactor intro animations into a separate Sass variable `$intro-transition` to allow for customizing. [#1147](https://github.com/mmistakes/minimal-mistakes/pull/1147)
-- Add [**jekyll-data**](https://github.com/ashmaroli/jekyll-data) as a dependency to read data files from theme-gem. [#1131](https://github.com/mmistakes/minimal-mistakes/pull/1131)
-- Add support for customizing header image alternative text through YAML Front Matter. [#1138](https://github.com/mmistakes/minimal-mistakes/pull/1138)
-
-### Bug Fixes
-
-- Fix Sass `DEPRECATION WARNING: Passing a string to call()` by [upgrading Susy to version 3](https://github.com/mmistakes/minimal-mistakes/commit/387f8149d6270b876f224a57a07062ffb0647938). [#1114](https://github.com/mmistakes/minimal-mistakes/issues/1114)
-- Fix disappearing author profile links due to tapping the "Follow" button and changing a browser's viewport width to > `$lg`. [#1136](https://github.com/mmistakes/minimal-mistakes/issues/1136)
-
-### Maintenance
-
-- Replace reference to "Basically Basic theme" with **Minimal Mistakes**. [#1149](https://github.com/mmistakes/minimal-mistakes/pull/1149)
-- Add documentation for disabling CSS3 animations. [#1150](https://github.com/mmistakes/minimal-mistakes/pull/1150)
-- Update quickstart, installation, and overriding defaults documentation. [#1151](https://github.com/mmistakes/minimal-mistakes/pull/1151)
-
-## [4.4.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.4.2)
-
-### Enhancements
-
-- Add Swedish, Dutch, and Indonesian localized UI text strings. [#996](https://github.com/mmistakes/minimal-mistakes/pull/996) [#1081](https://github.com/mmistakes/minimal-mistakes/pull/1081) [#1101](https://github.com/mmistakes/minimal-mistakes/pull/1101)
-- Add Bitbucket social icon color. [#1009](https://github.com/mmistakes/minimal-mistakes/pull/1009)
-- Add GitLab to author sidebar. [#1050](https://github.com/mmistakes/minimal-mistakes/pull/1050)
-- Add Sass variable for navicon link hover color. [#1089](https://github.com/mmistakes/minimal-mistakes/pull/1089) [#1088](https://github.com/mmistakes/minimal-mistakes/pull/1088)
-
-### Bug Fixes
-
-- Toggle close button on `mouseleave`. [#975](https://github.com/mmistakes/minimal-mistakes/issues/975)
-- Remove extraneous `` and `` tags from `paginator.html` include. [#1038](https://github.com/mmistakes/minimal-mistakes/pull/1038)
-- Fix Google+ comments provider includes. [#1092](https://github.com/mmistakes/minimal-mistakes/issues/1092)
-- Replace category variable used in `_includes/breadcrumbs.html` to `site.category_archive` to avoid conflicts with `site.categories`. [#1063](https://github.com/mmistakes/minimal-mistakes/pull/1063) [#329](https://github.com/mmistakes/minimal-mistakes/issues/329)
-
-### Maintenance
-
-- Add mention of Greek localized UI text strings to theme documentation. [#972](https://github.com/mmistakes/minimal-mistakes/pull/972)
-- Update Greek localized UI text strings. [#1054](https://github.com/mmistakes/minimal-mistakes/pull/1054)
-- Add documentation for adding teaser images in grid view using `header.teaser`.
-
-## [4.4.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.4.1)
-
-### Enhancements
-
-- Add Greek localized UI text strings. [#958](https://github.com/mmistakes/minimal-mistakes/pull/958)
-
-### Bug Fixes
-
-- Fix `video` helper to load Vimeo videos over https. [#945](https://github.com/mmistakes/minimal-mistakes/pull/945)
-- Fix close menu button that was removed when updating Greedy navigation script. [#969](https://github.com/mmistakes/minimal-mistakes/issues/969)
-
-## [4.4.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.4.0)
-
-### Enhancements
-
-- Move SCSS partials to `/_sass/minimal-mistakes` for easier CSS customization.
-- Replace `modified` with `last_modified_at` to leverage various Jekyll plugins that utilize this variable. [#930](https://github.com/mmistakes/minimal-mistakes/pull/930)
-- Add Lithuanian localized UI text. [#924](https://github.com/mmistakes/minimal-mistakes/pull/924)
-- Improve print stylesheet by increasing text contrast, removing elements that don't need to be printed, expanding URLs, and reducing amount of blank pages. [#909](https://github.com/mmistakes/minimal-mistakes/issues/909)
-
-### Maintenance
-
-- Remove extra word in comment. [#911](https://github.com/mmistakes/minimal-mistakes/pull/911)
-- Fix typo in Utility Class docs. [#915](https://github.com/mmistakes/minimal-mistakes/pull/915)
-
-## [4.3.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.3.1)
-
-### Bug Fixes
-
-- Fix `.masthead` and `.page__footer` overlapping full screen video elements. [#933](https://github.com/mmistakes/minimal-mistakes/issues/933)
-- Correctly show Related Posts heading when UI Text data file is omitted and `related: true` in YAML Front Matter. [#901](https://github.com/mmistakes/minimal-mistakes/pull/901)
-
-## [4.3.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.3.0)
-
-### Enhancements
-
-- Add workaround to allow theme gem's `/assets/js/main.min.js` file to be overridden by a local version. Simply add the following YAML Front Matter to the file:
-
- ```
- ---
- layout:
- ---
- ```
-
- Any local customizations you make to `/assets/js/main.min.js` should now replace the theme gem's version.
-
-## [4.2.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.2.2)
-
-### Enhancements
-
-- Update [Greedy Navigation](https://github.com/lukejacksonn/GreedyNav) to flexbox version to make it more flexible when dealing with long site titles (`site.title`). [#836](https://github.com/mmistakes/minimal-mistakes/issues/836)
-- Adjust `box-shadow` in navigation and author sidebar. [#576](https://github.com/mmistakes/minimal-mistakes/pull/576)
-- Add Russian, Korean, and zh-TW localized UI text. [#815](https://github.com/mmistakes/minimal-mistakes/issues/815) [#834](https://github.com/mmistakes/minimal-mistakes/pull/834) [#838](https://github.com/mmistakes/minimal-mistakes/pull/838)
-
-### Bug Fixes
-
-- Fix Discourse embedded comments bug. [#823](https://github.com/mmistakes/minimal-mistakes/issues/823)
-- Fix `seo_author` default value in `seo.html` and add `author` meta. [#858](https://github.com/mmistakes/minimal-mistakes/pull/858)
-
-### Maintenance
-
-- Add theme meta info to `_layouts/default.html` and `main.css`.
-- Update README.
-- Improve the pagination and taxonomy archive documentation. [#826](https://github.com/mmistakes/minimal-mistakes/pull/826)
-- Add comments to `/docs/_config.yml` to clarify use of YAML references. [#847](https://github.com/mmistakes/minimal-mistakes/pull/847)
-
-## [4.2.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.2.1)
-
-### Enhancements
-
-- Improve `paginator.html` to support paginated pages that live inside of a subfolder. See [documentation](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#home-page) for more details. [#764](https://github.com/mmistakes/minimal-mistakes/pull/764/)
-
-### Maintenance
-
-- Add `https` protocol to Google Universal Analytics embed. [#772](https://github.com/mmistakes/minimal-mistakes/pull/772)
-
-## [4.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.2.0)
-
-### Enhancements
-
-- Add `video` helper (for YouTube/Vimeo) and video headers to `single`, `archive`, and `splash` layouts. [#788](https://github.com/mmistakes/minimal-mistakes/pull/788)
-- Add missing simplified Chinese localized UI text strings. [#747](https://github.com/mmistakes/minimal-mistakes/pull/747)
-- Add Nepali (Nepalese) localized UI text strings. [#785](https://github.com/mmistakes/minimal-mistakes/pull/785)
-- Remove borders from table elements found in Google Custom Search Engine widget. [#759](https://github.com/mmistakes/minimal-mistakes/issues/759)
-
-### Bug Fixes
-
-- Remove `position: sticky` JavaScript polyfill and fallback to default positioning for browsers that don't support it. [#752](https://github.com/mmistakes/minimal-mistakes/issues/752)
-
-### Maintenance
-
-- Fix invalid Google Universal Analytics example in documentation. [#783](https://github.com/mmistakes/minimal-mistakes/pull/783)
-- Bump `jekyll-sitemap` gem dependency to (1.0).
-
-## [4.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.1.1)
-
-### Enhancements
-
-- Remove hardcoded `words_per_minute` "less than" and "minute read" values and make dynamic. [#703](https://github.com/mmistakes/minimal-mistakes/issues/703)
-- Update Font Awesome to `v4.7.0`. [#723](https://github.com/mmistakes/minimal-mistakes/issues/723), [#722](https://github.com/mmistakes/minimal-mistakes/issues/722)
-- Add support for YouTube channel URLs in author profile. [#716](https://github.com/mmistakes/minimal-mistakes/issues/716)
-
-### Bug Fixes
-
-- Add Jekyll as `spec.add_runtime_dependency` in `.gemspec`.
-
-## [4.1.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.1.0)
-
-### Enhancements
-
-- Add Jekyll include for adding [custom author profile links](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/author-profile-custom-links.html) to sidebar
-
-### Bug Fixes
-
-- Fix link to Discourse.org homepage in `noscript` section [#699](https://github.com/mmistakes/minimal-mistakes/pull/699)
-- Fix padding issue with pagination buttons [#694](https://github.com/mmistakes/minimal-mistakes/issues/694)
-
-## [4.0.10](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.10)
-
-### Bug Fixes
-
-- Add Staticman default `path`. [#683](https://github.com/mmistakes/minimal-mistakes/issues/683)
-
-### Maintenance
-
-- Slight correction/improvements to French UI text. [#685](https://github.com/mmistakes/minimal-mistakes/pull/685)
-
-## [4.0.9](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.9)
-
-### Bug Fixes
-
-- Fix overlapping sidebar navigation lists due to `max-height: 100vh`. [#668](https://github.com/mmistakes/minimal-mistakes/issues/668)
-
-## [4.0.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.8)
-
-### Bug Fixes
-
-- Set default value for `words_per_minute`. [#657](https://github.com/mmistakes/minimal-mistakes/issues/657)
-- Adjust sidebar navigation list CSS so it collapses at the correct width.
-
-### Maintenance
-
-- Add Google AdSense banner to `/docs/_layouts/default.html` for demo site.
-
-## [4.0.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.7)
-
-### Enhancements
-
-- Add `!default` values to **\_sass/\_variables.scss**.
-- Collapse sidebar navigation lists on smaller screens. [#607](https://github.com/mmistakes/minimal-mistakes/issues/607)
-
-### Bug Fixes
-
-- Rename `#comments` to something more unique to avoid clashes with Kramdown generated headline IDs. [#582](https://github.com/mmistakes/minimal-mistakes/issues/582)
-
-### Maintenance
-
-- Reorganize SCSS partials in **assets/css/main.scss**
-
-## [4.0.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.6)
-
-### Enhancements
-
-- Add [`figure` helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#figure) to make generating a `
-**Note:** There are two more configuration options from Jekyll Paginate V2 that this theme doesn't support yet. You should either leave them out or use their default values as shown below. Changing them may lead to unexpected results and you're on your own.
-
-```yaml
-pagination:
- # Optional, the default file extension for generated pages (e.g html, json, xml).
- # Internally this is set to html by default
- extension: html
-
- # Optional, the default name of the index file for generated pages (e.g. 'index.html')
- # Without file extension
- indexpage: 'index'
-```
-
-
-### 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](https://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. |
-| [jekyll-include-cache][jekyll-include-cache] | Liquid tag that caches Liquid includes. |
-
-[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
-[jekyll-include-cache]: https://github.com/benbalter/jekyll-include-cache
-
-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.
-
-**Note:** The [jekyll-include-cache](https://github.com/benbalter/jekyll-include-cache) plugin needs to be installed in your `Gemfile` and added to the `plugins` array of `_config.yml`. Otherwise you'll throw `Unknown tag 'include_cached'` errors at build.
-{: .notice--warning}
-
-## 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:** these are simply hash (fragment) links into the full taxonomy index pages. For them to resolve properly, the category and tag index pages need to exist at [`/categories/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.md) (copy to `_pages/category-archive.md`) and [`/tags/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.md) (copy to `_pages/tag-archive.md`).
-{: .notice--warning}
-
-If you have the luxury of using Jekyll Plugins, then [**jekyll-archives**][jekyll-archives] will create a better experience as discrete taxonomy pages would be generated, and their corresponding links would be "real" (not just hash/fragment links into a larger index). However, the plugin will not generate the taxonomy index pages (`category-archive.md` and `tag-archive.md`) so you'd still need to manually create them if you'd like to have them (see note above).
-
-First, you'll need to make sure that the `jekyll-archives` plugin is installed. Either run `gem install jekyll-archives` or add the following to your `Gemfile`:
-
-```
-group :jekyll_plugins do
- gem "jekyll-archives"
-end
-```
-
-Then run `bundle install`.
-
-Now that the plugin is installed, 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}
-
-
-
-
Tip
-
-To apply [Front Matter defaults](https://jekyllrb.com/docs/configuration/front-matter-defaults/) to pages generated by the `jekyll-archives` plugin, you can specify a scope of an empty `path` and a `type` of either `tag` or `category`.
-
-For example, the following configuration enables author profile on tag archives and disables comments on category archives.
-
-```yaml
-defaults:
- - scope:
- path: ""
- type: tag
- values:
- author_profile: true
- - scope:
- path: ""
- type: category
- values:
- comments: false
-```
-
-
-
-## 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 caveats 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`.
-{: .notice--warning}
-
-**Note:** CDN services such as CloudFlare provide optional automatic minification for HTML, CSS, and JavaScript. If you are serving your site via such a service and have minification enabled, this configuration might be redundant.
-{: .notice--info}
diff --git a/docs/_docs/06-overriding-theme-defaults.md b/docs/_docs/06-overriding-theme-defaults.md
deleted file mode 100644
index a4fa3f6f..00000000
--- a/docs/_docs/06-overriding-theme-defaults.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: "Overriding Theme Defaults"
-permalink: /docs/overriding-theme-defaults/
-excerpt: "Instructions on how to customize the theme's default set of layouts, includes, and stylesheets when using the Ruby Gem version."
-last_modified_at: 2020-07-27
----
-
-When installing the theme as a Ruby Gem its layouts, includes, stylesheets, and other assets are all bundled in the `gem`. Meaning they're not easily visible in your project.
-
-Each of these files can be modified, but you'll need to copy the default version into your project first. For example, if you wanted to modify the default [`single` layout](https://github.com/mmistakes/minimal-mistakes/blob/master/_layouts/single.html), you'd start by copying it to `_layouts/single.html`.
-
-**ProTip**: To locate theme files, run `bundle info minimal-mistakes-jekyll`. Then copy the files you want to override from the returned path, to the appropriate folder in your project.
-{: .notice--info}
-
-Jekyll will use the files in your project first before falling back to the default versions of the theme. It exhibits this behavior with files in the following folders:
-
-```
-/assets
-/_layouts
-/_includes
-/_sass
-```
-
-Additionally, from `v4.5.0` onwards the theme-gem will also exhibit above behavior for `/_data` via a plugin.
-Consequently, the data files for UI Text and Navigation are also bundled within the theme-gem.
-This doesn't apply if you're building your site on GitHub Pages, however.
-
-For more information on customizing the theme's [stylesheets]({{ "/docs/stylesheets/" | relative_url }}) and [JavaScript]({{ "/docs/javascript/" | relative_url }}), see the appropriate pages.
diff --git a/docs/_docs/07-navigation.md b/docs/_docs/07-navigation.md
deleted file mode 100644
index feb9fe25..00000000
--- a/docs/_docs/07-navigation.md
+++ /dev/null
@@ -1,74 +0,0 @@
----
-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
-toc: true
----
-
-Customize site navigational links through a Jekyll data file.
-
-## 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.
-
-To define these links add titles and URLs under the `main` key in `_data/navigation.yml`:
-
-```yaml
-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
- target: _blank
-```
-
-Which will give you a responsive masthead similar to this:
-
-
-
-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}
-
-## Breadcrumbs (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](https://github.com/jekyll/jekyll-archives) to auto-generate them. If these pages don't exist breadcrumb links to them will be broken.
-
-
-
-```yaml
-breadcrumbs: true # disabled by default
-```
-
-Breadcrumb start link text and separator character can both be changed in `_data/ui-text.yml`.
-
-```yaml
-breadcrumb_home_label : "Home"
-breadcrumb_separator : "/"
-```
-
-For breadcrumbs that resemble something like `Start > Blog > My Awesome Post` you'd apply these settings:
-
-```yaml
-breadcrumb_home_label : "Start"
-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.
\ No newline at end of file
diff --git a/docs/_docs/08-ui-text.md b/docs/_docs/08-ui-text.md
deleted file mode 100644
index 3a97ee1c..00000000
--- a/docs/_docs/08-ui-text.md
+++ /dev/null
@@ -1,56 +0,0 @@
----
-title: "UI Text"
-permalink: /docs/ui-text/
-excerpt: "Text for customizing user interface elements found in the theme."
-last_modified_at: 2021-05-11T10:22:55-04:00
----
-
-Text for UI elements, `_layouts`, and `_includes` grouped together as a set of translation keys. This is by no means a full-on i18n solution, but it does help make customizing theme text a bit easier.
-
-The English[^yaml-anchors] main keys in [`_data/ui-text.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml) are translated in the following languages:
-
-- Arabic (عربي)
-- Brazilian Portuguese (Português brasileiro)
-- Bulgarian
-- Catalan
-- Chinese
-- Czech
-- Danish
-- Dutch
-- Finnish
-- French (Français)
-- German (Deutsch)
-- Greek
-- Hebrew
-- Hungarian
-- Indonesian
-- Irish (Gaeilge)
-- Italian (Italiano)
-- Kiswahili
-- Korean
-- Japanese
-- Malayalam
-- Myanmar (Burmese)
-- Nepali (Nepalese)
-- Norwegian (Norsk)
-- Polish
-- Persian (فارسی)
-- Romanian
-- Russian
-- Slovak
-- Spanish (Español)
-- Swedish
-- Thai
-- Turkish (Türkçe)
-- Vietnamese
-
-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.
-
-
-
-**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}
diff --git a/docs/_docs/09-authors.md b/docs/_docs/09-authors.md
deleted file mode 100644
index 0990089a..00000000
--- a/docs/_docs/09-authors.md
+++ /dev/null
@@ -1,51 +0,0 @@
----
-title: "Authors"
-permalink: /docs/authors/
-excerpt: "Instructions and settings for working with multiple site authors."
-last_modified_at: 2018-09-10T12:33:24-04:00
----
-
-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`:
-
-**Step 1.** Create `_data/authors.yml` and add authors using the following format. Any variables found under `author:` in `_config.yml` can be used (e.g. `name`, `bio`, `avatar`, author `links`, etc.).
-
-```yaml
-# /_data/authors.yml
-
-Billy Rick:
- name : "Billy Rick"
- bio : "What do you want, jewels? I am a very extravagant man."
- avatar : "/assets/images/bio-photo-2.jpg"
- links:
- - label: "Email"
- icon: "fas fa-fw fa-envelope-square"
- url: "mailto:billyrick@rick.com"
- - label: "Website"
- icon: "fas fa-fw fa-link"
- url: "https://thewhip.com"
- - label: "Twitter"
- icon: "fab fa-fw fa-twitter-square"
- url: "https://twitter.com/extravagantman"
-
-Cornelius Fiddlebone:
- name : "Cornelius Fiddlebone"
- bio : "I ordered what?"
- avatar : "/assets/images/bio-photo.jpg"
- links:
- - label: "Email"
- icon: "fas fa-fw fa-envelope-square"
- url: "mailto:cornelius@thewhip.com"
- - label: "Twitter"
- icon: "fab fa-fw fa-twitter-square"
- url: "https://twitter.com/rhymeswithsackit"
-```
-
-**Step 2.** Assign one of the authors in `authors.yml` to a post or page you wish to override the `site.author` with.
-
-Example: To assign `Billy Rick` as an author for a post the following YAML Front Matter would be applied:
-
-```yaml
-author: Billy Rick
-```
diff --git a/docs/_docs/10-layouts.md b/docs/_docs/10-layouts.md
deleted file mode 100644
index cf3eeb47..00000000
--- a/docs/_docs/10-layouts.md
+++ /dev/null
@@ -1,853 +0,0 @@
----
-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: /assets/images/mm-layout-single-header.png
- alt: "single layout with header example"
- - image_path: /assets/images/mm-layout-single-meta.png
- alt: "single layout with comments and related posts"
-last_modified_at: 2020-08-30T21:27:40-04:00
-toc: true
-toc_label: "Included Layouts"
-toc_icon: "columns"
----
-
-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`:
-
-* `` 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 `` element eg. ``.
-
-| layout | class name |
-| ---------------- | --------------------------- |
-| archive | `.layout--archive` |
-| archive-taxonomy | `.layout--archive-taxonomy` |
-| search | `.layout--search` |
-| single | `.layout--single` |
-| splash | `.layout--splash` |
-| home | `.layout--home` |
-| posts | `.layout--posts` |
-| categories | `.layout--categories` |
-| category | `.layout--category` |
-| tags | `.layout--tags` |
-| tag | `.layout--tag` |
-
-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
-
-```
-
-### Canonical URL
-
-You can set custom Canonical URL for a page by specifying `canonical_url` option in pages YAML Front Matter. For example, if you have the following:
-
-```yaml
-layout: single
-title: Title of Your Post
-canonical_url: "https://yoursite.com/custom-canonical-url"
-```
-
-This will generate the following in the `` of your page:
-
-```html
-
-```
-
-## 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
-* Wide page variant
-
-{% 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]({{ "/docs/configuration/#front-matter-defaults" | relative_url }}) in `_config.yml`.
-
-### Wide page
-
-To expand the main content to the right, filling the space of what is normally occupied by the table of contents. Add the following to a post or page's YAML Front Matter:
-
-```yaml
-classes: wide
-```
-
-**Note:** If the page contains a table of contents, it will no longer appear to the right. Instead it will be forced into the main content container directly following the page's title.
-{: .notice--info}
-
-### Table of contents
-
-Auto-generated table of contents list for your posts and pages can be enabled by adding `toc: true` to the YAML Front Matter.
-
-
-
-| Parameter | Required | Description | Default |
-| --------- | -------- | ----------- | ------- |
-| **toc** | Optional | Show table of contents. (boolean) | `false` |
-| **toc_label** | Optional | Table of contents title. (string) | `toc_label` in UI Text data file. |
-| **toc_icon** | Optional | Table of contents icon, displays before the title. (string) | [Font Awesome](https://fontawesome.com/v6/search?s=solid&m=free) **file-alt** icon. Other FA icons can be used instead. |
-| **toc_sticky** | Optional | Stick table of contents to top of screen. | `false` |
-
-**TOC example with custom title and icon**
-
-```yaml
----
-toc: true
-toc_label: "My Table of Contents"
-toc_icon: "cog"
----
-```
-
-{% capture notice-text %}
-**Note:** You need to use contiguous levels of headings for the TOC to generate properly. For example:
-
-```markdown
-Good headings:
-
-# Heading
-## Heading
-### Heading
-### Heading
-# Heading
-## Heading
-
-Bad headings:
-
-# Heading
-### Heading (skipped H2)
-##### Heading (skipped H4)
-```
-{% endcapture %}
-
-
- {{ notice-text | markdownify }}
-
-
-## 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
-
-
-
- List view example.
-
-
-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 Tag -- 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/master/docs/_pages/category-archive.md
-[posts-tags]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.md
-[posts-year]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/year-archive.md
-[posts-collection]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/collection-archive.html
-[portfolio-collection]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/portfolio-archive.md
-
-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."
-```
-
-### Wide page
-
-To expand the main content to the right, filling the space of what is normally occupied by the table of contents. Add the following to a post or page's YAML Front Matter:
-
-```yaml
-classes: wide
-```
-
-### 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:
-
-Create a portfolio archive page (eg. `_pages/portfolio-archive.md`) with the following YAML Front Matter:
-
-```yaml
----
-title: Portfolio
-layout: collection
-permalink: /portfolio/
-collection: portfolio
-entries_layout: grid
----
-```
-
-Teaser images are assigned similar to header images using the following YAML Front Matter:
-
-```yaml
-header:
- teaser: path-to-teaser-image.jpg
-```
-
-**Note:** More information on using this `_include` can be found under [**Helpers**]({{ "/docs/helpers/" | relative_url }}).
-{: .notice--info}
-
-## Taxonomy archives
-
-If you have the luxury of using Jekyll plugins, the creation of category and tag archives is greatly simplified. Simply enable support for the [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) plugin with a few `_config.yml` settings as noted in the [**Configuration**]({{ "/docs/configuration/#archive-settings" | relative_url }}) section and you're good to go.
-
-
-
-If you're not using the `jekyll-archives` plugin then you need to create archive pages yourself. Sample taxonomy archives can be found by grabbing the Markdown sources below and adding to your site.
-
-| Name | Layout | Example |
-| -------------------- | ------ | ------ |
-| [Posts Archive](https://mmistakes.github.io/minimal-mistakes/year-archive/) | `layout: posts` | [year-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/year-archive.md) |
-| [Categories Archive](https://mmistakes.github.io/minimal-mistakes/categories/) | `layout: categories` | [category-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/category-archive.md) |
-| [Category Archive](https://mmistakes.github.io/minimal-mistakes/categories/edge-case/) | `layout: category` | [edge-case.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/edge-case.md) |
-| [Tags Archive](https://mmistakes.github.io/minimal-mistakes/tags/) | `layout: tags` | [tag-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/tag-archive.md) |
-| [Tag Archive](https://mmistakes.github.io/minimal-mistakes/tags/markup/) | `layout: tag` | [markup.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/markup.md) |
-| [Collection Archive](https://mmistakes.github.io/minimal-mistakes/recipes/) | `layout: collection` | [recipes-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/recipes-archive.md) |
-
-**Note:** By default, documents are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter.
-{: .notice--info}
-
-### `layout: posts`
-
-This layout displays all posts grouped by the year they were published. It accommodates the same front matter as `layout: archive`.
-
-### `layout: categories`
-
-This layout displays all posts grouped category. It accommodates the same front matter as `layout: archive`.
-
-### `layout: tags`
-
-This layout displays all posts grouped by tag. It accommodates the same front matter as `layout: archive`.
-
-### `layout: collection`
-
-This layout displays all documents grouped by a specific collection. It accommodates the same front matter as `layout: archive` with the addition of the following:
-
-```yaml
-collection: # collection name
-entries_layout: # list (default), grid
-show_excerpts: # true (default), false
-sort_by: # date (default), title or any metadata key added to the collection's documents
-sort_order: # forward (default), reverse
-```
-
-To create a page showing all documents in the `recipes` collection you'd create `recipes.md` in the root of your project and add this front matter:
-
-```yaml
-title: Recipes
-layout: collection
-permalink: /recipes/
-collection: recipes
-```
-
-If you want to sort the collection by title add `sort_by: title`. If you want reverse sorting, add `sort_order: reverse`.
-You can also use any metadata key that is present in the documents. For example, you can add `number: ` to your documents and use `number` as the sort key:
-
-```yaml
-sort_by: number
-```
-
-### `layout: category`
-
-This layout displays all posts grouped by a specific category. It accommodates the same front matter as `layout: archive` with the addition of the following:
-
-```yaml
-taxonomy: # category name
-entries_layout: # list (default), grid
-```
-
-To create a page showing all posts assigned to the category `foo` you'd create `foo.md` and add this front matter:
-
-```yaml
-title: Foo
-layout: category
-permalink: /categories/foo/
-taxonomy: foo
-```
-
-### `layout: tag`
-
-This layout displays all posts grouped by a specific tag. It accommodates the same front matter as `layout: archive` with the addition of the following:
-
-```yaml
-taxonomy: # tag name
-entries_layout: # list (default), grid
-```
-
-To create a page showing all posts assigned to the tag `foo bar` you'd create `foo-bar.md` and add this front matter:
-
-```yaml
-title: Foo Bar
-layout: tag
-permalink: /tags/foo-bar/
-taxonomy: foo bar
-```
-
-## Home page layout
-
-A derivative archive page layout to be used as a simple home page. It is built to show a paginated list of recent posts based off of the [pagination settings]({{ "/docs/configuration/#paginate" | relative_url }}) in `_config.yml`.
-
-
-
- Example of a paginated home page showing 5 recent posts.
-
-
-To use create `index.html` at the root of your project and add the following YAML Front Matter:
-
-```yaml
----
-layout: home
----
-```
-
-Then configure pagination in `_config.yml`.
-
-```yaml
-paginate: 5 # amount of posts to show
-paginate_path: /page:num/
-```
-
-If you'd rather have a paginated page of posts reside in a subfolder instead of acting as your homepage make the following adjustments.
-
-Create `index.html` in the location you'd like. For example if I wanted it to live at **/blog** I'd create `/blog/index.html` with `layout: home` in its YAML Front Matter.
-
-Then adjust the `paginate_path` in **_config.yml** to match.
-
-```yaml
-paginate_path: /blog/page:num
-```
-
-**Note:** The default Jekyll Paginate plugin can only paginate a single `index.html` file. If you'd like to paginate more pages (e.g. category indexes) you'll need the help of a custom plugin. For more pagination-related settings check the [**Configuration**]({{ "/docs/configuration/#paginate" | relative_url }}) section, including settings for [Jekyll Paginate V2](https://github.com/sverrirs/jekyll-paginate-v2).
-{: .notice--info}
-
-**Note:** By default, documents are shown in a list view. To change to a grid view add `entries_layout: grid` to the page's front matter. To increase the width of the main container, giving more space to the grid items also add `classes: wide` to the home page's YAML Front Matter.
-{: .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)
-
-
-
-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**]({{ "/docs/helpers/" | relative_url }}) section or review a [sample splash page](https://github.com/{{ site.repository }}/blob/master/docs/_pages/splash-page.md).
-
-## Search page layout
-
-A page with a search form. Add `layout: search` to the YAML Front Matter similar to [this example](https://github.com/mmistakes/minimal-mistakes/blob/master/test/_pages/search.md) on the test site.
-
-
-
-**Note:** A page using the `layout: search` isn't compatible with the new [site search feature]({{ "/docs/configuration/#site-search" | relative_url }}) incorporated in the masthead.
-{: .notice--warning}
-
-### Exclusions
-
-If you would like to exclude specific pages/posts from the search index set the search flag to `false` in the YAML Front Matter for the page/post.
-
-```yaml
-search: false
-```
-
-**ProTip:** Add a link to this page in the masthead navigation.
-{: .notice--info}
-
----
-
-## Headers
-
-To add some visual punch to a post or page, a large full-width header image can be included.
-
-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.
-
-**Please Note:** Paths for image headers, overlays, teasers, [galleries]({{ "/docs/helpers/#gallery" | relative_url }}), and [feature rows]({{ "/docs/helpers/#feature-row" | relative_url }}) have changed and require a full path. Instead of just `image: filename.jpg` you'll need to use the full path eg: `image: /assets/images/filename.jpg`. The preferred location is now `/assets/images/`, but can be placed elsewhere or external hosted. This all applies for image references in `_config.yml` and `author.yml` as well.
-{: .notice--danger}
-
-
-
-Place your images in the `/assets/images/` folder and add the following YAML Front Matter:
-
-```yaml
-header:
- image: /assets/images/image-filename.jpg
-```
-
-For externally hosted images include the full image path instead of just the filename:
-
-```yaml
-header:
- image: http://some-site.com/assets/images/image.jpg
-```
-
-To provide a custom alt tag for screen readers:
-
-```yaml
-header:
- image: /assets/images/unsplash-image-1.jpg
- image_description: "A description of the image"
-```
-
-To include a caption or attribution for the image:
-
-```yaml
-header:
- image: /assets/images/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. Example: `0.5`, `rgba(255, 0, 0, 0.5)` or [`linear-gradient`][mdn-linear-gradient]. |
-| **show_overlay_excerpt** | Display excerpt in the overlay text | true |
-| **excerpt** | Auto-generated page excerpt is added to the overlay text or can be overridden. | |
-| **tagline** | Overrides page excerpt. Useful when header text needs to be different from excerpt in archive views. | |
-| **actions** | Call to action button links (`actions` array: `label` and `url`). More than one button link can be assigned. | |
-
- [mdn-linear-gradient]: https://developer.mozilla.org/en-US/docs/Web/CSS/linear-gradient()
-
-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: /assets/images/unsplash-image-1.jpg
- caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
- actions:
- - label: "More Info"
- url: "https://unsplash.com"
-```
-
-You'd get a header image overlaid with text and a call to action button like this:
-
-
-
-You also have the option of specifying a solid background-color to use instead of an image.
-
-
-
-```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:
-
-
-
-```yaml
-excerpt: "This post should [...]"
-header:
- overlay_image: /assets/images/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)"
- actions:
- - label: "Download"
- url: "https://github.com"
-```
-
-Or if you feel colorful, use full rgba:
-
-
-
-```yaml
-excerpt: "This post should [...]"
-header:
- overlay_image: /assets/images/unsplash-image-1.jpg
- overlay_filter: rgba(255, 0, 0, 0.5)
- caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
- actions:
- - label: "Download"
- url: "https://github.com"
-```
-
-Or if you want to do more fancy things, go all the way to [linear-gradient][mdn-linear-gradient]:
-
-
-
-```yaml
-excerpt: "This post should [...]"
-header:
- overlay_image: /assets/images/unsplash-image-1.jpg
- overlay_filter: linear-gradient(rgba(255, 0, 0, 0.5), rgba(0, 255, 255, 0.5))
- caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
- actions:
- - label: "Download"
- url: "https://github.com"
-```
-
-Multiple call to action button links can be assigned like this:
-
-```yaml
-excerpt: "This post should display a **header with an overlay image**, if the theme supports it."
-header:
- overlay_image: /assets/images/unsplash-image-1.jpg
- caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
- actions:
- - label: "Foo Button"
- url: "#foo"
- - label: "Bar Button"
- url: "#bar"
-```
-
-### Open Graph & Twitter Card images
-
-By default the large page header or overlay images are used for sharing previews. If you'd like to set this image to something else use `page.header.og_image` like:
-
-```yaml
-header:
- image: /assets/images/your-page-image.jpg
- og_image: /assets/images/your-og-image.jpg
-```
-
-**ProTip:** `og_image` is useful for setting OpenGraph images on pages that don't have a header or overlay image.
-{: .notice--info}
-
----
-
-## 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.
-
-
-
-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}
-
-To assign more author links, add to the `author.links` array in [`_config.yml`]({{ "/docs/configuration/" | relative_url }}) link so. Any of [Font Awesome's icons](https://fontawesome.com/v6/search) are available for use.
-
-```yaml
-author:
- name: "Your Name"
- avatar: "/assets/images/bio-photo.jpg"
- bio: "I am an **amazing** person." # Note: Markdown is allowed
- location: "Somewhere"
- links:
- - label: "Made Mistakes"
- icon: "fas fa-fw fa-link"
- url: "https://mademistakes.com"
- - label: "Twitter"
- icon: "fab fa-fw fa-twitter-square"
- url: "https://twitter.com/mmistakes"
- - label: "GitHub"
- icon: "fab fa-fw fa-github"
- url: "https://github.com/mmistakes"
- - label: "Instagram"
- icon: "fab fa-fw fa-instagram"
- url: "https://instagram.com/mmistakes"
-```
-
-**Note:** Depending on the icon and theme skin used, colors may not be used. Popular social networks like Twitter, Facebook, Instagram, etc. have the appropriate brand color set in CSS. To change or add missing colors edit [`_utilities.scss`](https://github.com/mmistakes/minimal-mistakes/blob/master/_sass/minimal-mistakes/_utilities.scss) in `/_sass/minimal-mistakes/`.
-{: .notice--info}
-
-For example, to color a Reddit icon, simply add a `color` declaration and the corresponding hex code like so:
-
-```scss
-.social-icons {
- .fa-reddit {
- color: #ff4500;
- }
-}
-```
-
-
-
-### 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."
-```
-
-
-
- Example of custom sidebar content added as YAML Front Matter.
-
-
-**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.
-
-
-
- Custom sidebar navigation menu example.
-
-
-To start, add a new key to `_data/navigation.yml`. This will be referenced later 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"
-```
-
-*New in v4.26.0*: If you have multiple sidebar navs defined and want to include more than one on a page, the sidebar nav can also be a list.
-
-```yaml
-sidebar:
- nav:
- - main
- - docs
-```
-
----
-
-## Social sharing links
-
-The `single` layout has an option to enable social links at the bottom of posts for sharing on Twitter, Facebook, and LinkedIn. Similar to the links found in the author sidebar, the theme ships with defaults for the most common social networks.
-
-
-
-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 LinkedIn button with a Reddit one. Simply replace the HTML with the following:
-
-```html
-{% raw %} Reddit{% 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
-
-
-
-To change the color of the button use one of the built in [utility classes]({{ "/docs/utility-classes/#buttons" | relative_url }}). Or you can create a new button class to match whatever color you want.
-
-Under the `$buttoncolors:` color map in `_sass/minimal-mistakes/_buttons.scss` simply add a name (this will be appended to `btn--`) that matches the new button class. In our case `reddit` ~> `.btn--reddit`.
-
-```scss
-$buttoncolors:
-(facebook, $facebook-color),
-(twitter, $twitter-color),
-(linkedin, $linkedin-color),
-(reddit, $reddit-color);
-```
-
-**ProTip:** For bonus points you can modify the Sass variable `$reddit-color` that is set in `_variables.scss` [or use a different "brand" color](http://brandcolors.net/).
-{: .notice--info}
-
-Add the new `.btn--reddit` class to the `` element from earlier, [compile `main.css`]({{ "/docs/stylesheets/" | relative_url }}) and away you go.
-
-```html
-{% raw %} Reddit{% endraw %}
-```
-
-
-
----
-
-## Custom head and footer
-
-The `default` layout includes a number of custom templates, which provide ways for you to directly add content to all your pages.
-
-### Head
-
-`_includes/head/custom.html` is included at the end of the `` tag. An example use of this include is to add custom CSS per page:
-
-Add some Liquid tags for the new configuration to `_includes/head/custom.html`.
-{% raw %}```html
-{% if page.page_css %}
- {% for stylesheet in page.page_css %}
-
- {% endfor %}
-{% endif %}
-```{% endraw %}
-
-Next, add `page_css` to any page's YAML Front Matter to have your CSS loaded for that page.
-```yaml
-page_css:
- - /path/to/your/custom.css
-```
-
-### Footer
-
-`_includes/footer/custom.html` is included at the beginning of the `