diff --git a/.gitattributes b/.gitattributes index a12b5fb4e512..4d536e4abe56 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,6 +1,10 @@ -assets/fonts/* linguist-vendored -assets/js/main.min.js linguist-vendored -assets/js/lunr/* 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/lunr/* linguist-vendored +assets/js/plugins/* linguist-vendored +assets/js/vendor/* linguist-vendored _sass/minimal-mistakes/vendor/* linguist-vendored +CHANGELOG.md text merge=union +docs/_docs/18-history.md text merge=union + +*.md text diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 6341d98273aa..847b69e8c5a9 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,15 +1,23 @@ # Contributing -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. +Found a typo in the documentation or interested in [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. -Minimal Mistakes has been designed as a base for you to customize and fit your site's unique needs. Please keep this in mind when requesting features and/or submitting pull requests. If it's not something that most people will use, I probably won't consider it. When in doubt ask. +For help with using the theme or general Jekyll support questions, please use the [Jekyll Talk forums](https://talk.jekyllrb.com/). -This goes for author sidebar links and "share button" additions -- I have no intention of merging in every possibly option, the essentials are there to get you started :smile:. +Minimal Mistakes has been designed as a base for you to customize and fit your +site's unique needs. Please keep this in mind when requesting features and/or +submitting pull requests. If it's not something that most people will use, I +probably won't consider it. When in doubt ask. + +This goes for author sidebar links and "share button" additions -- I have no +intention of merging in every possibly option, the essentials are there to get +you started :smile:. ## Pull Requests When submitting a pull request: 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. \ No newline at end of file +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. diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md deleted file mode 100644 index f9c4dcace17e..000000000000 --- a/.github/ISSUE_TEMPLATE.md +++ /dev/null @@ -1,58 +0,0 @@ - - -- [ ] This is a question about using the theme. -- [ ] This is a feature request or enhancement. -- [ ] I believe this to be a bug with the theme. - - [ ] I am using the latest version of the theme. - - [ ] I have updated all gems with `bundle update`. - - [ ] I have tested locally with `bundle exec jekyll build`. - ---- - -## Environment informations - - - -- **Minimal Mistakes version:** -- **Jekyll version:** -- **GitHub Pages hosted:** yes/no -- **Operating system:** - ---- - -## Expected behavior - - - -## Steps to reproduce the behavior - - diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 000000000000..ac8b933ce42a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,94 @@ +name: Bug Report +description: There is something wrong with the theme. 99% of the time you should select Support below. +body: + - type: markdown + attributes: + value: | + 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/ + + If none of the above solved your problem, you can continue below. + + - type: textarea + id: environment + attributes: + label: Theme version and system environment + description: | + 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.yml + file, or problematic site content. + value: |- + - Minimal Mistakes version: + - Ruby gem or remote theme version: + - Jekyll version: + - Git repository URL: + - URL to the page with the problem: + - Operating system: + - Browser version: + validations: + required: true + + - type: textarea + id: what-happened + attributes: + label: What happened? + description: | + Describe the problem **in detail**. For example: + + - What is missing? + - What error do you see? Attach the error log if available. + validations: + required: true + + - type: textarea + id: expected-behavior + attributes: + label: Expected behavior + description: | + Please describe the expected behavior and the actual result you got. + placeholder: > + What is it you expected to happen? This should be a description of how the + functionality you tried to use is supposed to work. + validations: + required: true + + - type: textarea + id: steps-to-reproduce + attributes: + label: Steps to reproduce the behavior + description: | + Describe the steps you took for this problem to come up. 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. + validations: + required: true + + - type: textarea + id: other + attributes: + label: Other + description: | + Please provide a code repository, gist, code snippet, sample files, + screenshots, or anything else you think will aid in reproducing the issue. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 000000000000..e02be34d82d0 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Support + url: https://github.com/mmistakes/minimal-mistakes/discussions + about: Please post your support questions in the Discussions section. \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml new file mode 100644 index 000000000000..65a03152deae --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -0,0 +1,25 @@ +name: Documentation +description: Found a typo or something that needs clarification? +body: + - type: markdown + attributes: + value: | + Thanks for taking the time to open an issue and help make the docs better. + + - type: textarea + id: motivation + attributes: + label: Motivation + description: | + Why should we update our docs? + validations: + required: true + + - type: textarea + id: suggestion + attributes: + label: Suggestion + description: | + What should we do instead? + validations: + required: true \ No newline at end of file diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 000000000000..3271858f6dae --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,30 @@ + + + + + + + + +## Summary + + + +## Context + + + + diff --git a/.github/stale.yml b/.github/stale.yml deleted file mode 100644 index 2d8120fa3799..000000000000 --- a/.github/stale.yml +++ /dev/null @@ -1,22 +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" - - "Status: Review Needed" -# 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 diff --git a/.github/workflows/bad-pr.yml b/.github/workflows/bad-pr.yml new file mode 100644 index 000000000000..9c9c3647ad08 --- /dev/null +++ b/.github/workflows/bad-pr.yml @@ -0,0 +1,35 @@ +name: Cleanup bad PR + +on: + pull_request_target: + types: [opened, reopened] + +permissions: + contents: read + +jobs: + close-pr: + permissions: + pull-requests: write + runs-on: ubuntu-latest + if: "contains(github.event.pull_request.body, 'by deleting this comment block') || github.event.pull_request.body == ''" + steps: + - uses: actions-ecosystem/action-add-labels@v1 + with: + labels: 'Type: Invalid' + - uses: actions-ecosystem/action-add-labels@v1 + with: + labels: 'Type: Spam' + - uses: superbrothers/close-pull-request@v3 + with: + # Optional. Post an issue comment just before closing a pull request. + comment: | + **You have created a Pull Request to the wrong repository.** This is the repository for [Minimal Mistakes][1], the free Jekyll theme. See [GitHub Docs: About pull requests][2] if you need help. + + [1]: https://mmistakes.github.io/minimal-mistakes/ + [2]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests + - uses: sudo-bot/action-pull-request-lock@v1.0.5 + with: + github-token: ${{ secrets.GITHUB_TOKEN }} + number: ${{ github.event.pull_request.number }} + lock-reason: spam diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml new file mode 100644 index 000000000000..733ad0d6668c --- /dev/null +++ b/.github/workflows/build.yml @@ -0,0 +1,47 @@ +name: build + +on: + push: + branches: + - master + workflow_dispatch: {} + repository_dispatch: {} + +jobs: + build: + if: github.repository == 'mmistakes/minimal-mistakes' + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - uses: ruby/setup-ruby@v1 + with: + ruby-version: '3.2' + - name: Setup cache for Bundler + id: cache + uses: actions/cache@v4 + with: + path: | + docs/Gemfile.lock + docs/vendor/bundle + key: ${{ runner.os }}-bundler-${{ hashFiles('docs/Gemfile') }} + restore-keys: | + ${{ runner.os }}-bundler- + + - name: Install - Bundler + env: + MAKE: make -j2 + working-directory: docs/ + run: | + bundle config set path vendor/bundle + bundle install --jobs=4 --retry=3 + bundle clean + + - name: Update Algolia index + working-directory: docs/ + run: bundle exec jekyll algolia push + env: + ALGOLIA_API_KEY: ${{ secrets.ALGOLIA_API_KEY }} + continue-on-error: true diff --git a/.gitignore b/.gitignore index 5c4866d719f9..406061feb7db 100644 --- a/.gitignore +++ b/.gitignore @@ -1,14 +1,32 @@ -*.gem +# Vim +*~ +*.sw[p_] + +# IntelliJ IDEA +*.idea + +# Sublime Text *.sublime-project *.sublime-workspace + +# Ruby Gem +*.gem .bundle +Gemfile.lock +**/vendor/bundle + +# Node.js and NPM +node_modules +npm-debug.log* +package-lock.json +codekit-config.json + +# macOS .DS_Store + +# Jekyll generated files +.jekyll-cache .jekyll-metadata .sass-cache _asset_bundler_cache _site -codekit-config.json -example/_site -Gemfile.lock -node_modules -npm-debug.log* \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index a7fb6cab5c43..61aae5157087 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,290 +1,1044 @@ +# Changelog + ## Unreleased ### Enhancements -* Update jQuery to version `3.3.1`. [#1491](https://github.com/mmistakes/minimal-mistakes/issues/1491) +- Updated Traditional Chinese translation (#5250) +- Add built-in support for jekyll-gfm-admonitions (#5312) + +## [4.27.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.3) + +### Bug Fixes + +- Add explicit CSS rules for `.sr-only` following Font Awesome 7's changes. (#5296) + +## [4.27.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.2) + +### Enhancements + +- Hide `.page__footer-follow` if there are no links nor atom feed. (#5279) +- Add HTML escaping for some titles, labels and metada that was missing. (#5276) +- Add optional `footer.since` for copyright time range. (#5275) + +### Bug Fixes + +- Add `escape_once` to gallery title and alt text. + +## [4.27.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.1) + +### Enhancements + +- Add a "Share on Bluesky" button (#5179) +- Add preset variables for modern font stack (#5033) +- Update X share button to match brand color (#5245) + +### Bug Fixes + +- Fix wrong icon and color for X share button. + +## [4.27.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.0) + +### Enhancements + +- Add RTL Support. [#4886](https://github.com/mmistakes/minimal-mistakes/pull/4886) +- Add missing Polish translation. [#4890](https://github.com/mmistakes/minimal-mistakes/pull/4890) +- Rewrite most directions with [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values). +- Remove unnecessary "type" attribute (#4956) +- The "if" means the default is never used (#4955) +- For pages without a title, show the site title only once (#4959) +- Use `documents-collection.html` partial in `home` layout. +- Add Bulgarian translation. [#5003](https://github.com/mmistakes/minimal-mistakes/pull/5003) +- Add provider and comments info to `single.html` layout for non-production. (#5068) +- Tweak contrast skin $primary-color to adhere to WCAG guidelines. (#5126) +- Update social share buttons to reflect Twitter rebranding to X (#5210) + +### Bug Fixes + +- Replace a redirected link to MadeMistakes in footer. [#4882](https://github.com/mmistakes/minimal-mistakes/pull/4882) +- Fix wrong float direction for `feature_row` with `type="right"`. [#4061](https://github.com/mmistakes/minimal-mistakes/issues/4061) +- Fix reset stylesheet overruling `$doc-font-size`. [#4983](https://github.com/mmistakes/minimal-mistakes/issues/4983) +- Fix JavaScript null error on home and splash layouts. [#4938](https://github.com/mmistakes/minimal-mistakes/issues/4938), [#4939](https://github.com/mmistakes/minimal-mistakes/pull/4939) +- Fix bad <figure> HTML if "alt" contains quotes. +- Fix extra newline generated in `_includes/post_pagination.html`. +- Hide hidden links & remove the overlay when one is clicked. [#5042](https://github.com/mmistakes/minimal-mistakes/pull/5042) +- Fix typo in "Configuration" (#5106) +- bundle exec jekyll serve will fail if more than once (#5193) + +### Documentation & Maintenance + +- Automatically update Algolia search index with GitHub Actions. + +## [4.26.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.2) + +### Enhancements + +- Add Czech localization. [#4866](https://github.com/mmistakes/minimal-mistakes/pull/4866) +- Allow overriding HTML `lang` attribute on a per-page basis. [#4862](https://github.com/mmistakes/minimal-mistakes/pull/4862) + +### Bug Fixes + +- Figure helper breaks when using code markup in caption with `popup=true`. [#4841](https://github.com/mmistakes/minimal-mistakes/issues/4841) + +## [4.26.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.1) + +### Bug Fixes + +- Disable copy button on invalid syntax highlighting blocks to avoid positioning issues. +- Fix typo for `fa-dribbble` in `_utilities.scss`. +- Restrict "auto scroll sticky ToC to content" feature to Chromium browsers for now. [#4826](https://github.com/mmistakes/minimal-mistakes/issues/4826) + +### Documentation & Maintenance + +- Rewrite social icons SCSS with a loop. + +### Enhancements + +- Change the icon of a copy button into a tick for 1.5 seconds on successful copy. + +## [4.26.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.0) + +### Bug Fixes + +- Fix an unclosed `

` tag in `page__hero.html`, near `page.header.actions`. +- Remove overlay and revert X to hamburger icon when popup disappears. [#3958](https://github.com/mmistakes/minimal-mistakes/pull/3958) +- Fix SEO title when it contains a vertical bar. [#3094](https://github.com/mmistakes/minimal-mistakes/pull/3094) [#3113](https://github.com/mmistakes/minimal-mistakes/pull/3113) +- Remove "sticky sidebar" JS as it's now completely based on CSS media queries. [#4245](https://github.com/mmistakes/minimal-mistakes/issues/4245) [#4645](https://github.com/mmistakes/minimal-mistakes/pull/4645) + +### Enhancements + +- Add support for [Jekyll Paginate V2](https://github.com/sverrirs/jekyll-paginate-v2) 🎉 [#2636](https://github.com/mmistakes/minimal-mistakes/pull/2636) +- Add "copy to clipboard" button for code blocks 🎉 [#2812](https://github.com/mmistakes/minimal-mistakes/pull/2812) +- Auto scroll sticky ToC with content. [#3115](https://github.com/mmistakes/minimal-mistakes/pull/3115) +- Replace "hidden" check in Liquid templates with `where_exp: "item", "item.hidden != true"`. +- Remove deprecated `page.header.cta_url` setting. [#4821](https://github.com/mmistakes/minimal-mistakes/pull/4821) +- Allow multiple nav lists in sidebar. [#2843](https://github.com/mmistakes/minimal-mistakes/pull/2843) +- Add popup parameter to `{% include figure %}` to enable Magnific Popup. [#3119](https://github.com/mmistakes/minimal-mistakes/pull/3119) +- Add target attribute for navigation link. [#3056](https://github.com/mmistakes/minimal-mistakes/pull/3056) +- Split schema to a separate include file. [#3085](https://github.com/mmistakes/minimal-mistakes/pull/3085) +- Cleanup `_includes/seo.html`. + +### Documentation & Maintenance + +- Rewrite skin previews on `05-configuration.md` in Liquid template. +- Remove unused classes from `_layouts/single.html`. +- Migrate npm run scripts to Ruby Rake tasks. +- Add Rake task `version` for updating all hard-coded version numbers from `package.json` all at once. +- Merge `categories` and `tags` layout into `_includes/posts-taxonomy.html`. +- Update Social Sharing links section. [#4066](https://github.com/mmistakes/minimal-mistakes/pull/4066) + +## [4.25.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.1) + +### Bug Fixes + +- "You may also enjoy" no longer recommends hidden posts. [#4653](https://github.com/mmistakes/minimal-mistakes/issues/4653) +- Replaced dead link to "Viewport and Media Queries" slides. [#4421](https://github.com/mmistakes/minimal-mistakes/discussions/4421) +- Fix broken `where_exp` in `lunr-store.js` for Jekyll < 4.0. [#4808](https://github.com/mmistakes/minimal-mistakes/issues/4808) + +### Enhancements + +- Add Ukrainian translations. [#4273](https://github.com/mmistakes/minimal-mistakes/pull/4273) +- Add more configuration for Giscus. [#4274](https://github.com/mmistakes/minimal-mistakes/pull/4274) +- Bump jekyll-toc to [v1.2.1](https://github.com/allejo/jekyll-toc/releases/tag/v1.2.1). + +### Documentation & Maintenance + +- Bump shell-quote from 1.7.1 to 1.7.3 [#3692](https://github.com/mmistakes/minimal-mistakes/issues/3692) +- Add `after-content.html` and `before-related.html` includes to ease docs site overrides. +- GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884) +- Replace Font Awesome v5 search page with v6. +- Try adding an FAQ page. +- Update remote theme reference in Quick-Start Guide to point to 4.25.0. [#4809](https://github.com/mmistakes/minimal-mistakes/issues/4809) + +## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0) + +### Bug Fixes + +- Fix Linkedin social share link [#4754](https://github.com/mmistakes/minimal-mistakes/issues/4754) +- Fix non-English characters being url encoded in breadcrumb [#3819](https://github.com/mmistakes/minimal-mistakes/issues/3819) +- Fix wrong `first_page_path` because of hard-coded `page:num` [#3778](https://github.com/mmistakes/minimal-mistakes/issues/3778) +- Remove JS and other files from search index [#4000](https://github.com/mmistakes/minimal-mistakes/pull/4000) +- Fix unlisted YouTube video embeds in documentation/test sites. [#3649](https://github.com/mmistakes/minimal-mistakes/issues/3649) +- Fix error in Algolia search script when returning a hit that without `html` and `hightlight.html`. [#3101](https://github.com/mmistakes/minimal-mistakes/issues/3101) [#3102](https://github.com/mmistakes/minimal-mistakes/pull/3102) +- Fix inline code style not applied to stylized text. [#3253](https://github.com/mmistakes/minimal-mistakes/pull/3253) +- Fix Keybase icon in author sidebar. [#3221](https://github.com/mmistakes/minimal-mistakes/pull/3221) +- Fix sort order of Staticman comments when data files aren't named alphabetically. [#3184](https://github.com/mmistakes/minimal-mistakes/pull/3184) +- Fix `layout: compress` issue with HTML comment in video include. [#3117](https://github.com/mmistakes/minimal-mistakes/pull/3117) +- Add Magnific Popup class to anchors that only contain an `img` element. [#3111](https://github.com/mmistakes/minimal-mistakes/issues/3111) [#3114](https://github.com/mmistakes/minimal-mistakes/pull/3114) +- Fix heading level of related posts section from `h4` to `h2` to improve accessibility and SEO. [#3064](https://github.com/mmistakes/minimal-mistakes/pull/3064) +- Fix grammar error in German localized UI text string. [#3063](https://github.com/mmistakes/minimal-mistakes/pull/3063) +- Remove site.url from first breadcrumb link. [#3051](https://github.com/mmistakes/minimal-mistakes/pull/3051) + +### Enhancements + +- Add `site.copyright` and `site.copyright_url` config options [#4313](https://github.com/mmistakes/minimal-mistakes/pull/4313) +- Lazy-load InstantSearch scripts and stylesheets [#3691](https://github.com/mmistakes/minimal-mistakes/pull/3691) +- Improve Finnish translations [#4595](https://github.com/mmistakes/minimal-mistakes/pull/4595) +- Remove redundant downcase from \_layouts/categories.html. [#4531](https://github.com/mmistakes/minimal-mistakes/pull/4531) +- Load latest Font Awesome package. [#3765](https://github.com/mmistakes/minimal-mistakes/pull/3765) +- Add missing Polish missing UI text strings. [#3969](https://github.com/mmistakes/minimal-mistakes/pull/3969) +- Update breadcrumbs conditional to enable/disable them via Front Matter on pages using `layout: single`. [#3096](https://github.com/mmistakes/minimal-mistakes/pull/3096) [#3669](https://github.com/mmistakes/minimal-mistakes/pull/3669) +- Remove Internet Explorer 9 upgrade notice. [#3666](https://github.com/mmistakes/minimal-mistakes/pull/3666) +- Add Kiswahili localized UI text strings. [#3489](https://github.com/mmistakes/minimal-mistakes/pull/3489) +- Exclude `main.scss` from Lunr search index. +- Allow `site.pages` to be indexed and searched via Lunr. [#3352](https://github.com/mmistakes/minimal-mistakes/pull/3352) +- Update jQuery to v3.6.0. [#3254](https://github.com/mmistakes/minimal-mistakes/pull/3254) +- Use notice `` colors for blockquotes that have `notice--` classes applied. [#3140](https://github.com/mmistakes/minimal-mistakes/pull/3140) [#3068](https://github.com/mmistakes/minimal-mistakes/issues/3068) +- Add sameAs itemprop to author link. [#3087](https://github.com/mmistakes/minimal-mistakes/pull/3087) +- Update and add missing Brazilian Portuguese translations. [#3204](https://github.com/mmistakes/minimal-mistakes/pull/3204) +- Add optional label attribute for utterances comments. [#3128](https://github.com/mmistakes/minimal-mistakes/pull/3128) +- Add missing Danish translations. [#3095](https://github.com/mmistakes/minimal-mistakes/pull/3095) +- Add ARIA role to search forms. [#3086](https://github.com/mmistakes/minimal-mistakes/pull/3086) +- Add overflow scroll bar to sticky table of contents that are taller than the viewport's height. [#2874](https://github.com/mmistakes/minimal-mistakes/pull/2874) +- Add Microformats markup. [#3052](https://github.com/mmistakes/minimal-mistakes/pull/3052) + +### Documentation & Maintenance + +- Fix links to Font Awesome gallery. [#3599](https://github.com/mmistakes/minimal-mistakes/pull/3599) +- Fix GreedyNav.js attribution link. [#3553](https://github.com/mmistakes/minimal-mistakes/pull/3553) +- Fix typo about loading JavaScript in layout documentation. [#3350](https://github.com/mmistakes/minimal-mistakes/pull/3350) +- Fix documentation typos. [#3232](https://github.com/mmistakes/minimal-mistakes/pull/3232) [#3318](https://github.com/mmistakes/minimal-mistakes/pull/3318) +- Add link to documentation clarifying how to add plugins. [#3181](https://github.com/mmistakes/minimal-mistakes/pull/3181) +- Fix broken documentation link and add Baidu site verification to `_config.yml` files. [#3139](https://github.com/mmistakes/minimal-mistakes/pull/3139) +- Bump path-parse from 1.0.6 to 1.0.7. [#3116](https://github.com/mmistakes/minimal-mistakes/pull/3116) +- Automatically close invalid PRs using GitHub Actions. [#3313](https://github.com/mmistakes/minimal-mistakes/pull/3313) +- Add instructions on how to unminify `main.js` for easier browser debugging. [#3055](https://github.com/mmistakes/minimal-mistakes/pull/3055) +- Consolidate hard-coded version numbers where possible. +- Add Rakefile for automatically syncing CHANGELOG with history and synched them. + +## [4.24.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.24.0) + +### Bug Fixes + +- Fix README text for Gumshoejs license. [#3024](https://github.com/mmistakes/minimal-mistakes/pull/3024) +- Remove `tabindex="-1"` from `input` elements in `search.html` layout to allow them to be accessible by keyboard. [#2982](https://github.com/mmistakes/minimal-mistakes/issues/2982) +- Fix broken sidebar image in sample post. [#3013](https://github.com/mmistakes/minimal-mistakes/issues/3013) +- Fix broken links in Upgrading documentation. [#3004](https://github.com/mmistakes/minimal-mistakes/issues/3004) + +### Enhancements + +- Remove IE9 flexbox fallback. [#3042](https://github.com/mmistakes/minimal-mistakes/pull/3042) +- Remove `h2` from skip links navigation as it is not important for site structure. [#3012](https://github.com/mmistakes/minimal-mistakes/pull/3012) +- Loads Font Awesome asynchronously. [#2967](https://github.com/mmistakes/minimal-mistakes/pull/2967) +- Replace custom search icon SVG with Font Awesome icon. [#2774](https://github.com/mmistakes/minimal-mistakes/pull/2774) +- Adds support for giscus comments. [#3022](https://github.com/mmistakes/minimal-mistakes/pull/3022) + +## [4.23.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.23.0) + +### Enhancements + +- Add Arabic (عربي) localized UI text strings. [#2936](https://github.com/mmistakes/minimal-mistakes/pull/2936) +- Update onchange and uglify-js dependencies. +- Document head and footer `custom.html` includes. [#2815](https://github.com/mmistakes/minimal-mistakes/pull/2815) +- Color notices based on skin colors instead of fixed values. [#2887](https://github.com/mmistakes/minimal-mistakes/pull/2887) +- Add configurable datetime format. [#2844](https://github.com/mmistakes/minimal-mistakes/pull/2844) +- Add Baidu site verification [#2830](https://github.com/mmistakes/minimal-mistakes/pull/2830) +- Add `alt` attribute to site logo. [#2529](https://github.com/mmistakes/minimal-mistakes/issues/2529) [#2824](https://github.com/mmistakes/minimal-mistakes/issues/2824) + +### Bug Fixes + +- Fix menu toggle to properly show close icon when open. +- Fix Jekyll environment note in configuration documentation. [#2912](https://github.com/mmistakes/minimal-mistakes/issues/2912) +- Fix typo in Helpers documentation. [#2940](https://github.com/mmistakes/minimal-mistakes/pull/2940) +- Remove all references to official public Staticman API instance. [#2818](https://github.com/mmistakes/minimal-mistakes/issues/2818) [#2831](https://github.com/mmistakes/minimal-mistakes/pull/2831) +- Remove Google Search CSS. [#2852](https://github.com/mmistakes/minimal-mistakes/issues/2852) [#2855](https://github.com/mmistakes/minimal-mistakes/pull/2855) + +## [4.22.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.22.0) + +### Bug Fixes + +- Remove Google Search script from `404.md`. [#2597](https://github.com/mmistakes/minimal-mistakes/issues/2597) [#2737](https://github.com/mmistakes/minimal-mistakes/pull/2737) [#2789](https://github.com/mmistakes/minimal-mistakes/pull/2789) +- Fix Font Awesome icon color in `contrast`, `dark`, `mint`, `neon`, `plum`, and `sunrise` skins. [#2724](https://github.com/mmistakes/minimal-mistakes/issues/2724) + +### Enhancements + +- Allow custom sorting for collections. [#2723](https://github.com/mmistakes/minimal-mistakes/pull/2723) +- Use `sort_natural` instead of custom Liquid logic to sort tags and categories. [#2756](https://github.com/mmistakes/minimal-mistakes/pull/2756) +- Add configuration option to toggle off RSS feed link in `` and site footer. [#2787](https://github.com/mmistakes/minimal-mistakes/pull/2787) +- Upgrade Lunrjs to 2.3.9 and switch to `relative_url`. [#2805](https://github.com/mmistakes/minimal-mistakes/pull/2805) +- Adds `.webp` to list of supported image extensions for the image popup lightbox. [#2788](https://github.com/mmistakes/minimal-mistakes/pull/2788) +- Add Hebrew localized UI text strings. [#2760](https://github.com/mmistakes/minimal-mistakes/pull/2760) +- Update documentation to include `toc_sticky` parameter's description. [#2741](https://github.com/mmistakes/minimal-mistakes/pull/2741) +- Update Indonesian localized UI text strings. [#2731](https://github.com/mmistakes/minimal-mistakes/pull/2731) +- Update remote theme documentation. [#2734](https://github.com/mmistakes/minimal-mistakes/pull/2734) +- Update allejo/jekyll-toc to v1.1.0, skip headings without an ID. [#2752](https://github.com/mmistakes/minimal-mistakes/pull/2752) +- Allow custom gradient for page header overlay. [#2806](https://github.com/mmistakes/minimal-mistakes/pull/2806) + +## [4.21.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.21.0) + +### Bug Fixes + +- Fix greedy navigation by improving reliability of remaining space for visible links. [#2664](https://github.com/mmistakes/minimal-mistakes/issues/2664) +- Collapse white-space in `figure` helper to fix issues when used in Markdown ordered and unordered lists. [#2697](https://github.com/mmistakes/minimal-mistakes/pull/2697) +- Fix dead link to CI services in documentation. [#2635](https://github.com/mmistakes/minimal-mistakes/issues/2635) [#2692](https://github.com/mmistakes/minimal-mistakes/pull/2692) +- Fix a small typo in documentation. [#2718](https://github.com/mmistakes/minimal-mistakes/pull/2718) + +### Enhancements + +- Update jQuery to 3.5.1. [#2713](https://github.com/mmistakes/minimal-mistakes/pull/2713) +- Add Indonesian localized UI text strings. [#2725](https://github.com/mmistakes/minimal-mistakes/pull/2725) +- Update Vietnamese localized UI text strings. [#2722](https://github.com/mmistakes/minimal-mistakes/pull/2722) +- Add Norwegian (Norsk) localized UI text strings. [#2702](https://github.com/mmistakes/minimal-mistakes/pull/2702) +- Update allejo/jekyll-toc to v1.0.14 [#2700](https://github.com/mmistakes/minimal-mistakes/pull/2700) + +## [4.20.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.2) + +### Bug Fixes + +- Fix broken link in documentation. [#2677](https://github.com/mmistakes/minimal-mistakes/issues/2677) +- Fix typo in documentation. [#2678](https://github.com/mmistakes/minimal-mistakes/issues/2678) +- Remove duplicate CSS definitions. [#2666](https://github.com/mmistakes/minimal-mistakes/pull/2666) +- Fix `entries_layout: grid` in various layouts. [#2639](https://github.com/mmistakes/minimal-mistakes/issues/2639) +- Change `fa` to `fas` for Font Awesome 5. [#2649](https://github.com/mmistakes/minimal-mistakes/pull/2649) + +### Enhancements + +- Refactor page meta include. [#2641](https://github.com/mmistakes/minimal-mistakes/pull/2641) +- Add `article:author` Open Graph markup. [#2670](https://github.com/mmistakes/minimal-mistakes/pull/2670) + +## [4.20.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.1) + +### Bug Fixes + +- Fix grid `entries_layout` in home.html. [#2616](https://github.com/mmistakes/minimal-mistakes/pull/2616) + +## [4.20.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.0) + +### Bug Fixes + +- Add `relative_url` filter to author home link [#2575](https://github.com/mmistakes/minimal-mistakes/pull/2575) +- Fix `analytics.provider` config comment to list all analytics providers. [#2607](https://github.com/mmistakes/minimal-mistakes/pull/2607) +- Fix typo in installation documentation. [#2570](https://github.com/mmistakes/minimal-mistakes/pull/2570) +- Fix broken Lunr search with Jekyll v4.1.0. [#2617](https://github.com/mmistakes/minimal-mistakes/pull/2617) + +### Enhancements + +- Add an optional date alongside the reading time. To enable set `show_date: true` similar to how reading time is. [#2526](https://github.com/mmistakes/minimal-mistakes/pull/2526) +- Remove hidden posts from posts.html layout. [#2625](https://github.com/mmistakes/minimal-mistakes/pull/2625) +- Add entry layout configuration for `list` (default) or `grid` views on `layout: home`. [#2616](https://github.com/mmistakes/minimal-mistakes/pull/2616) +- Add missing Chinese translations. [#2576](https://github.com/mmistakes/minimal-mistakes/pull/2576) +- Improve Chinese translations. [#2626](https://github.com/mmistakes/minimal-mistakes/pull/2626) +- Add `line-height` to `h4` element in notice helper. [#2602](https://github.com/mmistakes/minimal-mistakes/pull/2602) +- Improve Algolia search. [#2572](https://github.com/mmistakes/minimal-mistakes/pull/2572) +- Update link to wtfpl license in README. [#2571](https://github.com/mmistakes/minimal-mistakes/pull/2571) +- Ignore teaser headline in table of contents when including posts list in another page. [#2558](https://github.com/mmistakes/minimal-mistakes/pull/2558) +- Replace Font Awesome Kits with CSS from jsDelivr CDN. [#2583](https://github.com/mmistakes/minimal-mistakes/pull/2583) +- Add `danmaku` option to Bilibili video provider and add corresponding documentation/ [#2599](https://github.com/mmistakes/minimal-mistakes/pull/2599) +- Update documentation about loading l10n data file from the theme-gem. [#2621](https://github.com/mmistakes/minimal-mistakes/issues/2621) [#2624](https://github.com/mmistakes/minimal-mistakes/pull/2624) + +## [4.19.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.3) + +### Enhancements + +- Update GreedyNav.js to reduce masthead link overflow/shifting on mobile devices. [#2551](https://github.com/mmistakes/minimal-mistakes/issues/2551) +- Replace `

` in `comments.html` include and add `custom_scripts.html` include for loading custom comment provider JavaScript in the footer. [#2549](https://github.com/mmistakes/minimal-mistakes/issues/2549) +- Move page date Liquid to include. [#2544](https://github.com/mmistakes/minimal-mistakes/pull/2544) +- Strip trailing whitespace in `seo_description`. [#2542](https://github.com/mmistakes/minimal-mistakes/pull/2542) +- Improve sticky sidebar's appearance with short content. [#2514](https://github.com/mmistakes/minimal-mistakes/pull/2514) + +## [4.19.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.2) + +### Enhancements + +- Add support for bilibili videos in [responsive video helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#responsive-video-embed). [#2512](https://github.com/mmistakes/minimal-mistakes/pull/2512) +- Add Myanmar (Burmese) localized UI text strings. [#2500](https://github.com/mmistakes/minimal-mistakes/pull/2500) +- Improve author links underline on hover. [#2472](https://github.com/mmistakes/minimal-mistakes/pull/2472) +- Add documentation for applying Front Matter defaults to jekyll-archives pages. [#2466](https://github.com/mmistakes/minimal-mistakes/pull/2466) +- Add missing Vietnamese translations. [#2459](https://github.com/mmistakes/minimal-mistakes/pull/2459) [#2486](https://github.com/mmistakes/minimal-mistakes/pull/2486) +- Fix Finnish localized UI text strings. [#2455](https://github.com/mmistakes/minimal-mistakes/pull/2455) +- Clarify documentation that Lunr only searches documents in collections. [#2450](https://github.com/mmistakes/minimal-mistakes/pull/2450) +- Add guide on applying Front Matter defaults to jekyll-archives pages [#2466](https://github.com/mmistakes/minimal-mistakes/pull/2466) + +### Bug Fixes + +- Fix typo in configuration documentation. [#2497](https://github.com/mmistakes/minimal-mistakes/pull/2497) +- Fix "Follow menu falls under post links" on small screens. [#2479](https://github.com/mmistakes/minimal-mistakes/issues/2479) +- Hide index page from page-archive. [#2482](https://github.com/mmistakes/minimal-mistakes/pull/2482) + +## [4.19.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.1) + +### Enhancements + +- Add [Dracula](https://draculatheme.com/) Base16 syntax highlighting theme Sass variables to [stylesheets documentation](https://mmistakes.github.io/minimal-mistakes/docs/stylesheets/#syntax-highlighting). [#2438](https://github.com/mmistakes/minimal-mistakes/pull/2438) +- Update links to `HTTPS` and remove Google+ from configuration documentation. [#2432](https://github.com/mmistakes/minimal-mistakes/pull/2432) +- Use `first_page_path` from jekyll-paginate-v2 if available. [#2431](https://github.com/mmistakes/minimal-mistakes/pull/2431) +- Update onchange and uglify-js dependencies. +- Update smooth-scroll.js to `v16.1.2`. [#2430](https://github.com/mmistakes/minimal-mistakes/issues/2430) + +### Bug Fixes + +- Fix author profile links `z-index` order on small screens. [#2440](https://github.com/mmistakes/minimal-mistakes/issues/2440) + +## [4.19.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.0) + +### Enhancements + +- Add "click" overlay to close masthead and follow button menus when open. [#1168](https://github.com/mmistakes/minimal-mistakes/issues/1168) +- Remove deprecated Staticman v1 configurations from `_config.yml`. [#2386](https://github.com/mmistakes/minimal-mistakes/issues/2386) +- Use `relative_url` and `absolute_url` filters where possible. [#2387](https://github.com/mmistakes/minimal-mistakes/pull/2387) +- Improve headline hierarchy and add Sass specific variables `$h-size-x`. [#2423](https://github.com/mmistakes/minimal-mistakes/issues/2423) +- Improve accessibility of `default` skin by increasing color contrast of text and links. +- Hide posts with `hidden: true` YAML front matter from appearing in listings. [#2345](https://github.com/mmistakes/minimal-mistakes/pull/2345) +- Add Irish (Gaeilge) localized UI text strings. [#2422](https://github.com/mmistakes/minimal-mistakes/pull/2422) +- Remove `box-shadow` on radio and checkbox inputs. [#2398](https://github.com/mmistakes/minimal-mistakes/pull/2398) +- Bump Jekyll gem dependency to `v3.7`. + +### Bug Fixes + +- Fix documentation around using `bundle info` command. [#2425](https://github.com/mmistakes/minimal-mistakes/pull/2425) +- Fix rake vulnerability in `.gemspec` file. +- Fix Staticman v2 comment submission. [#2402](https://github.com/mmistakes/minimal-mistakes/pull/2402) +- Fix repeated site base path for masthead logo. [#2385](https://github.com/mmistakes/minimal-mistakes/pull/2385) + +## [4.18.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.18.1) + +### Bug Fixes + +- Fix compatibility issue with jekyll-paginate-v2. [#2381](https://github.com/mmistakes/minimal-mistakes/pull/2381) + +## [4.18.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.18.0) + +### Enhancements + +- Allow `home` layout to display posts without pagination. [#2378](https://github.com/mmistakes/minimal-mistakes/pull/2378) +- Add links to high resolution skin screenshots in README. [#2363](https://github.com/mmistakes/minimal-mistakes/issues/2363) +- Update README and LICENSE. [#2367](https://github.com/mmistakes/minimal-mistakes/pull/2367) +- Update `.gitignore` file. [#2366](https://github.com/mmistakes/minimal-mistakes/pull/2366) +- Allow override of page excerpt in hero header via `tagline` YAML front matter. [#2307](https://github.com/mmistakes/minimal-mistakes/pull/2307) +- Exclude `package-lock.json` from Jekyll build. [#2364](https://github.com/mmistakes/minimal-mistakes/pull/2364) +- Use `%-d` instead of `%d` so displayed dates aren't padded with zero. [#2359](https://github.com/mmistakes/minimal-mistakes/pull/2359) +- Update table of contents helper (`toc.html`) to [v1.0.8](https://github.com/allejo/jekyll-toc/releases). [#2355](https://github.com/mmistakes/minimal-mistakes/pull/2355) +- Add missing Dutch localized UI text strings. [#2321](https://github.com/mmistakes/minimal-mistakes/pull/2321) +- Support page header (hero) in `archive-taxonomy` layout. [#2320](https://github.com/mmistakes/minimal-mistakes/pull/2320) +- Add social icon color for Keybase. [#2302](https://github.com/mmistakes/minimal-mistakes/pull/2302) + +### Bug Fixes + +- Fix JavaScript comments in Disqus include to be compatible with `compress` layout. [#2373](https://github.com/mmistakes/minimal-mistakes/pull/2373) +- Fix wrong newline concatenation in SEO description [#2368](https://github.com/mmistakes/minimal-mistakes/pull/2368) [#2354](https://github.com/mmistakes/minimal-mistakes/issues/2354) +- Fix Staticman v2/v3 conditional for showing comments. [#2351](https://github.com/mmistakes/minimal-mistakes/pull/2351) +- Fix masthead logo path. [#2332](https://github.com/mmistakes/minimal-mistakes/pull/2332) +- Fix schema.org dates to ISO-8601. [#2339](https://github.com/mmistakes/minimal-mistakes/pull/2339) +- Fix background color of code blocks in notices. [#2328](https://github.com/mmistakes/minimal-mistakes/pull/2328) +- Fix alignment of feature rows when placed next to a sticky sidebar. [#2327](https://github.com/mmistakes/minimal-mistakes/issues/2327) +- Fix `seo_description` in `_includes/seo.html`. [#2326](https://github.com/mmistakes/minimal-mistakes/pull/2326) +- Fix typo in `_config.yml`. [#2319](https://github.com/mmistakes/minimal-mistakes/pull/2319) + +## [4.17.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.2) + +### Enhancements + +- Add collection step to documentation about creating a portfolio page. [#2294](https://github.com/mmistakes/minimal-mistakes/pull/2294) +- Replace sticky footer JavaScript with flexbox styles. [#2289](https://github.com/mmistakes/minimal-mistakes/pull/2289) + +### Bug Fixes + +- Fix sticky footer when using MozBar extension. [#2281](https://github.com/mmistakes/minimal-mistakes/issues/2281) + +## [4.17.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.1) + +### Enhancements + +- Update Chinese (Simplified) localized UI text strings. [#2286](https://github.com/mmistakes/minimal-mistakes/pull/2286) +- Update list of 3rd party JavaScript used and licenses. [#2276](https://github.com/mmistakes/minimal-mistakes/pull/2276) + +### Bug Fixes + +- Fix indention of nested GFM task lists. [#2283](https://github.com/mmistakes/minimal-mistakes/issues/2283) + +## [4.17.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.0) + +### Enhancements + +- Show a permalink anchor when hovering over headings in main content area. [#2251](https://github.com/mmistakes/minimal-mistakes/pull/2251) +- Allow per-page override of `words_per_minute`. [#2250](https://github.com/mmistakes/minimal-mistakes/pull/2250) +- Update [onchange](https://www.npmjs.com/package/onchange) development dependency in `package.json`. [#2241](https://github.com/mmistakes/minimal-mistakes/issues/2241) +- Add Catalan localized UI text strings. [#2237](https://github.com/mmistakes/minimal-mistakes/pull/2237) + +### Bug Fixes + +- Remove extraneous space from Internet Explorer conditional statement. [#2273](https://github.com/mmistakes/minimal-mistakes/pull/2273) +- Fix typo in `_config.yml`. [#2243](https://github.com/mmistakes/minimal-mistakes/pull/2243) +- Replace `http` URLs with `https` where applicable in `_config.yml`. [#2244](https://github.com/mmistakes/minimal-mistakes/pull/2244) + +## [4.16.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.6) + +### Enhancements + +- Relax Jekyll dependency to allow for version 4.0. +- Add missing Spanish localized UI text strings. [#2229](https://github.com/mmistakes/minimal-mistakes/pull/2229) +- Allow Markdown in author bio. [#2215](https://github.com/mmistakes/minimal-mistakes/pull/2215) + +### Bug Fixes + +- Fix `site.url` in Organization/Person JSON-LD schema. [#1906](https://github.com/mmistakes/minimal-mistakes/issues/1906) +- Remove full stop in some `comment_form_info` UI text strings. [#2220](https://github.com/mmistakes/minimal-mistakes/pull/2220) +- Fix default `site.author` in seo.html [#2230](https://github.com/mmistakes/minimal-mistakes/pull/2230) +- Fix overlapping links (linked to and post's permalink) in post link type. [#2222](https://github.com/mmistakes/minimal-mistakes/issues/2222) + +## [4.16.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.5) + +### Enhancements + +- Add optional site subtitle to masthead. [#2173](https://github.com/mmistakes/minimal-mistakes/issues/2173) +- Add missing Punjabi and Hindi localized UI text strings. [#2212](https://github.com/mmistakes/minimal-mistakes/pull/2212) +- Add missing Korean localized UI text strings. [#2209](https://github.com/mmistakes/minimal-mistakes/pull/2209) +- Use [Font Awesome Kits](https://blog.fontawesome.com/introducing-font-awesome-kits-7134d1d59959) to use the latest version of icons. [#2184](https://github.com/mmistakes/minimal-mistakes/issues/2184) +- Remove unnecessary console.log in `lunr-en.js` and `lunr-gr.js` JavaScript. [#2193](https://github.com/mmistakes/minimal-mistakes/issues/2193) +- Remove unnecessary `type="text/javascript"` from Google Analytics JavaScript. [#2190](https://github.com/mmistakes/minimal-mistakes/pull/2190) +- Update links and fix typos in documentation. [#2186](https://github.com/mmistakes/minimal-mistakes/pull/2186) +- Add skip links. [#2182](https://github.com/mmistakes/minimal-mistakes/issues/2182) + +### Bug Fixes + +- Fix aria issues with Lunr search form. [#2211](https://github.com/mmistakes/minimal-mistakes/pull/2211) +- Fix missing fallback title for table of contents. + +## [4.16.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.4) + +### Enhancements + +- Update Brazilian Portuguese localized UI text strings. [#2162](https://github.com/mmistakes/minimal-mistakes/pull/2162) +- Update Font Awesome to v5.8.2. [#2150](https://github.com/mmistakes/minimal-mistakes/pull/2150) +- Add missing Spanish localized UI text strings. [#2149](https://github.com/mmistakes/minimal-mistakes/pull/2149) + +### Bug Fixes + +- Fix arithmetic in `_form.scss` partial. [#2169](https://github.com/mmistakes/minimal-mistakes/pull/2169) +- Fix pound symbol not displaying properly for post categories and tags. [#2156](https://github.com/mmistakes/minimal-mistakes/issues/2156) +- Fix permalink stacking order and click-able area in archives. + +## [4.16.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.3) + +### Enhancements + +- Update jQuery to v3.4.1. [#2137](https://github.com/mmistakes/minimal-mistakes/issues/2137) +- Update Gumshoe to v5.1.1. [#2140](https://github.com/mmistakes/minimal-mistakes/issues/2140) + +### Bug Fixes + +- Fix JavaScript error when resizing pages with table of contents. [#2140](https://github.com/mmistakes/minimal-mistakes/issues/2140) + +## [4.16.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.2) + +### Bug Fixes + +- Revert jQuery back to version v3.3.1, v.3.4.0 causes issues with other plugins that haven't been updated. [#2137](https://github.com/mmistakes/minimal-mistakes/issues/2137) + +## [4.16.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.1) + +### Enhancements + +- Update [`compress` layout](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#compress-layout) to v3.1.0. [#2128](https://github.com/mmistakes/minimal-mistakes/pull/2128) +- Update jQuery to v3.4.0. [#2129](https://github.com/mmistakes/minimal-mistakes/pull/2129) + +### Bug Fixes + +- Fix Gumshoe related JavaScript error on pages without a table of contents. [#2124](https://github.com/mmistakes/minimal-mistakes/pull/2124) + +## [4.16.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.0) + +### Enhancements + +- Improve search `input` semantics for Lunr and Google search providers. [#2123](https://github.com/mmistakes/minimal-mistakes/pull/2123) +- Allow adding JavaScript files after those bundled in the theme. [#2110](https://github.com/mmistakes/minimal-mistakes/issues/2110) [#2116](https://github.com/mmistakes/minimal-mistakes/pull/2116) +- Add `$max-width` Sass variable for adjusting page content's maximum width. [#2093](https://github.com/mmistakes/minimal-mistakes/pull/2093) +- Add Thai localized UI text strings. [#2111](https://github.com/mmistakes/minimal-mistakes/pull/2111) +- Update Font Awesome to [v5.8.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.8.1). [#2102](https://github.com/mmistakes/minimal-mistakes/pull/2102) +- Add missing Vietnamese localized UI text strings. [#2097](https://github.com/mmistakes/minimal-mistakes/pull/2097) +- Replace jQuery Smooth Scroll with Smooth Scroll + Gumshoe. [#2082](https://github.com/mmistakes/minimal-mistakes/pull/2082) +- Add styling for [GFM task lists](https://help.github.com/en/articles/about-task-lists#creating-task-lists). [#2092](https://github.com/mmistakes/minimal-mistakes/issues/2092) +- Update Google Universal Analytics to load async. [#2079](https://github.com/mmistakes/minimal-mistakes/pull/2079) +- Remove Google+ social sharing button, comment provider, and author link configs from theme. +- Add missing Chinese text strings. [#2072](https://github.com/mmistakes/minimal-mistakes/pull/2072) + +### Bug Fixes + +- Fix table of contents active link styling. +- Add missing Hindi localized UI text strings. [#2105](https://github.com/mmistakes/minimal-mistakes/pull/2105) [#2106](https://github.com/mmistakes/minimal-mistakes/pull/2106) +- Fix Brazilian Portuguese text strings. [#2098](https://github.com/mmistakes/minimal-mistakes/pull/2098) +- Fix typo in French `results_found` text string. [#2096](https://github.com/mmistakes/minimal-mistakes/pull/2096) +- Fix figures inside of list elements. [#2094](https://github.com/mmistakes/minimal-mistakes/pull/2094) +- Remove Font Awesome `data-search-pseudo-elements` attribute as it degrades smooth scroll performance. [#2075](https://github.com/mmistakes/minimal-mistakes/issues/2075#issuecomment-472437014) +- Fix footnote links incompatibility with smooth scroll plugin. [#2075](https://github.com/mmistakes/minimal-mistakes/issues/2075) +- Loosen Bundler dependency in ruby gem. + +## [4.15.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.2) + +### Enhancements + +- Close search overlay with Esc. [#2055](https://github.com/mmistakes/minimal-mistakes/pull/2055) +- Update Swedish localized UI text strings. [#2056](https://github.com/mmistakes/minimal-mistakes/pull/2056) +- Update Font Awesome to 5.7.1 and add `data-search-pseudo-elements` attribute. [#2053](https://github.com/mmistakes/minimal-mistakes/pull/2053) +- Add Malayalam localized UI text strings. [#2037](https://github.com/mmistakes/minimal-mistakes/pull/2037) + +### Bug Fixes + +- Fix table of contents errors with non-English characters in the headings. [#2042](https://github.com/mmistakes/minimal-mistakes/pull/2042) +- Fix `site.logo` false positives. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026#issuecomment-455770730) +- Add empty `alt` attribute to `site.logo` image. [#2035](https://github.com/mmistakes/minimal-mistakes/pull/2035) + +## [4.15.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.1) + +### Bug Fixes + +- Fix empty `` when `site_logo` is not assigned. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026#issuecomment-454809876) + +## [4.15.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.0) + +### Enhancements + +- Add logo and title customization to the masthead. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026) +- Add support to customize `issue-term` for utterances comment provider. [#2022](https://github.com/mmistakes/minimal-mistakes/pull/2022) +- Allow custom canonical url on a page-by-page basis. [#2021](https://github.com/mmistakes/minimal-mistakes/pull/2021) +- Update table of contents navigation based on scroll position to indicate which link is currently active in the viewport. [#2020](https://github.com/mmistakes/minimal-mistakes/pull/2020) +- Clicking table of contents links changes URL has fragment. [#2019](https://github.com/mmistakes/minimal-mistakes/pull/2019) [#2023](https://github.com/mmistakes/minimal-mistakes/pull/2023) + +## [4.14.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.2) + +### Enhancements + +- Improve accessibility by adding label text to search button toggle. [#2014](https://github.com/mmistakes/minimal-mistakes/pull/2014) +- Update Lunr to 2.3.5. [#2010](https://github.com/mmistakes/minimal-mistakes/pull/2010) +- Shorten Internet Explorer conditional statement in `_includes/head.html`. [#2006](https://github.com/mmistakes/minimal-mistakes/pull/2006) +- Add Persian localized UI text strings. [#2004](https://github.com/mmistakes/minimal-mistakes/pull/2004) +- Remove unused JavaScript variables from Staticman comment script. [#1996](https://github.com/mmistakes/minimal-mistakes/pull/1996) +- Update Font Awesome to 5.6.0. [#1995](https://github.com/mmistakes/minimal-mistakes/pull/1995) +- Change remaining schema.org markup to `https`. [#1978](https://github.com/mmistakes/minimal-mistakes/pull/1978) +- Update NPM dependencies. + +### Bug Fixes + +- Fix wide tables that overflow parent container. [#2008](https://github.com/mmistakes/minimal-mistakes/issues/2008) +- Fix Spanish `comments_label` and `comments_title` UI text strings. [#1997](https://github.com/mmistakes/minimal-mistakes/pull/1997) +- Allow sidebar navigation with custom sidebar content. [#1986](https://github.com/mmistakes/minimal-mistakes/issues/1986) +- Fix Google Custom Search JavaScript error when not using Instant Search. [#1983](https://github.com/mmistakes/minimal-mistakes/pull/1983) + +## [4.14.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.1) + +### Bug Fixes + +- Fix closed navicon on hover. + +## [4.14.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.0) + +### Enhancements + +- Change schema.org markup to `https`. [#1969](https://github.com/mmistakes/minimal-mistakes/pull/1969) +- Add Google Drive as video provider. [#1967](https://github.com/mmistakes/minimal-mistakes/pull/1967) +- Match `:focus` color to skin. +- Add support for [utterances](https://utteranc.es/) comments. [#1909](https://github.com/mmistakes/minimal-mistakes/issues/1909) +- Use privacy aware embed options for YouTube and Vimeo in [responsive video helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#responsive-video-embed). [#1964](https://github.com/mmistakes/minimal-mistakes/pull/1964) +- Add `rel="nofollow noopener noreferrer"` to author profile links. [#1924](https://github.com/mmistakes/minimal-mistakes/pull/1924) +- Improve color contrast of primary buttons and links. +- Add Punjabi localized UI text strings. [#1962](https://github.com/mmistakes/minimal-mistakes/pull/1962) +- Add Hindi localized UI text strings. [#1888](https://github.com/mmistakes/minimal-mistakes/pull/1888) +- Update Lunr to `2.3.3`. [#1885](https://github.com/mmistakes/minimal-mistakes/pull/1885) +- Cache "static" includes to improve build performance. **Note:** The theme uses the [jekyll-include-cache](https://github.com/benbalter/jekyll-include-cache) plugin which will need 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. [#1874](https://github.com/mmistakes/minimal-mistakes/pull/1874) +- Make entire feature and archive items "clickable". [#1864](https://github.com/mmistakes/minimal-mistakes/pull/1864) +- Allow custom Staticman endpoints. [#1842](https://github.com/mmistakes/minimal-mistakes/issues/1842) +- Remove `type="text/css"` from Algolia script includes. [#1836](https://github.com/mmistakes/minimal-mistakes/pull/1836) +- Remove unneeded `HandheldFriendly` and `MobileOptimized` meta tags. [#1837](https://github.com/mmistakes/minimal-mistakes/pull/1837) +- Update Font Awesome to version `5.5.0` and add `integrity` hash. [#1922](https://github.com/mmistakes/minimal-mistakes/pull/1922) +- Always load Google 404 Linkhelp script over HTTPS. [#1829](https://github.com/mmistakes/minimal-mistakes/pull/1829) +- Remove deprecated `base_path` include helper. + +### Bug Fixes + +- Prevent current post from showing in the related posts section. [#1976](https://github.com/mmistakes/minimal-mistakes/pull/1976) +- Fix dark skins syntax highlighting colors. [#1973](https://github.com/mmistakes/minimal-mistakes/issues/1973) +- Remove unnecessary closing bracket in analytics documentation. [#1915](https://github.com/mmistakes/minimal-mistakes/pull/1915) +- Fix breadcrumb navigation alignment. [#1917](https://github.com/mmistakes/minimal-mistakes/issues/1917) +- Fix Algolia search link positioning. [#1904](https://github.com/mmistakes/minimal-mistakes/pull/1904) +- Fix Lunr search index merging words. [#1883](https://github.com/mmistakes/minimal-mistakes/issues/1883) +- Properly apply `relative_url` filter to internal links in header overlay `actions` array. +- Revert cached includes (`include_cached`) for comment and analytics providers. [#1905](https://github.com/mmistakes/minimal-mistakes/issues/1905) + +## [4.13.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.13.0) + +### Enhancements + +- Add Romanian localized UI text strings. [#1814](https://github.com/mmistakes/minimal-mistakes/pull/1814) +- Improve author link flexibility. [#1581](https://github.com/mmistakes/minimal-mistakes/issues/1581) +- Improve footer link flexibility. +- Deprecate `cta_label` and `cta_url` in header overlay in favor of new `actions` array that allows for multiple "call to action" button links. [#1461](https://github.com/mmistakes/minimal-mistakes/issues/1461) +- Add support to [gallery helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery) for defining column layout (`half`, `third`, or single `''`). [#1821](https://github.com/mmistakes/minimal-mistakes/issues/1821) + +### Bug Fixes + +- Fix sidebar navigation list toggle. [#1819](https://github.com/mmistakes/minimal-mistakes/issues/1819) +- Fix hover animation for links with `:visited` state. [#1820](https://github.com/mmistakes/minimal-mistakes/issues/1820) + +## [4.12.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.2) + +### Enhancements + +- Add missing Italian localized UI text strings. [#1793](https://github.com/mmistakes/minimal-mistakes/pull/1793) +- Update [jekyll-toc](https://github.com/allejo/jekyll-toc) to `v1.0.5`. +- Support heading levels 1-6 in table of contents with proper indentation styling. [#1782](https://github.com/mmistakes/minimal-mistakes/issues/1782) +- Use relative links for masthead navigation menu items when possible. [#1784](https://github.com/mmistakes/minimal-mistakes/pull/1784) +- Add `.emoji` class to author sidebar to normalize image sizes. [#1780](https://github.com/mmistakes/minimal-mistakes/pull/1780) +- Update Staticman commit message to include comment author's name. +- Improve side navigation spacing in relation to masthead. +- Style archive links with appropriate link color. +- Adjust feature row spacing and font-sizes. +- Use sentence case and increase font-sizes for improved readability in table of contents. +- Add `{{ content }}` to `home` layout. [#1775](https://github.com/mmistakes/minimal-mistakes/pull/1775) + +## [4.12.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.1) + +### Enhancements + +- Add missing French localized UI text strings. [#1769](https://github.com/mmistakes/minimal-mistakes/pull/1769) [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741) +- Update Font Awesome to version [`5.2.0`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md). [#1754](https://github.com/mmistakes/minimal-mistakes/pull/1754) +- Add documentation note to update root `Gemfile` when forking theme. + +### Bug Fixes + +- Remove slash at the beginning of `path` in staticman.yml example. [#1772](https://github.com/mmistakes/minimal-mistakes/pull/1772) +- Fix `read_time` logic in header image overlay. [#1756](https://github.com/mmistakes/minimal-mistakes/pull/1756) + +## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0) + +### Enhancements + +- Add Hungarian localized UI text strings. [#1682](https://github.com/mmistakes/minimal-mistakes/pull/1682) +- DRY `tags_max` calculation in tags.html layout. [#1696](https://github.com/mmistakes/minimal-mistakes/pull/1696) +- DRY `categories_max` calculation in categories.html layout. +- Add support for ["sticking" table of contents](https://mmistakes.github.io/minimal-mistakes/layout-table-of-contents-sticky/) to top of page via `toc_sticky: true` YAML Front Matter. +- Add support for captioning images in feature row helper via `image_caption` YAML Front Matter. [#1440](https://github.com/mmistakes/minimal-mistakes/issues/1440) +- Add [Google Custom Search Engine](https://cse.google.com/cse) support. [#1652](https://github.com/mmistakes/minimal-mistakes/issues/1652) +- Update Font Awesome to version. [`5.1.13`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md) +- Add "Pets" sample archive page to documentation site. [#1664](https://github.com/mmistakes/minimal-mistakes/pull/1664) +- Add GitLab social icon brand color. [#1653](https://github.com/mmistakes/minimal-mistakes/issues/1653) +- Prevent line breaks between FontAwesome icon and text in footer social links. [#1659](https://github.com/mmistakes/minimal-mistakes/issues/1659) + +### Bug Fixes + +- Set default `title_separator`. [#1701](https://github.com/mmistakes/minimal-mistakes/pull/1701) +- Fix `naver_site_verification` typo in /\_includes/seo.html. [#1687](https://github.com/mmistakes/minimal-mistakes/pull/1687) +- Fix table of contents missing borders. [#1675](https://github.com/mmistakes/minimal-mistakes/issues/1675) +- Fix link to "Recipes" sample archive on documentation site. [#1664](https://github.com/mmistakes/minimal-mistakes/pull/1664) +- Update example Reddit social share interpolation syntax in documentation. [#1656](https://github.com/mmistakes/minimal-mistakes/issues/1656) +- Fix "Back to Top" links on pages that use [header overlays](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#header-overlay). + +## [4.11.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.11.2) + +### Enhancements + +- Update Font Awesome to version `5.0.11`. [#1620](https://github.com/mmistakes/minimal-mistakes/pull/1620) +- Add Slovak localized UI text strings. [#1613](https://github.com/mmistakes/minimal-mistakes/pull/1613) +- Add option to anonymize IP addresses of hits sent to Google Analytics. [#1636](https://github.com/mmistakes/minimal-mistakes/pull/1636) + +### Bug Fixes + +- Use correct text string for "Back to Top" link. [#1595](https://github.com/mmistakes/minimal-mistakes/issues/1595) +- Add conditionals for showing `reCaptcha.siteKey` and `reCaptcha.secret` in Staticman comments form. + +## [4.11.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.11.1) + +### Enhancements + +- Add default `theme` and `remote_theme` values to `_config.yml`. +- Add new layouts (`posts`, `categories`, `tags`, `collection`, `category`, and `tag`) for easier archive page creation. + +### Bug Fixes + +- Replace `absolute_url` filter with `relative_url` where it makes sense (asset/navigation related paths). [#1588](https://github.com/mmistakes/minimal-mistakes/issues/1588) +- Fix search excerpts that run together because of implied spaces. + +## [4.10.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.10.1) + +### Enhancements + +- Update jQuery to version `3.3.1`. [#1491](https://github.com/mmistakes/minimal-mistakes/issues/1491) +- Add link to jekyll-algolia's `files_to_exclude` documentation. +- Update Font Awesome to version [`5.0.8`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md). [#1561](https://github.com/mmistakes/minimal-mistakes/pull/1561) +- Activate Algolia search for documentation site. [#1570](https://github.com/mmistakes/minimal-mistakes/issues/1570) +- Add missing German translations. [#1577](https://github.com/mmistakes/minimal-mistakes/pull/1577) +- Add support for Google Analytics with global site tag (gtag.js) [#1563](https://github.com/mmistakes/minimal-mistakes/pull/1563) ### Bug Fixes -* Focus Algolia search input after clicking on search toggle. +- Focus Algolia search input after clicking on search toggle. ## [4.10.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.10.0) ### Enhancements -* Add support for [Algolia](https://www.algolia.com/) search provider ([see demo](https://mmistakes.github.io/minimal-mistakes-algolia-search/)). [#1416](https://github.com/mmistakes/minimal-mistakes/issues/1416) +- Add support for [Algolia](https://www.algolia.com/) search provider ([see demo](https://mmistakes.github.io/minimal-mistakes-algolia-search/)). [#1416](https://github.com/mmistakes/minimal-mistakes/issues/1416) ## [4.9.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.9.1) ### Enhancements -* Simplify year archive Liquid. -* Add documentation on how to downgrade theme. -* Improve greedy navigation's layout when JavaScript is disabled. -* Improve SEO include by grouping similar tags, reducing white-space, and adding `article:modified_time`. [#1456](https://github.com/mmistakes/minimal-mistakes/pull/1456) -* Minify `assets/js/lunr/lunr.js`. -* Improve calculation of Greedy navigation's `availableSpace`. -* Add Danish and Russian translations for new search strings. [#1472](https://github.com/mmistakes/minimal-mistakes/pull/1472) [#1477](https://github.com/mmistakes/minimal-mistakes/pull/1477) -* Indicate that archive titles are links with an underline. -* Remove `base_path` include from `/test` pages. -* Reduce font-size of page meta in list/grid items. -* Improve feature row styling when used with `archive` layout. [#1484](https://github.com/mmistakes/minimal-mistakes/issues/1484) -* Improve German translations. [#1511](https://github.com/mmistakes/minimal-mistakes/pull/1511) -* Update Font Awesome to `5.0.6`. [#1513](https://github.com/mmistakes/minimal-mistakes/pull/1513) -* Add `wide` variant to single layout. [#1516](https://github.com/mmistakes/minimal-mistakes/pull/1516) +- Simplify year archive Liquid. +- Add documentation on how to downgrade theme. +- Improve greedy navigation's layout when JavaScript is disabled. +- Improve SEO include by grouping similar tags, reducing white-space, and adding `article:modified_time`. [#1456](https://github.com/mmistakes/minimal-mistakes/pull/1456) +- Minify `assets/js/lunr/lunr.js`. +- Improve calculation of Greedy navigation's `availableSpace`. +- Add Danish and Russian translations for new search strings. [#1472](https://github.com/mmistakes/minimal-mistakes/pull/1472) [#1477](https://github.com/mmistakes/minimal-mistakes/pull/1477) +- Indicate that archive titles are links with an underline. +- Remove `base_path` include from `/test` pages. +- Reduce font-size of page meta in list/grid items. +- Improve feature row styling when used with `archive` layout. [#1484](https://github.com/mmistakes/minimal-mistakes/issues/1484) +- Improve German translations. [#1511](https://github.com/mmistakes/minimal-mistakes/pull/1511) +- Update Font Awesome to `5.0.6`. [#1513](https://github.com/mmistakes/minimal-mistakes/pull/1513) +- Add `wide` variant to single layout. [#1516](https://github.com/mmistakes/minimal-mistakes/pull/1516) ### Bug Fixes -* Allow `author` to accept an object or string. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289) -* Fix syntax highlighting line number styling inconsistency. [#1467](https://github.com/mmistakes/minimal-mistakes/issues/1467) -* Fix author sidebar icon colors for dark skins. [#1482](https://github.com/mmistakes/minimal-mistakes/issues/1482) -* Remove misleading underline hover state on feature row items. -* Properly escape quotes in `site.social.name` and `site.name`. [#1485](https://github.com/mmistakes/minimal-mistakes/pull/1485) -* Fix typo in upgrading documentation. [#1487](https://github.com/mmistakes/minimal-mistakes/pull/1487) -* Fix `border-bottom` for Gist line numbers. -* Replace `|` with HTML entity when used as title separator. [#760](https://github.com/mmistakes/minimal-mistakes/issues/760) +- Allow `author` to accept an object or string. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289) +- Fix syntax highlighting line number styling inconsistency. [#1467](https://github.com/mmistakes/minimal-mistakes/issues/1467) +- Fix author sidebar icon colors for dark skins. [#1482](https://github.com/mmistakes/minimal-mistakes/issues/1482) +- Remove misleading underline hover state on feature row items. +- Properly escape quotes in `site.social.name` and `site.name`. [#1485](https://github.com/mmistakes/minimal-mistakes/pull/1485) +- Fix typo in upgrading documentation. [#1487](https://github.com/mmistakes/minimal-mistakes/pull/1487) +- Fix `border-bottom` for Gist line numbers. +- Replace `|` with HTML entity when used as title separator. [#760](https://github.com/mmistakes/minimal-mistakes/issues/760) ## [4.9.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.9.0) ### Enhancements -* Add `show_overlay_excerpt` for disabling overlay image excerpt text. [#1436](https://github.com/mmistakes/minimal-mistakes/pull/1436) -* Update remote theme installation instructions in Quick Start Guide. [#1439](https://github.com/mmistakes/minimal-mistakes/pull/1439) -* Reduce visual weight of code blocks. -* Add Lunr.js Greek stemmer. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445) -* Update Font Awesome 5 [SVG with JavaScript version](https://fontawesome.com/how-to-use/svg-with-js). [#1446](https://github.com/mmistakes/minimal-mistakes/pull/1446) - * Note: if Font Awesome icons were used in the content of posts/pages or custom table of contents, find and replace any icons that have different names between version 4 and 5. Make sure to read the [complete list](https://fontawesome.com/how-to-use/upgrading-from-4#icon-name-changes-full) on Font Awesome's site. -* Reduce size of Lunr.js search JSON data and introduce `site.search_full_content` flag for limiting size of JSON file. [#1449](https://github.com/mmistakes/minimal-mistakes/pull/1449) -* Improve syntax highlighting styles. [#1450](https://github.com/mmistakes/minimal-mistakes/pull/1450) +- Add `show_overlay_excerpt` for disabling overlay image excerpt text. [#1436](https://github.com/mmistakes/minimal-mistakes/pull/1436) +- Update remote theme installation instructions in Quick Start Guide. [#1439](https://github.com/mmistakes/minimal-mistakes/pull/1439) +- Reduce visual weight of code blocks. +- Add Lunr.js Greek stemmer. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445) +- Update Font Awesome 5 [SVG with JavaScript version](https://fontawesome.com/how-to-use/svg-with-js). [#1446](https://github.com/mmistakes/minimal-mistakes/pull/1446) + - Note: if Font Awesome icons were used in the content of posts/pages or custom table of contents, find and replace any icons that have different names between version 4 and 5. Make sure to read the [complete list](https://fontawesome.com/how-to-use/upgrading-from-4#icon-name-changes-full) on Font Awesome's site. +- Reduce size of Lunr.js search JSON data and introduce `site.search_full_content` flag for limiting size of JSON file. [#1449](https://github.com/mmistakes/minimal-mistakes/pull/1449) +- Improve syntax highlighting styles. [#1450](https://github.com/mmistakes/minimal-mistakes/pull/1450) ### Bug Fixes -* Fix code block extra white-space when using [Jekyll's highlight tag](https://jekyllrb.com/docs/templates/#code-snippet-highlighting) with `linenos`. [#1437](https://github.com/mmistakes/minimal-mistakes/issues/1437) -* Round top-right corner of code block icon. -* Remove Lunr.js trimmer and bring back colons. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445) -* Fix sticky `.sidebar` that overlaps main content when resizing viewport. [#1447](https://github.com/mmistakes/minimal-mistakes/issues/1447) +- Fix code block extra white-space when using [Jekyll's highlight tag](https://jekyllrb.com/docs/templates/#code-snippet-highlighting) with `linenos`. [#1437](https://github.com/mmistakes/minimal-mistakes/issues/1437) +- Round top-right corner of code block icon. +- Remove Lunr.js trimmer and bring back colons. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445) +- Fix sticky `.sidebar` that overlaps main content when resizing viewport. [#1447](https://github.com/mmistakes/minimal-mistakes/issues/1447) ## [4.8.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.8.1) ### Enhancements -* Add linkback functionality to author avatar and name in sidebar via `author.home`. [#1386](https://github.com/mmistakes/minimal-mistakes/pull/1386) -* Add Japanese localized UI text strings. [#1411](https://github.com/mmistakes/minimal-mistakes/pull/1411) -* Update Lunr.js to 2.1.5 [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419) +- Add linkback functionality to author avatar and name in sidebar via `author.home`. [#1386](https://github.com/mmistakes/minimal-mistakes/pull/1386) +- Add Japanese localized UI text strings. [#1411](https://github.com/mmistakes/minimal-mistakes/pull/1411) +- Update Lunr.js to 2.1.5 [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419) ### Bug Fixes -* Fixed broken link to Staticman's page [#1422](https://github.com/mmistakes/minimal-mistakes/pull/1422) -* Fix Lunr search to work with number tags. [#1409](https://github.com/mmistakes/minimal-mistakes/issues/1409) [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419) +- Fixed broken link to Staticman's page [#1422](https://github.com/mmistakes/minimal-mistakes/pull/1422) +- Fix Lunr search to work with number tags. [#1409](https://github.com/mmistakes/minimal-mistakes/issues/1409) [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419) ## [4.8.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.8.0) ### Enhancements -* Open social share links in a new window. [#1357](https://github.com/mmistakes/minimal-mistakes/pull/1357) -* Remove Alexa.com verification due to retiring of "[Claim Your Site](https://support.alexa.com/hc/en-us/articles/219135887)" feature. [#1350](https://github.com/mmistakes/minimal-mistakes/issues/1350) -* Disable analytics in `development` environment. [#1362](https://github.com/mmistakes/minimal-mistakes/pull/1362) -* Disable comments in `development` environment. [#1363](https://github.com/mmistakes/minimal-mistakes/pull/1363) -* Exclude specific pages/posts from search index by adding `search: false` to the YAML Front Matter. [#1369](https://github.com/mmistakes/minimal-mistakes/pull/1369) -* Add optional `description` key to masthead links for clarifying their purpose with the `title` attribute. [#1380](https://github.com/mmistakes/minimal-mistakes/pull/1380) -* Incorporate site search into masthead. [#1383](https://github.com/mmistakes/minimal-mistakes/pull/1383) -* Update gem dependencies. [#1388](https://github.com/mmistakes/minimal-mistakes/pull/1388) +- Open social share links in a new window. [#1357](https://github.com/mmistakes/minimal-mistakes/pull/1357) +- Remove Alexa.com verification due to retiring of "[Claim Your Site](https://support.alexa.com/hc/en-us/articles/219135887)" feature. [#1350](https://github.com/mmistakes/minimal-mistakes/issues/1350) +- Disable analytics in `development` environment. [#1362](https://github.com/mmistakes/minimal-mistakes/pull/1362) +- Disable comments in `development` environment. [#1363](https://github.com/mmistakes/minimal-mistakes/pull/1363) +- Exclude specific pages/posts from search index by adding `search: false` to the YAML Front Matter. [#1369](https://github.com/mmistakes/minimal-mistakes/pull/1369) +- Add optional `description` key to masthead links for clarifying their purpose with the `title` attribute. [#1380](https://github.com/mmistakes/minimal-mistakes/pull/1380) +- Incorporate site search into masthead. [#1383](https://github.com/mmistakes/minimal-mistakes/pull/1383) +- Update gem dependencies. [#1388](https://github.com/mmistakes/minimal-mistakes/pull/1388) ### Bug Fixes -* Fix `post.content` typo in `assets/js/lunr-en.js`. [#1354](https://github.com/mmistakes/minimal-mistakes/pull/1354) -* Fix "lunr-en.js:1 Uncaught SyntaxError: Unexpected token <" in `assets/js/lunr-en.js`. [#1356](https://github.com/mmistakes/minimal-mistakes/pull/1356) -* Rename Naver verification `naver_site_verification` to be consistent with other site variables. -* Fix button class in "Post with Table Of Contents" demo content. [#1368](https://github.com/mmistakes/minimal-mistakes/pull/1368) -* Fix capitalization of WordPress in documentation. [#1381](https://github.com/mmistakes/minimal-mistakes/pull/1381) -* Fix zh-HK UI text to point to Traditional Chinese. [#1374](https://github.com/mmistakes/minimal-mistakes/issues/1374) [#1389](https://github.com/mmistakes/minimal-mistakes/pull/1389) +- Fix `post.content` typo in `assets/js/lunr-en.js`. [#1354](https://github.com/mmistakes/minimal-mistakes/pull/1354) +- Fix "lunr-en.js:1 Uncaught SyntaxError: Unexpected token <" in `assets/js/lunr-en.js`. [#1356](https://github.com/mmistakes/minimal-mistakes/pull/1356) +- Rename Naver verification `naver_site_verification` to be consistent with other site variables. +- Fix button class in "Post with Table Of Contents" demo content. [#1368](https://github.com/mmistakes/minimal-mistakes/pull/1368) +- Fix capitalization of WordPress in documentation. [#1381](https://github.com/mmistakes/minimal-mistakes/pull/1381) +- Fix zh-HK UI text to point to Traditional Chinese. [#1374](https://github.com/mmistakes/minimal-mistakes/issues/1374) [#1389](https://github.com/mmistakes/minimal-mistakes/pull/1389) ## [4.7.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.7.1) ### Enhancements -* Add search layout powered by [Lunr](https://lunrjs.com/). [#1353](https://github.com/mmistakes/minimal-mistakes/pull/1353) -* Use [jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) for demo site. [#1339](https://github.com/mmistakes/minimal-mistakes/issues/1339) -* Add note about WordPress to Staticman comment migration tool in documentation. [#1346](https://github.com/mmistakes/minimal-mistakes/issues/1346) +- Add search layout powered by [Lunr](https://lunrjs.com/). [#1353](https://github.com/mmistakes/minimal-mistakes/pull/1353) +- Use [jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) for demo site. [#1339](https://github.com/mmistakes/minimal-mistakes/issues/1339) +- Add note about WordPress to Staticman comment migration tool in documentation. [#1346](https://github.com/mmistakes/minimal-mistakes/issues/1346) ### Bug Fixes -* Change `http` to `https` for Jekyll and Browserhappy links. [#1342](https://github.com/mmistakes/minimal-mistakes/pull/1342) [#1343](https://github.com/mmistakes/minimal-mistakes/pull/1343) -* Change `http` author profile links to `https` when supported. [#1349](https://github.com/mmistakes/minimal-mistakes/pull/1349) -* Fix broken SCSS partial links in layouts documentation. [#1351](https://github.com/mmistakes/minimal-mistakes/issues/1351) +- Change `http` to `https` for Jekyll and Browserhappy links. [#1342](https://github.com/mmistakes/minimal-mistakes/pull/1342) [#1343](https://github.com/mmistakes/minimal-mistakes/pull/1343) +- Change `http` author profile links to `https` when supported. [#1349](https://github.com/mmistakes/minimal-mistakes/pull/1349) +- Fix broken SCSS partial links in layouts documentation. [#1351](https://github.com/mmistakes/minimal-mistakes/issues/1351) ## [4.7.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.7.0) ### Enhancements -* Add `alt` description to avatar image. [#1226](https://github.com/mmistakes/minimal-mistakes/pull/1226) -* Clarify documentation about which `assets` folders and files to remove when migrating to the gem version of the theme. [#1268](https://github.com/mmistakes/minimal-mistakes/issues/1268) -* Add note about Staticman GitHub compatibility. [#1273](https://github.com/mmistakes/minimal-mistakes/issues/1273) -* Add missing Brazilian Portuguese translations to `ui-text.yml`. [#1278](https://github.com/mmistakes/minimal-mistakes/pull/1278) -* Update font stack documentation. [#1292](https://github.com/mmistakes/minimal-mistakes/pull/1292) -* Improve accessibility of navigation menu button. [#1099](https://github.com/mmistakes/minimal-mistakes/issues/1099) -* Add Naver Webmaster Tools verification. [#1286](https://github.com/mmistakes/minimal-mistakes/pull/1286) -* Add support for Staticman v2 endpoint and reCAPTCHA. -* Add Polish localized UI text strings. [#1304](https://github.com/mmistakes/minimal-mistakes/pull/1304) -* Add toggleable table of contents via YAML Front Matter. Note: `toc` helper include will be deprecated in next major version. [#1222](https://github.com/mmistakes/minimal-mistakes/issues/1222) -* Refactor seo.html include to DRY-up page image handling. -* Add support for setting what image is used by OpenGraph and Twitter via `page.header.og_image`. [#1316](https://github.com/mmistakes/minimal-mistakes/issues/1316) -* Fix the spelling of some product names in the author profile. [#1328](https://github.com/mmistakes/minimal-mistakes/pull/1328) -* Add `aqua`, `neon`, and `plum` skins. [#1336](https://github.com/mmistakes/minimal-mistakes/pull/1336) -* Update **jekyll-toc** with heading classes fix. [#1337](https://github.com/mmistakes/minimal-mistakes/pull/1337) -* Remove `+` from Google+ author link to allow non-vanity URLs. [#1319](https://github.com/mmistakes/minimal-mistakes/pull/1319) +- Add `alt` description to avatar image. [#1226](https://github.com/mmistakes/minimal-mistakes/pull/1226) +- Clarify documentation about which `assets` folders and files to remove when migrating to the gem version of the theme. [#1268](https://github.com/mmistakes/minimal-mistakes/issues/1268) +- Add note about Staticman GitHub compatibility. [#1273](https://github.com/mmistakes/minimal-mistakes/issues/1273) +- Add missing Brazilian Portuguese translations to `ui-text.yml`. [#1278](https://github.com/mmistakes/minimal-mistakes/pull/1278) +- Update font stack documentation. [#1292](https://github.com/mmistakes/minimal-mistakes/pull/1292) +- Improve accessibility of navigation menu button. [#1099](https://github.com/mmistakes/minimal-mistakes/issues/1099) +- Add Naver Webmaster Tools verification. [#1286](https://github.com/mmistakes/minimal-mistakes/pull/1286) +- Add support for Staticman v2 endpoint and reCAPTCHA. +- Add Polish localized UI text strings. [#1304](https://github.com/mmistakes/minimal-mistakes/pull/1304) +- Add toggleable table of contents via YAML Front Matter. Note: `toc` helper include will be deprecated in next major version. [#1222](https://github.com/mmistakes/minimal-mistakes/issues/1222) +- Refactor seo.html include to DRY-up page image handling. +- Add support for setting what image is used by OpenGraph and Twitter via `page.header.og_image`. [#1316](https://github.com/mmistakes/minimal-mistakes/issues/1316) +- Fix the spelling of some product names in the author profile. [#1328](https://github.com/mmistakes/minimal-mistakes/pull/1328) +- Add `aqua`, `neon`, and `plum` skins. [#1336](https://github.com/mmistakes/minimal-mistakes/pull/1336) +- Update **jekyll-toc** with heading classes fix. [#1337](https://github.com/mmistakes/minimal-mistakes/pull/1337) +- Remove `+` from Google+ author link to allow non-vanity URLs. [#1319](https://github.com/mmistakes/minimal-mistakes/pull/1319) ### Bug Fixes -* Fix system font rendering in Chrome on macOS/OS X. [#1290](https://github.com/mmistakes/minimal-mistakes/pull/1290) -* Fix extra padding in syntax highlighted code blocks due to Rouge 2 adding `
` to markup. +- Fix system font rendering in Chrome on macOS/OS X. [#1290](https://github.com/mmistakes/minimal-mistakes/pull/1290) +- Fix extra padding in syntax highlighted code blocks due to Rouge 2 adding `
` to markup. ## [4.6.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.6.0) ### Enhancements -* Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236) -* Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239) -* Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color. -* DRY up button CSS using Sass lists and YIQ Color Contrast mixin. -* Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `my link`). -* Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208) -* Allow scripts in `` 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) +- Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236) +- Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239) +- Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color. +- DRY up button CSS using Sass lists and YIQ Color Contrast mixin. +- Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `my link`). +- Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208) +- Allow scripts in `` 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) +- 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. +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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`. +- 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) +- 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) +- 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) +- 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) +- 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) +- 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: +- 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: ``` --- @@ -298,593 +1052,593 @@ ### 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) +- 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) +- 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) +- 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/) +- 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) +- 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) +- 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) +- 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). +- 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) +- 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`. +- 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 +- 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) +- 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) +- 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) +- 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) +- 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. +- 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. +- 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) +- 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) +- 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** +- 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 `
` element with a single image and caption easier. [#572](https://github.com/mmistakes/minimal-mistakes/pull/572) -* Add structured data markup for `itemprop="person"` in author profile sidebar. [#647](https://github.com/mmistakes/minimal-mistakes/pull/647) +- Add [`figure` helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#figure) to make generating a `
` element with a single image and caption easier. [#572](https://github.com/mmistakes/minimal-mistakes/pull/572) +- Add structured data markup for `itemprop="person"` in author profile sidebar. [#647](https://github.com/mmistakes/minimal-mistakes/pull/647) ### Bug Fixes -* Fix improper YAML formatting of some locales. [#651](https://github.com/mmistakes/minimal-mistakes/pull/651) +- Fix improper YAML formatting of some locales. [#651](https://github.com/mmistakes/minimal-mistakes/pull/651) ### Maintenance -* Clarify "migrating to gem-theme" instructions in **Quick Start Guide**. -* Add `rake preview` task for testing `/test` during theme development. +- Clarify "migrating to gem-theme" instructions in **Quick Start Guide**. +- Add `rake preview` task for testing `/test` during theme development. ## [4.0.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.5) ### Enhancements -* Update gems: `jekyll-sitemap` (0.12), `jekyll-feed` (0.8). -* Improve next/previous pager links visibility by changing gray color to blue (`$link-color`). +- Update gems: `jekyll-sitemap` (0.12), `jekyll-feed` (0.8). +- Improve next/previous pager links visibility by changing gray color to blue (`$link-color`). ### Bug Fixes -* Fix `.sidebar` flicker/jump when hovered. [#583](https://github.com/mmistakes/minimal-mistakes/issues/583) +- Fix `.sidebar` flicker/jump when hovered. [#583](https://github.com/mmistakes/minimal-mistakes/issues/583) ### Maintenance -* Move contents of `gh-pages` branch to `master` inside of the `/docs` folder. +- Move contents of `gh-pages` branch to `master` inside of the `/docs` folder. ## [4.0.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.4) ### Enhancements -* "Gemify" theme ~> `gem "minimal-mistakes-jekyll"` -* Replace `base_path` include with `absolute_url` filter where possible. -* Allow images to be placed in other folders. Remove `/images/` only restriction and encourage placement in `/assets/images/` instead. **Full paths are now required. If upgrading from MM 3.4 add `/images/` before filenames in Front Matter and `_config.yml` variables.** -* Add [home `layout`](https://github.com/mmistakes/minimal-mistakes/blob/master/_layouts/home.html) -* Added missing Turkish translations for UI text. [#621](https://github.com/mmistakes/minimal-mistakes/pull/621) -* Make author avatar optional in sidebar. -* Update **/\_includes/seo.html** for meta description. [#558](https://github.com/mmistakes/minimal-mistakes/pull/558) +- "Gemify" theme ~> `gem "minimal-mistakes-jekyll"` +- Replace `base_path` include with `relative_url` filter where possible. +- Allow images to be placed in other folders. Remove `/images/` only restriction and encourage placement in `/assets/images/` instead. **Full paths are now required. If upgrading from MM 3.4 add `/images/` before filenames in Front Matter and `_config.yml` variables.** +- Add [home `layout`](https://github.com/mmistakes/minimal-mistakes/blob/master/_layouts/home.html) +- Added missing Turkish translations for UI text. [#621](https://github.com/mmistakes/minimal-mistakes/pull/621) +- Make author avatar optional in sidebar. +- Update **/\_includes/seo.html** for meta description. [#558](https://github.com/mmistakes/minimal-mistakes/pull/558) ### Bug Fixes -* Fix navigation bar animation "flicker" in Safari [#568](https://github.com/mmistakes/minimal-mistakes/issues/568) -* Fix `author.avatar` paths for externally hosted images. +- Fix navigation bar animation "flicker" in Safari [#568](https://github.com/mmistakes/minimal-mistakes/issues/568) +- Fix `author.avatar` paths for externally hosted images. ### Maintenance -* Add documentation around `gem "minimal-mistakes-jekyll"` installation and use. -* Add note about using full image paths for eg. `assets/images/filename.jpg` (header images, overlays, galleries, feature rows, etc.) instead of assuming they will always be in `/images/`. -* Add "[Overriding Theme Defaults](https://mmistakes.github.io/minimal-mistakes/docs/overriding-theme-defaults/)" page to documentation. +- Add documentation around `gem "minimal-mistakes-jekyll"` installation and use. +- Add note about using full image paths for eg. `assets/images/filename.jpg` (header images, overlays, galleries, feature rows, etc.) instead of assuming they will always be in `/images/`. +- Add "[Overriding Theme Defaults](https://mmistakes.github.io/minimal-mistakes/docs/overriding-theme-defaults/)" page to documentation. ## [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) +- 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) +- 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. +- 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 `` 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) +- Add `layout` based and user-defined class names to `` 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) +- 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) +- 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`. +- 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 `{% highlight linenos %}` 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) +- Improve line numbered code block styling when using `{% highlight linenos %}` 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 `{% highlight %}` tag. [#512](https://github.com/mmistakes/minimal-mistakes/issues/512) +- Fix Firefox alignment issues with code blocks generated with the `{% highlight %}` 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 `{% highlight %}` code block examples to demo site. -* Add documentation for using custom sidebar navigation menus. [#476](https://github.com/mmistakes/minimal-mistakes/issues/476) +- 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 `{% highlight %}` 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) +- 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) +- 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). +- 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) +- 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) +- 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. +- 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) +- 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`. +- Add `staticman.filename` configuration with UNIX timestamp for sorting data files. example ~> `comment-1470943149`. ### Bug Fixes -* Don't add `` to author name if URL is blank. +- Don't add `` 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) +- 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) +- 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) +- 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. +- 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) +- 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) +- 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.` +- 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 `` 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) +- Add support for configurable feed URL to use a service like FeedBurner instead of linking directly to `feed.xml` in `` 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). +- 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. +- Make footer stick to the bottom of the page. ### Bug Fixes -* Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402) +- Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402) ### Maintenance -* Set default `lang` to `en`. +- 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) +- 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) +- 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) +- 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) ### Enhancements -* 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`. +- 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) +- 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) +- 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) +- 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 +- 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` +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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) +- 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. +- 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) +- 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) +- 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. +- 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) ### Enhancements -* Add [Discourse](https://www.discourse.org/) as a commenting provider. [#335](https://github.com/mmistakes/minimal-mistakes/pull/335) +- 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) ### Enhancements -* 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) +- 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) +- 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. +- 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) +- 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. `

` element is now conditional if `title:` is not set for a `page` or collection item. [#312](https://github.com/mmistakes/minimal-mistakes/issues/312) +- Fix `Liquid Exception: undefined method 'gsub' for nil:NilClass in _layouts/single.html` error when `page.title` is null. `

` 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) +- 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) +- 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) ### Enhancements -* Add translation key for "Recent Posts" used in home page `index.html`. [#316](https://github.com/mmistakes/minimal-mistakes/pull/316) +- 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) +- 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`. +- 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) +- 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) +- 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) +- 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) +- 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) ### Enhancements -* 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. +- 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. ### Bug Fixes -* Fix alignment issues with related posts [#273](https://github.com/mmistakes/minimal-mistakes/issues/273) and "Follow" button in author profile [#274](https://github.com/mmistakes/minimal-mistakes/issues/274). +- Fix alignment issues with related posts [#273](https://github.com/mmistakes/minimal-mistakes/issues/273) and "Follow" button in author profile [#274](https://github.com/mmistakes/minimal-mistakes/issues/274). ## [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) +- 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`. +- 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. +- 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 ``. -* 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. +- 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 ``. +- 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) @@ -892,64 +1646,64 @@ ### Enhancements -* Add support for Jekyll 3.0 -* Minor updates to syntax highlighting CSS and theme documentation +- 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. +- 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) +- 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) +- 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 +- 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 +- 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)) +- 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 +- 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) @@ -957,24 +1711,24 @@ ### 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 +- 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. +- 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. +- 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) @@ -982,54 +1736,54 @@ ### Bug Fixes -* Table weren't filling the entire width of the content container. They now scale at 100%. Thanks [@dhruvbhatia](https://github.com/dhruvbhatia) +- 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 +- 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. +- 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. +- 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 +- 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. +- 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. +- 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. +- 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) diff --git a/Gemfile b/Gemfile index 1291498971d7..3be9c3cd812e 100644 --- a/Gemfile +++ b/Gemfile @@ -1,2 +1,2 @@ source "https://rubygems.org" -gemspec \ No newline at end of file +gemspec diff --git a/LICENSE b/LICENSE new file mode 100644 index 000000000000..67814e6c3f9e --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2013-2024 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. diff --git a/LICENSE.txt b/LICENSE.txt deleted file mode 100644 index afcb825ce2e9..000000000000 --- a/LICENSE.txt +++ /dev/null @@ -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 . -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). diff --git a/README.md b/README.md index 736a1be9592b..9298269786af 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,14 @@ -# [Minimal Mistakes Jekyll Theme](https://mmistakes.github.io/minimal-mistakes/) +# [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) -[![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) +[![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.7-blue.svg)](https://jekyllrb.com/) -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:. +Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building personal sites, blogs, and portfolios. 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). +**Note:** The theme uses the [jekyll-include-cache](https://github.com/benbalter/jekyll-include-cache) plugin which will need to be installed in your `Gemfile` and must be retained in the `plugins` array of `_config.yml`. Otherwise you'll encounter `Unknown tag 'include_cached'` errors at build. + [![Minimal Mistakes live preview][2]][1] [1]: https://mmistakes.github.io/minimal-mistakes/ @@ -16,36 +16,36 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your ![layout examples](screenshot-layouts.png) -## Notable Features +## Notable features -- Bundled as a "theme gem" for easier install/upgrading. +- Bundled as a "theme gem" for easier installation/upgrading. - 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 +- 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). +- 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](https://staticman.net/), [utterances](https://utteranc.es/), and [giscus](https://giscus.app/)). - [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, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Russian, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese. +- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Bulgarian, Catalan, Chinese, Czech, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), Ukrainian (Українська) and Vietnamese. -## Skins (Color Variations) +## Skins (color variations) -This theme comes in nine different skins (including the default one). +This theme comes in nine different skins (in addition to the default one). | `air` | `contrast` | `dark` | | --- | --- | --- | -| ![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) | +| [![air skin](https://mmistakes.github.io/minimal-mistakes/assets/images/air-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/air-skin-archive-large.png) | [![contrast skin](https://mmistakes.github.io/minimal-mistakes/assets/images/contrast-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/contrast-skin-archive-large.png) | [![dark skin](https://mmistakes.github.io/minimal-mistakes/assets/images/dark-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/dark-skin-archive-large.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) | +| [![dirt skin](https://mmistakes.github.io/minimal-mistakes/assets/images/dirt-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/dirt-skin-archive-large.png) | [![mint skin](https://mmistakes.github.io/minimal-mistakes/assets/images/mint-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/mint-skin-archive-large.png) | [![sunrise skin](https://mmistakes.github.io/minimal-mistakes/assets/images/sunrise-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/sunrise-skin-archive-large.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) | +| [![aqua skin](https://mmistakes.github.io/minimal-mistakes/assets/images/aqua-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/aqua-skin-archive-large.png) | [![neon skin](https://mmistakes.github.io/minimal-mistakes/assets/images/neon-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/neon-skin-archive-large.png) | [![plum skin](https://mmistakes.github.io/minimal-mistakes/assets/images/plum-skin-archive.png)](https://mmistakes.github.io/minimal-mistakes/assets/images/plum-skin-archive-large.png) | -## Demo Pages +## Demo pages | Name | Description | | ------------------------------------------- | ----------------------------------------------------- | @@ -70,11 +70,15 @@ Additional sample posts are available under [posts archive][year-archive] on the ## 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. +There are three ways to install: as a [gem-based theme](https://jekyllrb.com/docs/themes/#understanding-gem-based-themes), as a [remote theme](https://blog.github.com/2017-11-29-use-any-theme-with-github-pages/) (GitHub Pages compatible), or forking/directly copying all of the theme files into your project. + +### Gem-based method + +With Gem-based themes, directories such as the `assets`, `_layouts`, `_includes`, and `_sass` are stored in the theme’s gem, hidden from your immediate view. Yet all of the necessary directories will be read and processed during Jekyll’s build process. -### Ruby Gem Method +This allows for easier installation and updating as you don't have to manage any of the theme files. To install: -1. Install the theme as a Ruby Gem by adding it to your `Gemfile` like so: +1. Add the following to your `Gemfile`: ```ruby gem "minimal-mistakes-jekyll" @@ -94,7 +98,11 @@ There are three ways to install the theme: as a Ruby gem (for self-hosted sites) To update the theme run `bundle update`. -### GitHub Pages Method +### Remote theme method + +Remote themes are similar to Gem-based themes, but do not require `Gemfile` changes or whitelisting making them ideal for sites hosted with GitHub Pages. + +To install: 1. Create/replace the contents of your `Gemfile` with the following: @@ -102,29 +110,54 @@ To update the theme run `bundle update`. source "https://rubygems.org" gem "github-pages", group: :jekyll_plugins + gem "jekyll-include-cache", group: :jekyll_plugins ``` -2. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command: +2. Add `jekyll-include-cache` to the `plugins` array of your `_config.yml`. + +3. Fetch and update bundled gems by running the following [Bundler](https://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. +4. Add `remote_theme: "mmistakes/minimal-mistakes@4.27.3"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry. + + + +**Looking for an example?** Use the [Minimal Mistakes remote theme starter](https://github.com/mmistakes/mm-github-pages-starter/generate) for the quickest method of getting a GitHub Pages hosted site up and running. Generate a new repository from the starter, replace sample content with your own, and configure as needed. ## 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 -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. - -Minimal Mistakes has been designed as a base for you to customize and fit your site's unique needs. Please keep this in mind when requesting features and/or submitting pull requests. If it's not something that most people will use, I probably won't consider it. When in doubt ask. +Found a typo in the documentation or interested in [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. -This goes for author sidebar links and "share button" additions -- I have no intention of merging in every possibly option, the essentials are there to get you started :smile:. +For help with using the theme or general Jekyll support questions, please use the [Jekyll Talk forums](https://talk.jekyllrb.com/). ### Pull Requests @@ -142,8 +175,6 @@ 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. ---- - ## Credits ### Creator @@ -156,7 +187,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) +- [The Noun Project](https://thenounproject.com) - Garrett Knoll, Arthur Shlain, and [tracy tam](https://thenounproject.com/tracytam) - [Font Awesome](http://fontawesome.io/) - [Unsplash](https://unsplash.com/) @@ -169,16 +200,17 @@ To test the theme, run `bundle exec rake preview` and open your browser at `http - [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/) - [FitVids.JS](http://fitvidsjs.com/) - [GreedyNav.js](https://github.com/lukejacksonn/GreedyNav) -- [jQuery Smooth Scroll](https://github.com/kswedberg/jquery-smooth-scroll) +- [Smooth Scroll](https://github.com/cferdinandi/smooth-scroll) +- [Gumshoe](https://github.com/cferdinandi/gumshoe) +- [jQuery throttle / debounce](http://benalman.com/projects/jquery-throttle-debounce-plugin/) - [Lunr](http://lunrjs.com) - ---- +- [Clipboard.js](https://clipboardjs.com) ## License The MIT License (MIT) -Copyright (c) 2013-2018 Michael Rose and contributors +Copyright (c) 2013-2024 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 @@ -218,15 +250,23 @@ Breakpoint is distributed under the terms of the [MIT/GPL Licenses](http://opens 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/). +FitVids is distributed under the terms of the [WTFPL License](http://www.wtfpl.net/). 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 [Smooth Scroll](http://github.com/cferdinandi/smooth-scroll), +Copyright (c) 2019 Chris Ferdinandi. +Smooth Scroll is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT). + +Minimal Mistakes incorporates [Gumshoejs](http://github.com/cferdinandi/gumshoe), +Copyright (c) 2019 Chris Ferdinandi. +Gumshoejs is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT). + +Minimal Mistakes incorporates [jQuery throttle / debounce](http://benalman.com/projects/jquery-throttle-debounce-plugin/), +Copyright (c) 2010 "Cowboy" Ben Alman. +jQuery throttle / debounce 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. @@ -241,5 +281,9 @@ 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. +Copyright (c) 2018 Oliver Nightingale. Lunr is distributed under the terms of the [MIT License](http://opensource.org/licenses/MIT). + +Minimal Mistakes incorporates [clipboard.js](https://clipboardjs.com/), +Copyright (c) 2021 Zeno Rocha. +Clipboard.js is distributed under the terms of the [MIT License](https://opensource.org/licenses/MIT). diff --git a/Rakefile b/Rakefile index 921330e6ab79..2c5f027bd669 100644 --- a/Rakefile +++ b/Rakefile @@ -1,6 +1,15 @@ require "bundler/gem_tasks" require "jekyll" +require "json" require "listen" +require "rake/clean" +require "shellwords" +require "time" +require "yaml" + +task :default => %i[copyright changelog js version] + +package_json = JSON.parse(File.read("package.json")) def listen_ignore_paths(base, options) [ @@ -65,8 +74,7 @@ task :preview do puts " Halting auto-regeneration." exit 0 end - - loop { sleep 1000 } + sleep end rescue ThreadError # You pressed Ctrl-C, oh my! @@ -74,3 +82,130 @@ task :preview do Jekyll::Commands::Serve.process(options) end + +task :history => :changelog +task :changelog => "docs/_docs/18-history.md" +file "docs/_docs/18-history.md" => "CHANGELOG.md" do |t| + front_matter = { + title: "History", + classes: "wide", + permalink: "/docs/history/", + excerpt: "Change log of enhancements and bug fixes made to the theme.", + sidebar: { + nav: "docs", + }, + last_modified_at: Time.now.iso8601, + toc: false, + } + # https://stackoverflow.com/a/49553523/5958455 + front_matter = JSON.parse(JSON.dump(front_matter)) + File.open(t.name, "w") do |f| + f.puts front_matter.to_yaml + f.puts "---" + f.puts "" + f.puts "" + f.puts "" + f.puts "{% raw %}" + # Remove H1 + changelog = File.read(t.prerequisites.first) + .gsub(/^# [^\n]*$/m, "") + .gsub(/\(#(\d+)\)$/m, "[#\\1](https://github.com/mmistakes/minimal-mistakes/issues/\\1)") + .strip + f.write changelog + f.puts "" + f.puts "{% endraw %}" + end +end + +COPYRIGHT_LINES = [ + "Minimal Mistakes Jekyll Theme #{package_json["version"]} by Michael Rose", + "Copyright 2013-#{Time.now.year} Michael Rose - mademistakes.com | @mmistakes", + "Free for personal and commercial use under the MIT license", + "https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE", +] + +COPYRIGHT_FILES = [ + "_includes/copyright.html", + "_includes/copyright.js", + "_sass/minimal-mistakes/_copyright.scss", +] + +def genenerate_copyright_file(filename, header, prefix, footer) + File.open(filename, "w") do |f| + f.puts header + COPYRIGHT_LINES.each do |line| + f.puts "#{prefix}#{line}" + end + f.puts footer + end +end + +file "_includes/copyright.html" => "package.json" do |t| + genenerate_copyright_file(t.name, "") +end + +file "_includes/copyright.js" => "package.json" do |t| + genenerate_copyright_file(t.name, "/*!", " * ", " */") +end + +file "_sass/minimal-mistakes/_copyright.scss" => "package.json" do |t| + genenerate_copyright_file(t.name, "/*!", " * ", " */") +end + +task :copyright => COPYRIGHT_FILES + +CLEAN.include(*COPYRIGHT_FILES) + +JS_FILES = ["assets/js/vendor/jquery/jquery-3.6.0.js"] + Dir.glob("assets/js/plugins/*.js") + ["assets/js/_main.js"] +JS_TARGET = "assets/js/main.min.js" +task :js => JS_TARGET +file JS_TARGET => ["_includes/copyright.js"] + JS_FILES do |t| + sh Shellwords.join(%w[npx uglifyjs -c --comments /@mmistakes/ --source-map -m -o] + + [t.name] + t.prerequisites) +end + +task :watch_js do + listener = Listen.to( + "assets/js", + ignore: /main\.min\.js$/, + ) do |modified, added, removed| + Rake::Task[:js].invoke + end + + trap("INT") do + listener.stop + exit 0 + end + + begin + listener.start + sleep + rescue ThreadError + end +end + +task :version => ["docs/_data/theme.yml", "README.md", "docs/_pages/home.md"] + +file "docs/_data/theme.yml" => "package.json" do |t| + theme = { "version" => package_json["version"] } + File.open(t.name, "w") do |f| + f.puts "# for use with in-page templates" + f.puts theme.to_yaml + end +end + +file "README.md" => "package.json" do |t| + content = File.read(t.name) + content = content.gsub(/(mmistakes\/minimal-mistakes@)[\d.]+/, '\1' + package_json["version"]) + File.write(t.name, content) +end + +file "docs/_pages/home.md" => "package.json" do |t| + content = File.read(t.name) + content = content.gsub(/(\breleases\/tag\/|Latest release v)[\d.]+/, '\1' + package_json["version"]) + File.write(t.name, content) +end + +task :gem do + sh 'gem build minimal-mistakes-jekyll.gemspec' +end diff --git a/_config.yml b/_config.yml index ae4fe9779f26..ae0f84951b09 100644 --- a/_config.yml +++ b/_config.yml @@ -5,22 +5,36 @@ # 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" +rtl : # true, false (default) # turns direction of the page into right to left for RTL languages title : "Site Title" title_separator : "-" +subtitle : # site tagline that appears below site title in masthead name : "Your Name" description : "An amazing website." url : # the base hostname & protocol for your site e.g. "https://mmistakes.github.io" baseurl : # the subpath of your site, e.g. "/blog" repository : # GitHub username/repo-name e.g. "mmistakes/minimal-mistakes" teaser : # path of fallback teaser image, e.g. "/assets/images/500x300.png" -# breadcrumbs : false # true, false (default) +logo : # path of logo image to display in the masthead, e.g. "/assets/images/88x88.png" +masthead_title : # overrides the website title displayed in the masthead, use " " for no title +breadcrumbs : # true, false (default) words_per_minute : 200 +enable_copy_code_button : # true, false (default) +copyright : # "copyright" name, defaults to site.title +copyright_url : # "copyright" URL, defaults to site.url comments: - provider : # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman", "staticman_v2" "custom" + provider : # false (default), "disqus", "discourse", "facebook", "staticman", "staticman_v2", "utterances", "giscus", "custom" disqus: shortname : # https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname- discourse: @@ -30,41 +44,49 @@ comments: appid : num_posts : # 5 (default) colorscheme : # "light" (default), "dark" -staticman: - allowedFields : # ['name', 'email', 'url', 'message'] - branch : # "master" - commitMessage : # "New comment." - filename : # comment-{@timestamp} - format : # "yml" - moderation : # true - path : # "/_data/comments/{options.slug}" (default) - requiredFields : # ['name', 'email', 'message'] - transforms: - email : # "md5" - generatedFields: - date: - type : # "date" - options: - format : # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds" + utterances: + theme : # "github-light" (default), "github-dark" + issue_term : # "pathname" (default) + giscus: + repo_id : # Shown during giscus setup at https://giscus.app + category_name : # Full text name of the category + category_id : # Shown during giscus setup at https://giscus.app + discussion_term : # "pathname" (default), "url", "title", "og:title" + reactions_enabled : # '1' for enabled (default), '0' for disabled + theme : # "light" (default), "dark", "dark_dimmed", "transparent_dark", "preferred_color_scheme" + strict : # 1 for enabled, 0 for disabled (default) + input_position : # "top", "bottom" # The comment input box will be placed above or below the comments + emit_metadata : # 1 for enabled, 0 for disabled (default) # https://github.com/giscus/giscus/blob/main/ADVANCED-USAGE.md#imetadatamessage + lang : # "en" (default) + lazy : # true, false # Loading of the comments will be deferred until the user scrolls near the comments container. + staticman: + branch : # "master" + endpoint : # "https://{your Staticman v3 API}/v3/entry/github/" reCaptcha: siteKey : secret : atom_feed: path : # blank (default) uses feed.xml + hide : # true, false (default) search : # true, false (default) search_full_content : # true, false (default) -search_provider : # lunr (default), algolia +search_provider : # lunr (default), algolia, google +lunr: + search_within_pages : # true, false (default) 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 : bing_site_verification : -yandex_site_verification : naver_site_verification : +yandex_site_verification : +baidu_site_verification : # Social Sharing twitter: @@ -83,43 +105,61 @@ social: # Analytics analytics: - provider : false # false (default), "google", "google-universal", "custom" + provider : # false (default), "google", "google-universal", "google-gtag", "custom" google: tracking_id : + anonymize_ip : # true, false (default) # Site Author author: name : "Your Name" avatar : # path of avatar image, e.g. "/assets/images/bio-photo.jpg" - bio : "I am an amazing person." + bio : "I am an **amazing** person." location : "Somewhere" email : - uri : - home : # null (default), "absolute or relative url to link to author home" - bitbucket : - codepen : - dribbble : - flickr : - facebook : - foursquare : - github : - gitlab : - google_plus : - keybase : - instagram : - lastfm : - linkedin : # "john-doe-12345678" (the last part of your profile url, e.g. https://www.linkedin.com/in/john-doe-12345678) - pinterest : - soundcloud : - stackoverflow : # "123456/username" (the last part of your profile url, e.g. https://stackoverflow.com/users/123456/username) - steam : # "steamId" (the last part of your profile url, e.g. https://steamcommunity.com/id/steamId/) - tumblr : - twitter : - vine : - weibo : - xing : - youtube : # "https://youtube.com/c/MichaelRoseDesign" + links: + - label: "Email" + icon: "fas fa-fw fa-envelope-square" + # url: "mailto:your.name@email.com" + - label: "Website" + icon: "fas fa-fw fa-link" + # url: "https://your-website.com" + - label: "Twitter" + icon: "fab fa-fw fa-twitter-square" + # url: "https://twitter.com/" + - label: "Facebook" + icon: "fab fa-fw fa-facebook-square" + # url: "https://facebook.com/" + - label: "GitHub" + icon: "fab fa-fw fa-github" + # url: "https://github.com/" + - label: "Instagram" + icon: "fab fa-fw fa-instagram" + # url: "https://instagram.com/" + +# Site Footer +footer: + links: + - label: "Twitter" + icon: "fab fa-fw fa-twitter-square" + # url: + - label: "Facebook" + icon: "fab fa-fw fa-facebook-square" + # url: + - label: "GitHub" + icon: "fab fa-fw fa-github" + # url: + - label: "GitLab" + icon: "fab fa-fw fa-gitlab" + # url: + - label: "Bitbucket" + icon: "fab fa-fw fa-bitbucket" + # url: + - label: "Instagram" + icon: "fab fa-fw fa-instagram" + # url: + since: "2013" # Reading Files @@ -145,8 +185,10 @@ exclude: - gulpfile.js - LICENSE - log + - minimal-mistakes-jekyll.gemspec - node_modules - package.json + - package-lock.json - Rakefile - README - tmp @@ -182,14 +224,38 @@ kramdown: # Sass/SCSS sass: sass_dir: _sass - style: compressed # http://sass-lang.com/documentation/file.SASS_REFERENCE.html#output_style + style: compressed # https://sass-lang.com/documentation/file.SASS_REFERENCE.html#output_style # Outputting permalink: /:categories/:title/ +timezone: # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones + + +# Pagination with jekyll-paginate paginate: 5 # amount of posts to show paginate_path: /page:num/ -timezone: # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones + +# Pagination with jekyll-paginate-v2 +# See https://github.com/sverrirs/jekyll-paginate-v2/blob/master/README-GENERATOR.md#site-configuration +# for configuration details +pagination: + # Set enabled to true to use paginate v2 + # enabled: true + debug: false + collection: 'posts' + per_page: 10 + permalink: '/page/:num/' + title: ':title - page :num' + limit: 0 + sort_field: 'date' + sort_reverse: true + category: 'posts' + tag: '' + locale: '' + trail: + before: 2 + after: 2 # Plugins (previously gems:) @@ -198,7 +264,7 @@ plugins: - jekyll-sitemap - jekyll-gist - jekyll-feed - - jemoji + - jekyll-include-cache # mimic GitHub Pages with --safe whitelist: @@ -206,7 +272,7 @@ whitelist: - jekyll-sitemap - jekyll-gist - jekyll-feed - - jemoji + - jekyll-include-cache # Archives @@ -217,8 +283,8 @@ whitelist: # - Archive page should exist at path when using Liquid method or you can # expect broken links (especially with breadcrumbs enabled) # - /tags/my-awesome-tag/index.html ~> path: /tags/ -# - path: /categories/ -# - path: / +# - /categories/my-awesome-category/index.html ~> path: /categories/ +# - /my-awesome-category/index.html ~> path: / category_archive: type: liquid path: /categories/ @@ -239,7 +305,7 @@ tag_archive: # HTML Compression -# - http://jch.penibelst.de/ +# - https://jch.penibelst.de/ compress_html: clippings: all ignore: diff --git a/_data/ui-text.yml b/_data/ui-text.yml index c28935222fc2..59b779489b35 100644 --- a/_data/ui-text.yml +++ b/_data/ui-text.yml @@ -3,14 +3,19 @@ # English (default) # ----------------- en: &DEFAULT_EN + skip_links : "Skip links" + skip_primary_nav : "Skip to primary navigation" + skip_content : "Skip to content" + skip_footer : "Skip to footer" page : "Page" pagination_previous : "Previous" pagination_next : "Next" breadcrumb_home_label : "Home" breadcrumb_separator : "/" - menu_label : "Toggle Menu" - toc_label : "On This Page" - ext_link_label : "Direct Link" + menu_label : "Toggle menu" + search_label : "Toggle search" + toc_label : "On this page" + ext_link_label : "Direct link" less_than : "less than" minute_read : "minute read" share_on_label : "Share on" @@ -18,16 +23,16 @@ en: &DEFAULT_EN tags_label : "Tags:" categories_label : "Categories:" date_label : "Updated:" - comments_label : "Leave a Comment" + comments_label : "Leave a comment" comments_title : "Comments" - more_label : "Learn More" - related_label : "You May Also Enjoy" + more_label : "Learn more" + related_label : "You may also enjoy" follow_label : "Follow:" feed_label : "Feed" powered_by : "Powered by" website_label : "Website" email_label : "Email" - recent_posts : "Recent Posts" + recent_posts : "Recent posts" undefined_wpm : "Undefined parameter words_per_minute at _config.yml" comment_form_info : "Your email address will not be published. Required fields are marked" comment_form_comment_label : "Comment" @@ -35,13 +40,16 @@ en: &DEFAULT_EN comment_form_name_label : "Name" comment_form_email_label : "Email address" comment_form_website_label : "Website (optional)" - comment_btn_submit : "Submit Comment" + comment_btn_submit : "Submit comment" comment_btn_submitted : "Submitted" 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_label_text : "Enter your search term..." search_placeholder_text : "Enter your search term..." + search_algolia_no_results : "No results" results_found : "Result(s) found" + back_to_top : "Back to top" en-US: <<: *DEFAULT_EN en-CA: @@ -52,70 +60,85 @@ en-AU: <<: *DEFAULT_EN # Spanish -# -------------- +# ------- es: &DEFAULT_ES + skip_links : "Saltar enlaces" + skip_primary_nav : "Saltar a navegación principal" + skip_content : "Saltar a contenido" + skip_footer : "Saltar a pie" page : "Página" pagination_previous : "Anterior" pagination_next : "Siguiente" breadcrumb_home_label : "Inicio" breadcrumb_separator : "/" - menu_label : - toc_label : "Contenidos" - ext_link_label : "Enlace" + menu_label : "Alternar menú" + search_label : "Alternar búsqueda" + toc_label : "En esta página" + ext_link_label : "Enlace directo" less_than : "menos de" - minute_read : "minuto de lectura" - share_on_label : "Compartir" + minute_read : "minuto(s) de lectura" + share_on_label : "Compartir en" meta_label : tags_label : "Etiquetas:" categories_label : "Categorías:" date_label : "Actualizado:" - comments_label : "Comentar" - comments_title : + comments_label : "Deja un comentario" + comments_title : "Comentarios" more_label : "Ver más" - related_label : "Podrías ver también" + related_label : "Puede que también te interese" follow_label : "Seguir:" feed_label : "Feed" - powered_by : "Powered by" + powered_by : "Funciona con" website_label : "Sitio web" - email_label : "Email" + email_label : "Correo electrónico" 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" + undefined_wpm : "El parámetro words_per_minute (palabras por minuto) no está definido en _config.yml" + comment_form_info : "Tu dirección de correo electrónico no se publicará. Los campos obligatorios están marcados" comment_form_comment_label : "Comentario" - comment_form_md_info : "Markdown está soportado." + comment_form_md_info : "Puedes utilizar Markdown" comment_form_name_label : "Nombre" - comment_form_email_label : "Dirección de E-mail" + comment_form_email_label : "Dirección de correo electrónico" comment_form_website_label : "Sitio web (opcional)" - comment_btn_submit : "Enviar Commentario" + comment_btn_submit : "Enviar comentario" comment_btn_submitted : "Enviado" - comment_success_msg : "Gracias por su comentario!, Este se visualizará en el sitio una vez haya sido aprobado" - 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_success_msg : "¡Gracias por tu comentario! Se publicará una vez sea aprobado." + comment_error_msg : "Ha ocurrido un error al enviar el comentario. Asegúrate de completar todos los campos obligatorios e inténtalo de nuevo." loading_label : "Cargando..." + search_label_text : "Términos de búsqueda..." + search_placeholder_text : "Términos de búsqueda..." + search_algolia_no_results : + results_found : "resultado(s) encontrado(s)" + back_to_top : "Volver arriba" es-ES: <<: *DEFAULT_ES es-CO: <<: *DEFAULT_ES # French -# ----------------- +# ------ fr: &DEFAULT_FR + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Page" pagination_previous : "Précédent" pagination_next : "Suivant" breadcrumb_home_label : "Accueil" breadcrumb_separator : "/" - menu_label : + menu_label : "Menu" + search_label : toc_label : "Sur cette page" ext_link_label : "Lien direct" less_than : "moins de" - minute_read : "minute de lecture" + minute_read : "minute(s) de lecture" share_on_label : "Partager sur" meta_label : tags_label : "Tags :" categories_label : "Catégories :" date_label : "Mis à jour :" comments_label : "Laisser un commentaire" - comments_title : + comments_title : "Commentaires" more_label : "Lire plus" related_label : "Vous pourriez aimer aussi" follow_label : "Contact" @@ -125,7 +148,6 @@ fr: &DEFAULT_FR email_label : "Email" recent_posts : "Posts récents" undefined_wpm : "Le paramètre words_per_minute n'est pas défini dans _config.yml" - comments_title : "Commentaires" comment_form_info : "Votre adresse email ne sera pas visible. Les champs obligatoires sont marqués" comment_form_comment_label : "Commentaire" comment_form_md_info : "Markdown est supporté." @@ -137,6 +159,11 @@ fr: &DEFAULT_FR comment_success_msg : "Merci pour votre commentaire, 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..." + search_label_text : + search_placeholder_text : "Entrez votre recherche..." + search_algolia_no_results : + results_found : "Résultat(s) trouvé(s)" + back_to_top : "Retour en haut" fr-FR: <<: *DEFAULT_FR fr-BE: @@ -145,14 +172,19 @@ fr-CH: <<: *DEFAULT_FR # Turkish -# ----------------- +# ------- tr: &DEFAULT_TR + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Sayfa" pagination_previous : "Önceki" pagination_next : "Sonraki" breadcrumb_home_label : "Ana Sayfa" breadcrumb_separator : "/" menu_label : + search_label : toc_label : "İçindekiler" ext_link_label : "Doğrudan Bağlantı" less_than : "Şu süreden az: " @@ -184,17 +216,25 @@ tr: &DEFAULT_TR comment_success_msg : "Yorumunuz için teşekkürler! Yorumunuz onaylandıktan sonra sitede gösterilecektir." comment_error_msg : "Maalesef bir hata oluştu. Lütfen zorunlu olan tüm alanları doldurduğunuzdan emin olun ve sonrasında tekrar deneyin." loading_label : "Yükleniyor..." + search_label_text : + search_algolia_no_results : tr-TR: <<: *DEFAULT_TR # Portuguese +# ---------- pt: &DEFAULT_PT + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Página" pagination_previous : "Anterior" pagination_next : "Seguinte" breadcrumb_home_label : "Início" breadcrumb_separator : "/" menu_label : + search_label : toc_label : "Nesta Página" ext_link_label : "Link Direto" less_than : "menos de" @@ -226,58 +266,74 @@ 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..." + search_label_text : + search_algolia_no_results : pt-PT: <<: *DEFAULT_PT - # Brazilian Portuguese pt-BR: + skip_links : "Pular links" + skip_primary_nav : "Pular para navegação primária" + skip_content : "Pular para conteúdo" + skip_footer : "Pular para rodapé" page : "Página" pagination_previous : "Anterior" pagination_next : "Próxima" - breadcrumb_home_label : "Home" + breadcrumb_home_label : "Início" breadcrumb_separator : "/" - menu_label : + menu_label : "Chavear menu" + search_label : "Chavear busca" toc_label : "Nesta página" ext_link_label : "Link direto" - less_than : "menos que" + less_than : "menos de" minute_read : "minuto(s) de leitura" - share_on_label : "Compartilhe em" + share_on_label : "Compartilhe" meta_label : tags_label : "Tags:" categories_label : "Categorias:" date_label : "Atualizado em:" comments_label : "Deixe um comentário" - comments_title : - more_label : "Aprenda mais" - related_label : "Talvez você goste também" - follow_label : "Acompanhe em" + comments_title : "Comentários" + more_label : "Saiba mais" + related_label : "Talvez você também goste" + follow_label : "Siga:" feed_label : "Feed" - powered_by : "Feito com" + powered_by : "Desenvolvido com" website_label : "Site" - email_label : "Email" - recent_posts : "Postagens recentes" - undefined_wpm : "Parâmetro indefinido em words_per_minute no _config.yml" - comment_form_info : "Seu email não será publicado. Os campos obrigatórios estão marcados" + email_label : "E-mail" + recent_posts : "Publicações recentes" + undefined_wpm : "Parâmetro words_per_minute não definido em _config.yml" + comment_form_info : "Seu e-mail não será publicado. Os campos obrigatórios estão marcados" comment_form_comment_label : "Comentário" - comment_form_md_info : "Markdown é suportado." + comment_form_md_info : "Você pode usar Markdown." comment_form_name_label : "Nome" - comment_form_email_label : "Email" + comment_form_email_label : "E-mail" comment_form_website_label : "Site (opcional)" - comment_btn_submit : "Enviar Comentário" + comment_btn_submit : "Enviar comentário" comment_btn_submitted : "Enviado" comment_success_msg : "Obrigado pelo seu comentário! Ele aparecerá no site assim que for aprovado." - 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 : "Desculpe, ocorreu um erro no envio. Verifique se todos os campos obrigatórios foram preenchidos e tente novamente." loading_label : "Carregando..." + search_label_text : "Digite seu termo de busca..." + search_placeholder_text : "Digite seu termo de busca..." + search_algolia_no_results : "Nenhum resultado" + results_found : "Resultado(s) encontrado(s)" + back_to_top : "Voltar para o topo" # Italian -# ----------------- +# ------- it: &DEFAULT_IT + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Pagina" pagination_previous : "Precedente" pagination_next : "Prossima" breadcrumb_home_label : "Home" breadcrumb_separator : "/" menu_label : + search_label : toc_label : "Indice della pagina" ext_link_label : "Link" less_than : "meno di" @@ -309,22 +365,32 @@ it: &DEFAULT_IT comment_success_msg : "Grazie per il tuo commento! Verrà visualizzato nel sito una volta che sarà approvato." comment_error_msg : "C'è stato un errore con il tuo invio. Assicurati che tutti i campi richiesti siano stati completati e riprova." loading_label : "Caricamento..." + search_label_text : + search_placeholder_text : "Inserisci termini di ricerca..." + search_algolia_no_results : + results_found : "Risultati" + back_to_top : "Vai su" it-IT: <<: *DEFAULT_IT # Chinese (zh-CN Chinese - China) -# ----------------- +# -------------------------------- zh: &DEFAULT_ZH_HANS + skip_links : "跳转链接" + skip_primary_nav : "转到主导航栏" + skip_content : "转到内容" + skip_footer : "转到底部" page : "页面" - pagination_previous : "向前" - pagination_next : "向后" + pagination_previous : "上一页" + pagination_next : "下一页" breadcrumb_home_label : "首页" breadcrumb_separator : "/" menu_label : "切换菜单" - toc_label : "在本页上" + search_label : "切换搜索" + toc_label : "目录" ext_link_label : "直接链接" less_than : "少于" - minute_read : "分钟读完" + minute_read : "分钟阅读" share_on_label : "分享" meta_label : tags_label : "标签:" @@ -340,10 +406,10 @@ zh: &DEFAULT_ZH_HANS website_label : "网站" email_label : "电子邮箱" recent_posts : "最新文章" - undefined_wpm : "_config.yml配置中words_per_minute字段未定义" + undefined_wpm : "_config.yml 配置中 words_per_minute 字段未定义" comment_form_info : "您的电子邮箱地址并不会被展示。请填写标记为必须的字段。" comment_form_comment_label : "评论" - comment_form_md_info : "Markdown语法已支持。" + comment_form_md_info : "支持 Markdown 语法。" comment_form_name_label : "姓名" comment_form_email_label : "电子邮箱" comment_form_website_label : "网站（可选）" @@ -352,64 +418,85 @@ zh: &DEFAULT_ZH_HANS comment_success_msg : "感谢您的评论！被批准后它会立即在此站点展示。" comment_error_msg : "很抱歉，您的提交存在错误。请确保所有必填字段都已填写正确，然后再试一次。" loading_label : "正在加载..." + search_label_text : "输入您要搜索的关键词..." + search_placeholder_text : "输入您要搜索的关键词..." + search_algolia_no_results : "无结果" + results_found : "条记录匹配" + back_to_top : "返回顶部" zh-CN: <<: *DEFAULT_ZH_HANS zh-SG: <<: *DEFAULT_ZH_HANS # Taiwan (Traditional Chinese) zh-TW: &DEFAULT_ZH_HANT + skip_links : "跳過連結" + skip_primary_nav : "跳至主導覽" + skip_content : "跳至內容" + skip_footer : "跳至頁尾" page : "頁面" - pagination_previous : "較舊" - pagination_next : "較新" + pagination_previous : "上一頁" + pagination_next : "下一頁" breadcrumb_home_label : "首頁" breadcrumb_separator : "/" - menu_label : "切換選單" - toc_label : "本頁" + menu_label : "選單" + search_label : "搜尋" + toc_label : "本頁目錄" ext_link_label : "外部連結" less_than : "少於" minute_read : "分鐘閱讀" - share_on_label : "分享到" + 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" + comments_title : "留言" + more_label : "閱讀更多" + related_label : "您可能也會有興趣" + follow_label : "追蹤：" + feed_label : "訂閱 Feed" + powered_by : "採用技術：" website_label : "網站" - email_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 : "網頁 (可選填)" + 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 : "抱歉，部份資料輸入有問題。請確認資料填寫正確後再試一次。" + comment_error_msg : "抱歉，您提交的資料有誤。請確認所有必填欄位皆已正確填寫後再試一次。" loading_label : "載入中..." + search_label_text : "輸入您要搜尋的關鍵字..." + search_placeholder_text : "輸入您要搜尋的關鍵字..." + search_algolia_no_results : "找不到結果" + results_found : "找到結果" + back_to_top : "回到頁首" zh-HK: <<: *DEFAULT_ZH_HANT + # German / Deutsch -# ----------------- +# ---------------- de: &DEFAULT_DE + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Seite" pagination_previous : "Vorherige" pagination_next : "Nächste" breadcrumb_home_label : "Start" breadcrumb_separator : "/" menu_label : "Menü ein-/ausschalten" + search_label : toc_label : "Auf dieser Seite" ext_link_label : "Direkter Link" less_than : "weniger als" - minute_read : "Minuten zum lesen" + minute_read : "Minuten zum Lesen" share_on_label : "Teilen auf" meta_label : tags_label : "Tags:" @@ -437,6 +524,10 @@ de: &DEFAULT_DE 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_label_text : + search_placeholder_text : "Suchbegriff eingeben..." + search_algolia_no_results : + results_found : "Ergebnis(se) gefunden" de-DE: <<: *DEFAULT_DE de-AT: @@ -451,14 +542,19 @@ de-LU: <<: *DEFAULT_DE # Nepali (Nepal) -# ----------------- +# -------------- ne: &DEFAULT_NE + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "पृष्‍ठ" pagination_previous : "अघिल्लो" pagination_next : "अर्को" breadcrumb_home_label : "गृह" breadcrumb_separator : "/" menu_label : "टगल मेनु" + search_label : toc_label : "यो पृष्‍ठमा" ext_link_label : "सिधा सम्पर्क" less_than : "कम्तिमा" @@ -490,18 +586,25 @@ ne: &DEFAULT_NE comment_success_msg : "तपाईंको टिप्पणीको लागि धन्यवाद! एक पटक यो अनुमोदन गरेपछी यो साइटमा देखाउनेछ।" comment_error_msg : "माफ गर्नुहोस्, तपाईंको टिप्पणी त्रुटि थियो।सबै आवश्यक जानकारीहरु पूरा गरिएको छ भने निश्चित गर्नुहोस् र फेरि प्रयास गर्नुहोस्।" loading_label : "लोड हुँदैछ ..." + search_label_text : + search_algolia_no_results : ne-NP: <<: *DEFAULT_NE # Korean -# -------------- +# ------ ko: &DEFAULT_KO + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "페이지" pagination_previous : "이전" pagination_next : "다음" breadcrumb_home_label : "Home" breadcrumb_separator : "/" menu_label : "토글 메뉴" + search_label : toc_label : "On This Page" ext_link_label : "직접 링크" less_than : "최대" @@ -533,18 +636,28 @@ ko: &DEFAULT_KO comment_success_msg : "감사합니다! 댓글이 머지된 후 확인하실 수 있습니다." comment_error_msg : "댓글 등록에 문제가 있습니다. 필요 필드를 작성했는지 확인하고 다시 시도하세요." loading_label : "로딩중..." + search_label_text : + search_placeholder_text : "검색어를 입력하세요..." + search_algolia_no_results : + results_found : "개 결과 발견" + back_to_top : "맨 위로 이동" ko-KR: <<: *DEFAULT_KO # Russian / Русский # ----------------- ru: &DEFAULT_RU + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Страница" pagination_previous : "Предыдущая" pagination_next : "Следующая" breadcrumb_home_label : "Главная" breadcrumb_separator : "/" menu_label : "Выпадающее меню" + search_label : toc_label : "Содержание" ext_link_label : "Прямая ссылка" less_than : "менее" @@ -576,20 +689,27 @@ ru: &DEFAULT_RU comment_success_msg : "Спасибо за Ваш комментарий! Он будет опубликован на сайте после проверки." comment_error_msg : "К сожалению, произошла ошибка с отправкой комментария. Пожалуйста, убедитесь, что все обязательные поля заполнены и попытайтесь снова." loading_label : "Отправка..." + search_label_text : search_placeholder_text : "Введите поисковый запрос..." + search_algolia_no_results : results_found : "Найдено" ru-RU: <<: *DEFAULT_RU # Lithuanian / Lietuviškai -# ----------------- +# ------------------------ lt: &DEFAULT_LT + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Puslapis" pagination_previous : "Ankstesnis" pagination_next : "Sekantis" breadcrumb_home_label : "Pagrindinis" breadcrumb_separator : "/" menu_label : "Meniu rodymas" + search_label : toc_label : "Turinys" ext_link_label : "Tiesioginė nuoroda" less_than : "mažiau nei" @@ -610,7 +730,7 @@ lt: &DEFAULT_LT 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_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" @@ -621,18 +741,25 @@ lt: &DEFAULT_LT 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..." + search_label_text : + search_algolia_no_results : lt-LT: <<: *DEFAULT_LT # Greek -# -------------- +# ----- gr: &DEFAULT_GR + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Σελίδα" pagination_previous : "Προηγούμενo" pagination_next : "Επόμενo" breadcrumb_home_label : "Αρχική" breadcrumb_separator : "/" menu_label : "Μενού" + search_label : toc_label : "Περιεχόμενα" ext_link_label : "Εξωτερικός Σύνδεσμος" less_than : "Λιγότερο από" @@ -664,20 +791,27 @@ gr: &DEFAULT_GR comment_success_msg : "Ευχαριστούμε για το σχόλιό σας! Θα εμφανιστεί στην ιστοσελίδα αφού εγκριθεί." comment_error_msg : "Λυπούμαστε, παρουσιάστηκε σφάλμα με την υποβολή σας. Παρακαλούμε βεβαιωθείτε ότι έχετε όλα τα απαιτούμενα πεδία συμπληρωμένα και δοκιμάστε ξανά." loading_label : "Φόρτωση..." + search_label_text : search_placeholder_text : "Εισάγετε όρο αναζήτησης..." + search_algolia_no_results : results_found : "Αποτελέσματα" gr-GR: <<: *DEFAULT_GR # Swedish -# ----------------- +# ------- sv: &DEFAULT_SV + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Sidan" pagination_previous : "Föregående" pagination_next : "Nästa" breadcrumb_home_label : "Hem" breadcrumb_separator : "/" - menu_label : "Meny ridå" + menu_label : "Växla menyläge" + search_label : "Växla sökläge" toc_label : "På denna sida" ext_link_label : "Direkt länk" less_than : "mindre än" @@ -698,31 +832,41 @@ sv: &DEFAULT_SV 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_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_md_info : "Stöd för Markdown finns." 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." + comment_error_msg : "Tyvärr det har blivit något fel i ett av fälten, se till att du fyllt i alla obligatoriska fält och försök igen." loading_label : "Laddar..." + search_label_text : + search_placeholder_text : "Fyll i sökterm..." + search_algolia_no_results : + results_found : "Resultat funna" + back_to_top : "Tillbaka till toppen" sv-SE: <<: *DEFAULT_SV sv-FI: <<: *DEFAULT_SV # Dutch -# ----------------- +# ----- nl: &DEFAULT_NL + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "Pagina" pagination_previous : "Vorige" pagination_next : "Volgende" breadcrumb_home_label : "Home" breadcrumb_separator : "/" menu_label : "Wissel Menu" + search_label : toc_label : "Op deze pagina" ext_link_label : "Directe Link" less_than : "minder dan" @@ -754,84 +898,104 @@ nl: &DEFAULT_NL 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..." + search_label_text : "Geef uw zoekterm in..." + search_placeholder_text : "Geef uw zoekterm in..." + search_algolia_no_results : + results_found : "Resultaat gevonden" + back_to_top : "Terug naar boven" nl-BE: <<: *DEFAULT_NL nl-NL: <<: *DEFAULT_NL # Indonesian -# ----------------- +# ---------- id: &DEFAULT_ID + skip_links : + skip_primary_nav : "Loncat ke navigasi" + skip_content : "Loncat ke konten" + skip_footer : "Loncat ke footer" page : "Halaman" - pagination_previous : "Kembali" - pagination_next : "Maju" - breadcrumb_home_label : "Home" + pagination_previous : "Sebelumnya" + pagination_next : "Selanjutnya" + breadcrumb_home_label : "Beranda" breadcrumb_separator : "/" - menu_label : "Menu Toggle" + menu_label : "Menu" + search_label : "Pencarian" toc_label : "Pada Halaman Ini" ext_link_label : "Link langsung" less_than : "Kurang dari" - minute_read : "Waktu baca" - share_on_label : "Berbagi di" + minute_read : "menit baca" + share_on_label : "Bagikan di" meta_label : - tags_label : "Golongan:" + tags_label : "Label:" categories_label : "Kategori:" date_label : "Diupdate:" comments_label : "Tinggalkan komentar" comments_title : "Komentar" more_label : "Pelajari lagi" - related_label : "Anda juga akan suka" + related_label : "Anda mungkin suka" follow_label : "Ikuti:" feed_label : "Feed" powered_by : "Didukung oleh" website_label : "Website" email_label : "Email" - recent_posts : "Posting terbaru" + recent_posts : "Post 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_info : "Email Anda tidak akan dipublish. Kolom yang diperlukan ditandai dengan tanda " comment_form_comment_label : "Komentar" - comment_form_md_info : "Markdown disupport." + comment_form_md_info : "Markdown didukung." 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..." + comment_btn_submit : "Kirim Komentar" + comment_btn_submitted : "Telah dikirim" + comment_success_msg : "Terimakasih atas komentar Anda! Komentar akan tampil setelah disetujui." + comment_error_msg : "Maaf, ada kesalahan pada komentar Anda. Pastikan seluruh kolom sudah dilengkapi dan coba kembali." + loading_label : "Sedang memuat..." + search_label_text : "Masukkan kata kunci pencarian..." + search_placeholder_text : "Masukkan kata kunci pencarian..." + search_algolia_no_results : "Tidak ada hasil" + results_found : "Hasil pencarian ditemukan" + back_to_top : "Kembali ke awal" id-ID: <<: *DEFAULT_ID # Vietnamese -# ----------------- +# ---------- vi: &DEFAULT_VI + skip_links : "Đường dẫn tắt" + skip_primary_nav : "Nhảy tới thanh điều hướng" + skip_content : "Nhảy tới nội dung" + skip_footer : "Nhảy tới chân trang" page : "Trang" pagination_previous : "Trước" - pagination_next : "Sau" + pagination_next : "Kế tiếp" breadcrumb_home_label : "Trang chủ" breadcrumb_separator : "/" menu_label : "Menu" - toc_label : "Tại trang này" + search_label : "Tìm kiếm" + toc_label : "Mục lục" ext_link_label : "Đường dẫn trực tiếp" - less_than : "nhỏ hơn" - minute_read : "phút đọc" + less_than : "chỉ cầ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:" + tags_label : "Thẻ:" + categories_label : "Danh mục:" + date_label : "Ngày 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" + powered_by : "Xây dựng trên nền tảng" 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_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" @@ -842,18 +1006,28 @@ vi: &DEFAULT_VI 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..." + search_label_text : "Nhập từ khóa cần tìm..." + search_placeholder_text : "Nhập từ khóa cần tìm..." + search_algolia_no_results : "Không tìm thấy kết quả nào" + results_found : "Kết quả tìm được" + back_to_top : "Lên đầu trang" vi-VN: <<: *DEFAULT_VI # Danish # ------ da: &DEFAULT_DA + skip_links : + skip_primary_nav : "Gå til hovedmenuen" + skip_content : "Gå til indholdet" + skip_footer : "Gå til sidefoden" page : "Side" pagination_previous : "Forrige" pagination_next : "Næste" - breadcrumb_home_label : "Home" + breadcrumb_home_label : "Forside" breadcrumb_separator : "/" menu_label : "Vis/skjul menu" + search_label : "Søgning til/fra" toc_label : "På denne side" ext_link_label : "Direkte link" less_than : "mindre end" @@ -885,20 +1059,28 @@ da: &DEFAULT_DA 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_label_text : "Hvad leder du efter..." search_placeholder_text : "Hvad leder du efter..." + search_algolia_no_results : "Ingen resultater" results_found : "Resultat(er) fundet" + back_to_top : "Tilbage til toppen" da-DK: <<: *DEFAULT_DA # Polish # ------ pl: &DEFAULT_PL + skip_links : "Pomiń linki" + skip_primary_nav : "Przejdź do nawigacji" + skip_content : "Przejdź do treści" + skip_footer : "Przejdź do stopki" page : "Strona" pagination_previous : "Poprzednia" pagination_next : "Następna" breadcrumb_home_label : "Strona główna" breadcrumb_separator : "/" menu_label : "Przełącz menu" + search_label : "Przełącz wyszukiwanie" toc_label : "Spis treści" ext_link_label : "Link bezpośredni" less_than : "mniej niż" @@ -930,18 +1112,28 @@ pl: &DEFAULT_PL 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..." -da-PL: + search_label_text : "Wprowadź kryteria wyszukiwania..." + search_placeholder_text : "Wprowadź kryteria wyszukiwania..." + search_algolia_no_results : "Brak wyników" + results_found : "Znalezione wyniki" + back_to_top : "Wróć na górę" +pl-PL: <<: *DEFAULT_PL # Japanese -# ----------------- +# -------- ja: &DEFAULT_JA + skip_links : + skip_primary_nav : + skip_content : + skip_footer : page : "ページ" pagination_previous : "前へ" pagination_next : "次へ" breadcrumb_home_label : "ホーム" breadcrumb_separator : "/" menu_label : "メニュー" + search_label : toc_label : "目次" ext_link_label : "リンク" less_than : @@ -973,11 +1165,1021 @@ ja: &DEFAULT_JA comment_success_msg : "コメントありがとうございます！　コメントは承認されるとページに表示されます。" comment_error_msg : "送信エラーです。必須項目がすべて入力されていることを確認して再送信してください。" loading_label : "読み込み中..." + search_label_text : search_placeholder_text : "検索キーワードを入力してください..." + search_algolia_no_results : results_found : "件" ja-JP: <<: *DEFAULT_JA +# Slovak +# ----------------- +sk: &DEFAULT_SK + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + page : "Stránka" + pagination_previous : "Predošlá" + pagination_next : "Ďalšia" + breadcrumb_home_label : "Domov" + breadcrumb_separator : "/" + menu_label : "Menu" + search_label : + 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_label_text : + search_placeholder_text : "Zadaj hľadaný výraz..." + search_algolia_no_results : + results_found : "Nájdených výsledkov" + back_to_top : "Na začiatok stránky" +sk-SK: + <<: *DEFAULT_SK + +# Hungarian +# ----------------- +hu: &DEFAULT_HU + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + page : "Oldal" + pagination_previous : "Előző" + pagination_next : "Következő" + breadcrumb_home_label : "Kezdőlap" + breadcrumb_separator : "/" + menu_label : "Menü nyit/zár" + search_label : + 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_label_text : + search_placeholder_text : "Keresendő szöveg..." + search_algolia_no_results : + results_found : "Találatok:" + back_to_top : "Oldal tetejére" +hu-HU: + <<: *DEFAULT_HU + +# Romanian +# ----------------- +ro: &DEFAULT_RO + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + page : "Pagina" + pagination_previous : "Anterior" + pagination_next : "Următor" + breadcrumb_home_label : "Acasă" + breadcrumb_separator : "/" + menu_label : "Comută meniul" + search_label : + toc_label : "Pe această pagină" + ext_link_label : "Link direct" + less_than : "mai puțin de" + minute_read : "minute de citit" + share_on_label : "Distribuie pe" + meta_label : + tags_label : "Etichete:" + categories_label : "Categorii:" + date_label : "Actualizat:" + comments_label : "Lasă un comentariu" + comments_title : "Comentarii" + more_label : "Citește mai departe" + related_label : "S-ar putea să-ți placă" + follow_label : "Urmărește:" + feed_label : "Feed RSS" + powered_by : "Cu sprijinul" + website_label : "Site" + email_label : "Email" + recent_posts : "Articole recente" + undefined_wpm : "Parametru words_per_minute nedefinit în _config.yml" + comment_form_info : "Adresa ta de email nu va fi făcută publică. Câmpurile marcate sunt obligatorii" + comment_form_comment_label : "Comentariu" + comment_form_md_info : "Markdown este suportat." + comment_form_name_label : "Nume" + comment_form_email_label : "Adresă de email" + comment_form_website_label : "Site (opțional)" + comment_btn_submit : "Trimite comentariul" + comment_btn_submitted : "Trimis" + comment_success_msg : "Mulțumesc pentru comentariu! Va apărea pe site în momentul în care va fi aprobat." + comment_error_msg : "Scuze, este o problemă cu comentariul tău. Asigură-te că toate câmpurile obligatorii au fost completate și încearcă din nou." + loading_label : "Se încarcă..." + search_label_text : + search_placeholder_text : "Caută ceva..." + search_algolia_no_results : + results_found : "Rezultate găsite" + back_to_top : "Înapoi în susul paginii" +ro-RO: + <<: *DEFAULT_RO + +# Punjabi +# ----------------- +pa: &DEFAULT_PA + skip_links : "ਲਿੰਕ ਛੱਡੋ" + skip_primary_nav : "ਮੂਲ ਮਾਰਗ ਛੱਡੋ" + skip_content : "ਸਮੱਗਰੀ ਛੱਡੋ" + skip_footer : "ਅੰਤ ਵਿਚ ਲਿਖਿਆ ਛੱਡੋ" + page : "ਸਫ਼ਾ" + pagination_previous : "ਪਿਛਲਾ" + pagination_next : "ਅਗਲਾ " + breadcrumb_home_label : "ਘਰ" + breadcrumb_separator : "/" + menu_label : "ਟੌਗਲ ਮੀਨੂ" + search_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 : "_config.yml ਤੇ ਅਣ-ਪ੍ਰਭਾਸ਼ਿਤ ਪੈਰਾਮੀਟਰ words_per_minute" + 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 : "ਲੋਡ ਹੋ ਰਿਹਾ ਹੈ..." + search_label_text : "ਖੋਜ" + search_placeholder_text : "ਆਪਣੀ ਖੋਜ ਦੇ ਸ਼ਬਦ ਨੂੰ ਦਰਜ ਕਰੋ..." + search_algolia_no_results : + results_found : "ਨਤੀਜਾ ਮਿਲਿਆ/ਮਿਲੇ" + back_to_top : "ਵਾਪਸ ਚੋਟੀ 'ਤੇ ਜਾਓ" +pa-IN: + <<: *DEFAULT_PA + +# Persian (Farsi) +# -------------- +fa: &DEFAULT_FA + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + 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 : "سایت اینترنتی (اختیاری)" + comment_btn_submit : "ارسال نظر" + comment_btn_submitted : "ارسال شد" + comment_success_msg : ".باتشکر از ارسال دیدگاه! پس از تأیید، این دیدگاه در سایت نشان داده خواهد شد" + comment_error_msg : ".متاسفانه در ارسال شما خطایی بود. لطفا مطمئن شوید تمام فیلدهای مورد نیاز تکمیل شده و دوباره امتحان کنید" + loading_label : "بارگذاری..." + search_label_text : + search_placeholder_text : "عبارت جستجوی خود را وارد کنید..." + search_algolia_no_results : + results_found : "نتایج" + back_to_top : "بازگشت به بالا" +fa-IR: + <<: *DEFAULT_FA + + +# Malayalam +# ----------------- +ml: &DEFAULT_ML + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + page : "പേജ്" + pagination_previous : "തിരികെ" + pagination_next : "മുന്നോട്ട്" + breadcrumb_home_label : "ഹോം" + breadcrumb_separator : "/" + menu_label : "ടോഗിൾ മെനു" + search_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 : "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 : "ലോഡിംഗ്..." + search_label_text : + search_placeholder_text : "നിങ്ങളുടെ തിരയൽ പദം നൽകുക..." + search_algolia_no_results : + results_found : "ഫലം (കൾ) കണ്ടെത്തി" + back_to_top : "മുകളിലേയ്ക്ക്" +ml-IN: + <<: *DEFAULT_ML + +# Thailand +# -------------- +th: &DEFAULT_TH + skip_links : + skip_primary_nav : + skip_content : + skip_footer : + page : "หน้า" + pagination_previous : "ก่อนหน้า" + pagination_next : "ถัดไป" + breadcrumb_home_label : "หน้าแรก" + breadcrumb_separator : "/" + menu_label : "พับเมนู" + search_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 : "มาร์กดาวน์ได้รับการสนับสนุน" + 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_label_text : + search_placeholder_text : "ใส่คำค้นหาของคุณ..." + search_algolia_no_results : + results_found : "ผลการค้นหา พบ" + back_to_top : "กลับด้านบน" +th-TH: + <<: *DEFAULT_TH + +# Hindi +# ----------------- +hi: &DEFAULT_HI + skip_links : "लिंक छोड़ें" + skip_primary_nav : "प्राथमिक पथ-प्रदर्शन छोड़ें" + skip_content : "सामग्री छोड़ें" + skip_footer : "अंत-में लिखा छोड़ें" + 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 : "_config.yml पर अपरिभाषित पैरामीटर words_per_minute" + 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 : "लोड हो रहा है..." + search_label_text : "खोज" + search_placeholder_text : "अपना खोज शब्द दर्ज करें..." + search_algolia_no_results : + results_found : "परिणाम मिला/मिले" + back_to_top : "शीर्ष पर वापस" +hi-IN: + <<: *DEFAULT_HI + +# Catalan +# -------------- +ca: &DEFAULT_CA + skip_links : "Salta els enllaços" + skip_primary_nav : "Salta a la navegació primària" + skip_content : "Salta al contingut" + skip_footer : "Salta al peu" + page : "Pàgina" + pagination_previous : "Anterior" + pagination_next : "Següent" + breadcrumb_home_label : "Inici" + breadcrumb_separator : "/" + menu_label : "Mostra/amaga el menú" + search_label : "Mostra/amaga la cerca" + toc_label : "En aquesta pàgina" + ext_link_label : "Enllaç directe" + less_than : "es llegeix en menys de" + minute_read : "minut(s)" + share_on_label : "Comparteix a" + meta_label : + tags_label : "Etiquetes:" + categories_label : "Categories:" + date_label : "Actualitzat:" + comments_label : "Deixa un comentari" + comments_title : "Comentaris" + more_label : "Llegeix més" + related_label : "També et pot agradar" + follow_label : "Segueix-me:" + feed_label : "Feed" + powered_by : "Funciona amb" + website_label : "Pàgina web" + email_label : "Correu electrònic" + recent_posts : "Entrades recents" + undefined_wpm : "El paràmetre words_per_minute no està definit a _config.yml" + comment_form_info : "No es mostrarà el teu correu electrònic. Els camps obligatoris estan marcats" + comment_form_comment_label : "Comentari" + comment_form_md_info : "Admet Markdown." + comment_form_name_label : "Nom" + comment_form_email_label : "Correu electrònic" + comment_form_website_label : "Pàgina web (opcional)" + comment_btn_submit : "Envia" + comment_btn_submitted : "Enviat" + comment_success_msg : "Gràcies pel teu comentari! Apareixerà un cop sigui aprovat." + comment_error_msg : "Hi ha hagut un error enviat el comentari. Comprova que els camps obligatirs estiguin omplerts i torna-ho a provar." + loading_label : "Carregant..." + search_label_text : "Introdueix termes per cercar..." + search_placeholder_text : "Introdueix termes per cercar..." + search_algolia_no_results : + results_found : "resultat(s)" + back_to_top : "Torna a dalt" +ca-ES: + <<: *DEFAULT_CA + +# Irish (Gaeilge) +# -------------- +ga: &DEFAULT_GA + skip_links : "Léim naisc" + skip_primary_nav : "Léim chuig príomh naiscleanúint" + skip_content : "Léim chuig inneachar" + skip_footer : "Léim chuig buntásc" + page : "Leathanach" + pagination_previous : "Leathanach roimhe sin" + pagination_next : "Céad leathanach eile" + breadcrumb_home_label : "Baile" + breadcrumb_separator : "/" + menu_label : "Scorán roghchlár" + search_label : "Scorán cuardach" + toc_label : "Ar an leathanach seo" + ext_link_label : "Nasc díreach" + less_than : "níos lú na" + minute_read : "a léamh" + share_on_label : "Roinn ar" + meta_label : + tags_label : "Clibeanna:" + categories_label : "Catagoírí:" + date_label : "Nuashonraíodh:" + comments_label : "Fág trácht" + comments_title : "Tráchtanna" + more_label : "Foghlaim níos mó" + follow_label : "Lean:" + feed_label : "Feed" + powered_by : "Ag fáil cumhacht as" + website_label : "Suíomh gréasáin" + email_label : "R-phost" + recent_posts : "Postálacha le deanaí" + comment_form_comment_label : "Trácht" + comment_form_name_label : "Ainm" + comment_form_email_label : "Ríomhsheoladh" + comment_form_website_label : "Suíomh gréasáin (roghnach)" + comment_btn_submit : "Cuir isteach trácht" + comment_btn_submitted : "Curtha isteach" + loading_label : "Lódáil..." + search_label_text : "Cuir do chuardach isteach..." + search_placeholder_text : "Cuir do chuardach isteach..." + search_algolia_no_results : + results_found : "Torthaí aimsithe" + back_to_top : "Ar ais go barr" +ga-IE: + <<: *DEFAULT_GA + + +# Finnish / Suomi +# ----------------- +fi: &DEFAULT_FI + skip_links : "Ohita linkit" + skip_primary_nav : "Siirry päävalikkoon" + skip_content : "Siirry sisältöön" + skip_footer : "Siirry alareunaan" + page : "Sivu" + pagination_previous : "Edellinen" + pagination_next : "Seuraava" + breadcrumb_home_label : "Etusivu" + breadcrumb_separator : "/" + menu_label : "Avaa valikko" + search_label : "Avaa haku" + toc_label : "Tällä sivulla" + ext_link_label : "Suora linkki" + less_than : "vähemmän kuin" + minute_read : "minuuttia luettavaa" + share_on_label : "Jaa" + meta_label : + tags_label : "Tunnisteet:" + categories_label : "Kategoriat:" + date_label : "Päivitetty:" + comments_label : "Jätä kommentti" + comments_title : "Kommentit" + more_label : "Lisää" + related_label : "Saatat olla kiinnostunut myös" + follow_label : "Seuraa:" + feed_label : "Syöte" + powered_by : "Käyttäen" + website_label : "Kotisivu" + email_label : "Sähköposti" + recent_posts : "Viimeisimmät kirjoitukset" + undefined_wpm : "words_per_minute asetusta ei ole määritelty _config.yml tiedostossa" + comment_form_info : "Sinun sähköpostiosoitetta ei julkaista. Vaaditut kentät ovat merkittyjä" + comment_form_comment_label : "Kommentti" + comment_form_md_info : "Tukee markdown muotoilua." + comment_form_name_label : "Nimi" + comment_form_email_label : "Sähköpostiosoite" + comment_form_website_label : "Nettisivu (vapaaehtoinen)" + comment_btn_submit : "Lähetä" + comment_btn_submitted : "Lähetetty" + comment_success_msg : "Kiitos kommentista, se julkaistaan tällä sivulla tarkastelun jälkeen." + comment_error_msg : "Tapahtui virhe. Tarkista, että olet täyttänyt kaikki kentät ja yritä uudelleen." + loading_label : "Ladataan..." + search_label_text : "Hakusana..." + search_placeholder_text : "Hakusana..." + search_algolia_no_results : "Ei hakutuloksia" + results_found : "Tulosta" + back_to_top : "Siirry ylös" + +# Myanmar (Burmese) +# ----------------- +my: &DEFAULT_MY + skip_links : "လင့်များကို​ကျော်ပါ။" + skip_primary_nav : "မူလအညွှန်းသို့​ကျော်ပါ။" + skip_content : "အကြောင်းအရာသို့ကျော်ပါ။" + skip_footer : "အောက်ခြေသို့ကျော်ပါ။" + page : "စာမျက်နှာ" + pagination_previous : "ရှေ့တစ်ခု" + pagination_next : "နောက်တစ်ခု" + breadcrumb_home_label : "ပင်မစာမျက်နှာ" + breadcrumb_separator : "/" + menu_label : "မီနူး ဖွင့်၊ပိတ်" + search_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 : "Feed ယူရန် -" + 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 : "တင်နေသည်..." + search_label_text : "သင့်ရှာဖွေရေးဝေါဟာရကိုရိုက်ထည့်ပါ..." + search_placeholder_text : "သင့်ရှာဖွေရေးဝေါဟာရကိုရိုက်ထည့်ပါ..." + search_algolia_no_results : + results_found : "ရလဒ်(များ)ကိုတွေ့ရှိခဲ့သည်" + back_to_top : "အပေါ်သို့ပြန်သွား" +my-MM: + <<: *DEFAULT_MY + +# Norwegian +# ------- +no: &DEFAULT_NO + skip_links : "Hopp over lenker" + skip_primary_nav : "Gå til primærnavigasjon" + skip_content : "Gå til innhold" + skip_footer : "Gå til fotnote" + page : "Side" + pagination_previous : "Forrige" + pagination_next : "Neste" + breadcrumb_home_label : "Hjem" + breadcrumb_separator : "/" + menu_label : "Vis/skjul meny" + search_label : "Vis/skjul søk" + toc_label : "På denne siden" + ext_link_label : "Direkte lenke" + less_than : "mindre enn" + minute_read : "minutters lesing" + share_on_label : "Del på" + meta_label : + tags_label : "Nøkkelord:" + categories_label : "Kategorier:" + date_label : "Oppdatert:" + comments_label : "Skriv en kommentar" + comments_title : "Kommentarer" + more_label : "Lær mer" + related_label : "Du vil kanskje også lese:" + follow_label : "Følg:" + feed_label : "Feed" + powered_by : "Lagd med" + website_label : "Nettside" + email_label : "E-post" + recent_posts : "Nyeste innlegg" + undefined_wpm : "Parameteret words_per_minute er ikke definert i _config.yml" + comment_form_info : "Din e-postadresse vil ikke bli publisert. Obligatoriske felt er markert" + comment_form_comment_label : "Kommentar" + comment_form_md_info : "Markdown er støttet" + comment_form_name_label : "Navn" + comment_form_email_label : "E-postadresse" + comment_form_website_label : "Nettside (frivillig)" + comment_btn_submit : "Send kommentar" + comment_btn_submitted : "Sendt" + comment_success_msg : "Takk for din kommentar! Den blir vist på siden så fort den er godkjent" + comment_error_msg : "Beklager, noe gikk galt. Sjekk at alle obligatoriska felt er utfylt og prøv igjen" + loading_label : "Laster..." + search_label_text : "Skriv inn søkeord" + search_placeholder_text : "Skriv inn søkeord" + search_algolia_no_results : "Ingen treff" + results_found : "Treff funnet" + back_to_top : "Tillbake til toppen" +no-NB: + <<: *DEFAULT_NO +no-NN: + <<: *DEFAULT_NO + +# Hebrew +# ------- +he: &DEFAULT_HE + skip_links : "דלגו על קישור" + skip_primary_nav : "דלגו לראשי" + skip_content : "דלגו לתוכן" + skip_footer : "דלגו לתחתית" + page : "דף" + pagination_previous : "קודם" + pagination_next : "הבא" + breadcrumb_home_label : "בית" + breadcrumb_separator : "/" + menu_label : "סגירה/פתיחה של תפריט" + search_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 : "Undefined parameter words_per_minute at _config.yml" + comment_form_info : "האימייל שלך נשמר חסוי. שדות חובה מסומנים" + comment_form_comment_label : "הערה" + comment_form_md_info : "Markdown is supported." + 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_label_text : "מילות חיפוש..." + search_placeholder_text : "מילות חיפוש..." + search_algolia_no_results : "אין תוצאות" + results_found : "תוצאות נמצאו" + back_to_top : "חזרה להתחלה" +he-IL: + <<: *DEFAULT_HE + +# Arabic (عربي) +# -------------- +ar: &DEFAULT_AR + skip_links : "تخطي الروابط" + skip_primary_nav : "تخطى الى شريط التنقل" + skip_content : "الانتقال الى المحتوى" + skip_footer : "الانتقال الى ذيل الصفحة" + page : "صفحه" + pagination_previous : "قبل" + pagination_next : "بعد" + breadcrumb_home_label : "الرئيس" + breadcrumb_separator : "/" + menu_label : "الخيارات" + search_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_label_text : "اكتب مصطلح للبحث..." + search_placeholder_text : "اكتب مصطلح للبحث..." + search_algolia_no_results : "لا توجد نتائج" + results_found : "تم إيجاد نتيجة" + back_to_top : "الانتقال الى الأعلى" +ar-SD: + <<: *DEFAULT_AR +ar-SA: + <<: *DEFAULT_AR +ar-AE: + <<: *DEFAULT_AR +ar-EG: + <<: *DEFAULT_AR + +# Kiswahili +# ----------------- +sw: &DEFAULT_SW + skip_links : "Ruka viungo" + skip_primary_nav : "Ruka orodha kuu" + skip_content : "Ruka maandiko maakuu" + skip_footer : "Ruka chini" + page : "Ukurasa" + pagination_previous : "Rudi" + pagination_next : "Endelea" + breadcrumb_home_label : "Ukurasa wa kwanza" + breadcrumb_separator : "/" + menu_label : "Wezesha/Zima orodha" + search_label : "Wezesha/Zima kutafuta" + toc_label : "Kwa ukurasa huu" + ext_link_label : "Kiungo mbio" + less_than : "Soma kwa dakikia ndogo kuliko" + minute_read : "Soma kwa dakika" + share_on_label : "Tangaza" + meta_label : + tags_label : "Alama:" + categories_label : "Aina:" + date_label : "Geuzi ya mwisho:" + comments_label : "Wacha maoni" + comments_title : "Maoni" + more_label : "Jifunze zaidi" + related_label : "Pia, utapenda" + follow_label : "Fuata:" + feed_label : "Feed" + powered_by : "Inatumia" + website_label : "Tovuti" + email_label : "Barua pepe" + recent_posts : "Makala juzi" + undefined_wpm : "Ingizo words_per_minute kwa _config.yml haijawekwa" + comment_form_info : "Barua pepe yako haitaonekana. Kuna alama kwa ingizo tunahitaji." + comment_form_comment_label : "Maoni" + comment_form_md_info : "Unaweza kutumia `Markdown`." + comment_form_name_label : "Jina" + comment_form_email_label : "Barua pepe" + comment_form_website_label : "Tovuti (hiari)" + comment_btn_submit : "Tuma maoni" + comment_btn_submitted : "Umetuma" + comment_success_msg : "Asante kwa maoni yako! Itaonekana ikiridhiwa." + comment_error_msg : "Pole, kuna makosa kwa ingizo yako. Tafadhali angalia umeandika kwa ingizo zote zinahitaji, na jaribu tena." + loading_label : "Inapakiwa..." + search_label_text : "Ingiza neno unatafuta..." + search_placeholder_text : "Ingiza neno unatafuta..." + search_algolia_no_results : "Hakuna matokeo" + results_found : "Tumepata" + back_to_top : "Rudi juu" +sw-KE: + <<: *DEFAULT_SW +sw-TZ: + <<: *DEFAULT_SW + +# Ukrainian / Українська +# ----------------- +uk: &DEFAULT_UK + skip_links : "Посилання для переходу" + skip_primary_nav : "Перейти до основної навігації" + skip_content : "Перейти до змісту" + skip_footer : "Перейти до нижнього колонтитула" + page : "Сторінка" + pagination_previous : "Попередня" + pagination_next : "Наступна" + breadcrumb_home_label : "Головна" + breadcrumb_separator : "/" + menu_label : "Випадаюче меню" + search_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_label_text : "Введіть пошуковий запит..." + search_placeholder_text : "Введіть пошуковий запит..." + search_algolia_no_results : + results_found : "Знайдено" +uk-UA: + <<: *DEFAULT_UK + +# Czech / čeština +# ----------------- +cs: &DEFAULT_CS + skip_links : "Rychlé odkazy" + skip_primary_nav : "Přejít na hlavní navigace" + skip_content : "Přejít na obsah" + skip_footer : "Přejít na zápatí" + page : "Stránka" + pagination_previous : "Předchozí" + pagination_next : "Další" + breadcrumb_home_label : "Domů" + breadcrumb_separator : "/" + menu_label : "Přepnout zobrazení menu" + search_label : "Přepnout zobrazení vyhledávání" + toc_label : "Na této stránce" + ext_link_label : "Přímý odkaz" + less_than : "méně než" + minute_read : "minut" + share_on_label : "Sdílet" + meta_label : + tags_label : "Štítky:" + categories_label : "Rubriky:" + date_label : "Aktualizováno:" + comments_label : "Okomentovat" + comments_title : "Komentáře" + more_label : "Zjistit více" + related_label : "Může se vám také líbit" + follow_label : "Sledovat:" + feed_label : "Zdroj" + powered_by : "Používáme" + website_label : "Web" + email_label : "E-mail" + recent_posts : "Nejnovější příspěvky" + undefined_wpm : "V souboru _config.yml chybí parametr words_per_minute" + comment_form_info : "Vaše e-mailová adresa nebude zveřejněna. Povinná pole jsou označena" + comment_form_comment_label : "Komentář" + comment_form_md_info : "Podporuje markdown." + comment_form_name_label : "Jméno" + comment_form_email_label : "E-mailová adresa" + comment_form_website_label : "Web (volitelné)" + comment_btn_submit : "Odeslat komentář" + comment_btn_submitted : "Odesláno" + comment_success_msg : "Děkujeme za komentář. Na stránce se objeví jakmile projde schválením." + comment_error_msg : "Odeslání se nezdařilo. Zkontrolujte, že jste vyplnili všechna povinná pole a zkuste to znovu." + loading_label : "Načítání..." + search_label_text : "Zadejte vyhledávání..." + search_placeholder_text : "Zadejte vyhledávání..." + search_algolia_no_results : "Žádné výsledky" + results_found : "Nalezené výsledky" + back_to_top : "Na začátek stránky" +cs-CZ: + <<: *DEFAULT_CS + +# Bulgarian +# ----------------- +bg: &DEFAULT_BG + skip_links : "Пропуснете връзките" + skip_primary_nav : "Преминете към основната навигация" + skip_content : "Преминете към съдържанието" + skip_footer : "Преминете към долния колонтитул" + page : "Страница" + pagination_previous : "Предишна" + pagination_next : "Следваща" + breadcrumb_home_label : "Начало" + breadcrumb_separator : "/" + menu_label : "Превключване на меню" + search_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 : "Поддържа се Маркдаун." + 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_label_text : "Въведете термин за търсене..." + search_placeholder_text : "Въведете термин за търсене..." + search_algolia_no_results : "Няма резултати" + results_found : "Намерени резултати" + back_to_top : "Обратно към началото" +bg-BG: + <<: *DEFAULT_BG + # Another locale # -------------- # diff --git a/_includes/after-content.html b/_includes/after-content.html new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/_includes/analytics-providers/google-gtag.html b/_includes/analytics-providers/google-gtag.html new file mode 100644 index 000000000000..16d0cf176bac --- /dev/null +++ b/_includes/analytics-providers/google-gtag.html @@ -0,0 +1,9 @@ + + + diff --git a/_includes/analytics-providers/google-universal.html b/_includes/analytics-providers/google-universal.html index 10d65b2ee488..68c2674ba930 100644 --- a/_includes/analytics-providers/google-universal.html +++ b/_includes/analytics-providers/google-universal.html @@ -1,9 +1,7 @@ + diff --git a/_includes/analytics-providers/google.html b/_includes/analytics-providers/google.html index b591b995435a..c5742b9817d6 100644 --- a/_includes/analytics-providers/google.html +++ b/_includes/analytics-providers/google.html @@ -1,6 +1,9 @@ - \ No newline at end of file + diff --git a/_includes/analytics.html b/_includes/analytics.html index 5448a506dde0..371469f0af9b 100644 --- a/_includes/analytics.html +++ b/_includes/analytics.html @@ -5,6 +5,8 @@ {% 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 %} diff --git a/_includes/archive-single.html b/_includes/archive-single.html index 769d9184a61e..7854c961bd43 100644 --- a/_includes/archive-single.html +++ b/_includes/archive-single.html @@ -10,29 +10,21 @@ {% assign title = post.title %} {% endif %} -
-
diff --git a/_includes/author-profile-custom-links.html b/_includes/author-profile-custom-links.html index cf86521afb4e..1a3d4caefc55 100644 --- a/_includes/author-profile-custom-links.html +++ b/_includes/author-profile-custom-links.html @@ -1,6 +1,6 @@ diff --git a/_includes/category-list.html b/_includes/category-list.html index 97408c9c4fc3..ad9a3fc71423 100644 --- a/_includes/category-list.html +++ b/_includes/category-list.html @@ -6,20 +6,13 @@ {% endcase %} {% if site.category_archive.path %} - {% comment %} - - - {% 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 categories_sorted = page.categories | sort_natural %}

{{ site.data.ui-text[site.locale].categories_label | default: "Categories:" }} - {% for hash in category_hashes %} - {% assign keyValue = hash | split: '#' %} - {% capture category_word %}{{ keyValue[1] | strip_newlines }}{% endcapture %} - {% unless forloop.last %}, {% endunless %} + {% for category_word in categories_sorted %} + {% unless forloop.last %}, {% endunless %} {% endfor %}

diff --git a/_includes/comment.html b/_includes/comment.html index 7b33f46d52c0..2e3013ee2a76 100644 --- a/_includes/comment.html +++ b/_includes/comment.html @@ -1,9 +1,9 @@ -
+
{{ include.name }}
-

{{ comments_label }}

{% when "facebook" %}

{{ comments_label }}

- {% when "google-plus" %} -

{{ comments_label }}

-
Loading Google+ Comments ...
- - - - - + + + {% if site.head_scripts %} {% for script in site.head_scripts %} - {% if script contains "://" %} - {% capture script_path %}{{ script }}{% endcapture %} - {% else %} - {% capture script_path %}{{ script | absolute_url }}{% endcapture %} - {% endif %} - + {% endfor %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/_includes/head/custom.html b/_includes/head/custom.html index 0176731320fa..978d84fd8bdd 100644 --- a/_includes/head/custom.html +++ b/_includes/head/custom.html @@ -1,5 +1,5 @@ - + - \ No newline at end of file + diff --git a/_includes/masthead.html b/_includes/masthead.html index f3d8092e3b4a..c97b2aa34d0d 100644 --- a/_includes/masthead.html +++ b/_includes/masthead.html @@ -1,33 +1,39 @@ +{% capture logo_path %}{{ site.logo }}{% endcapture %} +
-
\ No newline at end of file +
diff --git a/_includes/nav_list b/_includes/nav_list index d264577a47cd..d25f9e9480bc 100644 --- a/_includes/nav_list +++ b/_includes/nav_list @@ -1,47 +1,27 @@ -{% assign navigation = site.data.navigation[include.nav] %} - \ No newline at end of file + diff --git a/_includes/page__date.html b/_includes/page__date.html new file mode 100644 index 000000000000..ec02005f1307 --- /dev/null +++ b/_includes/page__date.html @@ -0,0 +1,6 @@ +{% assign date_format = site.date_format | default: "%B %-d, %Y" %} +{% if page.last_modified_at %} +

{{ site.data.ui-text[site.locale].date_label | default: "Updated:" }}

+{% elsif page.date %} +

{{ site.data.ui-text[site.locale].date_label | default: "Updated:" }}

+{% endif %} \ No newline at end of file diff --git a/_includes/page__hero.html b/_includes/page__hero.html index b50ce76ad71a..ebc0b6b43068 100644 --- a/_includes/page__hero.html +++ b/_includes/page__hero.html @@ -1,25 +1,13 @@ -{% if page.header.image contains "://" %} - {% capture img_path %}{{ page.header.image }}{% endcapture %} -{% else %} - {% capture img_path %}{{ page.header.image | absolute_url }}{% endcapture %} -{% endif %} - -{% if page.header.cta_url contains "://" %} - {% capture cta_path %}{{ page.header.cta_url }}{% endcapture %} -{% else %} - {% capture cta_path %}{{ page.header.cta_url | absolute_url }}{% endcapture %} -{% endif %} +{% capture overlay_img_path %}{{ page.header.overlay_image | relative_url }}{% endcapture %} -{% 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 | absolute_url }}{% endcapture %} -{% endif %} - -{% if page.header.overlay_filter contains "rgba" %} +{% if page.header.overlay_filter contains "gradient" %} {% capture overlay_filter %}{{ page.header.overlay_filter }}{% endcapture %} +{% elsif page.header.overlay_filter contains "rgba" %} + {% capture overlay_filter %}{{ page.header.overlay_filter }}{% endcapture %} + {% capture overlay_filter %}linear-gradient({{ overlay_filter }}, {{ overlay_filter }}){% endcapture %} {% elsif page.header.overlay_filter %} {% capture overlay_filter %}rgba(0, 0, 0, {{ page.header.overlay_filter }}){% endcapture %} + {% capture overlay_filter %}linear-gradient({{ overlay_filter }}, {{ overlay_filter }}){% endcapture %} {% endif %} {% if page.header.image_description %} @@ -31,29 +19,33 @@ {% assign image_description = image_description | markdownify | strip_html | strip_newlines | escape_once %}
{% if page.header.overlay_color or page.header.overlay_image %}
-

+

{% if paginator and site.paginate_show_page_num %} {{ 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: "

" | remove: "

" }} {% endif %}

- {% if page.header.show_overlay_excerpt != false and page.excerpt %} + {% if page.tagline %} +

{{ page.tagline | markdownify | remove: "

" | remove: "

" }}

+ {% elsif page.header.show_overlay_excerpt != false and page.excerpt %}

{{ page.excerpt | markdownify | remove: "

" | remove: "

" }}

{% endif %} - {% if site.read_time and page.read_time %} -

{% include read-time.html %}

- {% endif %} - {% if page.header.cta_url %} -

{{ page.header.cta_label | default: site.data.ui-text[site.locale].more_label | default: "Learn More" }}

+ {% include page__meta.html %} + {% if page.header.actions %} +

+ {% for action in page.header.actions %} + {{ action.label | default: site.data.ui-text[site.locale].more_label | default: "Learn More" }} + {% endfor %} +

{% endif %}
{% else %} - {{ image_description }} + {{ image_description }} {% endif %} {% if page.header.caption %} {{ page.header.caption | markdownify | remove: "

" | remove: "

" }} diff --git a/_includes/page__hero_video.html b/_includes/page__hero_video.html index 8586a95a2b15..a313a23d45b9 100644 --- a/_includes/page__hero_video.html +++ b/_includes/page__hero_video.html @@ -1,4 +1,2 @@ -{% capture video_id %}{{ page.header.video.id }}{% endcapture %} -{% capture video_provider %}{{ page.header.video.provider }}{% endcapture %} - -{% include video id=video_id provider=video_provider %} +{% assign video = page.header.video %} +{% include video id=video.id provider=video.provider danmaku=video.danmaku %} diff --git a/_includes/page__meta.html b/_includes/page__meta.html new file mode 100644 index 000000000000..3d228c921205 --- /dev/null +++ b/_includes/page__meta.html @@ -0,0 +1,31 @@ +{% assign document = post | default: page %} +{% if document.read_time or document.show_date %} +

+ {% if document.show_date and document.date %} + {% assign date = document.date %} + + + {% assign date_format = site.date_format | default: "%B %-d, %Y" %} + + + {% endif %} + + {% if document.read_time and document.show_date %}{% endif %} + + {% if document.read_time %} + {% assign words_per_minute = document.words_per_minute | default: site.words_per_minute | default: 200 %} + {% assign words = document.content | strip_html | number_of_words %} + + + + {% if 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" }} + {% elsif words == words_per_minute %} + 1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }} + {% else %} + {{ words | divided_by: words_per_minute }} {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }} + {% endif %} + + {% endif %} +

+{% endif %} diff --git a/_includes/page__related.html b/_includes/page__related.html new file mode 100644 index 000000000000..9777865eeefd --- /dev/null +++ b/_includes/page__related.html @@ -0,0 +1,11 @@ +{% assign posts = include.posts | where_exp: "post", "post.hidden != true" %} +
+ {% include before-related.html %} +

{{ site.data.ui-text[site.locale].related_label | default: "You May Also Enjoy" }}

+
+ {% for post in posts limit:4 %} + {% if post.id == page.id %}{% continue %}{% endif %} + {% include archive-single.html type="grid" %} + {% endfor %} +
+
diff --git a/_includes/paginator-v1.html b/_includes/paginator-v1.html new file mode 100644 index 000000000000..c24d4909f488 --- /dev/null +++ b/_includes/paginator-v1.html @@ -0,0 +1,70 @@ +{% if paginator.total_pages > 1 %} + +{% endif %} diff --git a/_includes/paginator-v2.html b/_includes/paginator-v2.html new file mode 100644 index 000000000000..ea5707d56965 --- /dev/null +++ b/_includes/paginator-v2.html @@ -0,0 +1,68 @@ + diff --git a/_includes/paginator.html b/_includes/paginator.html index cf49ae8a2517..c4ab29edf29b 100644 --- a/_includes/paginator.html +++ b/_includes/paginator.html @@ -1,69 +1,7 @@ {% if paginator.total_pages > 1 %} - + {% if site.paginate %} + {% include paginator-v1.html %} + {% elsif site.pagination.enabled %} + {% include paginator-v2.html %} + {% endif %} {% endif %} diff --git a/_includes/post_pagination.html b/_includes/post_pagination.html index 3b8b61686621..47bae3c6ee40 100644 --- a/_includes/post_pagination.html +++ b/_includes/post_pagination.html @@ -1,14 +1,14 @@ {% if page.previous or page.next %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/_includes/posts-category.html b/_includes/posts-category.html new file mode 100644 index 000000000000..658f315104b2 --- /dev/null +++ b/_includes/posts-category.html @@ -0,0 +1,4 @@ +{% assign posts = site.categories[include.taxonomy] | where_exp: "post", "post.hidden != true" %} +{%- for post in posts -%} + {% include archive-single.html %} +{%- endfor -%} diff --git a/_includes/posts-tag.html b/_includes/posts-tag.html new file mode 100644 index 000000000000..a8fc472b443a --- /dev/null +++ b/_includes/posts-tag.html @@ -0,0 +1,4 @@ +{% assign posts = site.tags[include.taxonomy] | where_exp: "post", "post.hidden != true" %} +{%- for post in posts -%} + {% include archive-single.html %} +{%- endfor -%} diff --git a/_includes/posts-taxonomy.html b/_includes/posts-taxonomy.html new file mode 100644 index 000000000000..e99db65c875f --- /dev/null +++ b/_includes/posts-taxonomy.html @@ -0,0 +1,37 @@ +{% assign items_max = 0 %} +{% for item in include.taxonomies %} + {% if item[1].size > items_max %} + {% assign items_max = item[1].size %} + {% endif %} +{% endfor %} + +
    + {% for i in (1..items_max) reversed %} + {% for item in include.taxonomies %} + {% if item[1].size == i %} +
  • + + {{ item[0] }} {{ i }} + +
    • + {% endif %} + {% endfor %} + {% endfor %} +
+ +{% assign entries_layout = page.entries_layout | default: 'list' %} +{% for i in (1..items_max) reversed %} + {% for taxonomy in include.taxonomies %} + {% if taxonomy[1].size == i %} +
+

{{ taxonomy[0] }}

+
+ {% for post in taxonomy.last %} + {% include archive-single.html type=entries_layout %} + {% endfor %} +
+ {{ site.data.ui-text[site.locale].back_to_top | default: 'Back to Top' }} ↑ +
+ {% endif %} + {% endfor %} +{% endfor %} diff --git a/_includes/read-time.html b/_includes/read-time.html deleted file mode 100644 index df88d52926a3..000000000000 --- a/_includes/read-time.html +++ /dev/null @@ -1,15 +0,0 @@ -{% 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 %} - {{ site.data.ui-text[site.locale].less_than | default: "less than" }} 1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }} -{% elsif words == words_per_minute %} - 1 {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }} -{% else %} - {{ words | divided_by:words_per_minute }} {{ site.data.ui-text[site.locale].minute_read | default: "minute read" }} -{% endif %} \ No newline at end of file diff --git a/_includes/schema.html b/_includes/schema.html new file mode 100644 index 000000000000..1dae6e2d7243 --- /dev/null +++ b/_includes/schema.html @@ -0,0 +1,16 @@ + diff --git a/_includes/scripts.html b/_includes/scripts.html index ded8e7ba599f..bbdaddff0bab 100644 --- a/_includes/scripts.html +++ b/_includes/scripts.html @@ -1,26 +1,28 @@ {% if site.footer_scripts %} {% for script in site.footer_scripts %} - {% if script contains "://" %} - {% capture script_path %}{{ script }}{% endcapture %} - {% else %} - {% capture script_path %}{{ script | absolute_url }}{% endcapture %} - {% endif %} - + {% endfor %} {% else %} - - + {% 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 %} + {% include_cached search/lunr-search-scripts.html %} + {%- when "google" -%} + {% include_cached search/google-search-scripts.html %} {%- when "algolia" -%} - {% include search/algolia-search-scripts.html %} + {% include_cached search/algolia-search-scripts.html %} {%- endcase -%} {% endif %} {% include analytics.html %} {% include /comments-providers/scripts.html %} + +{% if site.after_footer_scripts %} + {% for script in site.after_footer_scripts %} + + {% endfor %} +{% endif %} diff --git a/_includes/search/algolia-search-scripts.html b/_includes/search/algolia-search-scripts.html index 1ec021df257e..f2e100224f97 100644 --- a/_includes/search/algolia-search-scripts.html +++ b/_includes/search/algolia-search-scripts.html @@ -1,54 +1,82 @@ - - - - - diff --git a/_includes/search/google-search-scripts.html b/_includes/search/google-search-scripts.html new file mode 100644 index 000000000000..4af7423bb3ca --- /dev/null +++ b/_includes/search/google-search-scripts.html @@ -0,0 +1,30 @@ + \ No newline at end of file diff --git a/_includes/search/lunr-search-scripts.html b/_includes/search/lunr-search-scripts.html index b8ffc23162ba..574c39009489 100644 --- a/_includes/search/lunr-search-scripts.html +++ b/_includes/search/lunr-search-scripts.html @@ -5,6 +5,6 @@ {% else %} {% assign lang = "en" %} {% endcase %} - - - \ No newline at end of file + + + \ No newline at end of file diff --git a/_includes/search/search_form.html b/_includes/search/search_form.html index 3058f6b14c7e..b9de365c6efe 100644 --- a/_includes/search/search_form.html +++ b/_includes/search/search_form.html @@ -1,11 +1,26 @@
-{%- assign search_provider = site.search_provider | default: "lunr" -%} -{%- case search_provider -%} + {%- assign search_provider = site.search_provider | default: "lunr" -%} + {%- case search_provider -%} {%- when "lunr" -%} - -
+ +
+ {%- when "google" -%} + +
+ +
{%- when "algolia" -%} -
-
-{%- endcase -%} -
\ No newline at end of file +
+
+ {%- endcase -%} +
diff --git a/_includes/seo.html b/_includes/seo.html index 2ac0b649a808..1e04a26174fa 100644 --- a/_includes/seo.html +++ b/_includes/seo.html @@ -1,52 +1,33 @@ -{%- if site.url -%} - {%- assign seo_url = site.url | append: site.baseurl -%} -{%- endif -%} -{%- assign seo_url = seo_url | default: site.github.url -%} - -{% if site.title_separator %} - {% assign title_separator = site.title_separator | default: '-' | replace: '|', '|' %} -{% endif %} +{%- assign title_separator = site.title_separator | default: '-' -%} -{%- if page.title -%} - {%- assign seo_title = page.title | append: " " | append: title_separator | append: " " | append: site.title -%} +{%- assign page_title = page.title | default: site.title | replace: '|', '|' -%} +{%- if page_title contains site.title -%} + {%- assign seo_title = page_title | replace: '|', '|' -%} +{%- else -%} + {%- assign seo_title = page_title | append: " " | append: title_separator | append: " " | append: site.title | replace: '|', '|' -%} {%- endif -%} -{%- if seo_title -%} - {%- assign seo_title = seo_title | markdownify | strip_html | strip_newlines | escape_once -%} -{%- endif -%} +{%- assign page_title = page_title | markdownify | strip_html | strip_newlines | escape_once -%} +{%- assign seo_title = seo_title | markdownify | strip_html | strip_newlines | escape_once -%} -{%- assign canonical_url = page.url | replace: "index.html", "" | absolute_url %} +{%- assign canonical_url = page.canonical_url | default: page.url | replace: "/index.html", "/" | absolute_url %} {%- assign seo_description = page.description | default: page.excerpt | default: site.description -%} {%- if seo_description -%} - {%- assign seo_description = seo_description | markdownify | strip_html | strip_newlines | escape_once -%} + {%- assign seo_description = seo_description | markdownify | strip_html | newline_to_br | strip_newlines | replace: '
', ' ' | escape_once | strip -%} {%- endif -%} -{%- assign author = page.author | default: page.authors[0] | default: site:author -%} +{%- assign author = page.author | default: page.authors[0] | default: site.author -%} {%- assign author = site.data.authors[author] | default: author -%} {%- if author.twitter -%} {%- assign author_twitter = author.twitter | replace: "@", "" -%} {%- endif -%} -{%- assign page_large_image = page.header.og_image | default: page.header.overlay_image | default: page.header.image -%} -{%- unless page_large_image contains '://' -%} - {%- assign page_large_image = page_large_image | absolute_url -%} -{%- endunless -%} -{%- assign page_large_image = page_large_image | escape -%} - -{%- assign page_teaser_image = page.header.teaser | default: site.og_image -%} -{%- unless page_teaser_image contains '://' -%} - {%- assign page_teaser_image = page_teaser_image | absolute_url -%} -{%- endunless -%} -{%- assign page_teaser_image = page_teaser_image | escape -%} - -{%- assign site_og_image = site.og_image -%} -{%- unless site_og_image contains '://' -%} - {%- assign site_og_image = site_og_image | absolute_url -%} -{%- endunless -%} -{%- assign site_og_image = site_og_image | escape -%} +{%- assign page_large_image = page.header.og_image | default: page.header.overlay_image | default: page.header.image | absolute_url | escape -%} +{%- assign page_teaser_image = page.header.teaser | default: site.og_image | absolute_url | escape -%} +{%- assign site_og_image = site.og_image | absolute_url | escape -%} {%- if page.date -%} {%- assign og_type = "article" -%} @@ -54,20 +35,23 @@ {%- assign og_type = "website" -%} {%- endif -%} -{{ seo_title | default: site.title }}{% if paginator %}{% unless paginator.page == 1 %} {{ title_separator }} {{ site.data.ui-text[site.locale].page | default: "Page" }} {{ paginator.page }}{% endunless %}{% endif %} +{{ seo_title }}{% if paginator %}{% unless paginator.page == 1 %} {{ title_separator }} {{ site.data.ui-text[site.locale].page | default: "Page" }} {{ paginator.page }}{% endunless %}{% endif %} {% if author.name %} - + + {% if og_type == "article" %} + + {% endif %} {% endif %} - - + + -{% if page.excerpt %} +{% if seo_description %} {% endif %} @@ -79,7 +63,7 @@ {% if site.twitter.username %} - + @@ -125,27 +109,8 @@ {% endif %} -{% if site.og_image %} - -{% endif %} - -{% if site.social %} - +{% if page.url == '/' %} + {% include schema.html %} {% endif %} {% if site.google_site_verification %} @@ -160,7 +125,10 @@ {% if site.yandex_site_verification %} {% endif %} -{% if site.naver-site-verification %} - +{% if site.naver_site_verification %} + +{% endif %} +{% if site.baidu_site_verification %} + {% endif %} diff --git a/_includes/sidebar.html b/_includes/sidebar.html index d2661c385f3b..a4ca1ca78151 100644 --- a/_includes/sidebar.html +++ b/_includes/sidebar.html @@ -4,20 +4,16 @@ {% if page.sidebar %} {% for s in page.sidebar %} {% if s.image %} - {% if s.image_alt %}{{ s.image_alt }}{% endif %} + {% if s.image_alt %}{{ s.image_alt }}{% endif %} {% endif %} {% if s.title %}

{{ s.title }}

{% endif %} {% if s.text %}{{ s.text | markdownify }}{% endif %} + {% if s.nav %}{% include nav_list nav=s.nav %}{% endif %} {% endfor %} {% if page.sidebar.nav %} {% include nav_list nav=page.sidebar.nav %} {% endif %} {% endif %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/_includes/skip-links.html b/_includes/skip-links.html new file mode 100644 index 000000000000..c2d52235e14f --- /dev/null +++ b/_includes/skip-links.html @@ -0,0 +1,7 @@ + diff --git a/_includes/social-share.html b/_includes/social-share.html index 10161aa01fec..8a1423638bfb 100644 --- a/_includes/social-share.html +++ b/_includes/social-share.html @@ -1,13 +1,19 @@ diff --git a/_includes/tag-list.html b/_includes/tag-list.html index 4bd97d7c4830..5893ee4e4d46 100644 --- a/_includes/tag-list.html +++ b/_includes/tag-list.html @@ -6,20 +6,13 @@ {% endcase %} {% if site.tag_archive.path %} - {% comment %} - - - {% endcomment %} - {% capture page_tags %}{% for tag in page.tags %}{{ tag | downcase }}#{{ tag }}{% unless forloop.last %},{% endunless %}{% endfor %}{% endcapture %} - {% assign tag_hashes = page_tags | split: ',' | sort %} + {% assign tags_sorted = page.tags | sort_natural %}

{{ site.data.ui-text[site.locale].tags_label | default: "Tags:" }} - {% for hash in tag_hashes %} - {% assign keyValue = hash | split: '#' %} - {% capture tag_word %}{{ keyValue[1] | strip_newlines }}{% endcapture %} - {% unless forloop.last %}, {% endunless %} + {% for tag_word in tags_sorted %} + {% unless forloop.last %}, {% endunless %} {% endfor %}

diff --git a/_includes/toc.html b/_includes/toc.html index 27023f7186b8..bc90d08a994b 100644 --- a/_includes/toc.html +++ b/_includes/toc.html @@ -1,6 +1,31 @@ {% capture tocWorkspace %} - {%- comment -%} - Version 1.0.2 + {% comment %} + Copyright (c) 2017 Vladimir "allejo" Jimenez + + 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. + {% endcomment %} + {% comment %} + Version 1.2.1 + https://github.com/allejo/jekyll-toc "...like all things liquid - where there's a will, and ~36 hours to spare, there's usually a/some way" ~jaybe @@ -8,68 +33,157 @@ {% include toc.html html=content sanitize=true class="inline_toc" id="my_toc" h_min=2 h_max=3 %} Parameters: - * html (string) - the HTML of compiled markdown generated by kramdown in Jekyll + * html (string) - the HTML of compiled markdown generated by kramdown in Jekyll Optional Parameters: - * sanitize (bool) : false - when set to true, the headers will be stripped of any HTML in the TOC - * class (string) : '' - a CSS class assigned to the TOC - * id (string) : '' - an ID to assigned to the TOC - * h_min (int) : 1 - the minimum TOC header level to use; any header lower than this value will be ignored - * h_max (int) : 6 - the maximum TOC header level to use; any header greater than this value will be ignored + * sanitize (bool) : false - when set to true, the headers will be stripped of any HTML in the TOC + * class (string) : '' - a CSS class assigned to the TOC + * id (string) : '' - an ID to assigned to the TOC + * h_min (int) : 1 - the minimum TOC header level to use; any header lower than this value will be ignored + * h_max (int) : 6 - the maximum TOC header level to use; any header greater than this value will be ignored + * ordered (bool) : false - when set to true, an ordered list will be outputted instead of an unordered list + * item_class (string) : '' - add custom class(es) for each list item; has support for '%level%' placeholder, which is the current heading level + * submenu_class (string) : '' - add custom class(es) for each child group of headings; has support for '%level%' placeholder which is the current "submenu" heading level + * base_url (string) : '' - add a base url to the TOC links for when your TOC is on another page than the actual content + * anchor_class (string) : '' - add custom class(es) for each anchor element + * skip_no_ids (bool) : false - skip headers that do not have an `id` attribute + * flat_toc (bool) : false - when set to true, the TOC will be a single level list Output: - An unordered list representing the table of contents of a markdown block. This snippet will only generate the table of contents and will NOT output the markdown given to it - {%- endcomment -%} + An ordered or unordered list representing the table of contents of a markdown block. This snippet will only + generate the table of contents and will NOT output the markdown given to it + {% endcomment %} - {% capture my_toc %}{% endcapture %} + {% capture newline %} + {% endcapture %} + {% assign newline = newline | rstrip %} + + {% capture deprecation_warnings %}{% endcapture %} + + {% if include.baseurl %} + {% capture deprecation_warnings %}{{ deprecation_warnings }}{{ newline }}{% endcapture %} + {% endif %} + + {% if include.skipNoIDs %} + {% capture deprecation_warnings %}{{ deprecation_warnings }}{{ newline }}{% endcapture %} + {% endif %} + + {% capture jekyll_toc %}{% endcapture %} + {% assign orderedList = include.ordered | default: false %} + {% assign flatToc = include.flat_toc | default: false %} + {% assign baseURL = include.base_url | default: include.baseurl | default: '' %} + {% assign skipNoIDs = include.skip_no_ids | default: include.skipNoIDs | default: false %} {% assign minHeader = include.h_min | default: 1 %} {% assign maxHeader = include.h_max | default: 6 %} - {% assign nodes = include.html | split: ' maxHeader %} + {% if currLevel < minHeader or currLevel > maxHeader %} {% continue %} {% endif %} - {% if firstHeader %} - {% assign firstHeader = false %} - {% assign minHeader = headerLevel %} - {% endif %} - - {% assign indentAmount = headerLevel | minus: minHeader | add: 1 %} {% assign _workspace = node | split: '' | first }}>{% endcapture %} {% assign header = _workspace[0] | replace: _hAttrToStrip, '' %} - {% assign space = '' %} - {% for i in (1..indentAmount) %} - {% assign space = space | prepend: ' ' %} - {% endfor %} + {% if include.item_class and include.item_class != blank %} + {% capture listItemClass %} class="{{ include.item_class | replace: '%level%', currLevel | split: '.' | join: ' ' }}"{% endcapture %} + {% endif %} + + {% if include.submenu_class and include.submenu_class != blank %} + {% assign subMenuLevel = currLevel | minus: 1 %} + {% capture subMenuClass %} class="{{ include.submenu_class | replace: '%level%', subMenuLevel | split: '.' | join: ' ' }}"{% endcapture %} + {% endif %} + + {% capture anchorBody %}{% if include.sanitize %}{{ header | strip_html }}{% else %}{{ header }}{% endif %}{% endcapture %} + + {% if htmlID %} + {% capture anchorAttributes %} href="{% if baseURL %}{{ baseURL }}{% endif %}#{{ htmlID }}"{% endcapture %} + + {% if include.anchor_class %} + {% capture anchorAttributes %}{{ anchorAttributes }} class="{{ include.anchor_class | split: '.' | join: ' ' }}"{% endcapture %} + {% endif %} - {% capture my_toc %}{{ my_toc }} -{{ space }}- [{% if include.sanitize %}{{ header | strip_html }}{% else %}{{ header }}{% endif %}](#{{ html_id }}){% endcapture %} + {% capture listItem %}{{ anchorBody }}{% endcapture %} + {% elsif skipNoIDs == true %} + {% continue %} + {% else %} + {% capture listItem %}{{ anchorBody }}{% endcapture %} + {% endif %} + + {% if currLevel > lastLevel and flatToc == false %} + {% capture jekyll_toc %}{{ jekyll_toc }}<{{ listModifier }}{{ subMenuClass }}>{% endcapture %} + {% elsif currLevel < lastLevel and flatToc == false %} + {% assign repeatCount = lastLevel | minus: currLevel %} + {% for i in (1..repeatCount) %} + {% capture jekyll_toc %}{{ jekyll_toc }}{% endcapture %} + {% endfor %} + + {% capture jekyll_toc %}{{ jekyll_toc }}{% endcapture %} + {% else %} + {% capture jekyll_toc %}{{ jekyll_toc }}{% endcapture %} + {% endif %} + + {% capture jekyll_toc %}{{ jekyll_toc }}{{ listItem }}{% endcapture %} + + {% assign lastLevel = currLevel %} + {% assign firstHeader = false %} {% endfor %} - {% if include.class %} - {% capture my_toc %}{:.{{ include.class }}} -{{ my_toc | lstrip }}{% endcapture %} + {% if flatToc == true %} + {% assign repeatCount = 1 %} + {% else %} + {% assign repeatCount = minHeader | minus: 1 %} + {% assign repeatCount = lastLevel | minus: repeatCount %} {% endif %} - {% if include.id %} - {% capture my_toc %}{: #{{ include.id }}} -{{ my_toc | lstrip }}{% endcapture %} + {% for i in (1..repeatCount) %} + {% capture jekyll_toc %}{{ jekyll_toc }}{% endcapture %} + {% endfor %} + + {% if jekyll_toc != '' %} + {% assign rootAttributes = '' %} + {% if include.class and include.class != blank %} + {% capture rootAttributes %} class="{{ include.class | split: '.' | join: ' ' }}"{% endcapture %} + {% endif %} + + {% if include.id and include.id != blank %} + {% capture rootAttributes %}{{ rootAttributes }} id="{{ include.id }}"{% endcapture %} + {% endif %} + + {% if rootAttributes %} + {% assign nodes = jekyll_toc | split: '>' %} + {% capture jekyll_toc %}<{{ listModifier }}{{ rootAttributes }}>{{ nodes | shift | join: '>' }}>{% endcapture %} + {% endif %} {% endif %} -{% endcapture %}{% assign tocWorkspace = '' %}{{ my_toc | markdownify | strip }} \ No newline at end of file +{% endcapture %}{% assign tocWorkspace = '' %}{{ deprecation_warnings }}{{ jekyll_toc -}} diff --git a/_includes/video b/_includes/video index 01b58ddac4d0..c85a868c1d0b 100644 --- a/_includes/video +++ b/_includes/video @@ -1,11 +1,24 @@ {% capture video_id %}{{ include.id }}{% endcapture %} {% capture video_provider %}{{ include.provider }}{% endcapture %} +{% capture video_danmaku %}{{ include.danmaku | default: 0 }}{% endcapture %} - -
-{% if video_provider == "vimeo" %} - -{% elsif video_provider == "youtube" %} - -{% endif %} -
+{% capture video_src %} + {% case video_provider %} + {% when "vimeo" %} + https://player.vimeo.com/video/{{ video_id }}?dnt=true + {% when "youtube" %} + https://www.youtube-nocookie.com/embed/{{ video_id }} + {% when "google-drive" %} + https://drive.google.com/file/d/{{ video_id }}/preview + {% when "bilibili" %} + https://player.bilibili.com/player.html?bvid={{ video_id }}&page=1&as_wide=1&high_quality=1&danmaku={{ video_danmaku }} + {% endcase %} +{% endcapture %} +{% assign video_src = video_src | strip %} + + +{% unless video_src == "" %} +
+ +
+{% endunless %} diff --git a/_layouts/archive-taxonomy.html b/_layouts/archive-taxonomy.html index 6939122d856b..4e94867df655 100644 --- a/_layouts/archive-taxonomy.html +++ b/_layouts/archive-taxonomy.html @@ -3,13 +3,27 @@ author_profile: false --- +{% if page.header.overlay_color or page.header.overlay_image or page.header.image %} + {% include page__hero.html %} +{% elsif page.header.video.id and page.header.video.provider %} + {% include page__hero_video.html %} +{% endif %} + +{% if page.url != "/" and site.breadcrumbs %} + {% unless paginator %} + {% include breadcrumbs.html %} + {% endunless %} +{% endif %} +
{% include sidebar.html %}
-

{{ page.title }}

+ {% unless page.header.overlay_color or page.header.overlay_image %} +

{{ page.title }}

+ {% endunless %} {% for post in page.posts %} {% include archive-single.html %} {% endfor %}
-
\ No newline at end of file + diff --git a/_layouts/archive.html b/_layouts/archive.html index 2784f67c17b2..83e109b58cb4 100644 --- a/_layouts/archive.html +++ b/_layouts/archive.html @@ -19,8 +19,8 @@
{% unless page.header.overlay_color or page.header.overlay_image %} -

{{ page.title }}

+

{{ page.title }}

{% endunless %} {{ content }}
- \ No newline at end of file + diff --git a/_layouts/categories.html b/_layouts/categories.html new file mode 100644 index 000000000000..4d3661188982 --- /dev/null +++ b/_layouts/categories.html @@ -0,0 +1,7 @@ +--- +layout: archive +--- + +{{ content }} + +{% include posts-taxonomy.html taxonomies=site.categories %} diff --git a/_layouts/category.html b/_layouts/category.html new file mode 100644 index 000000000000..b281c8560395 --- /dev/null +++ b/_layouts/category.html @@ -0,0 +1,10 @@ +--- +layout: archive +--- + +{{ content }} + +{% assign entries_layout = page.entries_layout | default: 'list' %} +
+ {% include posts-category.html taxonomy=page.taxonomy type=entries_layout %} +
diff --git a/_layouts/collection.html b/_layouts/collection.html new file mode 100644 index 000000000000..d23d0c723bf4 --- /dev/null +++ b/_layouts/collection.html @@ -0,0 +1,10 @@ +--- +layout: archive +--- + +{{ content }} + +{% assign entries_layout = page.entries_layout | default: 'list' %} +
+ {% include documents-collection.html collection=page.collection sort_by=page.sort_by sort_order=page.sort_order type=entries_layout %} +
diff --git a/_layouts/compress.html b/_layouts/compress.html index 8248010b4a80..bb34487d2a75 100644 --- a/_layouts/compress.html +++ b/_layouts/compress.html @@ -1,10 +1,10 @@ --- # Jekyll layout that compresses HTML -# v3.0.2 +# v3.1.0 # http://jch.penibelst.de/ # © 2014–2015 Anatol Broder # MIT License --- {% capture _LINE_FEED %} -{% endcapture %}{% if site.compress_html.ignore.envs contains jekyll.environment %}{{ content }}{% else %}{% capture _content %}{{ content }}{% endcapture %}{% assign _profile = site.compress_html.profile %}{% if site.compress_html.endings == "all" %}{% assign _endings = "html head body li dt dd p rt rp optgroup option colgroup caption thead tbody tfoot tr td th" | split: " " %}{% else %}{% assign _endings = site.compress_html.endings %}{% endif %}{% for _element in _endings %}{% capture _end %}{% endcapture %}{% assign _content = _content | remove: _end %}{% endfor %}{% if _profile and _endings %}{% assign _profile_endings = _content | size | plus: 1 %}{% endif %}{% for _element in site.compress_html.startings %}{% capture _start %}<{{ _element }}>{% endcapture %}{% assign _content = _content | remove: _start %}{% endfor %}{% if _profile and site.compress_html.startings %}{% assign _profile_startings = _content | size | plus: 1 %}{% endif %}{% if site.compress_html.comments == "all" %}{% assign _comments = "" | split: " " %}{% else %}{% assign _comments = site.compress_html.comments %}{% endif %}{% if _comments.size == 2 %}{% capture _comment_befores %}.{{ _content }}{% endcapture %}{% assign _comment_befores = _comment_befores | split: _comments.first %}{% for _comment_before in _comment_befores %}{% if forloop.first %}{% continue %}{% endif %}{% capture _comment_outside %}{% if _carry %}{{ _comments.first }}{% endif %}{{ _comment_before }}{% endcapture %}{% capture _comment %}{% unless _carry %}{{ _comments.first }}{% endunless %}{{ _comment_outside | split: _comments.last | first }}{% if _comment_outside contains _comments.last %}{{ _comments.last }}{% assign _carry = false %}{% else %}{% assign _carry = true %}{% endif %}{% endcapture %}{% assign _content = _content | remove_first: _comment %}{% endfor %}{% if _profile %}{% assign _profile_comments = _content | size | plus: 1 %}{% endif %}{% endif %}{% assign _pre_befores = _content | split: "" %}{% assign _pres_after = "" %}{% if _pres.size != 0 %}{% if site.compress_html.blanklines %}{% assign _lines = _pres.last | split: _LINE_FEED %}{% capture _pres_after %}{% for _line in _lines %}{% assign _trimmed = _line | split: " " | join: " " %}{% if _trimmed != empty or forloop.last %}{% unless forloop.first %}{{ _LINE_FEED }}{% endunless %}{{ _line }}{% endif %}{% endfor %}{% endcapture %}{% else %}{% assign _pres_after = _pres.last | split: " " | join: " " %}{% endif %}{% endif %}{% capture _content %}{{ _content }}{% if _pre_before contains "" %}{% endif %}{% unless _pre_before contains "" and _pres.size == 1 %}{{ _pres_after }}{% endunless %}{% endcapture %}{% endfor %}{% if _profile %}{% assign _profile_collapse = _content | size | plus: 1 %}{% endif %}{% if site.compress_html.clippings == "all" %}{% assign _clippings = "html head title base link meta style body article section nav aside h1 h2 h3 h4 h5 h6 hgroup header footer address p hr blockquote ol ul li dl dt dd figure figcaption main div table caption colgroup col tbody thead tfoot tr td th" | split: " " %}{% else %}{% assign _clippings = site.compress_html.clippings %}{% endif %}{% for _element in _clippings %}{% assign _edges = " ;; ;" | replace: "e", _element | split: ";" %}{% assign _content = _content | replace: _edges[0], _edges[1] | replace: _edges[2], _edges[3] | replace: _edges[4], _edges[5] %}{% endfor %}{% if _profile and _clippings %}{% assign _profile_clippings = _content | size | plus: 1 %}{% endif %}{{ _content }}{% if _profile %}
Step Bytes
raw {{ content | size }}{% if _profile_endings %}
endings {{ _profile_endings }}{% endif %}{% if _profile_startings %}
startings {{ _profile_startings }}{% endif %}{% if _profile_comments %}
comments {{ _profile_comments }}{% endif %}{% if _profile_collapse %}
collapse {{ _profile_collapse }}{% endif %}{% if _profile_clippings %}
clippings {{ _profile_clippings }}{% endif %}
{% endif %}{% endif %} +{% endcapture %}{% if site.compress_html.ignore.envs contains jekyll.environment or site.compress_html.ignore.envs == "all" %}{{ content }}{% else %}{% capture _content %}{{ content }}{% endcapture %}{% assign _profile = site.compress_html.profile %}{% if site.compress_html.endings == "all" %}{% assign _endings = "html head body li dt dd optgroup option colgroup caption thead tbody tfoot tr td th" | split: " " %}{% else %}{% assign _endings = site.compress_html.endings %}{% endif %}{% for _element in _endings %}{% capture _end %}{% endcapture %}{% assign _content = _content | remove: _end %}{% endfor %}{% if _profile and _endings %}{% assign _profile_endings = _content | size | plus: 1 %}{% endif %}{% for _element in site.compress_html.startings %}{% capture _start %}<{{ _element }}>{% endcapture %}{% assign _content = _content | remove: _start %}{% endfor %}{% if _profile and site.compress_html.startings %}{% assign _profile_startings = _content | size | plus: 1 %}{% endif %}{% if site.compress_html.comments == "all" %}{% assign _comments = "" | split: " " %}{% else %}{% assign _comments = site.compress_html.comments %}{% endif %}{% if _comments.size == 2 %}{% capture _comment_befores %}.{{ _content }}{% endcapture %}{% assign _comment_befores = _comment_befores | split: _comments.first %}{% for _comment_before in _comment_befores %}{% if forloop.first %}{% continue %}{% endif %}{% capture _comment_outside %}{% if _carry %}{{ _comments.first }}{% endif %}{{ _comment_before }}{% endcapture %}{% capture _comment %}{% unless _carry %}{{ _comments.first }}{% endunless %}{{ _comment_outside | split: _comments.last | first }}{% if _comment_outside contains _comments.last %}{{ _comments.last }}{% assign _carry = false %}{% else %}{% assign _carry = true %}{% endif %}{% endcapture %}{% assign _content = _content | remove_first: _comment %}{% endfor %}{% if _profile %}{% assign _profile_comments = _content | size | plus: 1 %}{% endif %}{% endif %}{% assign _pre_befores = _content | split: "" %}{% assign _pres_after = "" %}{% if _pres.size != 0 %}{% if site.compress_html.blanklines %}{% assign _lines = _pres.last | split: _LINE_FEED %}{% capture _pres_after %}{% for _line in _lines %}{% assign _trimmed = _line | split: " " | join: " " %}{% if _trimmed != empty or forloop.last %}{% unless forloop.first %}{{ _LINE_FEED }}{% endunless %}{{ _line }}{% endif %}{% endfor %}{% endcapture %}{% else %}{% assign _pres_after = _pres.last | split: " " | join: " " %}{% endif %}{% endif %}{% capture _content %}{{ _content }}{% if _pre_before contains "" %}{% endif %}{% unless _pre_before contains "" and _pres.size == 1 %}{{ _pres_after }}{% endunless %}{% endcapture %}{% endfor %}{% if _profile %}{% assign _profile_collapse = _content | size | plus: 1 %}{% endif %}{% if site.compress_html.clippings == "all" %}{% assign _clippings = "html head title base link meta style body article section nav aside h1 h2 h3 h4 h5 h6 hgroup header footer address p hr blockquote ol ul li dl dt dd figure figcaption main div table caption colgroup col tbody thead tfoot tr td th" | split: " " %}{% else %}{% assign _clippings = site.compress_html.clippings %}{% endif %}{% for _element in _clippings %}{% assign _edges = " ;; ;" | replace: "e", _element | split: ";" %}{% assign _content = _content | replace: _edges[0], _edges[1] | replace: _edges[2], _edges[3] | replace: _edges[4], _edges[5] %}{% endfor %}{% if _profile and _clippings %}{% assign _profile_clippings = _content | size | plus: 1 %}{% endif %}{{ _content }}{% if _profile %}
Step Bytes
raw {{ content | size }}{% if _profile_endings %}
endings {{ _profile_endings }}{% endif %}{% if _profile_startings %}
startings {{ _profile_startings }}{% endif %}{% if _profile_comments %}
comments {{ _profile_comments }}{% endif %}{% if _profile_collapse %}
collapse {{ _profile_collapse }}{% endif %}{% if _profile_clippings %}
clippings {{ _profile_clippings }}{% endif %}
{% endif %}{% endif %} diff --git a/_layouts/default.html b/_layouts/default.html index 9264900a3f8c..ecfc46620257 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -2,41 +2,35 @@ --- - - +{% include copyright.html %} + {% include head.html %} {% include head/custom.html %} - - - {% include browser-upgrade.html %} - {% include masthead.html %} + + {% include_cached skip-links.html %} + {% include_cached masthead.html %}
{{ content }} + {% include after-content.html %}
{% if site.search == true %}
- {% include search/search_form.html %} + {% include_cached search/search_form.html %}
{% endif %} -
+
{% include footer/custom.html %} - {% include footer.html %} + {% include_cached footer.html %}
{% include scripts.html %} - - \ No newline at end of file + diff --git a/_layouts/home.html b/_layouts/home.html index bcce92aba457..384a4d9a3bb7 100644 --- a/_layouts/home.html +++ b/_layouts/home.html @@ -2,10 +2,19 @@ layout: archive --- +{{ content }} +

{{ site.data.ui-text[site.locale].recent_posts | default: "Recent Posts" }}

-{% for post in paginator.posts %} - {% include archive-single.html %} -{% endfor %} +{% if paginator %} + {% assign posts = paginator.posts %} +{% else %} + {% assign posts = site.posts %} +{% endif %} + +{% assign entries_layout = page.entries_layout | default: 'list' %} +
+ {% include documents-collection.html entries=posts type=entries_layout %} +
{% include paginator.html %} diff --git a/_layouts/posts.html b/_layouts/posts.html new file mode 100644 index 000000000000..13fc707cf00a --- /dev/null +++ b/_layouts/posts.html @@ -0,0 +1,30 @@ +--- +layout: archive +--- + +{{ content }} + +
    + {% assign postsInYear = site.posts | where_exp: "item", "item.hidden != true" | group_by_exp: 'post', 'post.date | date: "%Y"' %} + {% for year in postsInYear %} +
  • + + {{ year.name }} {{ year.items | size }} + +
    • + {% endfor %} +
+ +{% assign entries_layout = page.entries_layout | default: 'list' %} +{% assign postsByYear = site.posts | where_exp: "item", "item.hidden != true" | group_by_exp: 'post', 'post.date | date: "%Y"' %} +{% for year in postsByYear %} +
+

{{ year.name }}

+
+ {% for post in year.items %} + {% include archive-single.html type=entries_layout %} + {% endfor %} +
+ {{ site.data.ui-text[site.locale].back_to_top | default: 'Back to Top' }} ↑ +
+{% endfor %} diff --git a/_layouts/search.html b/_layouts/search.html index 1bac452c4dc1..da8784350fd6 100644 --- a/_layouts/search.html +++ b/_layouts/search.html @@ -17,7 +17,7 @@
{% unless page.header.overlay_color or page.header.overlay_image %} -

{{ page.title }}

+

{{ page.title }}

{% endunless %} {{ content }} @@ -25,8 +25,15 @@

{{ page.title }}

{%- assign search_provider = site.search_provider | default: "lunr" -%} {%- case search_provider -%} {%- when "lunr" -%} - +
+ {%- when "google" -%} +
+ +
+
+ +
{%- when "algolia" -%}
diff --git a/_layouts/single.html b/_layouts/single.html index 4f4372b4759e..21cd71144b56 100644 --- a/_layouts/single.html +++ b/_layouts/single.html @@ -8,7 +8,11 @@ {% include page__hero_video.html %} {% endif %} -{% if page.url != "/" and site.breadcrumbs %} +{% assign breadcrumbs_enabled = site.breadcrumbs %} +{% if page.breadcrumbs != null %} + {% assign breadcrumbs_enabled = page.breadcrumbs %} +{% endif %} +{% if page.url != "/" and breadcrumbs_enabled %} {% unless paginator %} {% include breadcrumbs.html %} {% endunless %} @@ -17,28 +21,30 @@
{% include sidebar.html %} -
- {% if page.title %}{% endif %} +
+ {% if page.title %}{% endif %} {% if page.excerpt %}{% endif %} - {% if page.date %}{% endif %} - {% if page.last_modified_at %}{% endif %} + {% if page.date %}{% endif %} + {% if page.last_modified_at %}{% endif %}
{% unless page.header.overlay_color or page.header.overlay_image %}
- {% if page.title %}

{{ page.title | markdownify | remove: "

" | remove: "

" }}

{% endif %} - {% if page.read_time %} -

{% include read-time.html %}

- {% endif %} + {% if page.title -%} +

+ +

+ {%- endif %} + {% include page__meta.html %}
{% endunless %}
{% if page.toc %} -
{% comment %}{% endcomment %} {% if page.id and page.related and site.related_posts.size > 0 %} -
-

{{ site.data.ui-text[site.locale].related_label | default: "You May Also Enjoy" }}

-
- {% for post in site.related_posts limit:4 %} - {% include archive-single.html type="grid" %} - {% endfor %} -
-
+ {% include page__related.html posts=site.related_posts %} {% comment %}{% endcomment %} {% elsif page.id and page.related %} -
-

{{ site.data.ui-text[site.locale].related_label | default: "You May Also Enjoy" }}

-
- {% for post in site.posts limit:4 %} - {% include archive-single.html type="grid" %} - {% endfor %} -
-
+ {% include page__related.html posts=site.posts %} {% endif %}
diff --git a/_layouts/splash.html b/_layouts/splash.html index c9cc6998002f..394209d8c512 100644 --- a/_layouts/splash.html +++ b/_layouts/splash.html @@ -9,14 +9,14 @@ {% endif %}
-
+
{% if page.title %}{% endif %} {% if page.excerpt %}{% endif %} - {% if page.date %}{% endif %} - {% if page.last_modified_at %}{% endif %} + {% if page.date %}{% endif %} + {% if page.last_modified_at %}{% endif %}
{{ content }}
-
\ No newline at end of file +
diff --git a/_layouts/tag.html b/_layouts/tag.html new file mode 100644 index 000000000000..8b1c1885004f --- /dev/null +++ b/_layouts/tag.html @@ -0,0 +1,10 @@ +--- +layout: archive +--- + +{{ content }} + +{% assign entries_layout = page.entries_layout | default: 'list' %} +
+ {% include posts-tag.html taxonomy=page.taxonomy type=entries_layout %} +
diff --git a/_layouts/tags.html b/_layouts/tags.html new file mode 100644 index 000000000000..a28fa5d709c6 --- /dev/null +++ b/_layouts/tags.html @@ -0,0 +1,7 @@ +--- +layout: archive +--- + +{{ content }} + +{% include posts-taxonomy.html taxonomies=site.tags %} diff --git a/_sass/minimal-mistakes.scss b/_sass/minimal-mistakes.scss index 225bf85b9bf7..ba9d13d5df2f 100644 --- a/_sass/minimal-mistakes.scss +++ b/_sass/minimal-mistakes.scss @@ -1,8 +1,5 @@ -/*! - * Minimal Mistakes Jekyll Theme 4.10.0 by Michael Rose - * Copyright 2013-2018 Michael Rose - mademistakes.com | @mmistakes - * Licensed under MIT (https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE.txt) -*/ +/* Copyright comment */ +@import "minimal-mistakes/copyright"; /* Variables */ @import "minimal-mistakes/variables"; diff --git a/_sass/minimal-mistakes/_archive.scss b/_sass/minimal-mistakes/_archive.scss index f95cd4cdcbec..aee718909418 100644 --- a/_sass/minimal-mistakes/_archive.scss +++ b/_sass/minimal-mistakes/_archive.scss @@ -3,22 +3,36 @@ ========================================================================== */ .archive { + margin-top: 1em; margin-bottom: 2em; @include breakpoint($large) { - float: right; + float: inline-end; width: calc(100% - #{$right-sidebar-width-narrow}); - padding-right: $right-sidebar-width-narrow; + padding-inline-end: $right-sidebar-width-narrow; } @include breakpoint($x-large) { width: calc(100% - #{$right-sidebar-width}); - padding-right: $right-sidebar-width; + padding-inline-end: $right-sidebar-width; + } +} + +.archive__item { + position: relative; + + a { + position: relative; + z-index: 10; + } + + a[rel="permalink"] { + position: static; } } .archive__subtitle { - margin: 1.414em 0 0; + margin: 1.414em 0 0.5em; padding-bottom: 0.5em; font-size: $type-size-5; color: $muted-text-color; @@ -36,8 +50,10 @@ overflow: hidden; text-overflow: ellipsis; - a { - color: inherit; + a[rel="permalink"]::before { + content: ''; + position: absolute; + inset: 0; } a + a { @@ -60,16 +76,47 @@ & + p { text-indent: 0; } + + a { + position: relative; + } } .archive__item-teaser { + position: relative; border-radius: $border-radius; overflow: hidden; + img { width: 100%; } } +.archive__item-caption { + position: absolute; + bottom: 0; + inset-inline-end: 0; + margin: 0 auto; + padding: 2px 5px; + color: #fff; + font-family: $caption-font-family; + font-size: $type-size-8; + background: #000; + text-align: end; + z-index: 5; + opacity: 0.5; + border-radius: $border-radius 0 0 0; + + @include breakpoint($large) { + padding: 5px 10px; + } + + a { + color: #fff; + text-decoration: none; + } +} + /* List view ========================================================================== */ @@ -90,11 +137,11 @@ /* extend grid elements to the right */ @include breakpoint($large) { - margin-right: -1 * $right-sidebar-width-narrow; + margin-inline-end: -1 * $right-sidebar-width-narrow; } @include breakpoint($x-large) { - margin-right: -1 * $right-sidebar-width; + margin-inline-end: -1 * $right-sidebar-width; } } } @@ -103,23 +150,22 @@ margin-bottom: 2em; @include breakpoint($small) { - float: left; + float: inline-start; width: span(5 of 10); &:nth-child(2n + 1) { clear: both; - margin-left: 0; + margin-inline-start: 0; } &:nth-child(2n + 2) { clear: none; - margin-left: gutter(of 10); + margin-inline-start: gutter(of 10); } } @include breakpoint($medium) { - margin-left: 0; /* override margin*/ - margin-right: 0; /* override margin*/ + margin-inline: 0; /* override margin*/ width: span(3 of 12); &:nth-child(2n + 1) { @@ -132,17 +178,17 @@ &:nth-child(4n + 2) { clear: none; - margin-left: gutter(1 of 12); + margin-inline-start: gutter(1 of 12); } &:nth-child(4n + 3) { clear: none; - margin-left: gutter(1 of 12); + margin-inline-start: gutter(1 of 12); } &:nth-child(4n + 4) { clear: none; - margin-left: gutter(1 of 12); + margin-inline-start: gutter(1 of 12); } } @@ -151,6 +197,14 @@ font-size: 0.6em; } + .page__meta-sep { + display: block; + + &::before { + display: none; + } + } + .archive__item-title { margin-top: 0.5em; font-size: $type-size-5; @@ -184,30 +238,35 @@ @include clearfix(); margin-bottom: 2em; border-bottom: 1px solid $border-color; + + .archive__item-title { + margin-bottom: 0; + } } .feature__item { + position: relative; margin-bottom: 2em; - font-size: 1.25rem; + font-size: 1.125em; @include breakpoint($small) { - float: left; + float: inline-start; margin-bottom: 0; width: span(4 of 12); &:nth-child(3n + 1) { clear: both; - margin-left: 0; + margin-inline-start: 0; } &:nth-child(3n + 2) { clear: none; - margin-left: gutter(of 12); + margin-inline-start: gutter(of 12); } &:nth-child(3n + 3) { clear: none; - margin-left: gutter(of 12); + margin-inline-start: gutter(of 12); } .feature__item-teaser { @@ -216,74 +275,103 @@ } } - &--left { - float: left; - margin-left: 0; - margin-right: 0; + .archive__item-body { + padding-inline: gutter(1 of 12); + } + + a.btn::before { + content: ''; + position: absolute; + inset: 0; + } + + &--left, &--right { + position: relative; + margin-inline: 0; width: 100%; clear: both; - font-size: 1.25rem; + font-size: 1.125em; + + a.btn::before { + content: ''; + position: absolute; + inset: 0; + } .archive__item-teaser { margin-bottom: 2em; } + } + + &--left { + float: inline-start; + + .archive__item { + float: inline-start; + } @include breakpoint($small) { .archive__item-teaser { - float: left; + float: inline-start; width: span(5 of 12); } .archive__item-body { - float: right; - padding-left: gutter(0.5 of 12); - padding-right: gutter(1 of 12); + float: inline-end; width: span(7 of 12); + padding-inline-start: gutter(0.5 of 12); + padding-inline-end: gutter(1 of 12); } } } &--right { - float: left; - margin-left: 0; - margin-right: 0; - width: 100%; - clear: both; - font-size: 1.25rem; + float: inline-end; - .archive__item-teaser { - margin-bottom: 2em; + .archive__item { + float: inline-end; } @include breakpoint($small) { - text-align: right; + text-align: end; .archive__item-teaser { - float: right; + float: inline-end; width: span(5 of 12); } .archive__item-body { - float: right; + float: inline-start; width: span(7 of 12); - padding-left: gutter(0.5 of 12); - padding-right: gutter(1 of 12); + padding-inline-start: gutter(1 of 12); + padding-inline-end: gutter(0.5 of 12); } } } &--center { - float: left; - margin-left: 0; - margin-right: 0; + position: relative; + float: inline-start; + margin-inline: 0; width: 100%; clear: both; - font-size: 1.25rem; + font-size: 1.125em; + + .archive__item { + float: inline-start; + width: 100%; + } .archive__item-teaser { margin-bottom: 2em; } + a.btn::before { + content: ''; + position: absolute; + inset: 0; + } + @include breakpoint($small) { text-align: center; @@ -317,3 +405,27 @@ font-size: 1em; } } + +/* + Wide Pages + ========================================================================== */ + +.wide { + .archive { + @include breakpoint($large) { + padding-inline-end: 0; + } + + @include breakpoint($x-large) { + padding-inline-end: 0; + } + } +} + +/* Place inside a single layout */ + +.layout--single { + .feature__wrapper { + display: inline-block; + } +} diff --git a/_sass/minimal-mistakes/_base.scss b/_sass/minimal-mistakes/_base.scss index 82d5e63d85f8..48e98b295b10 100644 --- a/_sass/minimal-mistakes/_base.scss +++ b/_sass/minimal-mistakes/_base.scss @@ -6,6 +6,8 @@ html { /* sticky footer fix */ position: relative; min-height: 100%; + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; } body { @@ -35,27 +37,27 @@ h6 { h1 { margin-top: 0; - font-size: $type-size-3; + font-size: $h-size-1; } h2 { - font-size: $type-size-4; + font-size: $h-size-2; } h3 { - font-size: $type-size-5; + font-size: $h-size-3; } h4 { - font-size: $type-size-6; + font-size: $h-size-4; } h5 { - font-size: $type-size-6; + font-size: $h-size-5; } h6 { - font-size: $type-size-6; + font-size: $h-size-6; } small, @@ -107,18 +109,18 @@ abbr[data-original-title] { /* blockquotes */ blockquote { - margin: 2em 1em 2em 0; - padding-left: 1em; - padding-right: 1em; + margin-block: 2em; + margin-inline-end: 1em; + padding-inline: 1em; font-style: italic; - border-left: 0.25em solid $primary-color; + border-inline-start: 0.25em solid $primary-color; cite { font-style: italic; - &:before { + &::before { content: "\2014"; - padding-right: 5px; + padding-inline-end: 5px; } } } @@ -130,15 +132,14 @@ a { @extend %tab-focus; } - &:hover, - &:active { - color: $link-color-hover; - outline: 0; - } - &:visited { color: $link-color-visited; } + + &:hover { + color: $link-color-hover; + outline: 0; + } } /* buttons */ @@ -161,24 +162,6 @@ pre { overflow-x: auto; /* add scrollbars to wide code blocks*/ } -p > code, -a > code, -li > code, -figcaption > code, -td > code { - padding-top: 0.1rem; - padding-bottom: 0.1rem; - font-size: $type-size-6; - background: $code-background-color; - border-radius: $border-radius; - - &:before, - &:after { - letter-spacing: -0.2em; - content: "\00a0"; /* non-breaking space*/ - } -} - /* horizontal rule */ hr { diff --git a/_sass/minimal-mistakes/_buttons.scss b/_sass/minimal-mistakes/_buttons.scss index 6027eac73d78..3b664d73619f 100644 --- a/_sass/minimal-mistakes/_buttons.scss +++ b/_sass/minimal-mistakes/_buttons.scss @@ -21,11 +21,11 @@ cursor: pointer; .icon { - margin-right: 0.5em; + margin-inline-end: 0.5em; } .icon + .hidden { - margin-left: -0.5em; /* override for hidden text*/ + margin-inline-start: -0.5em; /* override for hidden text*/ } /* button colors */ @@ -37,10 +37,13 @@ (warning, $warning-color), (danger, $danger-color), (info, $info-color), + /* brands */ + (bluesky, $bluesky-color), (facebook, $facebook-color), + (linkedin, $linkedin-color), + (mastodon, $mastodon-color), (twitter, $twitter-color), - (google-plus, $google-plus-color), - (linkedin, $linkedin-color); + (x, $x-color); @each $buttoncolor, $color in $buttoncolors { &--#{$buttoncolor} { @@ -52,13 +55,13 @@ border: 1px solid #fff; } - &:hover { - @include yiq-contrasted(mix(#000, $color, 20%)); - } - &:visited { @include yiq-contrasted($color); } + + &:hover { + @include yiq-contrasted(mix(#000, $color, 20%)); + } } } @@ -95,4 +98,4 @@ &--small { font-size: $type-size-7; } -} \ No newline at end of file +} diff --git a/_sass/minimal-mistakes/_copyright.scss b/_sass/minimal-mistakes/_copyright.scss new file mode 100644 index 000000000000..647651203203 --- /dev/null +++ b/_sass/minimal-mistakes/_copyright.scss @@ -0,0 +1,6 @@ +/*! + * Minimal Mistakes Jekyll Theme 4.27.3 by Michael Rose + * Copyright 2013-2025 Michael Rose - mademistakes.com | @mmistakes + * Free for personal and commercial use under the MIT license + * https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE + */ diff --git a/_sass/minimal-mistakes/_footer.scss b/_sass/minimal-mistakes/_footer.scss index d3218b74cff0..96d0842cedef 100644 --- a/_sass/minimal-mistakes/_footer.scss +++ b/_sass/minimal-mistakes/_footer.scss @@ -4,16 +4,9 @@ .page__footer { @include clearfix; - float: left; - margin-left: 0; - margin-right: 0; + float: inline-start; + margin-inline: 0; width: 100%; - clear: both; - /* sticky footer fix start */ - position: absolute; - bottom: 0; - height: auto; - /* sticky footer fix end */ margin-top: 3em; color: $muted-text-color; -webkit-animation: $intro-transition; @@ -24,8 +17,7 @@ footer { @include clearfix; - margin-left: auto; - margin-right: auto; + margin-inline: auto; margin-top: 2em; max-width: 100%; padding: 0 1em 2em; @@ -73,13 +65,19 @@ text-transform: uppercase; } - li + li:before { + li + li::before { content: ""; - padding-right: 5px; + padding-inline-end: 5px; } a { - padding-right: 10px; + padding-inline-end: 10px; font-weight: bold; } + + .social-icons { + a { + white-space: nowrap; + } + } } diff --git a/_sass/minimal-mistakes/_forms.scss b/_sass/minimal-mistakes/_forms.scss index f93721663524..af29b9f72138 100644 --- a/_sass/minimal-mistakes/_forms.scss +++ b/_sass/minimal-mistakes/_forms.scss @@ -3,7 +3,7 @@ ========================================================================== */ form { - margin: 0 0 5px 0; + margin-bottom: 5px; padding: 1em; background-color: $form-background-color; @@ -17,7 +17,7 @@ form { display: block; width: 100%; margin-bottom: 5px * 2; - *margin-left: -7px; + margin-inline-start: -7px; padding: 0; color: $text-color; border: 0; @@ -25,7 +25,7 @@ form { } p { - margin-bottom: 5px / 2; + margin-bottom: (5px / 2); } ul { @@ -45,7 +45,6 @@ button, select, textarea { vertical-align: baseline; - *vertical-align: middle; } input, @@ -102,24 +101,21 @@ input[type="radio"] { height: auto; padding: 0; margin: 3px 0; - *margin-top: 0; line-height: normal; cursor: pointer; border-radius: 0; border: 0 \9; + box-shadow: none; } input[type="checkbox"], input[type="radio"] { box-sizing: border-box; padding: 0; - *width: 13px; - *height: 13px; } input[type="image"] { border: 0; - box-shadow: none; } input[type="file"] { @@ -138,12 +134,6 @@ input[type="submit"] { width: auto; height: auto; cursor: pointer; - *overflow: visible; -} - -select, -input[type="file"] { - *margin-top: 4px; } select { @@ -173,14 +163,14 @@ input[type="hidden"] { .radio, .checkbox { - padding-left: 18px; + padding-inline-start: 18px; font-weight: normal; } .radio input[type="radio"], .checkbox input[type="checkbox"] { - float: left; - margin-left: -18px; + float: inline-start; + margin-inline-start: -18px; } .radio.inline, @@ -193,7 +183,7 @@ input[type="hidden"] { .radio.inline + .radio.inline, .checkbox.inline + .checkbox.inline { - margin-left: 10px; + margin-inline-start: 10px; } /* @@ -248,7 +238,7 @@ select:focus { .help-inline { display: inline-block; vertical-align: middle; - padding-left: 5px; + padding-inline-start: 5px; } /* @@ -279,16 +269,16 @@ select:focus { .form-inline .radio, .form-inline .checkbox, .form-inline .radio { - padding-left: 0; + padding-inline-start: 0; margin-bottom: 0; vertical-align: middle; } .form-inline .radio input[type="radio"], .form-inline .checkbox input[type="checkbox"] { - float: left; - margin-left: 0; - margin-right: 3px; + float: inline-start; + margin-inline-start: 0; + margin-inline-end: 3px; } /* @@ -303,8 +293,7 @@ select:focus { } .form-search .search-query { - padding-left: 14px; - padding-right: 14px; + padding-inline: 14px; margin-bottom: 0; border-radius: 14px; } @@ -316,23 +305,23 @@ select:focus { .form-search .radio, .form-search .checkbox, .form-inline .radio { - padding-left: 0; + padding-inline-start: 0; margin-bottom: 0; vertical-align: middle; } .form-search .radio input[type="radio"], .form-search .checkbox input[type="checkbox"] { - float: left; - margin-left: 0; - margin-right: 3px; + float: inline-start; + margin-inline-start: 0; + margin-inline-end: 3px; } /* .form--loading ========================================================================== */ -.form--loading:before { +.form--loading::before { content: ""; } @@ -340,10 +329,10 @@ select:focus { display: block; } -.form:before { +.form::before { position: absolute; top: 0; - left: 0; + inset-inline-start: 0; width: 100%; height: 100%; background-color: rgba(255, 255, 255, 0.7); @@ -354,40 +343,6 @@ select:focus { display: none; position: absolute; top: 50%; - left: 50%; + inset-inline-start: 50%; z-index: 11; } - -/* - Google search form - ========================================================================== */ - -#goog-fixurl { - ul { - list-style: none; - margin-left: 0; - padding-left: 0; - li { - list-style-type: none; - } - } -} - -#goog-wm-qt { - width: auto; - margin-right: 10px; - margin-bottom: 20px; - padding: 8px 20px; - display: inline-block; - font-size: $type-size-6; - background-color: #fff; - color: #000; - border-width: 2px !important; - border-style: solid !important; - border-color: $border-color; - border-radius: $border-radius; -} - -#goog-wm-sb { - @extend .btn; -} diff --git a/_sass/minimal-mistakes/_masthead.scss b/_sass/minimal-mistakes/_masthead.scss index 3317c7fda8e2..80b0ed57ab40 100644 --- a/_sass/minimal-mistakes/_masthead.scss +++ b/_sass/minimal-mistakes/_masthead.scss @@ -13,18 +13,19 @@ &__inner-wrap { @include clearfix; - margin-left: auto; - margin-right: auto; + margin-inline: auto; padding: 1em; max-width: 100%; display: -webkit-box; + display: -ms-flexbox; display: flex; -webkit-box-pack: justify; + -ms-flex-pack: justify; justify-content: space-between; font-family: $sans-serif-narrow; @include breakpoint($x-large) { - max-width: $x-large; + max-width: $max-width; } nav { @@ -37,29 +38,36 @@ } } +.site-logo img { + max-height: 2rem; +} + .site-title { display: -webkit-box; + display: -ms-flexbox; display: flex; - padding: 0.5rem 0; - align-self: stretch; - -webkit-box-align: center; - align-items: center; + -ms-flex-item-align: center; + align-self: center; font-weight: bold; - z-index: 20; + // z-index: 20; +} + +.site-subtitle { + display: block; + font-size: $type-size-8; } .masthead__menu { - float: left; - margin-left: 0; - margin-right: 0; + float: inline-start; + margin-inline: 0; width: 100%; clear: both; .site-nav { - margin-left: 0; + margin-inline-start: 0; @include breakpoint($small) { - float: right; + float: inline-end; } } @@ -77,7 +85,7 @@ white-space: nowrap; &--lg { - padding-right: 2em; + padding-inline-end: 2em; font-weight: 700; } } diff --git a/_sass/minimal-mistakes/_mixins.scss b/_sass/minimal-mistakes/_mixins.scss index 1d221fc8091e..4aa9eb09ca80 100644 --- a/_sass/minimal-mistakes/_mixins.scss +++ b/_sass/minimal-mistakes/_mixins.scss @@ -4,9 +4,9 @@ %tab-focus { /* Default*/ - outline: thin dotted $warning-color; + outline: thin dotted $focus-color; /* Webkit*/ - outline: 5px auto $warning-color; + outline: 5px auto $focus-color; outline-offset: -2px; } diff --git a/_sass/minimal-mistakes/_navigation.scss b/_sass/minimal-mistakes/_navigation.scss index 306cedb7e470..3ba1b66deaa0 100644 --- a/_sass/minimal-mistakes/_navigation.scss +++ b/_sass/minimal-mistakes/_navigation.scss @@ -10,19 +10,13 @@ @include clearfix; margin: 0 auto; max-width: 100%; - padding-left: 2em; - padding-right: 2em; + padding-inline: 1em; font-family: $sans-serif; -webkit-animation: $intro-transition; animation: $intro-transition; -webkit-animation-delay: 0.3s; animation-delay: 0.3s; - @include breakpoint($large) { - padding-left: 1em; - padding-right: 1em; - } - @include breakpoint($x-large) { max-width: $x-large; } @@ -33,12 +27,12 @@ font-size: $type-size-6; @include breakpoint($large) { - float: right; - width: span(10 of 12); + float: inline-end; + width: calc(100% - #{$right-sidebar-width-narrow}); } @include breakpoint($x-large) { - padding-left: gutter(0.5 of 12); + width: calc(100% - #{$right-sidebar-width}); } } @@ -57,7 +51,7 @@ .pagination { @include clearfix(); - float: left; + float: inline-start; margin-top: 1em; padding-top: 1em; width: 100%; @@ -71,8 +65,8 @@ li { display: block; - float: left; - margin-left: -1px; + float: inline-start; + margin-inline-start: -1px; a { display: block; @@ -106,18 +100,18 @@ } &:first-child { - margin-left: 0; + margin-inline-start: 0; a { - border-top-left-radius: $border-radius; - border-bottom-left-radius: $border-radius; + border-start-start-radius: $border-radius; + border-end-start-radius: $border-radius; } } &:last-child { a { - border-top-right-radius: $border-radius; - border-bottom-right-radius: $border-radius; + border-start-end-radius: $border-radius; + border-end-end-radius: $border-radius; } } } @@ -126,7 +120,7 @@ &--pager { display: block; padding: 1em 2em; - float: left; + float: inline-start; width: 50%; font-family: $sans-serif; font-size: $type-size-5; @@ -142,14 +136,14 @@ } &:first-child { - border-top-right-radius: 0; - border-bottom-right-radius: 0; + border-start-end-radius: 0; + border-end-end-radius: 0; } &:last-child { - margin-left: -1px; - border-top-left-radius: 0; - border-bottom-left-radius: 0; + margin-inline-start: -1px; + border-start-start-radius: 0; + border-end-start-radius: 0; } &.disabled { @@ -176,48 +170,66 @@ .greedy-nav { position: relative; display: -webkit-box; + display: -ms-flexbox; display: flex; -webkit-box-align: center; + -ms-flex-align: center; align-items: center; + min-height: $nav-height; background: $background-color; a { display: block; margin: 0 1rem; - padding: 0.5rem 0; color: $masthead-link-color; text-decoration: none; + -webkit-transition: none; + transition: none; &:hover { color: $masthead-link-color-hover; } + &.site-logo { + margin-inline-start: 0; + margin-inline-end: 0.5rem; + } + &.site-title { - margin-left: 0; + margin-inline-start: 0; } } + img { + -webkit-transition: none; + transition: none; + } + &__toggle { - padding: 0 0.5rem; - align-self: stretch; + -ms-flex-item-align: center; + align-self: center; + height: $nav-toggle-height; border: 0; outline: none; - color: #fff; - background-color: $primary-color; + background-color: transparent; cursor: pointer; } .visible-links { display: -webkit-box; + display: -ms-flexbox; display: flex; -webkit-box-pack: end; + -ms-flex-pack: end; justify-content: flex-end; -webkit-box-flex: 1; + -ms-flex: 1; flex: 1; overflow: hidden; li { -webkit-box-flex: 0; + -ms-flex: none; flex: none; } @@ -227,7 +239,7 @@ &:before { content: ""; position: absolute; - left: 0; + inset-inline-start: 0; bottom: 0; height: 4px; background: $primary-color; @@ -235,13 +247,13 @@ -webkit-transition: $global-transition; transition: $global-transition; -webkit-transform: scaleX(0) translate3d(0, 0, 0); - transform: scaleX(0) translate3d(0, 0, 0); /* hide*/ + transform: scaleX(0) translate3d(0, 0, 0); // hide } &:hover:before { -webkit-transform: scaleX(1); -ms-transform: scaleX(1); - transform: scaleX(1); /* reveal*/ + transform: scaleX(1); // reveal } } } @@ -249,12 +261,14 @@ .hidden-links { position: absolute; top: 100%; - right: 0; + inset-inline-end: 0; margin-top: 15px; padding: 5px; border: 1px solid $border-color; border-radius: $border-radius; background: $background-color; + -webkit-box-shadow: 0 2px 4px 0 rgba(#000, 0.16), + 0 2px 10px 0 rgba(#000, 0.12); box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12); &.hidden { @@ -272,11 +286,11 @@ } } - &:before { + &::before { content: ""; position: absolute; top: -11px; - right: 10px; + inset-inline-end: 10px; width: 0; border-style: solid; border-width: 0 10px 10px; @@ -285,11 +299,11 @@ z-index: 0; } - &:after { + &::after { content: ""; position: absolute; top: -10px; - right: 10px; + inset-inline-end: 10px; width: 0; border-style: solid; border-width: 0 10px 10px; @@ -331,7 +345,7 @@ display: none; } - @include breakpoint(max-width ($large - 1px)) { + @include breakpoint(max-width $large - 1px) { label { position: relative; display: inline-block; @@ -346,11 +360,11 @@ transition: 0.2s ease-out; cursor: pointer; - &:before, - &:after { + &::before, + &::after { content: ""; position: absolute; - right: 1em; + inset-inline-end: 1em; top: 1.25em; width: 0.75em; height: 0.125em; @@ -431,13 +445,12 @@ } .active { - margin-left: -0.5em; - padding-left: 0.5em; - padding-right: 0.5em; + margin-inline-start: -0.5em; + padding-inline: 0.5em; font-weight: bold; } - @include breakpoint(max-width ($large - 1px)) { + @include breakpoint(max-width $large - 1px) { position: relative; max-height: 0; opacity: 0%; @@ -451,7 +464,7 @@ } } -@include breakpoint(max-width ($large - 1px)) { +@include breakpoint(max-width $large - 1px) { .nav__list input:checked ~ .nav__items { -webkit-transition: 0.5s ease-in-out; transition: 0.5s ease-in-out; @@ -467,7 +480,7 @@ .nav__title { margin: 0; - padding: 0.5rem 1rem; + padding: 0.5rem 0.75rem; font-family: $sans-serif-narrow; font-size: $type-size-5; font-weight: bold; @@ -476,7 +489,7 @@ .nav__sub-title { display: block; margin: 0.5rem 0; - padding: 0.5rem 0; + padding: 0.25rem 0; font-family: $sans-serif-narrow; font-size: $type-size-6; font-weight: bold; @@ -491,19 +504,23 @@ .toc { font-family: $sans-serif-narrow; color: $gray; - text-transform: uppercase; - letter-spacing: 1px; background-color: $background-color; border: 1px solid $border-color; border-radius: $border-radius; + -webkit-box-shadow: $box-shadow; box-shadow: $box-shadow; .nav__title { color: #fff; font-size: $type-size-6; background: $primary-color; - border-top-left-radius: $border-radius; - border-top-right-radius: $border-radius; + border-start-start-radius: $border-radius; + border-start-end-radius: $border-radius; + } + + // Scrollspy marks toc items as .active when they are in focus + .active a { + @include yiq-contrasted($active-color); } } @@ -512,13 +529,16 @@ padding: 0; width: 100%; list-style: none; - font-size: 0.8rem; + font-size: $type-size-6; + + @include breakpoint($large) { + font-size: $type-size-7; + } a { display: block; - padding: 0.5rem 1rem; + padding: 0.25rem 0.75rem; color: $muted-text-color; - font-size: $type-size-7; font-weight: bold; line-height: 1.5; border-bottom: 1px solid $border-color; @@ -528,23 +548,24 @@ } } - > li:last-child { - a { - border-bottom: none; - } - } - li ul > li a { - padding-left: 1.75rem; + padding-inline-start: 1.25rem; font-weight: normal; } - /* hide sub sub links on small screens*/ - li > ul li { - display: none; + li ul li ul > li a { + padding-inline-start: 1.75rem; + } - @include breakpoint($medium) { - display: block; - } + li ul li ul li ul > li a { + padding-inline-start: 2.25rem; + } + + li ul li ul li ul li ul > li a { + padding-inline-start: 2.75rem; + } + + li ul li ul li ul li ul li ul > li a { + padding-inline-start: 3.25rem; } } diff --git a/_sass/minimal-mistakes/_notices.scss b/_sass/minimal-mistakes/_notices.scss index 7f9b733f62f9..da6601214947 100644 --- a/_sass/minimal-mistakes/_notices.scss +++ b/_sass/minimal-mistakes/_notices.scss @@ -13,17 +13,18 @@ @mixin notice($notice-color) { margin: 2em 0 !important; /* override*/ padding: 1em; - color: $dark-gray; + color: $text-color; font-family: $global-font-family; font-size: $type-size-6 !important; text-indent: initial; /* override*/ - background-color: mix(#fff, $notice-color, 90%); + background-color: mix($background-color, $notice-color, $notice-background-mix); border-radius: $border-radius; box-shadow: 0 1px 1px rgba($notice-color, 0.25); h4 { margin-top: 0 !important; /* override*/ margin-bottom: 0.75em; + line-height: inherit; } @at-root .page__content #{&} h4 { @@ -45,17 +46,25 @@ } a { - color: $notice-color; + color: mix(#000, $notice-color, 10%); &:hover { - color: mix(#000, $notice-color, 40%); + color: mix(#000, $notice-color, 50%); } } + @at-root #{selector-unify(&, "blockquote")} { + border-inline-start-color: mix(#000, $notice-color, 10%); + } + code { - background-color: mix(#fff, $notice-color, 95%) + background-color: mix($background-color, $notice-color, $code-notice-background-mix) } + pre code { + background-color: inherit; + } + ul { &:last-child { margin-bottom: 0; /* override*/ @@ -65,36 +74,42 @@ /* Default notice */ -.notice { +.notice, +.markdown-alert { @include notice($light-gray); } /* Primary notice */ -.notice--primary { +.notice--primary, +.markdown-alert-important { @include notice($primary-color); } /* Info notice */ -.notice--info { +.notice--info, +.markdown-alert-note { @include notice($info-color); } /* Warning notice */ -.notice--warning { +.notice--warning, +.markdown-alert-warning { @include notice($warning-color); } /* Success notice */ -.notice--success { +.notice--success, +.markdown-alert-tip { @include notice($success-color); } /* Danger notice */ -.notice--danger { +.notice--danger, +.markdown-alert-caution { @include notice($danger-color); -} \ No newline at end of file +} diff --git a/_sass/minimal-mistakes/_page.scss b/_sass/minimal-mistakes/_page.scss index c5c1f38060a0..e33888400eed 100644 --- a/_sass/minimal-mistakes/_page.scss +++ b/_sass/minimal-mistakes/_page.scss @@ -4,11 +4,8 @@ #main { @include clearfix; - margin-left: auto; - margin-top: 2em; - margin-right: auto; - padding-left: 1em; - padding-right: 1em; + margin-inline: auto; + padding-inline: 1em; -webkit-animation: $intro-transition; animation: $intro-transition; max-width: 100%; @@ -16,26 +13,42 @@ animation-delay: 0.15s; @include breakpoint($x-large) { - max-width: $x-large; + max-width: $max-width; } } +body { + display: -webkit-box; + display: -ms-flexbox; + display: flex; + min-height: 100vh; + -webkit-box-orient: vertical; + -webkit-box-direction: normal; + -ms-flex-direction: column; + flex-direction: column; +} + +.initial-content, +.search-content { + flex: 1 0 auto; +} + .page { @include breakpoint($large) { - float: right; + float: inline-end; width: calc(100% - #{$right-sidebar-width-narrow}); - padding-right: $right-sidebar-width-narrow; + padding-inline-end: $right-sidebar-width-narrow; } @include breakpoint($x-large) { width: calc(100% - #{$right-sidebar-width}); - padding-right: $right-sidebar-width; + padding-inline-end: $right-sidebar-width; } .page__inner-wrap { - float: left; - margin-left: 0; - margin-right: 0; + float: inline-start; + margin-top: 1em; + margin-inline: 0; width: 100%; clear: both; @@ -43,9 +56,8 @@ .page__meta, .page__share { position: relative; - float: left; - margin-left: 0; - margin-right: 0; + float: inline-start; + margin-inline: 0; width: 100%; clear: both; } @@ -56,6 +68,11 @@ margin-top: 0; line-height: 1; + a { + color: $text-color; + text-decoration: none; + } + & + .page__meta { margin-top: -0.5em; } @@ -72,6 +89,23 @@ border-bottom: 1px solid $border-color; } + h1, h2, h3, h4, h5, h6 { + .header-link { + position: relative; + inset-inline-start: 0.5em; + opacity: 0; + font-size: 0.8em; + -webkit-transition: opacity 0.2s ease-in-out 0.1s; + -moz-transition: opacity 0.2s ease-in-out 0.1s; + -o-transition: opacity 0.2s ease-in-out 0.1s; + transition: opacity 0.2s ease-in-out 0.1s; + } + + &:hover .header-link { + opacity: 1; + } + } + p, li, dl { @@ -101,6 +135,20 @@ } } + :not(pre) > code { + padding-top: 0.1rem; + padding-bottom: 0.1rem; + font-size: 0.8em; + background: $code-background-color; + border-radius: $border-radius; + + &::before, + &::after { + letter-spacing: -0.2em; + content: "\00a0"; /* non-breaking space*/ + } + } + dt { margin-top: 1em; font-family: $sans-serif; @@ -108,7 +156,7 @@ } dd { - margin-left: 1em; + margin-inline-start: 1em; font-family: $sans-serif; font-size: $type-size-6; } @@ -120,7 +168,7 @@ /* blockquote citations */ blockquote + .small { margin-top: -1.5em; - padding-left: 1.25rem; + padding-inline-start: 1.25rem; } } @@ -151,8 +199,7 @@ } .wrapper { - padding-left: 1em; - padding-right: 1em; + padding-inline: 1em; @include breakpoint($x-large) { max-width: $x-large; @@ -190,14 +237,14 @@ .page__hero-caption { position: absolute; bottom: 0; - right: 0; + inset-inline-end: 0; margin: 0 auto; padding: 2px 5px; color: #fff; font-family: $caption-font-family; font-size: $type-size-7; background: #000; - text-align: right; + text-align: end; z-index: 5; opacity: 0.5; border-radius: $border-radius 0 0 0; @@ -266,6 +313,11 @@ text-transform: uppercase; } +.page__meta-sep::before { + content: "\2022"; + padding-inline: 0.5em; +} + /* Page taxonomy ========================================================================== */ @@ -276,13 +328,13 @@ } strong { - margin-right: 10px; + margin-inline-end: 10px; } } .page__taxonomy-item { display: inline-block; - margin-right: 5px; + margin-inline-end: 5px; margin-bottom: 8px; padding: 5px 10px; text-decoration: none; @@ -295,14 +347,81 @@ } } +.taxonomy__section { + margin-bottom: 2em; + padding-bottom: 1em; + + &:not(:last-child) { + border-bottom: solid 1px $border-color; + } + + .archive__item-title { + margin-top: 0; + } + + .archive__subtitle { + clear: both; + border: 0; + } + + + .taxonomy__section { + margin-top: 2em; + } +} + +.taxonomy__title { + margin-bottom: 0.5em; + color: $muted-text-color; +} + +.taxonomy__count { + color: $muted-text-color; +} + +.taxonomy__index { + display: grid; + grid-column-gap: 2em; + grid-template-columns: repeat(2, 1fr); + margin: 1.414em 0; + padding: 0; + font-size: 0.75em; + list-style: none; + + @include breakpoint($large) { + grid-template-columns: repeat(3, 1fr); + } + + a { + display: -webkit-box; + display: -ms-flexbox; + display: flex; + padding: 0.25em 0; + -webkit-box-pack: justify; + -ms-flex-pack: justify; + justify-content: space-between; + color: inherit; + text-decoration: none; + border-bottom: 1px solid $border-color; + } +} + +.back-to-top { + display: block; + clear: both; + color: $muted-text-color; + font-size: 0.6em; + text-transform: uppercase; + text-align: end; + text-decoration: none; +} + /* Comments ========================================================================== */ .page__comments { - float: left; - margin-left: 0; - margin-right: 0; + float: inline-start; + margin-inline: 0; width: 100%; clear: both; } @@ -344,7 +463,7 @@ } .comment__avatar-wrapper { - float: left; + float: inline-start; width: 60px; height: 60px; @@ -368,7 +487,7 @@ } .comment__content-wrapper { - float: right; + float: inline-end; width: calc(100% - 60px); @include breakpoint($large) { @@ -399,13 +518,13 @@ .page__related { @include clearfix(); - float: left; + float: inline-start; margin-top: 2em; padding-top: 1em; border-top: 1px solid $border-color; @include breakpoint($large) { - float: right; + float: inline-end; width: calc(100% - #{$right-sidebar-width-narrow}); } @@ -430,23 +549,13 @@ ========================================================================== */ .wide { - .page { - @include breakpoint($large) { - padding-right: 0; - } - - @include breakpoint($x-large) { - padding-right: 0; - } - } - - .page__related { + .page, .page__related { @include breakpoint($large) { - padding-right: 0; + padding-inline-end: 0; } @include breakpoint($x-large) { - padding-right: 0; + padding-inline-end: 0; } } } diff --git a/_sass/minimal-mistakes/_reset.scss b/_sass/minimal-mistakes/_reset.scss index 2259fd0c2388..13bd9915b5ea 100644 --- a/_sass/minimal-mistakes/_reset.scss +++ b/_sass/minimal-mistakes/_reset.scss @@ -8,18 +8,18 @@ html { /* apply a natural box layout model to all elements */ box-sizing: border-box; background-color: $background-color; - font-size: 16px; + font-size: $doc-font-size; @include breakpoint($medium) { - font-size: 18px; + font-size: $doc-font-size-medium; } @include breakpoint($large) { - font-size: 20px; + font-size: $doc-font-size-large; } @include breakpoint($x-large) { - font-size: 22px; + font-size: $doc-font-size-x-large; } -webkit-text-size-adjust: 100%; @@ -64,8 +64,6 @@ audio, canvas, video { display: inline-block; - *display: inline; - *zoom: 1; } /* Prevents modern browsers from displaying 'audio' without controls */ @@ -142,7 +140,6 @@ textarea { button, input { - *overflow: visible; /* inner spacing ie IE6/7*/ line-height: normal; /* FF3/4 have !important on line-height in UA stylesheet*/ } @@ -184,4 +181,4 @@ input[type="search"]::-webkit-search-cancel-button { textarea { overflow: auto; /* remove vertical scrollbar in IE6-9*/ vertical-align: top; /* readability and alignment cross-browser*/ -} \ No newline at end of file +} diff --git a/_sass/minimal-mistakes/_search.scss b/_sass/minimal-mistakes/_search.scss index fe3c4367ea90..4a3a2b37e997 100644 --- a/_sass/minimal-mistakes/_search.scss +++ b/_sass/minimal-mistakes/_search.scss @@ -9,18 +9,18 @@ } .search__toggle { - margin-left: 1rem; - margin-right: 1rem; + margin-inline: 1rem; + height: $nav-toggle-height; border: 0; outline: none; - color: $muted-text-color; + color: $primary-color; background-color: transparent; cursor: pointer; -webkit-transition: 0.2s; transition: 0.2s; &:hover { - color: $text-color; + color: mix(#000, $primary-color, 25%); } } @@ -37,18 +37,21 @@ &__inner-wrap { width: 100%; - margin-left: auto; - margin-right: auto; - padding-left: 1em; - padding-right: 1em; + margin-inline: auto; + padding-inline: 1em; -webkit-animation: $intro-transition; animation: $intro-transition; -webkit-animation-delay: 0.15s; animation-delay: 0.15s; @include breakpoint($x-large) { - max-width: $x-large; + max-width: $max-width; } + + } + + &__form { + background-color: transparent; } .search-input { @@ -114,12 +117,13 @@ } .archive__item-title .ais-Highlight { - color: $link-color; + color: $primary-color; font-style: normal; text-decoration: underline; } + .archive__item-excerpt .ais-Highlight { - color: $link-color; + color: $primary-color; font-style: normal; font-weight: bold; } diff --git a/_sass/minimal-mistakes/_sidebar.scss b/_sass/minimal-mistakes/_sidebar.scss index 808324cc69f1..e51443527a62 100644 --- a/_sass/minimal-mistakes/_sidebar.scss +++ b/_sass/minimal-mistakes/_sidebar.scss @@ -8,18 +8,16 @@ .sidebar { @include clearfix(); - margin-bottom: 1em; - - @include breakpoint(max-width $large) { - /* fix z-index order of follow links */ - position: relative; - z-index: 10; - -webkit-transform: translate3d(0, 0, 0); - transform: translate3d(0, 0, 0); - } + // @include breakpoint(max-width $large) { + // /* fix z-index order of follow links */ + // position: relative; + // z-index: 10; + // -webkit-transform: translate3d(0, 0, 0); + // transform: translate3d(0, 0, 0); + // } @include breakpoint($large) { - float: left; + float: inline-start; width: calc(#{$right-sidebar-width-narrow} - 1em); opacity: 0.75; -webkit-transition: opacity 0.2s ease-in-out; @@ -31,10 +29,10 @@ &.sticky { overflow-y: auto; - /* calculate height of nav list */ - height: calc( - 100vh - 90px - 2em - ); // viewport height - approx. masthead height - main content top margin + /* calculate height of nav list + viewport height - nav height - masthead x-padding + */ + max-height: calc(100vh - #{$nav-height} - 2em); } } @@ -42,6 +40,11 @@ width: calc(#{$right-sidebar-width} - 1em); } + > * { + margin-top: 1em; + margin-bottom: 1em; + } + h2, h3, h4, @@ -60,6 +63,11 @@ img { width: 100%; + + &.emoji { + width: 20px; + height: 20px; + } } } @@ -69,28 +77,43 @@ @include breakpoint($large) { position: absolute; top: 0; - right: 0; + inset-inline-end: 0; width: $right-sidebar-width-narrow; - margin-right: -1 * $right-sidebar-width-narrow; - padding-left: 1em; + margin-inline-end: -1 * $right-sidebar-width-narrow; + padding-inline-start: 1em; z-index: 10; + + &.sticky { + @include clearfix(); + position: -webkit-sticky; + position: sticky; + top: 2em; + float: inline-end; + + .toc { + .toc__menu { + overflow-y: auto; + max-height: calc(100vh - 7em); + } + } + } } @include breakpoint($x-large) { width: $right-sidebar-width; - margin-right: -1 * $right-sidebar-width; + margin-inline-end: -1 * $right-sidebar-width; } } .splash .sidebar__right { @include breakpoint($large) { position: relative; - float: right; - margin-right: 0; + float: inline-end; + margin-inline-end: 0; } @include breakpoint($x-large) { - margin-right: 0; + margin-inline-end: 0; } } @@ -124,15 +147,13 @@ .author__content { display: table-cell; vertical-align: top; - padding-left: 15px; - padding-right: 25px; + padding-inline: 15px 25px; line-height: 1; @include breakpoint($large) { display: block; width: 100%; - padding-left: 0; - padding-right: 0; + padding-inline: 0; } a { @@ -168,8 +189,7 @@ display: table-cell; vertical-align: middle; font-family: $sans-serif; - z-index: 10; - position: relative; + z-index: 20; cursor: pointer; li:last-child { @@ -178,13 +198,38 @@ } } + .author__urls { + span.label { + padding-inline-start: 5px; + } + } + @include breakpoint($large) { display: block; } button { + position: relative; margin-bottom: 0; + &:before { + @supports (pointer-events: none) { + content: ''; + position: fixed; + top: 0; + inset-inline-start: 0; + width: 100%; + height: 100%; + pointer-events: none; + } + } + + &.open { + &:before { + pointer-events: auto; + } + } + @include breakpoint($large) { display: none; } @@ -194,14 +239,13 @@ .author__urls { display: none; position: absolute; - right: 0; + inset-inline-end: 0; margin-top: 15px; padding: 10px; list-style-type: none; border: 1px solid $border-color; border-radius: $border-radius; background: $background-color; - z-index: -1; box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12); cursor: default; @@ -219,12 +263,12 @@ box-shadow: none; } - &:before { + &::before { display: block; content: ""; position: absolute; top: -11px; - left: calc(50% - 10px); + inset-inline-start: calc(50% - 10px); width: 0; border-style: solid; border-width: 0 10px 10px; @@ -241,7 +285,7 @@ content: ""; position: absolute; top: -10px; - left: calc(50% - 10px); + inset-inline-start: calc(50% - 10px); width: 0; border-style: solid; border-width: 0 10px 10px; @@ -253,6 +297,11 @@ } } + ul { + padding: 10px; + list-style-type: none; + } + li { white-space: nowrap; } @@ -260,9 +309,8 @@ a { display: block; margin-bottom: 5px; - padding-right: 5px; - padding-top: 2px; - padding-bottom: 2px; + padding-block: 2px; + padding-inline-end: 5px; color: inherit; font-size: $type-size-5; text-decoration: none; @@ -279,19 +327,23 @@ .wide .sidebar__right { margin-bottom: 1em; + @include breakpoint($large) { position: initial; top: initial; - right: initial; + inset-inline-end: initial; width: initial; - margin-right: initial; - padding-left: initial; + margin-inline-end: initial; + padding-inline-start: initial; z-index: initial; + + &.sticky { + float: none; + } } @include breakpoint($x-large) { width: initial; - margin-right: initial; + margin-inline-end: initial; } } - diff --git a/_sass/minimal-mistakes/_syntax.scss b/_sass/minimal-mistakes/_syntax.scss index 726520202bcd..6d9102d6f663 100644 --- a/_sass/minimal-mistakes/_syntax.scss +++ b/_sass/minimal-mistakes/_syntax.scss @@ -13,6 +13,11 @@ figure.highlight { line-height: 1.8; border-radius: $border-radius; + [dir=rtl] & { + direction: ltr; + text-align: start; + } + > pre, pre.highlight { margin: 0; @@ -33,17 +38,17 @@ figure.highlight { /* line numbers*/ &.gutter, &.rouge-gutter { - padding-right: 1em; + padding-inline-end: 1em; width: 1em; color: $base04; - border-right: 1px solid $base04; - text-align: right; + border-inline-end: 1px solid $base04; + text-align: end; } /* code */ &.code, &.rouge-code { - padding-left: 1em; + padding-inline-start: 1em; } } @@ -321,4 +326,4 @@ figure.highlight { th, td { border-bottom: 0; } -} \ No newline at end of file +} diff --git a/_sass/minimal-mistakes/_tables.scss b/_sass/minimal-mistakes/_tables.scss index 05211df05344..e2704ee81edc 100644 --- a/_sass/minimal-mistakes/_tables.scss +++ b/_sass/minimal-mistakes/_tables.scss @@ -3,11 +3,13 @@ ========================================================================== */ table { + display: block; margin-bottom: 1em; width: 100%; font-family: $global-font-family; font-size: $type-size-6; border-collapse: collapse; + overflow-x: auto; & + table { margin-top: 1em; @@ -22,7 +24,7 @@ thead { th { padding: 0.5em; font-weight: bold; - text-align: left; + text-align: start; } td { @@ -34,4 +36,4 @@ tr, td, th { vertical-align: middle; -} \ No newline at end of file +} diff --git a/_sass/minimal-mistakes/_utilities.scss b/_sass/minimal-mistakes/_utilities.scss index b989f3a221ee..8ec69d20241b 100644 --- a/_sass/minimal-mistakes/_utilities.scss +++ b/_sass/minimal-mistakes/_utilities.scss @@ -29,13 +29,18 @@ .visually-hidden, .screen-reader-text, .screen-reader-text span, -.screen-reader-shortcut { +.screen-reader-shortcut, +.sr-only, +.sr-only-focusable:not(:focus) { position: absolute !important; - clip: rect(1px, 1px, 1px, 1px); + clip: rect(0, 0, 0, 0); height: 1px !important; width: 1px !important; + padding: 0 !important; border: 0 !important; + margin: -1px; overflow: hidden; + white-space: nowrap; } body:hover .visually-hidden a, @@ -83,24 +88,36 @@ body:hover .visually-hidden button { Type ========================================================================== */ -.text-left { - text-align: left; +$text-alignments: left, right, start, end, center, justify; +@each $alignment in $text-alignments { + .text-#{$alignment} { + text-align: $alignment; + } } -.text-center { - text-align: center; +.text-nowrap { + white-space: nowrap; } -.text-right { - text-align: right; -} +/* + Task lists + ========================================================================== */ + +.task-list { + padding: 0; + + li { + list-style-type: none; + } -.text-justify { - text-align: justify; + .task-list-item-checkbox { + margin-inline-end: 0.5em; + opacity: 1; + } } -.text-nowrap { - white-space: nowrap; +.task-list .task-list { + margin-inline-start: 1em; } /* @@ -114,8 +131,7 @@ body:hover .visually-hidden button { } .wrapper { - margin-left: auto; - margin-right: auto; + margin-inline: auto; width: 100%; } @@ -127,8 +143,7 @@ body:hover .visually-hidden button { .align-left { display: block; - margin-left: auto; - margin-right: auto; + margin-inline: auto; @include breakpoint($small) { float: left; @@ -140,8 +155,7 @@ body:hover .visually-hidden button { .align-right { display: block; - margin-left: auto; - margin-right: auto; + margin-inline: auto; @include breakpoint($small) { float: right; @@ -153,15 +167,14 @@ body:hover .visually-hidden button { .align-center { display: block; - margin-left: auto; - margin-right: auto; + margin-inline: auto; } /* file page content container */ .full { @include breakpoint($large) { - margin-right: -1 * span(2.5 of 12) !important; + margin-inline-end: -1 * span(2.5 of 12) !important; } } @@ -190,107 +203,36 @@ body:hover .visually-hidden button { color: $text-color; } - .fa-behance, - .fa-behance-square { - color: $behance-color; - } - - .fa-bitbucket { - color: $bitbucket-color; - } - - .fa-dribbble, - .fa-dribble-square { - color: $dribbble-color; - } - - .fa-facebook, - .fa-facebook-square, - .fa-facebook-f { - color: $facebook-color; - } - - .fa-flickr { - color: $flickr-color; - } - - .fa-foursquare { - color: $foursquare-color; - } - - .fa-github, - .fa-github-alt, - .fa-github-square { - color: $github-color; - } - - .fa-google-plus, - .fa-google-plus-square, - .fa-google-plus-g { - color: $google-plus-color; - } - - .fa-instagram { - color: $instagram-color; - } - - .fa-lastfm, - .fa-lastfm-square { - color: $lastfm-color; - } - - .fa-linkedin, - .fa-linkedin-in { - color: $linkedin-color; - } - - .fa-pinterest, - .fa-pinterest-p, - .fa-pinterest-square { - color: $pinterest-color; - } - - .fa-rss, - .fa-rss-square { - color: $rss-color; - } - - .fa-soundcloud { - color: $soundcloud-color; - } - - .fa-stack-exchange, - .fa-stack-overflow { - color: $stackoverflow-color; - } - - .fa-tumblr, - .fa-tumblr-square { - color: $tumblr-color; - } - - .fa-twitter, - .fa-twitter-square { - color: $twitter-color; - } - - .fa-vimeo, - .fa-vimeo-square, - .fa-vimeo-v { - color: $vimeo-color; - } - - .fa-vine { - color: $vine-color; - } - - .fa-youtube { - color: $youtube-color; - } - - .fa-xing, - .fa-xing-square { - color: $xing-color; + @each $color, $icons in ( + $behance-color: ".fa-behance, .fa-behance-square", + $bitbucket-color: ".fa-bitbucket", + $dribbble-color: ".fa-dribbble, .fa-dribbble-square", + $facebook-color: ".fa-facebook, .fa-facebook-square, .fa-facebook-f", + $flickr-color: ".fa-flickr", + $foursquare-color: ".fa-foursquare", + $github-color: ".fa-github, .fa-github-alt, .fa-github-square", + $gitlab-color: ".fa-gitlab", + $instagram-color: ".fa-instagram", + $keybase-color: ".fa-keybase", + $lastfm-color: ".fa-lastfm, .fa-lastfm-square", + $linkedin-color: ".fa-linkedin, .fa-linkedin-in", + $mastodon-color: ".fa-mastodon, .fa-mastodon-square", + $pinterest-color: ".fa-pinterest, .fa-pinterest-p, .fa-pinterest-square", + $reddit-color: ".fa-reddit", + $rss-color: ".fa-rss, .fa-rss-square", + $soundcloud-color: ".fa-soundcloud", + $stackoverflow-color: ".fa-stack-exchange, .fa-stack-overflow", + $tumblr-color: ".fa-tumblr, .fa-tumblr-square", + $twitter-color: ".fa-twitter, .fa-twitter-square", + $x-color: ".fa-x-twitter, .fa-square-x-twitter", + $vimeo-color: ".fa-vimeo, .fa-vimeo-square, .fa-vimeo-v", + $vine-color: ".fa-vine", + $xing-color: ".fa-xing, .fa-xing-square", + $youtube-color: ".fa-youtube", + ) { + #{$icons} { + color: $color; + } } } @@ -302,19 +244,19 @@ body:hover .visually-hidden button { position: relative; width: $navicon-width; height: $navicon-height; - background: #fff; + background: $primary-color; margin: auto; -webkit-transition: 0.3s; transition: 0.3s; - &:before, - &:after { + &::before, + &::after { content: ""; position: absolute; - left: 0; + inset-inline-start: 0; width: $navicon-width; height: $navicon-height; - background: #fff; + background: $primary-color; -webkit-transition: 0.3s; transition: 0.3s; } @@ -353,6 +295,47 @@ body:hover .visually-hidden button { } } +.greedy-nav__toggle { + &:before { + @supports (pointer-events: none) { + content: ''; + position: fixed; + top: 0; + inset-inline-start: 0; + width: 100%; + height: 100%; + opacity: 0; + background-color: $background-color; + -webkit-transition: $global-transition; + transition: $global-transition; + pointer-events: none; + } + } + + &.close { + &:before { + opacity: 0.9; + -webkit-transition: $global-transition; + transition: $global-transition; + pointer-events: auto; + } + } +} + +.greedy-nav__toggle:hover { + .navicon, + .navicon:before, + .navicon:after { + background: mix(#000, $primary-color, 25%); + } + + &.close { + .navicon { + background: transparent; + } + } +} + /* Sticky, fixed to top content ========================================================================== */ @@ -392,11 +375,11 @@ body:hover .visually-hidden button { overflow: hidden; position: relative; - &:before { + &::before { position: absolute; content: ""; top: 0; - left: 0; + inset-inline-start: 0; width: 100%; height: 100%; z-index: 999; @@ -413,8 +396,8 @@ body:hover .visually-hidden button { position: fixed; width: 300px; top: 50%; - left: 50%; - margin-left: -150px; + inset-inline-start: 50%; + margin-inline-start: -150px; margin-top: -150px; min-height: 0; z-index: 9999; @@ -505,7 +488,7 @@ a.reversefootnote { embed { position: absolute; top: 0; - left: 0; + inset-inline-start: 0; width: 100%; height: 100%; } @@ -518,3 +501,74 @@ a.reversefootnote { position: static; } } + +/* + Copy 
 block to clipboard
+   ========================================================================== */
+
+// a ",ve.noCloneChecked=!!e.cloneNode(!0).lastChild.defaultValue}();var et=ae.documentElement,tt=/^key/,nt=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,rt=/^([^.]*)(?:\.(.+)|)/;we.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,u,c,f,d,p,h,m,g=Be.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&we.find.matchesSelector(et,i),n.guid||(n.guid=we.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==we&&we.event.triggered!==t.type?we.event.dispatch.apply(e,arguments):void 0}),u=(t=(t||"").match(Le)||[""]).length;u--;)p=m=(s=rt.exec(t[u])||[])[1],h=(s[2]||"").split(".").sort(),p&&(f=we.event.special[p]||{},p=(i?f.delegateType:f.bindType)||p,f=we.event.special[p]||{},c=we.extend({type:p,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&we.expr.match.needsContext.test(i),namespace:h.join(".")},o),(d=l[p])||((d=l[p]=[]).delegateCount=0,f.setup&&!1!==f.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(p,a)),f.add&&(f.add.call(e,c),c.handler.guid||(c.handler.guid=n.guid)),i?d.splice(d.delegateCount++,0,c):d.push(c),we.event.global[p]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,u,c,f,d,p,h,m,g=Be.hasData(e)&&Be.get(e);if(g&&(l=g.events)){for(u=(t=(t||"").match(Le)||[""]).length;u--;)if(s=rt.exec(t[u])||[],p=m=s[1],h=(s[2]||"").split(".").sort(),p){for(f=we.event.special[p]||{},d=l[p=(r?f.delegateType:f.bindType)||p]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=d.length;o--;)c=d[o],!i&&m!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(d.splice(o,1),c.selector&&d.delegateCount--,f.remove&&f.remove.call(e,c));a&&!d.length&&(f.teardown&&!1!==f.teardown.call(e,h,g.handle)||we.removeEvent(e,p,g.handle),delete l[p])}else for(p in l)we.event.remove(e,p+t[u],n,r,!0);we.isEmptyObject(l)&&Be.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=we.event.fix(e),l=new Array(arguments.length),u=(Be.get(this,"events")||{})[s.type]||[],c=we.event.special[s.type]||{};for(l[0]=s,t=1;t=1))for(;u!==this;u=u.parentNode||this)if(1===u.nodeType&&("click"!==e.type||!0!==u.disabled)){for(o=[],a={},n=0;n-1:we.find(i,this,null,[u]).length),a[i]&&o.push(r);o.length&&s.push({elem:u,handlers:o})}return u=this,l\x20\t\r\n\f]*)[^>]*)\/>/gi,ot=/\s*$/g;we.extend({htmlPrefilter:function(e){return e.replace(it,"<$1>")},clone:function(e,t,n){var r,i,o,a,s=e.cloneNode(!0),l=we.contains(e.ownerDocument,e);if(!(ve.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||we.isXMLDoc(e)))for(a=w(s),r=0,i=(o=w(e)).length;r0&&C(a,!l&&w(e,"script")),s},cleanData:function(e){for(var t,n,r,i=we.event.special,o=0;void 0!==(n=e[o]);o++)if(_e(n)){if(t=n[Be.expando]){if(t.events)for(r in t.events)i[r]?we.event.remove(n,r):we.removeEvent(n,r,t.handle);n[Be.expando]=void 0}n[$e.expando]&&(n[$e.expando]=void 0)}}}),we.fn.extend({detach:function(e){return P(this,e,!0)},remove:function(e){return P(this,e)},text:function(e){return qe(this,function(e){return void 0===e?we.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return O(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||N(this,e).appendChild(e)})},prepend:function(){return O(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=N(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return O(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return O(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(we.cleanData(w(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return we.clone(this,e,t)})},html:function(e){return qe(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!ot.test(e)&&!Qe[(Ze.exec(e)||["",""])[1].toLowerCase()]){e=we.htmlPrefilter(e);try{for(;n1)}}),we.Tween=z,z.prototype={constructor:z,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||we.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(we.cssNumber[n]?"":"px")},cur:function(){var e=z.propHooks[this.prop];return e&&e.get?e.get(this):z.propHooks._default.get(this)},run:function(e){var t,n=z.propHooks[this.prop];return this.options.duration?this.pos=t=we.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):z.propHooks._default.set(this),this}},z.prototype.init.prototype=z.prototype,z.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=we.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){we.fx.step[e.prop]?we.fx.step[e.prop](e):1!==e.elem.nodeType||null==e.elem.style[we.cssProps[e.prop]]&&!we.cssHooks[e.prop]?e.elem[e.prop]=e.now:we.style(e.elem,e.prop,e.now+e.unit)}}},z.propHooks.scrollTop=z.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},we.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},we.fx=z.prototype.init,we.fx.step={};var vt,yt,xt=/^(?:toggle|show|hide)$/,bt=/queueHooks$/;we.Animation=we.extend(G,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return y(n.elem,e,We.exec(t),n),n}]},tweener:function(e,t){ye(e)?(t=e,e=["*"]):e=e.match(Le);for(var n,r=0,i=e.length;r1)},removeAttr:function(e){return this.each(function(){we.removeAttr(this,e)})}}),we.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?we.prop(e,t,n):(1===o&&we.isXMLDoc(e)||(i=we.attrHooks[t.toLowerCase()]||(we.expr.match.bool.test(t)?wt:void 0)),void 0!==n?null===n?void we.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=we.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!ve.radioValue&&"radio"===t&&o(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(Le);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),wt={set:function(e,t,n){return!1===t?we.removeAttr(e,n):e.setAttribute(n,n),n}},we.each(we.expr.match.bool.source.match(/\w+/g),function(e,t){var n=Ct[t]||we.find.attr;Ct[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=Ct[a],Ct[a]=i,i=null!=n(e,t,r)?a:null,Ct[a]=o),i}});var Tt=/^(?:input|select|textarea|button)$/i,kt=/^(?:a|area)$/i;we.fn.extend({prop:function(e,t){return qe(this,we.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[we.propFix[e]||e]})}}),we.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&we.isXMLDoc(e)||(t=we.propFix[t]||t,i=we.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=we.find.attr(e,"tabindex");return t?parseInt(t,10):Tt.test(e.nodeName)||kt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),ve.optSelected||(we.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),we.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){we.propFix[this.toLowerCase()]=this}),we.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(ye(e))return this.each(function(t){we(this).addClass(e.call(this,t,K(this)))});if((t=Q(e)).length)for(;n=this[l++];)if(i=K(n),r=1===n.nodeType&&" "+Z(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=Z(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(ye(e))return this.each(function(t){we(this).removeClass(e.call(this,t,K(this)))});if(!arguments.length)return this.attr("class","");if((t=Q(e)).length)for(;n=this[l++];)if(i=K(n),r=1===n.nodeType&&" "+Z(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=Z(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):ye(e)?this.each(function(n){we(this).toggleClass(e.call(this,n,K(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=we(this),a=Q(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=K(this))&&Be.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Be.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+Z(K(n))+" ").indexOf(t)>-1)return!0;return!1}});var St=/\r/g;we.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=ye(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,we(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=we.map(i,function(e){return null==e?"":e+""})),(t=we.valHooks[this.type]||we.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=we.valHooks[i.type]||we.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(St,""):null==n?"":n:void 0}}),we.extend({valHooks:{option:{get:function(e){var t=we.find.attr(e,"value");return null!=t?t:Z(we.text(e))}},select:{get:function(e){var t,n,r,i=e.options,a=e.selectedIndex,s="select-one"===e.type,l=s?null:[],u=s?a+1:i.length;for(r=a<0?u:s?a:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),we.each(["radio","checkbox"],function(){we.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=we.inArray(we(e).val(),t)>-1}},ve.checkOn||(we.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),ve.focusin="onfocusin"in e;var Et=/^(?:focusinfocus|focusoutblur)$/,jt=function(e){e.stopPropagation()};we.extend(we.event,{trigger:function(t,n,r,i){var o,a,s,l,u,c,f,d,p=[r||ae],h=he.call(t,"type")?t.type:t,m=he.call(t,"namespace")?t.namespace.split("."):[];if(a=d=s=r=r||ae,3!==r.nodeType&&8!==r.nodeType&&!Et.test(h+we.event.triggered)&&(h.indexOf(".")>-1&&(h=(m=h.split(".")).shift(),m.sort()),u=h.indexOf(":")<0&&"on"+h,t=t[we.expando]?t:new we.Event(h,"object"==typeof t&&t),t.isTrigger=i?2:3,t.namespace=m.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+m.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=r),n=null==n?[t]:we.makeArray(n,[t]),f=we.event.special[h]||{},i||!f.trigger||!1!==f.trigger.apply(r,n))){if(!i&&!f.noBubble&&!xe(r)){for(l=f.delegateType||h,Et.test(l+h)||(a=a.parentNode);a;a=a.parentNode)p.push(a),s=a;s===(r.ownerDocument||ae)&&p.push(s.defaultView||s.parentWindow||e)}for(o=0;(a=p[o++])&&!t.isPropagationStopped();)d=a,t.type=o>1?l:f.bindType||h,(c=(Be.get(a,"events")||{})[t.type]&&Be.get(a,"handle"))&&c.apply(a,n),(c=u&&a[u])&&c.apply&&_e(a)&&(t.result=c.apply(a,n),!1===t.result&&t.preventDefault());return t.type=h,i||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(p.pop(),n)||!_e(r)||u&&ye(r[h])&&!xe(r)&&((s=r[u])&&(r[u]=null),we.event.triggered=h,t.isPropagationStopped()&&d.addEventListener(h,jt),r[h](),t.isPropagationStopped()&&d.removeEventListener(h,jt),we.event.triggered=void 0,s&&(r[u]=s)),t.result}},simulate:function(e,t,n){var r=we.extend(new we.Event,n,{type:e,isSimulated:!0});we.event.trigger(r,null,t)}}),we.fn.extend({trigger:function(e,t){return this.each(function(){we.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return we.event.trigger(e,t,n,!0)}}),ve.focusin||we.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){we.event.simulate(t,e.target,we.event.fix(e))};we.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Be.access(r,t);i||r.addEventListener(e,n,!0),Be.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Be.access(r,t)-1;i?Be.access(r,t,i):(r.removeEventListener(e,n,!0),Be.remove(r,t))}}});var Nt=e.location,At=Date.now(),Dt=/\?/;we.parseXML=function(t){var n;if(!t||"string"!=typeof t)return null;try{n=(new e.DOMParser).parseFromString(t,"text/xml")}catch(e){n=void 0}return n&&!n.getElementsByTagName("parsererror").length||we.error("Invalid XML: "+t),n};var It=/\[\]$/,Lt=/\r?\n/g,Ot=/^(?:submit|button|image|reset|file)$/i,Pt=/^(?:input|select|textarea|keygen)/i;we.param=function(e,t){var n,r=[],i=function(e,t){var n=ye(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!we.isPlainObject(e))we.each(e,function(){i(this.name,this.value)});else for(n in e)J(n,e[n],t,i);return r.join("&")},we.fn.extend({serialize:function(){return we.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=we.prop(this,"elements");return e?we.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!we(this).is(":disabled")&&Pt.test(this.nodeName)&&!Ot.test(e)&&(this.checked||!Ge.test(e))}).map(function(e,t){var n=we(this).val();return null==n?null:Array.isArray(n)?we.map(n,function(e){return{name:t.name,value:e.replace(Lt,"\r\n")}}):{name:t.name,value:n.replace(Lt,"\r\n")}}).get()}});var qt=/%20/g,Ht=/#.*$/,Mt=/([?&])_=[^&]*/,_t=/^(.*?):[ \t]*([^\r\n]*)$/gm,Bt=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,$t=/^(?:GET|HEAD)$/,Ft=/^\/\//,zt={},Rt={},Wt="*/".concat("*"),Ut=ae.createElement("a");Ut.href=Nt.href,we.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Nt.href,type:"GET",isLocal:Bt.test(Nt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Wt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":we.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?ne(ne(e,we.ajaxSettings),t):ne(we.ajaxSettings,e)},ajaxPrefilter:ee(zt),ajaxTransport:ee(Rt),ajax:function(t,n){function r(t,n,r,s){var u,d,p,b,w,C=n;c||(c=!0,l&&e.clearTimeout(l),i=void 0,a=s||"",T.readyState=t>0?4:0,u=t>=200&&t<300||304===t,r&&(b=re(h,T,r)),b=ie(h,b,T,u),u?(h.ifModified&&((w=T.getResponseHeader("Last-Modified"))&&(we.lastModified[o]=w),(w=T.getResponseHeader("etag"))&&(we.etag[o]=w)),204===t||"HEAD"===h.type?C="nocontent":304===t?C="notmodified":(C=b.state,d=b.data,u=!(p=b.error))):(p=C,!t&&C||(C="error",t<0&&(t=0))),T.status=t,T.statusText=(n||C)+"",u?v.resolveWith(m,[d,C,T]):v.rejectWith(m,[T,C,p]),T.statusCode(x),x=void 0,f&&g.trigger(u?"ajaxSuccess":"ajaxError",[T,h,u?d:p]),y.fireWith(m,[T,C]),f&&(g.trigger("ajaxComplete",[T,h]),--we.active||we.event.trigger("ajaxStop")))}"object"==typeof t&&(n=t,t=void 0),n=n||{};var i,o,a,s,l,u,c,f,d,p,h=we.ajaxSetup({},n),m=h.context||h,g=h.context&&(m.nodeType||m.jquery)?we(m):we.event,v=we.Deferred(),y=we.Callbacks("once memory"),x=h.statusCode||{},b={},w={},C="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(c){if(!s)for(s={};t=_t.exec(a);)s[t[1].toLowerCase()]=t[2];t=s[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return c?a:null},setRequestHeader:function(e,t){return null==c&&(e=w[e.toLowerCase()]=w[e.toLowerCase()]||e,b[e]=t),this},overrideMimeType:function(e){return null==c&&(h.mimeType=e),this},statusCode:function(e){var t;if(e)if(c)T.always(e[T.status]);else for(t in e)x[t]=[x[t],e[t]];return this},abort:function(e){var t=e||C;return i&&i.abort(t),r(0,t),this}};if(v.promise(T),h.url=((t||h.url||Nt.href)+"").replace(Ft,Nt.protocol+"//"),h.type=n.method||n.type||h.method||h.type,h.dataTypes=(h.dataType||"*").toLowerCase().match(Le)||[""],null==h.crossDomain){u=ae.createElement("a");try{u.href=h.url,u.href=u.href,h.crossDomain=Ut.protocol+"//"+Ut.host!=u.protocol+"//"+u.host}catch(e){h.crossDomain=!0}}if(h.data&&h.processData&&"string"!=typeof h.data&&(h.data=we.param(h.data,h.traditional)),te(zt,h,n,T),c)return T;(f=we.event&&h.global)&&0==we.active++&&we.event.trigger("ajaxStart"),h.type=h.type.toUpperCase(),h.hasContent=!$t.test(h.type),o=h.url.replace(Ht,""),h.hasContent?h.data&&h.processData&&0===(h.contentType||"").indexOf("application/x-www-form-urlencoded")&&(h.data=h.data.replace(qt,"+")):(p=h.url.slice(o.length),h.data&&(h.processData||"string"==typeof h.data)&&(o+=(Dt.test(o)?"&":"?")+h.data,delete h.data),!1===h.cache&&(o=o.replace(Mt,"$1"),p=(Dt.test(o)?"&":"?")+"_="+At+++p),h.url=o+p),h.ifModified&&(we.lastModified[o]&&T.setRequestHeader("If-Modified-Since",we.lastModified[o]),we.etag[o]&&T.setRequestHeader("If-None-Match",we.etag[o])),(h.data&&h.hasContent&&!1!==h.contentType||n.contentType)&&T.setRequestHeader("Content-Type",h.contentType),T.setRequestHeader("Accept",h.dataTypes[0]&&h.accepts[h.dataTypes[0]]?h.accepts[h.dataTypes[0]]+("*"!==h.dataTypes[0]?", "+Wt+"; q=0.01":""):h.accepts["*"]);for(d in h.headers)T.setRequestHeader(d,h.headers[d]);if(h.beforeSend&&(!1===h.beforeSend.call(m,T,h)||c))return T.abort();if(C="abort",y.add(h.complete),T.done(h.success),T.fail(h.error),i=te(Rt,h,n,T)){if(T.readyState=1,f&&g.trigger("ajaxSend",[T,h]),c)return T;h.async&&h.timeout>0&&(l=e.setTimeout(function(){T.abort("timeout")},h.timeout));try{c=!1,i.send(b,r)}catch(e){if(c)throw e;r(-1,e)}}else r(-1,"No Transport");return T},getJSON:function(e,t,n){return we.get(e,t,n,"json")},getScript:function(e,t){return we.get(e,void 0,t,"script")}}),we.each(["get","post"],function(e,t){we[t]=function(e,n,r,i){return ye(n)&&(i=i||r,r=n,n=void 0),we.ajax(we.extend({url:e,type:t,dataType:i,data:n,success:r},we.isPlainObject(e)&&e))}}),we._evalUrl=function(e){return we.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,throws:!0})},we.fn.extend({wrapAll:function(e){var t;return this[0]&&(ye(e)&&(e=e.call(this[0])),t=we(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return ye(e)?this.each(function(t){we(this).wrapInner(e.call(this,t))}):this.each(function(){var t=we(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=ye(e);return this.each(function(n){we(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){we(this).replaceWith(this.childNodes)}),this}}),we.expr.pseudos.hidden=function(e){return!we.expr.pseudos.visible(e)},we.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},we.ajaxSettings.xhr=function(){try{return new e.XMLHttpRequest}catch(e){}};var Xt={0:200,1223:204},Vt=we.ajaxSettings.xhr();ve.cors=!!Vt&&"withCredentials"in Vt,ve.ajax=Vt=!!Vt,we.ajaxTransport(function(t){var n,r;if(ve.cors||Vt&&!t.crossDomain)return{send:function(i,o){var a,s=t.xhr();if(s.open(t.type,t.url,t.async,t.username,t.password),t.xhrFields)for(a in t.xhrFields)s[a]=t.xhrFields[a];t.mimeType&&s.overrideMimeType&&s.overrideMimeType(t.mimeType),t.crossDomain||i["X-Requested-With"]||(i["X-Requested-With"]="XMLHttpRequest");for(a in i)s.setRequestHeader(a,i[a]);n=function(e){return function(){n&&(n=r=s.onload=s.onerror=s.onabort=s.ontimeout=s.onreadystatechange=null,"abort"===e?s.abort():"error"===e?"number"!=typeof s.status?o(0,"error"):o(s.status,s.statusText):o(Xt[s.status]||s.status,s.statusText,"text"!==(s.responseType||"text")||"string"!=typeof s.responseText?{binary:s.response}:{text:s.responseText},s.getAllResponseHeaders()))}},s.onload=n(),r=s.onerror=s.ontimeout=n("error"),void 0!==s.onabort?s.onabort=r:s.onreadystatechange=function(){4===s.readyState&&e.setTimeout(function(){n&&r()})},n=n("abort");try{s.send(t.hasContent&&t.data||null)}catch(e){if(n)throw e}},abort:function(){n&&n()}}}),we.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),we.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return we.globalEval(e),e}}}),we.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),we.ajaxTransport("script",function(e){if(e.crossDomain){var t,n;return{send:function(r,i){t=we("
+  {% endfor %}
+{% endif %}
+```{% endraw %}
+
+Next, add `page_js` to any page's YAML Front Matter to have your JavaScript loaded for that page.
+```yaml
+page_js:
+  - /path/to/your/custom.js
+```
+
+---
diff --git a/docs/_docs/11-posts.md b/docs/_docs/11-posts.md
index f8126291c0f9..41b72aa191d9 100644
--- a/docs/_docs/11-posts.md
+++ b/docs/_docs/11-posts.md
@@ -2,7 +2,7 @@
 title: "Working with Posts"
 permalink: /docs/posts/
 excerpt: "Suggestions and Front Matter defaults for working with posts."
-last_modified_at: 2016-11-03T11:12:40-04:00
+last_modified_at: 2018-03-20T15:59:57-04:00
 ---
 
 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/).
@@ -31,7 +31,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" | absolute_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*]({{ "/docs/layouts/#social-sharing-links" | relative_url }}), and *related posts*, for all posts.
 
 **ProTip:** Remember to write unique `excerpt` descriptions for each post for improved SEO and archive listings.
 {: .notice--info}
\ No newline at end of file
diff --git a/docs/_docs/13-collections.md b/docs/_docs/13-collections.md
index cfa568b49632..8a88b51a5e0a 100644
--- a/docs/_docs/13-collections.md
+++ b/docs/_docs/13-collections.md
@@ -2,12 +2,12 @@
 title: "Working with Collections"
 permalink: /docs/collections/
 excerpt: "Suggestions and Front Matter defaults for working with collections."
-last_modified_at: 2016-11-03T11:13:38-04:00
+last_modified_at: 2018-03-20T16:00:02-04:00
 ---
 
 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/" | absolute_url }}) on the demo site ([portfolio]({{ "/portfolio/" | absolute_url }}), [recipes]({{ "/recipes/" | absolute_url }}), pets). 
+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 }})). 
 
 **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.
 {: .notice--info}
@@ -41,6 +41,19 @@ defaults:
       share: true
 ```
 
+Now make a portfolio.md file in the '_pages' folder.
+
+```yaml
+---
+title: Portfolio
+layout: collection
+permalink: /portfolio/
+collection: portfolio
+entries_layout: grid
+classes: wide
+---
+```
+
 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.
 
-![portfolio collection example]({{ "/assets/images/mm-portfolio-collection-example.jpg" | absolute_url }})
\ No newline at end of file
+![portfolio collection example]({{ "/assets/images/mm-portfolio-collection-example.jpg" | relative_url }})
diff --git a/docs/_docs/14-helpers.md b/docs/_docs/14-helpers.md
index 369e5b521976..9f281b4f8c69 100644
--- a/docs/_docs/14-helpers.md
+++ b/docs/_docs/14-helpers.md
@@ -30,7 +30,7 @@ feature_row:
   - image_path: /assets/images/unsplash-gallery-image-3-th.jpg
     title: "Placeholder 3"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
-last_modified_at: 2018-01-09T14:26:13-05:00
+last_modified_at: 2020-05-01T10:22:56-04:00
 toc: true
 toc_label: "Helpers"
 toc_icon: "cogs"
@@ -38,56 +38,38 @@ toc_icon: "cogs"
 
 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
-
-**Deprecated**. Use `absolute_url` filter instead.
-
-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 use absolute URL paths for assets (especially post images) so they correctly resolve in the site's XML feeds. Example: `{% raw %}{{ "/assets/images/filename.jpg" | absolute_url }}{% endraw %}` ~> `https://yourdoamin.com/assets/images/filename.jpg`
-{: .notice--info}
-
-## Group by Array
+## 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 tag     | [Source][tag-array]      | [Demo][tag-array-demo]      |
-
-[category-array]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.html
-[category-array-demo]: {{ "/categories/" | absolute_url }}
-[tag-array]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.html
-[tag-array-demo]: {{ "/tags/" | absolute_url }}
+A liquid include file for Jekyll that allows an object to be grouped by an array.
 
 ## Figure
 
 Generate a `
` element with a single image and caption.
 
-| Include Parameter | Required     | Description |
-| ----              | --------     | ----------- |
+| Include Parameter | Required     | Description                                                                                          |
+| ----------------- | ------------ | ---------------------------------------------------------------------------------------------------- |
 | **image_path**    | **Required** | Full path to image eg: `/assets/images/filename.jpg`. Use absolute URLS for those hosted externally. |
-| **alt**           | Optional     | Alternate text for image. |
-| **caption**       | Optional     | Figure caption text. Markdown is allowed. |
+| **alt**           | Optional     | Alternate text for image.                                                                            |
+| **caption**       | Optional     | Figure caption text. Markdown is allowed.                                                            |
+| **popup**         | Optional     | Enable Magnific Popup on the image.                                                                  |
 
 Using the `figure` include like so:
 
 ```liquid
-{% raw %}{% include figure image_path="/assets/images/unsplash-image-10.jpg" alt="this is a placeholder image" caption="This is a figure caption." %}{% endraw %}
+{% raw %}{% include figure popup=true image_path="/assets/images/unsplash-image-10.jpg" alt="this is a placeholder image" caption="This is a figure caption." %}{% endraw %}
 ```
 
 Will output the following:
 
-{% include figure image_path="/assets/images/unsplash-image-10.jpg" alt="this is a placeholder image" caption="This is a figure caption." %}
+{% include figure popup=true image_path="/assets/images/unsplash-image-10.jpg" alt="this is a placeholder image" caption="This is a figure caption." %}
 
 ```html
 

-  this is a placeholder image
+  
+    this is a placeholder image
+  
   
This is a figure caption.

 

 ```
@@ -98,11 +80,11 @@ Generate a `
` element with optional caption of arrays with two or more i
 
 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** | Full path to image eg: `/assets/images/filename.jpg`. Use absolute URLS for those hosted externally. |
-| **alt**        | Optional     | Alternate text for image. |
+| Name           | Required     | Description                                                                                                           |
+| -------------- | ------------ | --------------------------------------------------------------------------------------------------------------------- |
+| **url**        | Optional     | URL to link gallery image to (eg. a larger detail image).                                                             |
+| **image_path** | **Required** | Full path to image eg: `/assets/images/filename.jpg`. 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
@@ -121,13 +103,14 @@ gallery:
     title: "Image 3 title caption"
 ```
 
-And then drop-in the gallery include in the body where you'd like it to appear. 
+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 `
` element for additional styling needs. | |
-| **caption**       | Optional    | Gallery caption description. Markdown is allowed. | |
+| 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`                                                                    |
+| **layout**        | Optional | Layout type. 2 column: `half`, 3 column: `third`, single column: `''` (blank)                                                                                     | Determined by gallery size. Two items: `half`, three or more items: `third`. |
+| **class**         | Optional | Use to add a `class` attribute to the surrounding `
` 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 %}
@@ -137,24 +120,25 @@ And then drop-in the gallery include in the body where you'd like it to appear.
 
 {% 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/master/docs/_posts/2010-09-09-post-gallery.md) can be seen in [this sample gallery post]({{ "" | absolute_url }}{% post_url 2010-09-09-post-gallery %}).
+**More Gallery Goodness:** A few more examples and [source code](https://github.com/{{ site.repository }}/blob/master/docs/\_posts/2010-09-09-post-gallery.md) can be seen in [this sample gallery post]({{ "" | relative_url }}{% post_url 2010-09-09-post-gallery %}).
 {: .notice--info}
 
-## Feature Row
+## Feature row
 
-Designed to compliment the [`splash`]({{ "/docs/layouts/#splash-page-layout" | absolute_url }}) page layout as a way of arranging and aligning "feature blocks" containing text or image.
+Designed to compliment the [`splash`]({{ "/docs/layouts/#splash-page-layout" | relative_url }}) 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** | Full path to image eg: `/assets/images/filename.jpg`. 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]({{ "/docs/utility-classes/#buttons" | absolute_url }}) for options. | `btn` |
+| Name              | Required     | Description                                                                                          | Default                            |
+| ----------------- | ------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------- |
+| **image_path**    | **Required** | Full path to image eg: `/assets/images/filename.jpg`. Use absolute URLS for those hosted externally. |                                    |
+| **image_caption** | Optional     | Caption for image, Markdown is supported eg: `"Image from [Unsplash](https://unsplash.com)"`         |
+| **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]({{ "/docs/utility-classes/#buttons"                              | relative_url }}) for options.      | `btn` |
 
 ```yaml
 feature_row:
@@ -176,10 +160,10 @@ feature_row:
 
 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. | |
+| 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 %}
@@ -187,40 +171,44 @@ And then drop-in the feature row include in the body where you'd like it to appe
 
 {% include feature_row %}
 
-**More Feature Row Goodness:** A [few more examples]({{ "/splash-page/" | absolute_url }}) and [source code](https://github.com/{{ site.repository }}/blob/master/docs/_pages/splash-page.md) can be seen in the demo site.
+**More Feature Row Goodness:** A [few more examples]({{ "/splash-page/" | relative_url }}) and [source code](https://github.com/{{ site.repository }}/blob/master/docs/\_pages/splash-page.md) can be seen in the demo site.
 {: .notice--info}
 
-## Responsive Video Embed
+## Responsive video embed
 
-Embed a video from YouTube or Vimeo that responsively sizes to fit the width of its parent.
+Embed a video from YouTube, Vimeo, Google Drive, or bilibili that responsively sizes to fit the width of its parent. To help with GDPR compliance, the theme is using the privacy enhanced version of YouTube and Vimeo providers out of the box.
 
-| Parameter  | Required     | Description |
-|----------  |---------     | ----------- |
-| `id`       | **Required** | ID of the video |
-| `provider` | **Required** | Hosting provider of the video, either `youtube` or `vimeo` |
+| Parameter  | Required     | Description                                                |
+| ---------- | ------------ | ---------------------------------------------------------- |
+| `id`       | **Required** | ID of the video                                            |
+| `provider` | **Required** | Hosting provider of the video: `youtube`, `vimeo`, `google-drive`, or `bilibili` |
+| `danmaku`  | Optional     | Bilibili only, [details below](#Bilibili)                  |
 
 ### YouTube
 
-To embed the following YouTube video at url `https://www.youtube.com/watch?v=XsxDH4HcOWA` (long version) or `https://youtu.be/XsxDH4HcOWA` (short version) into a post or page's main content you'd use: 
+To embed the following YouTube video at url `https://www.youtube.com/watch?v=-PVofD2A9t8` (long version) or `https://youtu.be/-PVofD2A9t8` (short version) into a post or page's main content you'd use:
 
 ```liquid
-{% raw %}{% include video id="XsxDH4HcOWA" provider="youtube" %}{% endraw %}
+{% raw %}{% include video id="-PVofD2A9t8" provider="youtube" %}{% endraw %}
 ```
 
-{% include video id="XsxDH4HcOWA" provider="youtube" %}
+{% include video id="-PVofD2A9t8" provider="youtube" %}
 
 To embed it as a video header you'd use the following YAML Front Matter
 
 ```yaml
 header:
   video:
-    id: XsxDH4HcOWA
+    id: -PVofD2A9t8
     provider: youtube
 ```
 
+**Tip:** if you'd like to start the video at a particular timestamp, you can append `?start=110` (for instance) to the video `id` in order to have the video start at 1:50.
+{: .notice--info }
+
 ### Vimeo
 
-To embed the following Vimeo video at url `https://vimeo.com/212731897` into a post or page's main content you'd use: 
+To embed the following Vimeo video at url `https://vimeo.com/212731897` into a post or page's main content you'd use:
 
 ```liquid
 {% raw %}{% include video id="212731897" provider="vimeo" %}{% endraw %}
@@ -237,35 +225,104 @@ header:
     provider: vimeo
 ```
 
-## Table of Contents
+### Google Drive
+
+To embed the following Google Drive video at url `https://drive.google.com/file/d/1u41lIbMLbV53PvMbyYc9HzvBug5lNWaO/preview` into a post or page's main content you'd use:
+
+```liquid
+{% raw %}{% include video id="1u41lIbMLbV53PvMbyYc9HzvBug5lNWaO" provider="google-drive" %}{% endraw %}
+```
+
+{% include video id="1u41lIbMLbV53PvMbyYc9HzvBug5lNWaO" provider="google-drive" %}
+
+To embed it as a video header you'd use the following YAML Front Matter
+
+```yaml
+header:
+  video:
+    id: 212731897
+    provider: google-drive
+```
+
+### Bilibili
+
+To embed the following Bilibili video at url `https://www.bilibili.com/video/BV1E7411e7hC` into a post or page's main content you'd use:
+
+```liquid
+{% raw %}{% include video id="BV1E7411e7hC" provider="bilibili" %}{% endraw %}
+```
+
+If you want to enable danmaku (弹幕) for the embedded video, which is disabled by default, you can supply an additional parameter `danmaku="1"` as shown below:
+
+```liquid
+{% raw %}{% include video id="BV1E7411e7hC" provider="bilibili" danmaku="1" %}{% endraw %}
+```
+
+To embed it as a video header you'd use the following YAML Front Matter:
+
+```yaml
+header:
+  video:
+    id: BV1E7411e7hC
+    provider: bilibili
+    danmaku: 1
+```
+
+## Table of contents
 
 Auto-generated table of contents list for your posts and pages can be enabled using two methods.
 
-![table of contents example]({{ "/assets/images/mm-toc-helper-example.jpg" | absolute_url }})
+![table of contents example]({{ "/assets/images/mm-toc-helper-example.jpg" | relative_url }})
 
 ### Enabled via YAML Front Matter
 
 Add `toc: true` to the YAML Front Matter of any post or page.
 
-| 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/icons?d=gallery&s=solid&m=free)  **file-alt** icon. Other FA icons can be used instead. |
+| 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"
 ---
+
 ```
 
 **Note:** using both methods will have unintended results. Be sure to remove `{% raw %}{% include toc %}{% endraw %}` placed table of contents from your content when using `toc: true`.
 {: .notice--warning }
 
+{% 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 }}
+

+
 ### Enabled via `toc` include (deprecated)
 
 To include a Kramdown [auto-generated table of contents](https://kramdown.gettalong.org/converter/html.html#toc) for posts and pages, add the following helper to your content.
@@ -280,10 +337,10 @@ To include a Kramdown [auto-generated table of contents](https://kramdown.gettal
 **Deprecated:** `toc` helper will be removed in the next major version of the theme. It is encouraged that you migrate to the YAML Front Matter method above.
 {: .notice--danger}
 
-| Parameter   | Required | Description | Default |
-| ---------   | -------- | ----------- | ------- |
-| **title**   | Optional | Table of contents title. (string) | `toc_label` in UI Text data file. |
-| **icon**    | Optional | Table of contents icon, displays before the title. (string) | [Font Awesome](https://fontawesome.com/icons?d=gallery&s=solid&m=free)  **file-alt** icon. Other FA icons can be used instead. |
+| Parameter | Required | Description                                                 | Default                                                                                                                                                       |
+| --------- | -------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **title** | Optional | Table of contents title. (string)                           | `toc_label` in UI Text data file.                                                                                                                             |
+| **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 example with custom title and icon**
 
@@ -291,11 +348,11 @@ To include a Kramdown [auto-generated table of contents](https://kramdown.gettal
 {% raw %}{% include toc icon="cog" title="My Table of Contents" %}{% endraw %}
 ```
 
-## Navigation List
+## 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]({{ "/docs/navigation/" | absolute_url }}) is built.
+**1.** Start by adding a set of titles and URLs to `_data/navigation.yml` in the same way the [`main` navigation]({{ "/docs/navigation/" | relative_url }}) is built.
 
 `foo` navigation example:
 
@@ -359,6 +416,6 @@ To add a navigation list to a post or page's main content instead of the sidebar
 
 {% include nav_list nav="foo" %}
 
-| Parameter | Required     | Description |
-| --------- | --------     | ----------- |
+| Parameter | Required     | Description                                              |
+| --------- | ------------ | -------------------------------------------------------- |
 | items     | **Required** | Name of the links array found in `_data/navigation.yml`. |
diff --git a/docs/_docs/15-utility-classes.md b/docs/_docs/15-utility-classes.md
index 78ba4a9023de..3e20023f0e70 100644
--- a/docs/_docs/15-utility-classes.md
+++ b/docs/_docs/15-utility-classes.md
@@ -2,10 +2,10 @@
 title: "Utility Classes"
 permalink: /docs/utility-classes/
 excerpt: "CSS classes for aligning text/image, styling buttons and notices, and more."
-last_modified_at: 2017-10-20T12:36:34-04:00
+last_modified_at: 2018-11-25T19:46:43-05:00
 toc: true
 toc_label: "Utility Classes"
-toc_icon: "gears"
+toc_icon: "cogs"
 ---
 
 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.
@@ -13,7 +13,7 @@ Using the Kramdown Markdown renderer with Jekyll allows you to add [block](http:
 **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.
 {: .notice--warning}
 
-## Text Alignment
+## Text alignment
 
 Align text blocks with the following classes.
 
@@ -65,11 +65,11 @@ No wrap text.
 {: .text-nowrap}
 ```
 
-## Image Alignment
+## Image alignment
 
 Position images with the following classes.
 
-![image-center]({{ "/assets/images/image-alignment-580x300.jpg" | absolute_url }}){: .align-center}
+![image-center]({{ "/assets/images/image-alignment-580x300.jpg" | relative_url }}){: .align-center}
 
 The image above happens to be **centered**.
 
@@ -79,7 +79,7 @@ The image above happens to be **centered**.
 
 ---
 
-![image-left]({{ "/assets/images/image-alignment-150x150.jpg" | absolute_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]({{ "/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.
 
 ```markdown
 ![image-left](/assets/images/filename.jpg){: .align-left}
@@ -87,7 +87,7 @@ The image above happens to be **centered**.
 
 ---
 
-![image-right]({{ "/assets/images/image-alignment-300x200.jpg" | absolute_url }}){: .align-right}
+![image-right]({{ "/assets/images/image-alignment-300x200.jpg" | relative_url }}){: .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.
 
@@ -97,7 +97,7 @@ And now we're going to shift things to the **right align**. Again, there should
 
 ---
 
-![full]({{ "/assets/images/image-alignment-1200x4002.jpg" | absolute_url }})
+![full]({{ "/assets/images/image-alignment-1200x4002.jpg" | relative_url }})
 {: .full}
 
 The image above should extend outside of the parent container on right.
@@ -172,6 +172,6 @@ You can also add the `.notice` class to a `
` element.
 {% endcapture %}
 
 

-  
Notice Headline:

+  
Notice Headline:

   {{ notice-text | markdownify }}
 

diff --git a/docs/_docs/16-stylesheets.md b/docs/_docs/16-stylesheets.md
index 98e49aa1d527..c8acf05146d5 100644
--- a/docs/_docs/16-stylesheets.md
+++ b/docs/_docs/16-stylesheets.md
@@ -2,7 +2,7 @@
 title: "Stylesheets"
 permalink: /docs/stylesheets/
 excerpt: "Instructions for customizing and building the theme's stylesheets."
-last_modified_at: 2018-01-09T09:59:16-05:00
+last_modified_at: 2018-11-25T19:47:43-05:00
 toc: true
 ---
 
@@ -40,29 +40,29 @@ minimal-mistakes
 
 ## Customizing
 
-To override the default [Sass](http://sass-lang.com/guide) (located in theme's 
+To override the default [Sass](http://sass-lang.com/guide) (located in theme's
 `_sass` directory), do one of the following:
 
 1. Copy directly from the Minimal Mistakes theme gem
 
-   - Go to your local Minimal Mistakes gem installation directory (run 
+   - Go to your local Minimal Mistakes gem installation directory (run
      `bundle show minimal-mistakes-jekyll` to get the path to it).
-   - Copy the contents of `/assets/css/main.scss` from there to 
+   - Copy the contents of `/assets/css/main.scss` from there to
      ``.
    - Customize what you want inside `/assets/css/main.scss`.
 
 2. Copy from this repo.
 
-   - Copy the contents of [assets/css/main.scss](https://github.com/mmistakes/minimal-mistakes/blob/master/assets/css/main.scss) 
+   - Copy the contents of [assets/css/main.scss](https://github.com/mmistakes/minimal-mistakes/blob/master/assets/css/main.scss)
      to ``.
    - Customize what you want inside `` due to the way Jekyll currently reads those files.
 
-To make basic tweaks to theme's style Sass variables can be overridden by adding 
-to `/assets/css/main.scss`. For instance, to change the 
+To make basic tweaks to theme's style Sass variables can be overridden by adding
+to `/assets/css/main.scss`. For instance, to change the
 link color used throughout the theme add:
 
 ```scss
@@ -71,18 +71,18 @@ $link-color: red;
 
 Before any `@import` lines.
 
-### Paragraph Indention 
+### 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.
 
 

-  indented paragraph example
+  indented paragraph example
   
Example of indented paragraphs.

 

 
 The size of the indent can also be customized by changing the value of `$indent-var`.
 
-### Font Stacks
+### 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 by default.
 
@@ -98,7 +98,7 @@ Sans-serif fonts have been used for most of the type, with serifs reserved for c
 **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
+#### Typography from older versions
 
 Not a fan of the refreshed typography of the theme and want to revert back an older version? Easy enough.
 
@@ -118,9 +118,9 @@ $global-font-family : $serif;
 $header-font-family : $sans-serif-narrow;
 ```
 
-### Type Scale
+### 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. 
+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.
 
 Example:
 
@@ -147,9 +147,9 @@ $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.
+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 effect when changed.
 
-#### Syntax Highlighting
+#### Syntax highlighting
 
 To make customizing the colors used in code highlighted blocks, a base of sixteen colors ([Base16](http://chriskempson.com/projects/base16/)) have been used.
 
@@ -157,7 +157,7 @@ Code block colors can easily be changed by overriding any of the following color
 
 ##### Default
 
-![default-code-block]({{ '/assets/images/default-code-block.jpg' | absolute_url }})
+![default-code-block]({{ '/assets/images/default-code-block.jpg' | relative_url }})
 
 ```scss
 /* default syntax highlighting (base16) */
@@ -179,9 +179,9 @@ $base0e: #c792ea;
 $base0f: #ff5370;
 ```
 
-##### Solarized Light
+##### Solarized light
 
-![solarized-light-code-block]({{ '/assets/images/solarized-light-code-block.jpg' | absolute_url }})
+![solarized-light-code-block]({{ '/assets/images/solarized-light-code-block.jpg' | relative_url }})
 
 ```scss
 /* solarized light syntax highlighting (base16) */
@@ -205,7 +205,7 @@ $base0f: #d33682 !default;
 
 ##### Contrast
 
-![contrast-code-block]({{ '/assets/images/contrast-code-block.jpg' | absolute_url }})
+![contrast-code-block]({{ '/assets/images/contrast-code-block.jpg' | relative_url }})
 
 ```scss
 /* contrast syntax highlighting (base16) */
@@ -229,7 +229,7 @@ $base0f: #b18a3d;
 
 ##### Dark
 
-![dark-code-block]({{ '/assets/images/dark-code-block.jpg' | absolute_url }})
+![dark-code-block]({{ '/assets/images/dark-code-block.jpg' | relative_url }})
 
 ```scss
 /* dark syntax highlighting (base16) */
@@ -253,7 +253,7 @@ $base0f: #cc6633;
 
 ##### Dirt
 
-![dirt-code-block]({{ '/assets/images/dirt-code-block.jpg' | absolute_url }})
+![dirt-code-block]({{ '/assets/images/dirt-code-block.jpg' | relative_url }})
 
 ```scss
 /* dirt syntax highlighting (base16) */
@@ -275,9 +275,34 @@ $base0e: #bb90e2;
 $base0f: #b49368;
 ```
 
+##### Dracula
+
+![dracula-code-block]({{ '/assets/images/dracula-code-block.jpg' | relative_url }})
+
+```scss
+/* dracula syntax highlighting (base16) */
+/* https://github.com/dracula/base16-dracula-scheme */
+$base00: #282936;
+$base01: #3a3c4e;
+$base02: #4d4f68;
+$base03: #626483;
+$base04: #62d6e8;
+$base05: #e9e9f4;
+$base06: #f1f2f8;
+$base07: #f7f7fb;
+$base08: #ea51b2;
+$base09: #b45bcf;
+$base0a: #00f769;
+$base0b: #ebff87;
+$base0c: #a1efe4;
+$base0d: #62d6e8;
+$base0e: #b45bcf;
+$base0f: #00f769;
+```
+
 ##### Neon
 
-![neon-code-block]({{ '/assets/images/neon-code-block.jpg' | absolute_url }})
+![neon-code-block]({{ '/assets/images/neon-code-block.jpg' | relative_url }})
 
 ```scss
 /* neon syntax highlighting (base16) */
@@ -301,7 +326,7 @@ $base0f: #cc6633;
 
 ##### Plum
 
-![plum-code-block]({{ '/assets/images/plum-code-block.jpg' | absolute_url }})
+![plum-code-block]({{ '/assets/images/plum-code-block.jpg' | relative_url }})
 
 ```scss
 /* plum syntax highlighting (base16) */
@@ -325,7 +350,7 @@ $base0f: #cc6633;
 
 ##### Sunrise
 
-![sunrise-code-block]({{ '/assets/images/sunrise-code-block.jpg' | absolute_url }})
+![sunrise-code-block]({{ '/assets/images/sunrise-code-block.jpg' | relative_url }})
 
 ```scss
 /* sunrise syntax highlighting (base16) */
@@ -345,20 +370,20 @@ $base0c: #8abeb7;
 $base0d: #81a2be;
 $base0e: #b294bb;
 $base0f: #a3685a;
-```  
+```
 
-### Breakpoints and Grid Stuff
+### 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.
 
 

-  Susy grid overlay for debugging
+  Susy grid overlay for debugging
   
Susy grid debug overlay enabled.

 

 
-### Disabling Animations
+### Disabling animations
 
 You can disable either the fade-in intro animation, element transition animations, or both by overriding the corresponding variables. For example if you wanted to disable all animations you could include the following lines:
 
diff --git a/docs/_docs/17-javascript.md b/docs/_docs/17-javascript.md
index 6f5d4d8c5d87..919315cb5d8c 100644
--- a/docs/_docs/17-javascript.md
+++ b/docs/_docs/17-javascript.md
@@ -2,7 +2,7 @@
 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
+last_modified_at: 2021-07-23T09:33:35-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).
@@ -12,15 +12,17 @@ minimal mistakes
 ├── assets
 |  ├── js
 |  |  ├── plugins
-|  |  |   ├── 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
+|  |  |   ├── gumshoe.js                     # simple scrollspy
+|  |  |   ├── jquery.ba-throttle-debounce.js # rate-limit functions
+|  |  |   ├── jquery.fitvids.js              # fluid width video embeds
+|  |  |   ├── jquery.greedy-navigation.js    # priority plus navigation
+|  |  |   ├── jquery.magnific-popup.js       # responsive lightbox
+|  |  |   └── smooth-scroll.js               # make same-page links scroll smoothly
 |  |  ├── vendor
 |  |  |   └── jquery
-|  |  |       └── jquery-3.2.1.min.js
-|  |  ├── _main.js                         # jQuery plugin settings and other scripts
-|  |  └── main.min.js                      # concatenated and minified scripts
+|  |  |       └── jquery-3.5.1.js
+|  |  ├── _main.js                           # jQuery plugin settings and other scripts
+|  |  └── main.min.js                        # concatenated and minified theme script
 ```
 
 ## Customizing
@@ -35,10 +37,12 @@ You can also add scripts to the `` or closing `` elements by adding
 
 ```yaml
 head_scripts:
-  - https://code.jquery.com/jquery-3.2.1.min.js
+  - 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
+after_footer_scripts:
+  - /assets/js/custom-script-loads-after-footer.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.
@@ -46,7 +50,7 @@ footer_scripts:
 
 ---
 
-## Build Process
+## Build process
 
 In an effort to reduce dependencies a set of [**npm scripts**](https://css-tricks.com/why-npm-scripts/) are used to build `main.min.js` instead of task runners like [Gulp](http://gulpjs.com/) or [Grunt](http://gruntjs.com/). If those tools are more your style then by all means use them instead :wink:.
 
@@ -60,3 +64,19 @@ To get started:
 {: .notice--warning}
 
 If all goes well, running `npm run build:js` will compress/concatenate `_main.js` and all plugin scripts into `main.min.js`.
+
+## Debugging
+
+The minified JavaScript is harder to debug in the browser than the raw source. To stop the minification and bundle all the JavaScript as-is --- open up `package.json` and edit the value `scripts.uglify` from:
+
+```json
+  "scripts": {
+    "uglify": "uglifyjs [...] -c -m -o assets/js/main.min.js",
+```
+
+To the following:
+
+```json
+  "scripts": {
+    "uglify": "cat [...] > assets/js/main.min.js",
+```
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 583f17b1917f..8272a2e888a7 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -1,300 +1,1059 @@
 ---
-title: "History"
-permalink: /docs/history/
-excerpt: "Change log of enhancements and bug fixes made to the theme."
+title: History
+classes: wide
+permalink: "/docs/history/"
+excerpt: Change log of enhancements and bug fixes made to the theme.
 sidebar:
   nav: docs
-last_modified_at: 2018-02-16T15:18:36-05:00
-toc: true
+last_modified_at: '2025-08-31T11:43:03+08:00'
+toc: false
 ---
 
+
+
+{% raw %}
 ## Unreleased
 
 ### Enhancements
 
-* Update jQuery to version `3.3.1`. [#1491](https://github.com/mmistakes/minimal-mistakes/issues/1491)
+- Updated Traditional Chinese translation [#5250](https://github.com/mmistakes/minimal-mistakes/issues/5250)
+- Add built-in support for jekyll-gfm-admonitions [#5312](https://github.com/mmistakes/minimal-mistakes/issues/5312)
+
+## [4.27.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.3)
+
+### Bug Fixes
+
+- Add explicit CSS rules for `.sr-only` following Font Awesome 7's changes. [#5296](https://github.com/mmistakes/minimal-mistakes/issues/5296)
+
+## [4.27.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.2)
+
+### Enhancements
+
+- Hide `.page__footer-follow` if there are no links nor atom feed. [#5279](https://github.com/mmistakes/minimal-mistakes/issues/5279)
+- Add HTML escaping for some titles, labels and metada that was missing. [#5276](https://github.com/mmistakes/minimal-mistakes/issues/5276)
+- Add optional `footer.since` for copyright time range. [#5275](https://github.com/mmistakes/minimal-mistakes/issues/5275)
+
+### Bug Fixes
+
+- Add `escape_once` to gallery title and alt text.
+
+## [4.27.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.1)
+
+### Enhancements
+
+- Add a "Share on Bluesky" button [#5179](https://github.com/mmistakes/minimal-mistakes/issues/5179)
+- Add preset variables for modern font stack [#5033](https://github.com/mmistakes/minimal-mistakes/issues/5033)
+- Update X share button to match brand color [#5245](https://github.com/mmistakes/minimal-mistakes/issues/5245)
+
+### Bug Fixes
+
+- Fix wrong icon and color for X share button.
+
+## [4.27.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.0)
+
+### Enhancements
+
+- Add RTL Support. [#4886](https://github.com/mmistakes/minimal-mistakes/pull/4886)
+- Add missing Polish translation. [#4890](https://github.com/mmistakes/minimal-mistakes/pull/4890)
+- Rewrite most directions with [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
+- Remove unnecessary "type" attribute [#4956](https://github.com/mmistakes/minimal-mistakes/issues/4956)
+- The "if" means the default is never used [#4955](https://github.com/mmistakes/minimal-mistakes/issues/4955)
+- For pages without a title, show the site title only once [#4959](https://github.com/mmistakes/minimal-mistakes/issues/4959)
+- Use `documents-collection.html` partial in `home` layout.
+- Add Bulgarian translation. [#5003](https://github.com/mmistakes/minimal-mistakes/pull/5003)
+- Add provider and comments info to `single.html` layout for non-production. [#5068](https://github.com/mmistakes/minimal-mistakes/issues/5068)
+- Tweak contrast skin $primary-color to adhere to WCAG guidelines. [#5126](https://github.com/mmistakes/minimal-mistakes/issues/5126)
+- Update social share buttons to reflect Twitter rebranding to X [#5210](https://github.com/mmistakes/minimal-mistakes/issues/5210)
+
+### Bug Fixes
+
+- Replace a redirected link to MadeMistakes in footer. [#4882](https://github.com/mmistakes/minimal-mistakes/pull/4882)
+- Fix wrong float direction for `feature_row` with `type="right"`. [#4061](https://github.com/mmistakes/minimal-mistakes/issues/4061)
+- Fix reset stylesheet overruling `$doc-font-size`. [#4983](https://github.com/mmistakes/minimal-mistakes/issues/4983)
+- Fix JavaScript null error on home and splash layouts. [#4938](https://github.com/mmistakes/minimal-mistakes/issues/4938), [#4939](https://github.com/mmistakes/minimal-mistakes/pull/4939)
+- Fix bad <figure> HTML if "alt" contains quotes.
+- Fix extra newline generated in `_includes/post_pagination.html`.
+- Hide hidden links & remove the overlay when one is clicked. [#5042](https://github.com/mmistakes/minimal-mistakes/pull/5042)
+- Fix typo in "Configuration" [#5106](https://github.com/mmistakes/minimal-mistakes/issues/5106)
+- bundle exec jekyll serve will fail if more than once [#5193](https://github.com/mmistakes/minimal-mistakes/issues/5193)
+
+### Documentation & Maintenance
+
+- Automatically update Algolia search index with GitHub Actions.
+
+## [4.26.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.2)
+
+### Enhancements
+
+- Add Czech localization. [#4866](https://github.com/mmistakes/minimal-mistakes/pull/4866)
+- Allow overriding HTML `lang` attribute on a per-page basis. [#4862](https://github.com/mmistakes/minimal-mistakes/pull/4862)
+
+### Bug Fixes
+
+- Figure helper breaks when using code markup in caption with `popup=true`. [#4841](https://github.com/mmistakes/minimal-mistakes/issues/4841)
+
+## [4.26.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.1)
+
+### Bug Fixes
+
+- Disable copy button on invalid syntax highlighting blocks to avoid positioning issues.
+- Fix typo for `fa-dribbble` in `_utilities.scss`.
+- Restrict "auto scroll sticky ToC to content" feature to Chromium browsers for now. [#4826](https://github.com/mmistakes/minimal-mistakes/issues/4826)
+
+### Documentation & Maintenance
+
+- Rewrite social icons SCSS with a loop.
+
+### Enhancements
+
+- Change the icon of a copy button into a tick for 1.5 seconds on successful copy.
+
+## [4.26.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.0)
+
+### Bug Fixes
+
+- Fix an unclosed `
` tag in `page__hero.html`, near `page.header.actions`.
+- Remove overlay and revert X to hamburger icon when popup disappears. [#3958](https://github.com/mmistakes/minimal-mistakes/pull/3958)
+- Fix SEO title when it contains a vertical bar. [#3094](https://github.com/mmistakes/minimal-mistakes/pull/3094) [#3113](https://github.com/mmistakes/minimal-mistakes/pull/3113)
+- Remove "sticky sidebar" JS as it's now completely based on CSS media queries. [#4245](https://github.com/mmistakes/minimal-mistakes/issues/4245) [#4645](https://github.com/mmistakes/minimal-mistakes/pull/4645)
+
+### Enhancements
+
+- Add support for [Jekyll Paginate V2](https://github.com/sverrirs/jekyll-paginate-v2) 🎉 [#2636](https://github.com/mmistakes/minimal-mistakes/pull/2636)
+- Add "copy to clipboard" button for code blocks 🎉 [#2812](https://github.com/mmistakes/minimal-mistakes/pull/2812)
+- Auto scroll sticky ToC with content. [#3115](https://github.com/mmistakes/minimal-mistakes/pull/3115)
+- Replace "hidden" check in Liquid templates with `where_exp: "item", "item.hidden != true"`.
+- Remove deprecated `page.header.cta_url` setting. [#4821](https://github.com/mmistakes/minimal-mistakes/pull/4821)
+- Allow multiple nav lists in sidebar. [#2843](https://github.com/mmistakes/minimal-mistakes/pull/2843)
+- Add popup parameter to `{% include figure %}` to enable Magnific Popup. [#3119](https://github.com/mmistakes/minimal-mistakes/pull/3119)
+- Add target attribute for navigation link. [#3056](https://github.com/mmistakes/minimal-mistakes/pull/3056)
+- Split schema to a separate include file. [#3085](https://github.com/mmistakes/minimal-mistakes/pull/3085)
+- Cleanup `_includes/seo.html`.
+
+### Documentation & Maintenance
+
+- Rewrite skin previews on `05-configuration.md` in Liquid template.
+- Remove unused classes from `_layouts/single.html`.
+- Migrate npm run scripts to Ruby Rake tasks.
+- Add Rake task `version` for updating all hard-coded version numbers from `package.json` all at once.
+- Merge `categories` and `tags` layout into `_includes/posts-taxonomy.html`.
+- Update Social Sharing links section. [#4066](https://github.com/mmistakes/minimal-mistakes/pull/4066)
+
+## [4.25.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.1)
 
 ### Bug Fixes
 
-* Focus Algolia search input after clicking on search toggle.
+- "You may also enjoy" no longer recommends hidden posts. [#4653](https://github.com/mmistakes/minimal-mistakes/issues/4653)
+- Replaced dead link to "Viewport and Media Queries" slides. [#4421](https://github.com/mmistakes/minimal-mistakes/discussions/4421)
+- Fix broken `where_exp` in `lunr-store.js` for Jekyll < 4.0. [#4808](https://github.com/mmistakes/minimal-mistakes/issues/4808)
+
+### Enhancements
+
+- Add Ukrainian translations. [#4273](https://github.com/mmistakes/minimal-mistakes/pull/4273)
+- Add more configuration for Giscus. [#4274](https://github.com/mmistakes/minimal-mistakes/pull/4274)
+- Bump jekyll-toc to [v1.2.1](https://github.com/allejo/jekyll-toc/releases/tag/v1.2.1).
+
+### Documentation & Maintenance
+
+- Bump shell-quote from 1.7.1 to 1.7.3 [#3692](https://github.com/mmistakes/minimal-mistakes/issues/3692)
+- Add `after-content.html` and `before-related.html` includes to ease docs site overrides.
+- GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884)
+- Replace Font Awesome v5 search page with v6.
+- Try adding an FAQ page.
+- Update remote theme reference in Quick-Start Guide to point to 4.25.0. [#4809](https://github.com/mmistakes/minimal-mistakes/issues/4809)
+
+## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0)
+
+### Bug Fixes
+
+- Fix Linkedin social share link [#4754](https://github.com/mmistakes/minimal-mistakes/issues/4754)
+- Fix non-English characters being url encoded in breadcrumb [#3819](https://github.com/mmistakes/minimal-mistakes/issues/3819)
+- Fix wrong `first_page_path` because of hard-coded `page:num` [#3778](https://github.com/mmistakes/minimal-mistakes/issues/3778)
+- Remove JS and other files from search index [#4000](https://github.com/mmistakes/minimal-mistakes/pull/4000)
+- Fix unlisted YouTube video embeds in documentation/test sites. [#3649](https://github.com/mmistakes/minimal-mistakes/issues/3649)
+- Fix error in Algolia search script when returning a hit that without `html` and `hightlight.html`. [#3101](https://github.com/mmistakes/minimal-mistakes/issues/3101) [#3102](https://github.com/mmistakes/minimal-mistakes/pull/3102)
+- Fix inline code style not applied to stylized text. [#3253](https://github.com/mmistakes/minimal-mistakes/pull/3253)
+- Fix Keybase icon in author sidebar. [#3221](https://github.com/mmistakes/minimal-mistakes/pull/3221)
+- Fix sort order of Staticman comments when data files aren't named alphabetically. [#3184](https://github.com/mmistakes/minimal-mistakes/pull/3184)
+- Fix `layout: compress` issue with HTML comment in video include. [#3117](https://github.com/mmistakes/minimal-mistakes/pull/3117)
+- Add Magnific Popup class to anchors that only contain an `img` element. [#3111](https://github.com/mmistakes/minimal-mistakes/issues/3111) [#3114](https://github.com/mmistakes/minimal-mistakes/pull/3114)
+- Fix heading level of related posts section from `h4` to `h2` to improve accessibility and SEO. [#3064](https://github.com/mmistakes/minimal-mistakes/pull/3064)
+- Fix grammar error in German localized UI text string. [#3063](https://github.com/mmistakes/minimal-mistakes/pull/3063)
+- Remove site.url from first breadcrumb link. [#3051](https://github.com/mmistakes/minimal-mistakes/pull/3051)
+
+### Enhancements
+
+- Add `site.copyright` and `site.copyright_url` config options [#4313](https://github.com/mmistakes/minimal-mistakes/pull/4313)
+- Lazy-load InstantSearch scripts and stylesheets [#3691](https://github.com/mmistakes/minimal-mistakes/pull/3691)
+- Improve Finnish translations [#4595](https://github.com/mmistakes/minimal-mistakes/pull/4595)
+- Remove redundant downcase from \_layouts/categories.html. [#4531](https://github.com/mmistakes/minimal-mistakes/pull/4531)
+- Load latest Font Awesome package. [#3765](https://github.com/mmistakes/minimal-mistakes/pull/3765)
+- Add missing Polish missing UI text strings. [#3969](https://github.com/mmistakes/minimal-mistakes/pull/3969)
+- Update breadcrumbs conditional to enable/disable them via Front Matter on pages using `layout: single`. [#3096](https://github.com/mmistakes/minimal-mistakes/pull/3096) [#3669](https://github.com/mmistakes/minimal-mistakes/pull/3669)
+- Remove Internet Explorer 9 upgrade notice. [#3666](https://github.com/mmistakes/minimal-mistakes/pull/3666)
+- Add Kiswahili localized UI text strings. [#3489](https://github.com/mmistakes/minimal-mistakes/pull/3489)
+- Exclude `main.scss` from Lunr search index.
+- Allow `site.pages` to be indexed and searched via Lunr. [#3352](https://github.com/mmistakes/minimal-mistakes/pull/3352)
+- Update jQuery to v3.6.0. [#3254](https://github.com/mmistakes/minimal-mistakes/pull/3254)
+- Use notice `` colors for blockquotes that have `notice--` classes applied. [#3140](https://github.com/mmistakes/minimal-mistakes/pull/3140) [#3068](https://github.com/mmistakes/minimal-mistakes/issues/3068)
+- Add sameAs itemprop to author link. [#3087](https://github.com/mmistakes/minimal-mistakes/pull/3087)
+- Update and add missing Brazilian Portuguese translations. [#3204](https://github.com/mmistakes/minimal-mistakes/pull/3204)
+- Add optional label attribute for utterances comments. [#3128](https://github.com/mmistakes/minimal-mistakes/pull/3128)
+- Add missing Danish translations. [#3095](https://github.com/mmistakes/minimal-mistakes/pull/3095)
+- Add ARIA role to search forms. [#3086](https://github.com/mmistakes/minimal-mistakes/pull/3086)
+- Add overflow scroll bar to sticky table of contents that are taller than the viewport's height. [#2874](https://github.com/mmistakes/minimal-mistakes/pull/2874)
+- Add Microformats markup. [#3052](https://github.com/mmistakes/minimal-mistakes/pull/3052)
+
+### Documentation & Maintenance
+
+- Fix links to Font Awesome gallery. [#3599](https://github.com/mmistakes/minimal-mistakes/pull/3599)
+- Fix GreedyNav.js attribution link. [#3553](https://github.com/mmistakes/minimal-mistakes/pull/3553)
+- Fix typo about loading JavaScript in layout documentation. [#3350](https://github.com/mmistakes/minimal-mistakes/pull/3350)
+- Fix documentation typos. [#3232](https://github.com/mmistakes/minimal-mistakes/pull/3232) [#3318](https://github.com/mmistakes/minimal-mistakes/pull/3318)
+- Add link to documentation clarifying how to add plugins. [#3181](https://github.com/mmistakes/minimal-mistakes/pull/3181)
+- Fix broken documentation link and add Baidu site verification to `_config.yml` files. [#3139](https://github.com/mmistakes/minimal-mistakes/pull/3139)
+- Bump path-parse from 1.0.6 to 1.0.7. [#3116](https://github.com/mmistakes/minimal-mistakes/pull/3116)
+- Automatically close invalid PRs using GitHub Actions. [#3313](https://github.com/mmistakes/minimal-mistakes/pull/3313)
+- Add instructions on how to unminify `main.js` for easier browser debugging. [#3055](https://github.com/mmistakes/minimal-mistakes/pull/3055)
+- Consolidate hard-coded version numbers where possible.
+- Add Rakefile for automatically syncing CHANGELOG with history and synched them.
+
+## [4.24.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.24.0)
+
+### Bug Fixes
+
+- Fix README text for Gumshoejs license. [#3024](https://github.com/mmistakes/minimal-mistakes/pull/3024)
+- Remove `tabindex="-1"` from `input` elements in `search.html` layout to allow them to be accessible by keyboard. [#2982](https://github.com/mmistakes/minimal-mistakes/issues/2982)
+- Fix broken sidebar image in sample post. [#3013](https://github.com/mmistakes/minimal-mistakes/issues/3013)
+- Fix broken links in Upgrading documentation. [#3004](https://github.com/mmistakes/minimal-mistakes/issues/3004)
+
+### Enhancements
+
+- Remove IE9 flexbox fallback. [#3042](https://github.com/mmistakes/minimal-mistakes/pull/3042)
+- Remove `h2` from skip links navigation as it is not important for site structure. [#3012](https://github.com/mmistakes/minimal-mistakes/pull/3012)
+- Loads Font Awesome asynchronously. [#2967](https://github.com/mmistakes/minimal-mistakes/pull/2967)
+- Replace custom search icon SVG with Font Awesome icon. [#2774](https://github.com/mmistakes/minimal-mistakes/pull/2774)
+- Adds support for giscus comments. [#3022](https://github.com/mmistakes/minimal-mistakes/pull/3022)
+
+## [4.23.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.23.0)
+
+### Enhancements
+
+- Add Arabic (عربي) localized UI text strings. [#2936](https://github.com/mmistakes/minimal-mistakes/pull/2936)
+- Update onchange and uglify-js dependencies.
+- Document head and footer `custom.html` includes. [#2815](https://github.com/mmistakes/minimal-mistakes/pull/2815)
+- Color notices based on skin colors instead of fixed values. [#2887](https://github.com/mmistakes/minimal-mistakes/pull/2887)
+- Add configurable datetime format. [#2844](https://github.com/mmistakes/minimal-mistakes/pull/2844)
+- Add Baidu site verification [#2830](https://github.com/mmistakes/minimal-mistakes/pull/2830)
+- Add `alt` attribute to site logo. [#2529](https://github.com/mmistakes/minimal-mistakes/issues/2529) [#2824](https://github.com/mmistakes/minimal-mistakes/issues/2824)
+
+### Bug Fixes
+
+- Fix menu toggle to properly show close icon when open.
+- Fix Jekyll environment note in configuration documentation. [#2912](https://github.com/mmistakes/minimal-mistakes/issues/2912)
+- Fix typo in Helpers documentation. [#2940](https://github.com/mmistakes/minimal-mistakes/pull/2940)
+- Remove all references to official public Staticman API instance. [#2818](https://github.com/mmistakes/minimal-mistakes/issues/2818) [#2831](https://github.com/mmistakes/minimal-mistakes/pull/2831)
+- Remove Google Search CSS. [#2852](https://github.com/mmistakes/minimal-mistakes/issues/2852) [#2855](https://github.com/mmistakes/minimal-mistakes/pull/2855)
+
+## [4.22.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.22.0)
+
+### Bug Fixes
+
+- Remove Google Search script from `404.md`. [#2597](https://github.com/mmistakes/minimal-mistakes/issues/2597) [#2737](https://github.com/mmistakes/minimal-mistakes/pull/2737) [#2789](https://github.com/mmistakes/minimal-mistakes/pull/2789)
+- Fix Font Awesome icon color in `contrast`, `dark`, `mint`, `neon`, `plum`, and `sunrise` skins. [#2724](https://github.com/mmistakes/minimal-mistakes/issues/2724)
+
+### Enhancements
+
+- Allow custom sorting for collections. [#2723](https://github.com/mmistakes/minimal-mistakes/pull/2723)
+- Use `sort_natural` instead of custom Liquid logic to sort tags and categories. [#2756](https://github.com/mmistakes/minimal-mistakes/pull/2756)
+- Add configuration option to toggle off RSS feed link in `` and site footer. [#2787](https://github.com/mmistakes/minimal-mistakes/pull/2787)
+- Upgrade Lunrjs to 2.3.9 and switch to `relative_url`. [#2805](https://github.com/mmistakes/minimal-mistakes/pull/2805)
+- Adds `.webp` to list of supported image extensions for the image popup lightbox. [#2788](https://github.com/mmistakes/minimal-mistakes/pull/2788)
+- Add Hebrew localized UI text strings. [#2760](https://github.com/mmistakes/minimal-mistakes/pull/2760)
+- Update documentation to include `toc_sticky` parameter's description. [#2741](https://github.com/mmistakes/minimal-mistakes/pull/2741)
+- Update Indonesian localized UI text strings. [#2731](https://github.com/mmistakes/minimal-mistakes/pull/2731)
+- Update remote theme documentation. [#2734](https://github.com/mmistakes/minimal-mistakes/pull/2734)
+- Update allejo/jekyll-toc to v1.1.0, skip headings without an ID. [#2752](https://github.com/mmistakes/minimal-mistakes/pull/2752)
+- Allow custom gradient for page header overlay. [#2806](https://github.com/mmistakes/minimal-mistakes/pull/2806)
+
+## [4.21.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.21.0)
+
+### Bug Fixes
+
+- Fix greedy navigation by improving reliability of remaining space for visible links. [#2664](https://github.com/mmistakes/minimal-mistakes/issues/2664)
+- Collapse white-space in `figure` helper to fix issues when used in Markdown ordered and unordered lists. [#2697](https://github.com/mmistakes/minimal-mistakes/pull/2697)
+- Fix dead link to CI services in documentation. [#2635](https://github.com/mmistakes/minimal-mistakes/issues/2635) [#2692](https://github.com/mmistakes/minimal-mistakes/pull/2692)
+- Fix a small typo in documentation. [#2718](https://github.com/mmistakes/minimal-mistakes/pull/2718)
+
+### Enhancements
+
+- Update jQuery to 3.5.1. [#2713](https://github.com/mmistakes/minimal-mistakes/pull/2713)
+- Add Indonesian localized UI text strings. [#2725](https://github.com/mmistakes/minimal-mistakes/pull/2725)
+- Update Vietnamese localized UI text strings. [#2722](https://github.com/mmistakes/minimal-mistakes/pull/2722)
+- Add Norwegian (Norsk) localized UI text strings. [#2702](https://github.com/mmistakes/minimal-mistakes/pull/2702)
+- Update allejo/jekyll-toc to v1.0.14 [#2700](https://github.com/mmistakes/minimal-mistakes/pull/2700)
+
+## [4.20.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.2)
+
+### Bug Fixes
+
+- Fix broken link in documentation. [#2677](https://github.com/mmistakes/minimal-mistakes/issues/2677)
+- Fix typo in documentation. [#2678](https://github.com/mmistakes/minimal-mistakes/issues/2678)
+- Remove duplicate CSS definitions. [#2666](https://github.com/mmistakes/minimal-mistakes/pull/2666)
+- Fix `entries_layout: grid` in various layouts. [#2639](https://github.com/mmistakes/minimal-mistakes/issues/2639)
+- Change `fa` to `fas` for Font Awesome 5. [#2649](https://github.com/mmistakes/minimal-mistakes/pull/2649)
+
+### Enhancements
+
+- Refactor page meta include. [#2641](https://github.com/mmistakes/minimal-mistakes/pull/2641)
+- Add `article:author` Open Graph markup. [#2670](https://github.com/mmistakes/minimal-mistakes/pull/2670)
+
+## [4.20.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.1)
+
+### Bug Fixes
+
+- Fix grid `entries_layout` in home.html. [#2616](https://github.com/mmistakes/minimal-mistakes/pull/2616)
+
+## [4.20.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.20.0)
+
+### Bug Fixes
+
+- Add `relative_url` filter to author home link [#2575](https://github.com/mmistakes/minimal-mistakes/pull/2575)
+- Fix `analytics.provider` config comment to list all analytics providers. [#2607](https://github.com/mmistakes/minimal-mistakes/pull/2607)
+- Fix typo in installation documentation. [#2570](https://github.com/mmistakes/minimal-mistakes/pull/2570)
+- Fix broken Lunr search with Jekyll v4.1.0. [#2617](https://github.com/mmistakes/minimal-mistakes/pull/2617)
+
+### Enhancements
+
+- Add an optional date alongside the reading time. To enable set `show_date: true` similar to how reading time is. [#2526](https://github.com/mmistakes/minimal-mistakes/pull/2526)
+- Remove hidden posts from posts.html layout. [#2625](https://github.com/mmistakes/minimal-mistakes/pull/2625)
+- Add entry layout configuration for `list` (default) or `grid` views on `layout: home`. [#2616](https://github.com/mmistakes/minimal-mistakes/pull/2616)
+- Add missing Chinese translations. [#2576](https://github.com/mmistakes/minimal-mistakes/pull/2576)
+- Improve Chinese translations. [#2626](https://github.com/mmistakes/minimal-mistakes/pull/2626)
+- Add `line-height` to `h4` element in notice helper. [#2602](https://github.com/mmistakes/minimal-mistakes/pull/2602)
+- Improve Algolia search. [#2572](https://github.com/mmistakes/minimal-mistakes/pull/2572)
+- Update link to wtfpl license in README. [#2571](https://github.com/mmistakes/minimal-mistakes/pull/2571)
+- Ignore teaser headline in table of contents when including posts list in another page. [#2558](https://github.com/mmistakes/minimal-mistakes/pull/2558)
+- Replace Font Awesome Kits with CSS from jsDelivr CDN. [#2583](https://github.com/mmistakes/minimal-mistakes/pull/2583)
+- Add `danmaku` option to Bilibili video provider and add corresponding documentation/ [#2599](https://github.com/mmistakes/minimal-mistakes/pull/2599)
+- Update documentation about loading l10n data file from the theme-gem. [#2621](https://github.com/mmistakes/minimal-mistakes/issues/2621) [#2624](https://github.com/mmistakes/minimal-mistakes/pull/2624)
+
+## [4.19.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.3)
+
+### Enhancements
+
+- Update GreedyNav.js to reduce masthead link overflow/shifting on mobile devices. [#2551](https://github.com/mmistakes/minimal-mistakes/issues/2551)
+- Replace `
` in `comments.html` include and add `custom_scripts.html` include for loading custom comment provider JavaScript in the footer. [#2549](https://github.com/mmistakes/minimal-mistakes/issues/2549)
+- Move page date Liquid to include. [#2544](https://github.com/mmistakes/minimal-mistakes/pull/2544)
+- Strip trailing whitespace in `seo_description`. [#2542](https://github.com/mmistakes/minimal-mistakes/pull/2542)
+- Improve sticky sidebar's appearance with short content. [#2514](https://github.com/mmistakes/minimal-mistakes/pull/2514)
+
+## [4.19.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.2)
+
+### Enhancements
+
+- Add support for bilibili videos in [responsive video helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#responsive-video-embed). [#2512](https://github.com/mmistakes/minimal-mistakes/pull/2512)
+- Add Myanmar (Burmese) localized UI text strings. [#2500](https://github.com/mmistakes/minimal-mistakes/pull/2500)
+- Improve author links underline on hover. [#2472](https://github.com/mmistakes/minimal-mistakes/pull/2472)
+- Add documentation for applying Front Matter defaults to jekyll-archives pages. [#2466](https://github.com/mmistakes/minimal-mistakes/pull/2466)
+- Add missing Vietnamese translations. [#2459](https://github.com/mmistakes/minimal-mistakes/pull/2459) [#2486](https://github.com/mmistakes/minimal-mistakes/pull/2486)
+- Fix Finnish localized UI text strings. [#2455](https://github.com/mmistakes/minimal-mistakes/pull/2455)
+- Clarify documentation that Lunr only searches documents in collections. [#2450](https://github.com/mmistakes/minimal-mistakes/pull/2450)
+- Add guide on applying Front Matter defaults to jekyll-archives pages [#2466](https://github.com/mmistakes/minimal-mistakes/pull/2466)
+
+### Bug Fixes
+
+- Fix typo in configuration documentation. [#2497](https://github.com/mmistakes/minimal-mistakes/pull/2497)
+- Fix "Follow menu falls under post links" on small screens. [#2479](https://github.com/mmistakes/minimal-mistakes/issues/2479)
+- Hide index page from page-archive. [#2482](https://github.com/mmistakes/minimal-mistakes/pull/2482)
+
+## [4.19.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.1)
+
+### Enhancements
+
+- Add [Dracula](https://draculatheme.com/) Base16 syntax highlighting theme Sass variables to [stylesheets documentation](https://mmistakes.github.io/minimal-mistakes/docs/stylesheets/#syntax-highlighting). [#2438](https://github.com/mmistakes/minimal-mistakes/pull/2438)
+- Update links to `HTTPS` and remove Google+ from configuration documentation. [#2432](https://github.com/mmistakes/minimal-mistakes/pull/2432)
+- Use `first_page_path` from jekyll-paginate-v2 if available. [#2431](https://github.com/mmistakes/minimal-mistakes/pull/2431)
+- Update onchange and uglify-js dependencies.
+- Update smooth-scroll.js to `v16.1.2`. [#2430](https://github.com/mmistakes/minimal-mistakes/issues/2430)
+
+### Bug Fixes
+
+- Fix author profile links `z-index` order on small screens. [#2440](https://github.com/mmistakes/minimal-mistakes/issues/2440)
+
+## [4.19.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.19.0)
+
+### Enhancements
+
+- Add "click" overlay to close masthead and follow button menus when open. [#1168](https://github.com/mmistakes/minimal-mistakes/issues/1168)
+- Remove deprecated Staticman v1 configurations from `_config.yml`. [#2386](https://github.com/mmistakes/minimal-mistakes/issues/2386)
+- Use `relative_url` and `absolute_url` filters where possible. [#2387](https://github.com/mmistakes/minimal-mistakes/pull/2387)
+- Improve headline hierarchy and add Sass specific variables `$h-size-x`. [#2423](https://github.com/mmistakes/minimal-mistakes/issues/2423)
+- Improve accessibility of `default` skin by increasing color contrast of text and links.
+- Hide posts with `hidden: true` YAML front matter from appearing in listings. [#2345](https://github.com/mmistakes/minimal-mistakes/pull/2345)
+- Add Irish (Gaeilge) localized UI text strings. [#2422](https://github.com/mmistakes/minimal-mistakes/pull/2422)
+- Remove `box-shadow` on radio and checkbox inputs. [#2398](https://github.com/mmistakes/minimal-mistakes/pull/2398)
+- Bump Jekyll gem dependency to `v3.7`.
+
+### Bug Fixes
+
+- Fix documentation around using `bundle info` command. [#2425](https://github.com/mmistakes/minimal-mistakes/pull/2425)
+- Fix rake vulnerability in `.gemspec` file.
+- Fix Staticman v2 comment submission. [#2402](https://github.com/mmistakes/minimal-mistakes/pull/2402)
+- Fix repeated site base path for masthead logo. [#2385](https://github.com/mmistakes/minimal-mistakes/pull/2385)
+
+## [4.18.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.18.1)
+
+### Bug Fixes
+
+- Fix compatibility issue with jekyll-paginate-v2. [#2381](https://github.com/mmistakes/minimal-mistakes/pull/2381)
+
+## [4.18.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.18.0)
+
+### Enhancements
+
+- Allow `home` layout to display posts without pagination. [#2378](https://github.com/mmistakes/minimal-mistakes/pull/2378)
+- Add links to high resolution skin screenshots in README. [#2363](https://github.com/mmistakes/minimal-mistakes/issues/2363)
+- Update README and LICENSE. [#2367](https://github.com/mmistakes/minimal-mistakes/pull/2367)
+- Update `.gitignore` file. [#2366](https://github.com/mmistakes/minimal-mistakes/pull/2366)
+- Allow override of page excerpt in hero header via `tagline` YAML front matter. [#2307](https://github.com/mmistakes/minimal-mistakes/pull/2307)
+- Exclude `package-lock.json` from Jekyll build. [#2364](https://github.com/mmistakes/minimal-mistakes/pull/2364)
+- Use `%-d` instead of `%d` so displayed dates aren't padded with zero. [#2359](https://github.com/mmistakes/minimal-mistakes/pull/2359)
+- Update table of contents helper (`toc.html`) to [v1.0.8](https://github.com/allejo/jekyll-toc/releases). [#2355](https://github.com/mmistakes/minimal-mistakes/pull/2355)
+- Add missing Dutch localized UI text strings. [#2321](https://github.com/mmistakes/minimal-mistakes/pull/2321)
+- Support page header (hero) in `archive-taxonomy` layout. [#2320](https://github.com/mmistakes/minimal-mistakes/pull/2320)
+- Add social icon color for Keybase. [#2302](https://github.com/mmistakes/minimal-mistakes/pull/2302)
+
+### Bug Fixes
+
+- Fix JavaScript comments in Disqus include to be compatible with `compress` layout. [#2373](https://github.com/mmistakes/minimal-mistakes/pull/2373)
+- Fix wrong newline concatenation in SEO description [#2368](https://github.com/mmistakes/minimal-mistakes/pull/2368) [#2354](https://github.com/mmistakes/minimal-mistakes/issues/2354)
+- Fix Staticman v2/v3 conditional for showing comments. [#2351](https://github.com/mmistakes/minimal-mistakes/pull/2351)
+- Fix masthead logo path. [#2332](https://github.com/mmistakes/minimal-mistakes/pull/2332)
+- Fix schema.org dates to ISO-8601. [#2339](https://github.com/mmistakes/minimal-mistakes/pull/2339)
+- Fix background color of code blocks in notices. [#2328](https://github.com/mmistakes/minimal-mistakes/pull/2328)
+- Fix alignment of feature rows when placed next to a sticky sidebar. [#2327](https://github.com/mmistakes/minimal-mistakes/issues/2327)
+- Fix `seo_description` in `_includes/seo.html`. [#2326](https://github.com/mmistakes/minimal-mistakes/pull/2326)
+- Fix typo in `_config.yml`. [#2319](https://github.com/mmistakes/minimal-mistakes/pull/2319)
+
+## [4.17.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.2)
+
+### Enhancements
+
+- Add collection step to documentation about creating a portfolio page. [#2294](https://github.com/mmistakes/minimal-mistakes/pull/2294)
+- Replace sticky footer JavaScript with flexbox styles. [#2289](https://github.com/mmistakes/minimal-mistakes/pull/2289)
+
+### Bug Fixes
+
+- Fix sticky footer when using MozBar extension. [#2281](https://github.com/mmistakes/minimal-mistakes/issues/2281)
+
+## [4.17.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.1)
+
+### Enhancements
+
+- Update Chinese (Simplified) localized UI text strings. [#2286](https://github.com/mmistakes/minimal-mistakes/pull/2286)
+- Update list of 3rd party JavaScript used and licenses. [#2276](https://github.com/mmistakes/minimal-mistakes/pull/2276)
+
+### Bug Fixes
+
+- Fix indention of nested GFM task lists. [#2283](https://github.com/mmistakes/minimal-mistakes/issues/2283)
+
+## [4.17.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.17.0)
+
+### Enhancements
+
+- Show a permalink anchor when hovering over headings in main content area. [#2251](https://github.com/mmistakes/minimal-mistakes/pull/2251)
+- Allow per-page override of `words_per_minute`. [#2250](https://github.com/mmistakes/minimal-mistakes/pull/2250)
+- Update [onchange](https://www.npmjs.com/package/onchange) development dependency in `package.json`. [#2241](https://github.com/mmistakes/minimal-mistakes/issues/2241)
+- Add Catalan localized UI text strings. [#2237](https://github.com/mmistakes/minimal-mistakes/pull/2237)
+
+### Bug Fixes
+
+- Remove extraneous space from Internet Explorer conditional statement. [#2273](https://github.com/mmistakes/minimal-mistakes/pull/2273)
+- Fix typo in `_config.yml`. [#2243](https://github.com/mmistakes/minimal-mistakes/pull/2243)
+- Replace `http` URLs with `https` where applicable in `_config.yml`. [#2244](https://github.com/mmistakes/minimal-mistakes/pull/2244)
+
+## [4.16.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.6)
+
+### Enhancements
+
+- Relax Jekyll dependency to allow for version 4.0.
+- Add missing Spanish localized UI text strings. [#2229](https://github.com/mmistakes/minimal-mistakes/pull/2229)
+- Allow Markdown in author bio. [#2215](https://github.com/mmistakes/minimal-mistakes/pull/2215)
+
+### Bug Fixes
+
+- Fix `site.url` in Organization/Person JSON-LD schema. [#1906](https://github.com/mmistakes/minimal-mistakes/issues/1906)
+- Remove full stop in some `comment_form_info` UI text strings. [#2220](https://github.com/mmistakes/minimal-mistakes/pull/2220)
+- Fix default `site.author` in seo.html [#2230](https://github.com/mmistakes/minimal-mistakes/pull/2230)
+- Fix overlapping links (linked to and post's permalink) in post link type. [#2222](https://github.com/mmistakes/minimal-mistakes/issues/2222)
+
+## [4.16.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.5)
+
+### Enhancements
+
+- Add optional site subtitle to masthead. [#2173](https://github.com/mmistakes/minimal-mistakes/issues/2173)
+- Add missing Punjabi and Hindi localized UI text strings. [#2212](https://github.com/mmistakes/minimal-mistakes/pull/2212)
+- Add missing Korean localized UI text strings. [#2209](https://github.com/mmistakes/minimal-mistakes/pull/2209)
+- Use [Font Awesome Kits](https://blog.fontawesome.com/introducing-font-awesome-kits-7134d1d59959) to use the latest version of icons. [#2184](https://github.com/mmistakes/minimal-mistakes/issues/2184)
+- Remove unnecessary console.log in `lunr-en.js` and `lunr-gr.js` JavaScript. [#2193](https://github.com/mmistakes/minimal-mistakes/issues/2193)
+- Remove unnecessary `type="text/javascript"` from Google Analytics JavaScript. [#2190](https://github.com/mmistakes/minimal-mistakes/pull/2190)
+- Update links and fix typos in documentation. [#2186](https://github.com/mmistakes/minimal-mistakes/pull/2186)
+- Add skip links. [#2182](https://github.com/mmistakes/minimal-mistakes/issues/2182)
+
+### Bug Fixes
+
+- Fix aria issues with Lunr search form. [#2211](https://github.com/mmistakes/minimal-mistakes/pull/2211)
+- Fix missing fallback title for table of contents.
+
+## [4.16.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.4)
+
+### Enhancements
+
+- Update Brazilian Portuguese localized UI text strings. [#2162](https://github.com/mmistakes/minimal-mistakes/pull/2162)
+- Update Font Awesome to v5.8.2. [#2150](https://github.com/mmistakes/minimal-mistakes/pull/2150)
+- Add missing Spanish localized UI text strings. [#2149](https://github.com/mmistakes/minimal-mistakes/pull/2149)
+
+### Bug Fixes
+
+- Fix arithmetic in `_form.scss` partial. [#2169](https://github.com/mmistakes/minimal-mistakes/pull/2169)
+- Fix pound symbol not displaying properly for post categories and tags. [#2156](https://github.com/mmistakes/minimal-mistakes/issues/2156)
+- Fix permalink stacking order and click-able area in archives.
+
+## [4.16.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.3)
+
+### Enhancements
+
+- Update jQuery to v3.4.1. [#2137](https://github.com/mmistakes/minimal-mistakes/issues/2137)
+- Update Gumshoe to v5.1.1. [#2140](https://github.com/mmistakes/minimal-mistakes/issues/2140)
+
+### Bug Fixes
+
+- Fix JavaScript error when resizing pages with table of contents. [#2140](https://github.com/mmistakes/minimal-mistakes/issues/2140)
+
+## [4.16.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.2)
+
+### Bug Fixes
+
+- Revert jQuery back to version v3.3.1, v.3.4.0 causes issues with other plugins that haven't been updated. [#2137](https://github.com/mmistakes/minimal-mistakes/issues/2137)
+
+## [4.16.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.1)
+
+### Enhancements
+
+- Update [`compress` layout](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#compress-layout) to v3.1.0. [#2128](https://github.com/mmistakes/minimal-mistakes/pull/2128)
+- Update jQuery to v3.4.0. [#2129](https://github.com/mmistakes/minimal-mistakes/pull/2129)
+
+### Bug Fixes
+
+- Fix Gumshoe related JavaScript error on pages without a table of contents. [#2124](https://github.com/mmistakes/minimal-mistakes/pull/2124)
+
+## [4.16.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.16.0)
+
+### Enhancements
+
+- Improve search `input` semantics for Lunr and Google search providers. [#2123](https://github.com/mmistakes/minimal-mistakes/pull/2123)
+- Allow adding JavaScript files after those bundled in the theme. [#2110](https://github.com/mmistakes/minimal-mistakes/issues/2110) [#2116](https://github.com/mmistakes/minimal-mistakes/pull/2116)
+- Add `$max-width` Sass variable for adjusting page content's maximum width. [#2093](https://github.com/mmistakes/minimal-mistakes/pull/2093)
+- Add Thai localized UI text strings. [#2111](https://github.com/mmistakes/minimal-mistakes/pull/2111)
+- Update Font Awesome to [v5.8.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.8.1). [#2102](https://github.com/mmistakes/minimal-mistakes/pull/2102)
+- Add missing Vietnamese localized UI text strings. [#2097](https://github.com/mmistakes/minimal-mistakes/pull/2097)
+- Replace jQuery Smooth Scroll with Smooth Scroll + Gumshoe. [#2082](https://github.com/mmistakes/minimal-mistakes/pull/2082)
+- Add styling for [GFM task lists](https://help.github.com/en/articles/about-task-lists#creating-task-lists). [#2092](https://github.com/mmistakes/minimal-mistakes/issues/2092)
+- Update Google Universal Analytics to load async. [#2079](https://github.com/mmistakes/minimal-mistakes/pull/2079)
+- Remove Google+ social sharing button, comment provider, and author link configs from theme.
+- Add missing Chinese text strings. [#2072](https://github.com/mmistakes/minimal-mistakes/pull/2072)
+
+### Bug Fixes
+
+- Fix table of contents active link styling.
+- Add missing Hindi localized UI text strings. [#2105](https://github.com/mmistakes/minimal-mistakes/pull/2105) [#2106](https://github.com/mmistakes/minimal-mistakes/pull/2106)
+- Fix Brazilian Portuguese text strings. [#2098](https://github.com/mmistakes/minimal-mistakes/pull/2098)
+- Fix typo in French `results_found` text string. [#2096](https://github.com/mmistakes/minimal-mistakes/pull/2096)
+- Fix figures inside of list elements. [#2094](https://github.com/mmistakes/minimal-mistakes/pull/2094)
+- Remove Font Awesome `data-search-pseudo-elements` attribute as it degrades smooth scroll performance. [#2075](https://github.com/mmistakes/minimal-mistakes/issues/2075#issuecomment-472437014)
+- Fix footnote links incompatibility with smooth scroll plugin. [#2075](https://github.com/mmistakes/minimal-mistakes/issues/2075)
+- Loosen Bundler dependency in ruby gem.
+
+## [4.15.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.2)
+
+### Enhancements
+
+- Close search overlay with Esc. [#2055](https://github.com/mmistakes/minimal-mistakes/pull/2055)
+- Update Swedish localized UI text strings. [#2056](https://github.com/mmistakes/minimal-mistakes/pull/2056)
+- Update Font Awesome to 5.7.1 and add `data-search-pseudo-elements` attribute. [#2053](https://github.com/mmistakes/minimal-mistakes/pull/2053)
+- Add Malayalam localized UI text strings. [#2037](https://github.com/mmistakes/minimal-mistakes/pull/2037)
+
+### Bug Fixes
+
+- Fix table of contents errors with non-English characters in the headings. [#2042](https://github.com/mmistakes/minimal-mistakes/pull/2042)
+- Fix `site.logo` false positives. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026#issuecomment-455770730)
+- Add empty `alt` attribute to `site.logo` image. [#2035](https://github.com/mmistakes/minimal-mistakes/pull/2035)
+
+## [4.15.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.1)
+
+### Bug Fixes
+
+- Fix empty `` when `site_logo` is not assigned. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026#issuecomment-454809876)
+
+## [4.15.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.15.0)
+
+### Enhancements
+
+- Add logo and title customization to the masthead. [#2026](https://github.com/mmistakes/minimal-mistakes/pull/2026)
+- Add support to customize `issue-term` for utterances comment provider. [#2022](https://github.com/mmistakes/minimal-mistakes/pull/2022)
+- Allow custom canonical url on a page-by-page basis. [#2021](https://github.com/mmistakes/minimal-mistakes/pull/2021)
+- Update table of contents navigation based on scroll position to indicate which link is currently active in the viewport. [#2020](https://github.com/mmistakes/minimal-mistakes/pull/2020)
+- Clicking table of contents links changes URL has fragment. [#2019](https://github.com/mmistakes/minimal-mistakes/pull/2019) [#2023](https://github.com/mmistakes/minimal-mistakes/pull/2023)
+
+## [4.14.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.2)
+
+### Enhancements
+
+- Improve accessibility by adding label text to search button toggle. [#2014](https://github.com/mmistakes/minimal-mistakes/pull/2014)
+- Update Lunr to 2.3.5. [#2010](https://github.com/mmistakes/minimal-mistakes/pull/2010)
+- Shorten Internet Explorer conditional statement in `_includes/head.html`. [#2006](https://github.com/mmistakes/minimal-mistakes/pull/2006)
+- Add Persian localized UI text strings. [#2004](https://github.com/mmistakes/minimal-mistakes/pull/2004)
+- Remove unused JavaScript variables from Staticman comment script. [#1996](https://github.com/mmistakes/minimal-mistakes/pull/1996)
+- Update Font Awesome to 5.6.0. [#1995](https://github.com/mmistakes/minimal-mistakes/pull/1995)
+- Change remaining schema.org markup to `https`. [#1978](https://github.com/mmistakes/minimal-mistakes/pull/1978)
+- Update NPM dependencies.
+
+### Bug Fixes
+
+- Fix wide tables that overflow parent container. [#2008](https://github.com/mmistakes/minimal-mistakes/issues/2008)
+- Fix Spanish `comments_label` and `comments_title` UI text strings. [#1997](https://github.com/mmistakes/minimal-mistakes/pull/1997)
+- Allow sidebar navigation with custom sidebar content. [#1986](https://github.com/mmistakes/minimal-mistakes/issues/1986)
+- Fix Google Custom Search JavaScript error when not using Instant Search. [#1983](https://github.com/mmistakes/minimal-mistakes/pull/1983)
+
+## [4.14.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.1)
+
+### Bug Fixes
+
+- Fix closed navicon on hover.
+
+## [4.14.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.14.0)
+
+### Enhancements
+
+- Change schema.org markup to `https`. [#1969](https://github.com/mmistakes/minimal-mistakes/pull/1969)
+- Add Google Drive as video provider. [#1967](https://github.com/mmistakes/minimal-mistakes/pull/1967)
+- Match `:focus` color to skin.
+- Add support for [utterances](https://utteranc.es/) comments. [#1909](https://github.com/mmistakes/minimal-mistakes/issues/1909)
+- Use privacy aware embed options for YouTube and Vimeo in [responsive video helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#responsive-video-embed). [#1964](https://github.com/mmistakes/minimal-mistakes/pull/1964)
+- Add `rel="nofollow noopener noreferrer"` to author profile links. [#1924](https://github.com/mmistakes/minimal-mistakes/pull/1924)
+- Improve color contrast of primary buttons and links.
+- Add Punjabi localized UI text strings. [#1962](https://github.com/mmistakes/minimal-mistakes/pull/1962)
+- Add Hindi localized UI text strings. [#1888](https://github.com/mmistakes/minimal-mistakes/pull/1888)
+- Update Lunr to `2.3.3`. [#1885](https://github.com/mmistakes/minimal-mistakes/pull/1885)
+- Cache "static" includes to improve build performance. **Note:** The theme uses the [jekyll-include-cache](https://github.com/benbalter/jekyll-include-cache) plugin which will need 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. [#1874](https://github.com/mmistakes/minimal-mistakes/pull/1874)
+- Make entire feature and archive items "clickable". [#1864](https://github.com/mmistakes/minimal-mistakes/pull/1864)
+- Allow custom Staticman endpoints. [#1842](https://github.com/mmistakes/minimal-mistakes/issues/1842)
+- Remove `type="text/css"` from Algolia script includes. [#1836](https://github.com/mmistakes/minimal-mistakes/pull/1836)
+- Remove unneeded `HandheldFriendly` and `MobileOptimized` meta tags. [#1837](https://github.com/mmistakes/minimal-mistakes/pull/1837)
+- Update Font Awesome to version `5.5.0` and add `integrity` hash. [#1922](https://github.com/mmistakes/minimal-mistakes/pull/1922)
+- Always load Google 404 Linkhelp script over HTTPS. [#1829](https://github.com/mmistakes/minimal-mistakes/pull/1829)
+- Remove deprecated `base_path` include helper.
+
+### Bug Fixes
+
+- Prevent current post from showing in the related posts section. [#1976](https://github.com/mmistakes/minimal-mistakes/pull/1976)
+- Fix dark skins syntax highlighting colors. [#1973](https://github.com/mmistakes/minimal-mistakes/issues/1973)
+- Remove unnecessary closing bracket in analytics documentation. [#1915](https://github.com/mmistakes/minimal-mistakes/pull/1915)
+- Fix breadcrumb navigation alignment. [#1917](https://github.com/mmistakes/minimal-mistakes/issues/1917)
+- Fix Algolia search link positioning. [#1904](https://github.com/mmistakes/minimal-mistakes/pull/1904)
+- Fix Lunr search index merging words. [#1883](https://github.com/mmistakes/minimal-mistakes/issues/1883)
+- Properly apply `relative_url` filter to internal links in header overlay `actions` array.
+- Revert cached includes (`include_cached`) for comment and analytics providers. [#1905](https://github.com/mmistakes/minimal-mistakes/issues/1905)
+
+## [4.13.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.13.0)
+
+### Enhancements
+
+- Add Romanian localized UI text strings. [#1814](https://github.com/mmistakes/minimal-mistakes/pull/1814)
+- Improve author link flexibility. [#1581](https://github.com/mmistakes/minimal-mistakes/issues/1581)
+- Improve footer link flexibility.
+- Deprecate `cta_label` and `cta_url` in header overlay in favor of new `actions` array that allows for multiple "call to action" button links. [#1461](https://github.com/mmistakes/minimal-mistakes/issues/1461)
+- Add support to [gallery helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery) for defining column layout (`half`, `third`, or single `''`). [#1821](https://github.com/mmistakes/minimal-mistakes/issues/1821)
+
+### Bug Fixes
+
+- Fix sidebar navigation list toggle. [#1819](https://github.com/mmistakes/minimal-mistakes/issues/1819)
+- Fix hover animation for links with `:visited` state. [#1820](https://github.com/mmistakes/minimal-mistakes/issues/1820)
+
+## [4.12.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.2)
+
+### Enhancements
+
+- Add missing Italian localized UI text strings. [#1793](https://github.com/mmistakes/minimal-mistakes/pull/1793)
+- Update [jekyll-toc](https://github.com/allejo/jekyll-toc) to `v1.0.5`.
+- Support heading levels 1-6 in table of contents with proper indentation styling. [#1782](https://github.com/mmistakes/minimal-mistakes/issues/1782)
+- Use relative links for masthead navigation menu items when possible. [#1784](https://github.com/mmistakes/minimal-mistakes/pull/1784)
+- Add `.emoji` class to author sidebar to normalize image sizes. [#1780](https://github.com/mmistakes/minimal-mistakes/pull/1780)
+- Update Staticman commit message to include comment author's name.
+- Improve side navigation spacing in relation to masthead.
+- Style archive links with appropriate link color.
+- Adjust feature row spacing and font-sizes.
+- Use sentence case and increase font-sizes for improved readability in table of contents.
+- Add `{{ content }}` to `home` layout. [#1775](https://github.com/mmistakes/minimal-mistakes/pull/1775)
+
+## [4.12.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.1)
+
+### Enhancements
+
+- Add missing French localized UI text strings. [#1769](https://github.com/mmistakes/minimal-mistakes/pull/1769) [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
+- Update Font Awesome to version [`5.2.0`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md). [#1754](https://github.com/mmistakes/minimal-mistakes/pull/1754)
+- Add documentation note to update root `Gemfile` when forking theme.
+
+### Bug Fixes
+
+- Remove slash at the beginning of `path` in staticman.yml example. [#1772](https://github.com/mmistakes/minimal-mistakes/pull/1772)
+- Fix `read_time` logic in header image overlay. [#1756](https://github.com/mmistakes/minimal-mistakes/pull/1756)
+
+## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0)
+
+### Enhancements
+
+- Add Hungarian localized UI text strings. [#1682](https://github.com/mmistakes/minimal-mistakes/pull/1682)
+- DRY `tags_max` calculation in tags.html layout. [#1696](https://github.com/mmistakes/minimal-mistakes/pull/1696)
+- DRY `categories_max` calculation in categories.html layout.
+- Add support for ["sticking" table of contents](https://mmistakes.github.io/minimal-mistakes/layout-table-of-contents-sticky/) to top of page via `toc_sticky: true` YAML Front Matter.
+- Add support for captioning images in feature row helper via `image_caption` YAML Front Matter. [#1440](https://github.com/mmistakes/minimal-mistakes/issues/1440)
+- Add [Google Custom Search Engine](https://cse.google.com/cse) support. [#1652](https://github.com/mmistakes/minimal-mistakes/issues/1652)
+- Update Font Awesome to version. [`5.1.13`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md)
+- Add "Pets" sample archive page to documentation site. [#1664](https://github.com/mmistakes/minimal-mistakes/pull/1664)
+- Add GitLab social icon brand color. [#1653](https://github.com/mmistakes/minimal-mistakes/issues/1653)
+- Prevent line breaks between FontAwesome icon and text in footer social links. [#1659](https://github.com/mmistakes/minimal-mistakes/issues/1659)
+
+### Bug Fixes
+
+- Set default `title_separator`. [#1701](https://github.com/mmistakes/minimal-mistakes/pull/1701)
+- Fix `naver_site_verification` typo in /\_includes/seo.html. [#1687](https://github.com/mmistakes/minimal-mistakes/pull/1687)
+- Fix table of contents missing borders. [#1675](https://github.com/mmistakes/minimal-mistakes/issues/1675)
+- Fix link to "Recipes" sample archive on documentation site. [#1664](https://github.com/mmistakes/minimal-mistakes/pull/1664)
+- Update example Reddit social share interpolation syntax in documentation. [#1656](https://github.com/mmistakes/minimal-mistakes/issues/1656)
+- Fix "Back to Top" links on pages that use [header overlays](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#header-overlay).
+
+## [4.11.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.11.2)
+
+### Enhancements
+
+- Update Font Awesome to version `5.0.11`. [#1620](https://github.com/mmistakes/minimal-mistakes/pull/1620)
+- Add Slovak localized UI text strings. [#1613](https://github.com/mmistakes/minimal-mistakes/pull/1613)
+- Add option to anonymize IP addresses of hits sent to Google Analytics. [#1636](https://github.com/mmistakes/minimal-mistakes/pull/1636)
+
+### Bug Fixes
+
+- Use correct text string for "Back to Top" link. [#1595](https://github.com/mmistakes/minimal-mistakes/issues/1595)
+- Add conditionals for showing `reCaptcha.siteKey` and `reCaptcha.secret` in Staticman comments form.
+
+## [4.11.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.11.1)
+
+### Enhancements
+
+- Add default `theme` and `remote_theme` values to `_config.yml`.
+- Add new layouts (`posts`, `categories`, `tags`, `collection`, `category`, and `tag`) for easier archive page creation.
+
+### Bug Fixes
+
+- Replace `absolute_url` filter with `relative_url` where it makes sense (asset/navigation related paths). [#1588](https://github.com/mmistakes/minimal-mistakes/issues/1588)
+- Fix search excerpts that run together because of implied spaces.
+
+## [4.10.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.10.1)
+
+### Enhancements
+
+- Update jQuery to version `3.3.1`. [#1491](https://github.com/mmistakes/minimal-mistakes/issues/1491)
+- Add link to jekyll-algolia's `files_to_exclude` documentation.
+- Update Font Awesome to version [`5.0.8`](https://github.com/FortAwesome/Font-Awesome/blob/master/CHANGELOG.md). [#1561](https://github.com/mmistakes/minimal-mistakes/pull/1561)
+- Activate Algolia search for documentation site. [#1570](https://github.com/mmistakes/minimal-mistakes/issues/1570)
+- Add missing German translations. [#1577](https://github.com/mmistakes/minimal-mistakes/pull/1577)
+- Add support for Google Analytics with global site tag (gtag.js) [#1563](https://github.com/mmistakes/minimal-mistakes/pull/1563)
+
+### Bug Fixes
+
+- Focus Algolia search input after clicking on search toggle.
 
 ## [4.10.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.10.0)
 
 ### Enhancements
 
-* Add support for [Algolia](https://www.algolia.com/) search provider ([see demo](https://mmistakes.github.io/minimal-mistakes-algolia-search/)). [#1416](https://github.com/mmistakes/minimal-mistakes/issues/1416)
+- Add support for [Algolia](https://www.algolia.com/) search provider ([see demo](https://mmistakes.github.io/minimal-mistakes-algolia-search/)). [#1416](https://github.com/mmistakes/minimal-mistakes/issues/1416)
 
 ## [4.9.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.9.1)
 
 ### Enhancements
 
-* Simplify year archive Liquid.
-* Add documentation on how to downgrade theme.
-* Improve greedy navigation's layout when JavaScript is disabled.
-* Improve SEO include by grouping similar tags, reducing white-space, and adding `article:modified_time`. [#1456](https://github.com/mmistakes/minimal-mistakes/pull/1456)
-* Minify `assets/js/lunr/lunr.js`.
-* Improve calculation of Greedy navigation's `availableSpace`.
-* Add Danish and Russian translations for new search strings. [#1472](https://github.com/mmistakes/minimal-mistakes/pull/1472) [#1477](https://github.com/mmistakes/minimal-mistakes/pull/1477)
-* Indicate that archive titles are links with an underline.
-* Remove `base_path` include from `/test` pages.
-* Reduce font-size of page meta in list/grid items.
-* Improve feature row styling when used with `archive` layout. [#1484](https://github.com/mmistakes/minimal-mistakes/issues/1484)
-* Improve German translations. [#1511](https://github.com/mmistakes/minimal-mistakes/pull/1511)
-* Update Font Awesome to `5.0.6`. [#1513](https://github.com/mmistakes/minimal-mistakes/pull/1513)
-* Add `wide` variant to single layout. [#1516](https://github.com/mmistakes/minimal-mistakes/pull/1516)
+- Simplify year archive Liquid.
+- Add documentation on how to downgrade theme.
+- Improve greedy navigation's layout when JavaScript is disabled.
+- Improve SEO include by grouping similar tags, reducing white-space, and adding `article:modified_time`. [#1456](https://github.com/mmistakes/minimal-mistakes/pull/1456)
+- Minify `assets/js/lunr/lunr.js`.
+- Improve calculation of Greedy navigation's `availableSpace`.
+- Add Danish and Russian translations for new search strings. [#1472](https://github.com/mmistakes/minimal-mistakes/pull/1472) [#1477](https://github.com/mmistakes/minimal-mistakes/pull/1477)
+- Indicate that archive titles are links with an underline.
+- Remove `base_path` include from `/test` pages.
+- Reduce font-size of page meta in list/grid items.
+- Improve feature row styling when used with `archive` layout. [#1484](https://github.com/mmistakes/minimal-mistakes/issues/1484)
+- Improve German translations. [#1511](https://github.com/mmistakes/minimal-mistakes/pull/1511)
+- Update Font Awesome to `5.0.6`. [#1513](https://github.com/mmistakes/minimal-mistakes/pull/1513)
+- Add `wide` variant to single layout. [#1516](https://github.com/mmistakes/minimal-mistakes/pull/1516)
 
 ### Bug Fixes
 
-* Allow `author` to accept an object or string. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289)
-* Fix syntax highlighting line number styling inconsistency. [#1467](https://github.com/mmistakes/minimal-mistakes/issues/1467)
-* Fix author sidebar icon colors for dark skins. [#1482](https://github.com/mmistakes/minimal-mistakes/issues/1482)
-* Remove misleading underline hover state on feature row items.
-* Properly escape quotes in `site.social.name` and `site.name`. [#1485](https://github.com/mmistakes/minimal-mistakes/pull/1485)
-* Fix typo in upgrading documentation. [#1487](https://github.com/mmistakes/minimal-mistakes/pull/1487)
-* Fix `border-bottom` for Gist line numbers.
-* Replace `|` with HTML entity when used as title separator. [#760](https://github.com/mmistakes/minimal-mistakes/issues/760)
+- Allow `author` to accept an object or string. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289)
+- Fix syntax highlighting line number styling inconsistency. [#1467](https://github.com/mmistakes/minimal-mistakes/issues/1467)
+- Fix author sidebar icon colors for dark skins. [#1482](https://github.com/mmistakes/minimal-mistakes/issues/1482)
+- Remove misleading underline hover state on feature row items.
+- Properly escape quotes in `site.social.name` and `site.name`. [#1485](https://github.com/mmistakes/minimal-mistakes/pull/1485)
+- Fix typo in upgrading documentation. [#1487](https://github.com/mmistakes/minimal-mistakes/pull/1487)
+- Fix `border-bottom` for Gist line numbers.
+- Replace `|` with HTML entity when used as title separator. [#760](https://github.com/mmistakes/minimal-mistakes/issues/760)
 
 ## [4.9.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.9.0)
 
 ### Enhancements
 
-* Add `show_overlay_excerpt` for disabling overlay image excerpt text. [#1436](https://github.com/mmistakes/minimal-mistakes/pull/1436)
-* Update remote theme installation instructions in Quick Start Guide. [#1439](https://github.com/mmistakes/minimal-mistakes/pull/1439)
-* Reduce visual weight of code blocks.
-* Add Lunr.js Greek stemmer. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445)
-* Update Font Awesome 5 [SVG with JavaScript version](https://fontawesome.com/how-to-use/svg-with-js). [#1446](https://github.com/mmistakes/minimal-mistakes/pull/1446)
-  * Note: if Font Awesome icons were used in the content of posts/pages or custom table of contents, find and replace any icons that have different names between version 4 and 5. Make sure to read the [complete list](https://fontawesome.com/how-to-use/upgrading-from-4#icon-name-changes-full) on Font Awesome's site.
-* Reduce size of Lunr.js search JSON data and introduce `site.search_full_content` flag for limiting size of JSON file. [#1449](https://github.com/mmistakes/minimal-mistakes/pull/1449)
-* Improve syntax highlighting styles. [#1450](https://github.com/mmistakes/minimal-mistakes/pull/1450)
+- Add `show_overlay_excerpt` for disabling overlay image excerpt text. [#1436](https://github.com/mmistakes/minimal-mistakes/pull/1436)
+- Update remote theme installation instructions in Quick Start Guide. [#1439](https://github.com/mmistakes/minimal-mistakes/pull/1439)
+- Reduce visual weight of code blocks.
+- Add Lunr.js Greek stemmer. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445)
+- Update Font Awesome 5 [SVG with JavaScript version](https://fontawesome.com/how-to-use/svg-with-js). [#1446](https://github.com/mmistakes/minimal-mistakes/pull/1446)
+  - Note: if Font Awesome icons were used in the content of posts/pages or custom table of contents, find and replace any icons that have different names between version 4 and 5. Make sure to read the [complete list](https://fontawesome.com/how-to-use/upgrading-from-4#icon-name-changes-full) on Font Awesome's site.
+- Reduce size of Lunr.js search JSON data and introduce `site.search_full_content` flag for limiting size of JSON file. [#1449](https://github.com/mmistakes/minimal-mistakes/pull/1449)
+- Improve syntax highlighting styles. [#1450](https://github.com/mmistakes/minimal-mistakes/pull/1450)
 
 ### Bug Fixes
 
-* Fix code block extra white-space when using [Jekyll's highlight tag](https://jekyllrb.com/docs/templates/#code-snippet-highlighting) with `linenos`. [#1437](https://github.com/mmistakes/minimal-mistakes/issues/1437)
-* Round top-right corner of code block icon.
-* Remove Lunr.js trimmer and bring back colons. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445)
-* Fix sticky `.sidebar` that overlaps main content when resizing viewport. [#1447](https://github.com/mmistakes/minimal-mistakes/issues/1447)
+- Fix code block extra white-space when using [Jekyll's highlight tag](https://jekyllrb.com/docs/templates/#code-snippet-highlighting) with `linenos`. [#1437](https://github.com/mmistakes/minimal-mistakes/issues/1437)
+- Round top-right corner of code block icon.
+- Remove Lunr.js trimmer and bring back colons. [#1445](https://github.com/mmistakes/minimal-mistakes/pull/1445)
+- Fix sticky `.sidebar` that overlaps main content when resizing viewport. [#1447](https://github.com/mmistakes/minimal-mistakes/issues/1447)
 
 ## [4.8.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.8.1)
 
 ### Enhancements
 
-* Add linkback functionality to author avatar and name in sidebar via `author.home`. [#1386](https://github.com/mmistakes/minimal-mistakes/pull/1386)
-* Add Japanese localized UI text strings. [#1411](https://github.com/mmistakes/minimal-mistakes/pull/1411)
-* Update Lunr.js to 2.1.5 [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419)
+- Add linkback functionality to author avatar and name in sidebar via `author.home`. [#1386](https://github.com/mmistakes/minimal-mistakes/pull/1386)
+- Add Japanese localized UI text strings. [#1411](https://github.com/mmistakes/minimal-mistakes/pull/1411)
+- Update Lunr.js to 2.1.5 [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419)
 
 ### Bug Fixes
 
-* Fixed broken link to Staticman's page [#1422](https://github.com/mmistakes/minimal-mistakes/pull/1422)
-* Fix Lunr search to work with number tags. [#1409](https://github.com/mmistakes/minimal-mistakes/issues/1409) [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419)
+- Fixed broken link to Staticman's page [#1422](https://github.com/mmistakes/minimal-mistakes/pull/1422)
+- Fix Lunr search to work with number tags. [#1409](https://github.com/mmistakes/minimal-mistakes/issues/1409) [#1419](https://github.com/mmistakes/minimal-mistakes/pull/1419)
 
 ## [4.8.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.8.0)
 
 ### Enhancements
 
-* Open social share links in a new window. [#1357](https://github.com/mmistakes/minimal-mistakes/pull/1357)
-* Remove Alexa.com verification due to retiring of "[Claim Your Site](https://support.alexa.com/hc/en-us/articles/219135887)" feature. [#1350](https://github.com/mmistakes/minimal-mistakes/issues/1350)
-* Disable analytics in `development` environment. [#1362](https://github.com/mmistakes/minimal-mistakes/pull/1362)
-* Disable comments in `development` environment. [#1363](https://github.com/mmistakes/minimal-mistakes/pull/1363)
-* Exclude specific pages/posts from search index by adding `search: false` to the YAML Front Matter. [#1369](https://github.com/mmistakes/minimal-mistakes/pull/1369)
-* Add optional `description` key to masthead links for clarifying their purpose with the `title` attribute. [#1380](https://github.com/mmistakes/minimal-mistakes/pull/1380)
-* Incorporate site search into masthead. [#1383](https://github.com/mmistakes/minimal-mistakes/pull/1383)
-* Update gem dependencies. [#1388](https://github.com/mmistakes/minimal-mistakes/pull/1388)
+- Open social share links in a new window. [#1357](https://github.com/mmistakes/minimal-mistakes/pull/1357)
+- Remove Alexa.com verification due to retiring of "[Claim Your Site](https://support.alexa.com/hc/en-us/articles/219135887)" feature. [#1350](https://github.com/mmistakes/minimal-mistakes/issues/1350)
+- Disable analytics in `development` environment. [#1362](https://github.com/mmistakes/minimal-mistakes/pull/1362)
+- Disable comments in `development` environment. [#1363](https://github.com/mmistakes/minimal-mistakes/pull/1363)
+- Exclude specific pages/posts from search index by adding `search: false` to the YAML Front Matter. [#1369](https://github.com/mmistakes/minimal-mistakes/pull/1369)
+- Add optional `description` key to masthead links for clarifying their purpose with the `title` attribute. [#1380](https://github.com/mmistakes/minimal-mistakes/pull/1380)
+- Incorporate site search into masthead. [#1383](https://github.com/mmistakes/minimal-mistakes/pull/1383)
+- Update gem dependencies. [#1388](https://github.com/mmistakes/minimal-mistakes/pull/1388)
 
 ### Bug Fixes
 
-* Fix `post.content` typo in `assets/js/lunr-en.js`. [#1354](https://github.com/mmistakes/minimal-mistakes/pull/1354)
-* Fix "lunr-en.js:1 Uncaught SyntaxError: Unexpected token <" in `assets/js/lunr-en.js`. [#1356](https://github.com/mmistakes/minimal-mistakes/pull/1356)
-* Rename Naver verification `naver_site_verification` to be consistent with other site variables.
-* Fix button class in "Post with Table Of Contents" demo content. [#1368](https://github.com/mmistakes/minimal-mistakes/pull/1368)
-* Fix capitalization of WordPress in documentation. [#1381](https://github.com/mmistakes/minimal-mistakes/pull/1381)
-* Fix zh-HK UI text to point to Traditional Chinese. [#1374](https://github.com/mmistakes/minimal-mistakes/issues/1374) [#1389](https://github.com/mmistakes/minimal-mistakes/pull/1389)
+- Fix `post.content` typo in `assets/js/lunr-en.js`. [#1354](https://github.com/mmistakes/minimal-mistakes/pull/1354)
+- Fix "lunr-en.js:1 Uncaught SyntaxError: Unexpected token <" in `assets/js/lunr-en.js`. [#1356](https://github.com/mmistakes/minimal-mistakes/pull/1356)
+- Rename Naver verification `naver_site_verification` to be consistent with other site variables.
+- Fix button class in "Post with Table Of Contents" demo content. [#1368](https://github.com/mmistakes/minimal-mistakes/pull/1368)
+- Fix capitalization of WordPress in documentation. [#1381](https://github.com/mmistakes/minimal-mistakes/pull/1381)
+- Fix zh-HK UI text to point to Traditional Chinese. [#1374](https://github.com/mmistakes/minimal-mistakes/issues/1374) [#1389](https://github.com/mmistakes/minimal-mistakes/pull/1389)
 
 ## [4.7.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.7.1)
 
 ### Enhancements
 
-* Add search layout powered by [Lunr](https://lunrjs.com/). [#1353](https://github.com/mmistakes/minimal-mistakes/pull/1353)
-* Use [jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) for demo site. [#1339](https://github.com/mmistakes/minimal-mistakes/issues/1339)
-* Add note about WordPress to Staticman comment migration tool in documentation. [#1346](https://github.com/mmistakes/minimal-mistakes/issues/1346)
+- Add search layout powered by [Lunr](https://lunrjs.com/). [#1353](https://github.com/mmistakes/minimal-mistakes/pull/1353)
+- Use [jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) for demo site. [#1339](https://github.com/mmistakes/minimal-mistakes/issues/1339)
+- Add note about WordPress to Staticman comment migration tool in documentation. [#1346](https://github.com/mmistakes/minimal-mistakes/issues/1346)
 
 ### Bug Fixes
 
-* Change `http` to `https` for Jekyll and Browserhappy links. [#1342](https://github.com/mmistakes/minimal-mistakes/pull/1342) [#1343](https://github.com/mmistakes/minimal-mistakes/pull/1343)
-* Change `http` author profile links to `https` when supported. [#1349](https://github.com/mmistakes/minimal-mistakes/pull/1349)
-* Fix broken SCSS partial links in layouts documentation. [#1351](https://github.com/mmistakes/minimal-mistakes/issues/1351)
+- Change `http` to `https` for Jekyll and Browserhappy links. [#1342](https://github.com/mmistakes/minimal-mistakes/pull/1342) [#1343](https://github.com/mmistakes/minimal-mistakes/pull/1343)
+- Change `http` author profile links to `https` when supported. [#1349](https://github.com/mmistakes/minimal-mistakes/pull/1349)
+- Fix broken SCSS partial links in layouts documentation. [#1351](https://github.com/mmistakes/minimal-mistakes/issues/1351)
 
 ## [4.7.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.7.0)
 
 ### Enhancements
 
-* Add `alt` description to avatar image. [#1226](https://github.com/mmistakes/minimal-mistakes/pull/1226)
-* Clarify documentation about which `assets` folders and files to remove when migrating to the gem version of the theme. [#1268](https://github.com/mmistakes/minimal-mistakes/issues/1268)
-* Add note about Staticman GitHub compatibility. [#1273](https://github.com/mmistakes/minimal-mistakes/issues/1273)
-* Add missing Brazilian Portuguese translations to `ui-text.yml`. [#1278](https://github.com/mmistakes/minimal-mistakes/pull/1278)
-* Update font stack documentation. [#1292](https://github.com/mmistakes/minimal-mistakes/pull/1292)
-* Improve accessibility of navigation menu button. [#1099](https://github.com/mmistakes/minimal-mistakes/issues/1099)
-* Add Naver Webmaster Tools verification. [#1286](https://github.com/mmistakes/minimal-mistakes/pull/1286)
-* Add support for Staticman v2 endpoint and reCAPTCHA.
-* Add Polish localized UI text strings. [#1304](https://github.com/mmistakes/minimal-mistakes/pull/1304)
-* Add toggleable table of contents via YAML Front Matter. Note: `toc` helper include will be deprecated in next major version. [#1222](https://github.com/mmistakes/minimal-mistakes/issues/1222)
-* Refactor seo.html include to DRY-up page image handling.
-* Add support for setting what image is used by OpenGraph and Twitter via `page.header.og_image`. [#1316](https://github.com/mmistakes/minimal-mistakes/issues/1316)
-* Fix the spelling of some product names in the author profile. [#1328](https://github.com/mmistakes/minimal-mistakes/pull/1328)
-* Add `aqua`, `neon`, and `plum` skins. [#1336](https://github.com/mmistakes/minimal-mistakes/pull/1336)
-* Update **jekyll-toc** with heading classes fix. [#1337](https://github.com/mmistakes/minimal-mistakes/pull/1337)
-* Remove `+` from Google+ author link to allow non-vanity URLs. [#1319](https://github.com/mmistakes/minimal-mistakes/pull/1319)
+- Add `alt` description to avatar image. [#1226](https://github.com/mmistakes/minimal-mistakes/pull/1226)
+- Clarify documentation about which `assets` folders and files to remove when migrating to the gem version of the theme. [#1268](https://github.com/mmistakes/minimal-mistakes/issues/1268)
+- Add note about Staticman GitHub compatibility. [#1273](https://github.com/mmistakes/minimal-mistakes/issues/1273)
+- Add missing Brazilian Portuguese translations to `ui-text.yml`. [#1278](https://github.com/mmistakes/minimal-mistakes/pull/1278)
+- Update font stack documentation. [#1292](https://github.com/mmistakes/minimal-mistakes/pull/1292)
+- Improve accessibility of navigation menu button. [#1099](https://github.com/mmistakes/minimal-mistakes/issues/1099)
+- Add Naver Webmaster Tools verification. [#1286](https://github.com/mmistakes/minimal-mistakes/pull/1286)
+- Add support for Staticman v2 endpoint and reCAPTCHA.
+- Add Polish localized UI text strings. [#1304](https://github.com/mmistakes/minimal-mistakes/pull/1304)
+- Add toggleable table of contents via YAML Front Matter. Note: `toc` helper include will be deprecated in next major version. [#1222](https://github.com/mmistakes/minimal-mistakes/issues/1222)
+- Refactor seo.html include to DRY-up page image handling.
+- Add support for setting what image is used by OpenGraph and Twitter via `page.header.og_image`. [#1316](https://github.com/mmistakes/minimal-mistakes/issues/1316)
+- Fix the spelling of some product names in the author profile. [#1328](https://github.com/mmistakes/minimal-mistakes/pull/1328)
+- Add `aqua`, `neon`, and `plum` skins. [#1336](https://github.com/mmistakes/minimal-mistakes/pull/1336)
+- Update **jekyll-toc** with heading classes fix. [#1337](https://github.com/mmistakes/minimal-mistakes/pull/1337)
+- Remove `+` from Google+ author link to allow non-vanity URLs. [#1319](https://github.com/mmistakes/minimal-mistakes/pull/1319)
 
 ### Bug Fixes
 
-* Fix system font rendering in Chrome on macOS/OS X. [#1290](https://github.com/mmistakes/minimal-mistakes/pull/1290)
-* Fix extra padding in syntax highlighted code blocks due to Rouge 2 adding `
` to markup.
+- Fix system font rendering in Chrome on macOS/OS X. [#1290](https://github.com/mmistakes/minimal-mistakes/pull/1290)
+- Fix extra padding in syntax highlighted code blocks due to Rouge 2 adding `
` to markup.
 
 ## [4.6.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.6.0)
 
 ### Enhancements
 
-* Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236)
-* Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239)
-* Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color.
-* DRY up button CSS using Sass lists and YIQ Color Contrast mixin.
-* Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `my link`).
-* Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208)
-* Allow scripts in `` 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)
+- Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236)
+- Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239)
+- Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color.
+- DRY up button CSS using Sass lists and YIQ Color Contrast mixin.
+- Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `my link`).
+- Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208)
+- Allow scripts in `` 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)
+- 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 {% raw %}`"{{ page.[include.id] }}"`"{% endraw %} 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.
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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`.
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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:
+- 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:
 
   ```
   ---
@@ -308,601 +1067,593 @@ toc: true
 
 ### 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)
+- 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)
+- 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)
+- 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/)
+- 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)
+- 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)
+- 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)
+- 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).
+- 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)
+- 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`.
+- 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
+- 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)
+- 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)
+- 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)
+- 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)
+- 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.
+- 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.
+- 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)
+- 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)
+- 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**
+- 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 `
` element with a single image and caption easier. [#572](https://github.com/mmistakes/minimal-mistakes/pull/572)
-* Add structured data markup for `itemprop="person"` in author profile sidebar. [#647](https://github.com/mmistakes/minimal-mistakes/pull/647)
+- Add [`figure` helper](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#figure) to make generating a `
` element with a single image and caption easier. [#572](https://github.com/mmistakes/minimal-mistakes/pull/572)
+- Add structured data markup for `itemprop="person"` in author profile sidebar. [#647](https://github.com/mmistakes/minimal-mistakes/pull/647)
 
 ### Bug Fixes
 
-* Fix improper YAML formatting of some locales. [#651](https://github.com/mmistakes/minimal-mistakes/pull/651)
+- Fix improper YAML formatting of some locales. [#651](https://github.com/mmistakes/minimal-mistakes/pull/651)
 
 ### Maintenance
 
-* Clarify "migrating to gem-theme" instructions in **Quick Start Guide**.
-* Add `rake preview` task for testing `/test` during theme development.
+- Clarify "migrating to gem-theme" instructions in **Quick Start Guide**.
+- Add `rake preview` task for testing `/test` during theme development.
 
 ## [4.0.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.5)
 
 ### Enhancements
 
-* Update gems: `jekyll-sitemap` (0.12), `jekyll-feed` (0.8).
-* Improve next/previous pager links visibility by changing gray color to blue (`$link-color`).
+- Update gems: `jekyll-sitemap` (0.12), `jekyll-feed` (0.8).
+- Improve next/previous pager links visibility by changing gray color to blue (`$link-color`).
 
 ### Bug Fixes
 
-* Fix `.sidebar` flicker/jump when hovered. [#583](https://github.com/mmistakes/minimal-mistakes/issues/583)
+- Fix `.sidebar` flicker/jump when hovered. [#583](https://github.com/mmistakes/minimal-mistakes/issues/583)
 
 ### Maintenance
 
-* Move contents of `gh-pages` branch to `master` inside of the `/docs` folder.
+- Move contents of `gh-pages` branch to `master` inside of the `/docs` folder.
 
 ## [4.0.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.0.4)
 
 ### Enhancements
 
-* "Gemify" theme ~> `gem "minimal-mistakes-jekyll"`
-* Replace `base_path` include with `absolute_url` filter where possible.
-* Allow images to be placed in other folders. Remove `/images/` only restriction and encourage placement in `/assets/images/` instead. **Full paths are now required. If upgrading from MM 3.4 add `/images/` before filenames in Front Matter and `_config.yml` variables.**
-* Add [home `layout`](https://github.com/mmistakes/minimal-mistakes/blob/master/_layouts/home.html)
-* Added missing Turkish translations for UI text. [#621](https://github.com/mmistakes/minimal-mistakes/pull/621)
-* Make author avatar optional in sidebar.
-* Update **/\_includes/seo.html** for meta description. [#558](https://github.com/mmistakes/minimal-mistakes/pull/558)
+- "Gemify" theme ~> `gem "minimal-mistakes-jekyll"`
+- Replace `base_path` include with `relative_url` filter where possible.
+- Allow images to be placed in other folders. Remove `/images/` only restriction and encourage placement in `/assets/images/` instead. **Full paths are now required. If upgrading from MM 3.4 add `/images/` before filenames in Front Matter and `_config.yml` variables.**
+- Add [home `layout`](https://github.com/mmistakes/minimal-mistakes/blob/master/_layouts/home.html)
+- Added missing Turkish translations for UI text. [#621](https://github.com/mmistakes/minimal-mistakes/pull/621)
+- Make author avatar optional in sidebar.
+- Update **/\_includes/seo.html** for meta description. [#558](https://github.com/mmistakes/minimal-mistakes/pull/558)
 
 ### Bug Fixes
 
-* Fix navigation bar animation "flicker" in Safari [#568](https://github.com/mmistakes/minimal-mistakes/issues/568)
-* Fix `author.avatar` paths for externally hosted images.
+- Fix navigation bar animation "flicker" in Safari [#568](https://github.com/mmistakes/minimal-mistakes/issues/568)
+- Fix `author.avatar` paths for externally hosted images.
 
 ### Maintenance
 
-* Add documentation around `gem "minimal-mistakes-jekyll"` installation and use.
-* Add note about using full image paths for eg. `assets/images/filename.jpg` (header images, overlays, galleries, feature rows, etc.) instead of assuming they will always be in `/images/`.
-* Add "[Overriding Theme Defaults](https://mmistakes.github.io/minimal-mistakes/docs/overriding-theme-defaults/)" page to documentation.
+- Add documentation around `gem "minimal-mistakes-jekyll"` installation and use.
+- Add note about using full image paths for eg. `assets/images/filename.jpg` (header images, overlays, galleries, feature rows, etc.) instead of assuming they will always be in `/images/`.
+- Add "[Overriding Theme Defaults](https://mmistakes.github.io/minimal-mistakes/docs/overriding-theme-defaults/)" page to documentation.
 
 ## [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)
+- 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)
+- 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.
+- 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 `` 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)
+- Add `layout` based and user-defined class names to `` 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)
+- 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)
+- 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`.
+- 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)
+- Improve line numbered code block styling when using `{% highlight linenos %}` 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)
+- Fix Firefox alignment issues with code blocks generated with the `{% highlight %}` 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)
+- 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 `{% highlight %}` 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)
+- 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)
+- 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).
+- 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)
+- 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)
+- 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.
+- 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)
+- 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`.
+- Add `staticman.filename` configuration with UNIX timestamp for sorting data files. example ~> `comment-1470943149`.
 
 ### Bug Fixes
 
-* Don't add `` to author name if URL is blank.
+- Don't add `` 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)
+- 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)
+- 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)
+- 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.
+- 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)
+- 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)
+- 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.`
+- 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 `` 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)
+- Add support for configurable feed URL to use a service like FeedBurner instead of linking directly to `feed.xml` in `` 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).
+- 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.
+- Make footer stick to the bottom of the page.
 
 ### Bug Fixes
 
-* Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402)
+- 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`.
+- 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)
+- 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)
+- 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)
+- 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
+### Enhancements
 
-* 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`.
+- 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)
+- 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)
+- 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)
+- 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
+- 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`
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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)
+- 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.
+- 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)
+- 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)
+- 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.
+- 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
+### Enhancements
 
-* Add [Discourse](https://www.discourse.org/) as a commenting provider [#335](https://github.com/mmistakes/minimal-mistakes/pull/335)
+- 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
+### Enhancements
 
-* 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)
+- 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)
+- 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.
+- 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)
+- 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. `
` element is now conditional if `title:` is not set for a `page` or collection item. [#312](https://github.com/mmistakes/minimal-mistakes/issues/312)
+- Fix `Liquid Exception: undefined method 'gsub' for nil:NilClass in _layouts/single.html` error when `page.title` is null. `
` 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)
+- 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)
+- 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
+### Enhancements
 
-* Add translation key for "Recent Posts" used in home page `index.html`. [#316](https://github.com/mmistakes/minimal-mistakes/pull/316)
+- 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)
+- 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`.
+- 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)
+- 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)
+- 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)
+- 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)
+- 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
+### Enhancements
+
+- 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.
+
+### Bug Fixes
 
-* 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.
+- Fix alignment issues with related posts [#273](https://github.com/mmistakes/minimal-mistakes/issues/273) and "Follow" button in author profile [#274](https://github.com/mmistakes/minimal-mistakes/issues/274).
 
 ## [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)
+- 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`.
+- 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.
+- 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 ``.
-* 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.
+- 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 ``.
+- 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)
 
@@ -910,64 +1661,64 @@ toc: true
 
 ### Enhancements
 
-* Add support for Jekyll 3.0
-* Minor updates to syntax highlighting CSS and theme documentation
+- 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.
+- 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)
+- 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)
+- 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
+- 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
+- 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))
+- 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
+- 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)
 
@@ -975,24 +1726,24 @@ toc: true
 
 ### 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
+- 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.
+- 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.
+- 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)
 
@@ -1000,54 +1751,55 @@ toc: true
 
 ### Bug Fixes
 
-* Table weren't filling the entire width of the content container. They now scale at 100%. Thanks [@dhruvbhatia](https://github.com/dhruvbhatia)
+- 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
+- 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.
+- 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.
+- 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
+- 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.
+- 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.
+- 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.
+- 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)
+{% endraw %}
diff --git a/docs/_docs/19-contributing.md b/docs/_docs/19-contributing.md
index 7fb495926a77..bd555ee2c46f 100644
--- a/docs/_docs/19-contributing.md
+++ b/docs/_docs/19-contributing.md
@@ -11,7 +11,7 @@ Minimal Mistakes has been designed as a base for you to customize and fit your s
 
 This goes for author sidebar links and "share button" additions -- I have no intention of merging in every possibly option, the essentials are there to get you started :smile:.
 
-## Pull Requests
+## Pull requests
 
 When submitting a pull request:
 
diff --git a/docs/_docs/20-docs-2-2.md b/docs/_docs/20-docs-2-2.md
index 1e8facf1fa89..bcaa01cfa1b9 100644
--- a/docs/_docs/20-docs-2-2.md
+++ b/docs/_docs/20-docs-2-2.md
@@ -2,7 +2,7 @@
 title: "2.2 Documentation"
 permalink: /docs/docs-2-2/
 excerpt: "Setup and installation instructions for Minimal Mistakes 2.2 (deprecated)."
-last_modified_at: 2017-10-20T12:37:11-04:00
+last_modified_at: 2018-03-20T16:00:34-04:00
 toc: true
 ---
 
@@ -49,7 +49,6 @@ How Minimal Mistakes is organized and what the various files are. All posts, lay
 minimal-mistakes/
 ├── _includes/
 |    ├── author-bio.html        # bio stuff layout. pulls optional owner data from _config.yml
-|    ├── browser-upgrade   # prompt to install a modern browser for < IE9
 |    ├── disqus-comments   # Disqus comments script
 |    ├── footer            # site footer
 |    ├── head              # site head
@@ -256,7 +255,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.
 
 

-  screen shot of paragraphs with default indent style set
+  screen shot of paragraphs with default indent style set
   
Example of the default paragraph style (indented first line and bottom margin removed).

 

 
@@ -267,7 +266,7 @@ $paragraph-indent: false;
 ```
 
 

-  screen shot of paragraphs with indent style disabled
+  screen shot of paragraphs with indent style disabled
   
Example of paragraphs with $paragraph-indent disabled.

 

 
@@ -297,4 +296,4 @@ To modify the site's JavaScript files I setup a Grunt build script to lint/conca
 npm install
 ```
 
-From the theme's root, use `grunt` concatenate JavaScript files, and optimize .jpg, .png, and .svg files in the `images/` folder. You can also use `grunt dev` in combination with `jekyll build --watch` to watch for updates JS files that Grunt will then automatically re-build as you write your code which will in turn auto-generate your Jekyll site when developing locally.
\ No newline at end of file
+From the theme's root, use `grunt` concatenate JavaScript files, and optimize .jpg, .png, and .svg files in the `images/` folder. You can also use `grunt dev` in combination with `jekyll build --watch` to watch for updates JS files that Grunt will then automatically re-build as you write your code which will in turn auto-generate your Jekyll site when developing locally.
diff --git a/docs/_docs/22-faq.md b/docs/_docs/22-faq.md
new file mode 100644
index 000000000000..f41f7fc14d02
--- /dev/null
+++ b/docs/_docs/22-faq.md
@@ -0,0 +1,18 @@
+---
+title: Frequently Asked Questions
+classes: wide
+permalink: "/docs/faq/"
+sidebar:
+  nav: docs
+last_modified_at: '2024-04-24T00:51:32+08:00'
+toc: false
+---
+
+This page is still under construction. Meanwhile, check out existing [issues](https://github.com/mmistakes/minimal-mistakes/issues) and [discussions](https://github.com/mmistakes/minimal-mistakes/discussions) to see if your question has already been asked before.
+{: .notice--primary }
+
+- `'require': cannot load such file -- webrick (LoadError)`
+  
+  This error occurs when you run `jekyll serve` on Ruby 3.0+. 
+
+  Ruby 3.0 no longer comes with Webrick by default. To fix this, add `gem "webrick"` to your `Gemfile` and run `bundle install`. See [jekyll/jekyll#8523](https://github.com/jekyll/jekyll/issues/8523)
diff --git a/docs/_includes/after-content.html b/docs/_includes/after-content.html
new file mode 100644
index 000000000000..482c530b7931
--- /dev/null
+++ b/docs/_includes/after-content.html
@@ -0,0 +1,8 @@
+

+  
+

diff --git a/docs/_includes/before-related.html b/docs/_includes/before-related.html
new file mode 100644
index 000000000000..69ea67c544a5
--- /dev/null
+++ b/docs/_includes/before-related.html
@@ -0,0 +1 @@
+{% include after-content.html %}
diff --git a/docs/_includes/comments-providers/scripts.html b/docs/_includes/comments-providers/scripts.html
new file mode 100644
index 000000000000..5617ab8922fa
--- /dev/null
+++ b/docs/_includes/comments-providers/scripts.html
@@ -0,0 +1,11 @@
+{% comment %}
+  Repurposing this file as "after-scripts.html" snippet,
+  since the docs site isn't using comments anyway.
+{% endcomment %}
+
+
+
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
deleted file mode 100644
index 88aa9cb572af..000000000000
--- a/docs/_layouts/default.html
+++ /dev/null
@@ -1,53 +0,0 @@
----
----
-
-
-
-
-  
-    {% include head.html %}
-    {% include head/custom.html %}
-  
-
-  
-
-    {% include browser-upgrade.html %}
-    {% include masthead.html %}
-
-    

-      {{ content }}
-      
-        

-        
-        

-        
-    

-
-    {% if site.search == true %}
-      

-        {% include search/search_form.html %}
-      

-    {% endif %}
-
-    

-      

-        {% include footer/custom.html %}
-        {% include footer.html %}
-      

-    

-
-    {% include scripts.html %}
-
-  
-
\ No newline at end of file
diff --git a/docs/_pages/404.md b/docs/_pages/404.md
index 9d0f86066123..b3025a6053b5 100644
--- a/docs/_pages/404.md
+++ b/docs/_pages/404.md
@@ -5,12 +5,4 @@ sitemap: false
 permalink: /404.html
 ---
 
-Sorry, but the page you were trying to view does not exist --- perhaps you can try searching for it below.
-
-
-
+Sorry, but the page you were trying to view does not exist.
diff --git a/docs/_pages/about.md b/docs/_pages/about.md
index e8e7cbe21818..4a805ceda268 100644
--- a/docs/_pages/about.md
+++ b/docs/_pages/about.md
@@ -12,7 +12,7 @@ layouts_gallery:
   - url: /assets/images/mm-layout-archive.png
     image_path: /assets/images/mm-layout-archive.png
     alt: "archive layout example"
-last_modified_at: 2018-01-10T11:22:24-05:00
+last_modified_at: 2022-05-27T11:59:26-04:00
 toc: true
 ---
 
@@ -20,7 +20,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
 
 {% include gallery id="layouts_gallery" caption="Examples of included layouts `splash`, `single`, and `archive`." %}
 
-[Install the Theme]({{ "/docs/quick-start-guide/" | absolute_url }}){: .btn .btn--success .btn--large}
+[Install the Theme]({{ "/docs/quick-start-guide/" | relative_url }}){: .btn .btn--success .btn--large}
 
 ## Notable Features
 
@@ -31,9 +31,9 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
 - 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).
+- Commenting support (powered by [Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), [Discourse](https://www.discourse.org/), [utterances](https://utteranc.es/), [giscus](https://giscus.app/), 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, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Russian, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
+- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Bulgarian, Catalan, Chinese, Czech, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), and Vietnamese.
 
 ## Demo Pages
 
@@ -49,14 +49,14 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
 
 For even more demo pages check the [posts archive][year-archive].
 
-[header-image-post]: {{ "" | absolute_url }}{% post_url 2012-03-15-layout-header-image-text-readability %}
-[gallery-post]: {{ "" | absolute_url }}{% post_url 2010-09-09-post-gallery %}
-[html-tags-post]: {{ "" | absolute_url }}{% post_url 2013-01-11-markup-html-tags-and-formatting %}
-[syntax-post]: {{ "" | absolute_url }}{% post_url 2013-08-16-markup-syntax-highlighting %}
-[sample-collection]: {{ "/recipes/chocolate-chip-cookies/" | absolute_url }}
-[categories-archive]: {{ "/categories/" | absolute_url }}
-[tags-archive]: {{ "/tags/" | absolute_url }}
-[year-archive]: {{ "/year-archive/" | absolute_url }}
+[header-image-post]: {{ "" | relative_url }}{% post_url 2012-03-15-layout-header-image-text-readability %}
+[gallery-post]: {{ "" | relative_url }}{% post_url 2010-09-09-post-gallery %}
+[html-tags-post]: {{ "" | relative_url }}{% post_url 2013-01-11-markup-html-tags-and-formatting %}
+[syntax-post]: {{ "" | relative_url }}{% post_url 2013-08-16-markup-syntax-highlighting %}
+[sample-collection]: {{ "/recipes/chocolate-chip-cookies/" | relative_url }}
+[categories-archive]: {{ "/categories/" | relative_url }}
+[tags-archive]: {{ "/tags/" | relative_url }}
+[year-archive]: {{ "/year-archive/" | relative_url }}
 
 ---
 
diff --git a/docs/_pages/category-archive.html b/docs/_pages/category-archive.html
deleted file mode 100644
index c9e03e1563a4..000000000000
--- a/docs/_pages/category-archive.html
+++ /dev/null
@@ -1,16 +0,0 @@
----
-layout: archive
-permalink: /categories/
-title: "Posts by Category"
-author_profile: true
----
-
-{% include group-by-array collection=site.posts field="categories" %}
-
-{% for category in group_names %}
-  {% assign posts = group_items[forloop.index0] %}
-  
{{ category }}

-  {% for post in posts %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
\ No newline at end of file
diff --git a/docs/_pages/category-archive.md b/docs/_pages/category-archive.md
new file mode 100644
index 000000000000..4cb3860e91be
--- /dev/null
+++ b/docs/_pages/category-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Category"
+layout: categories
+permalink: /categories/
+author_profile: true
+---
diff --git a/docs/_pages/edge-case.md b/docs/_pages/edge-case.md
new file mode 100644
index 000000000000..016138a4675a
--- /dev/null
+++ b/docs/_pages/edge-case.md
@@ -0,0 +1,8 @@
+---
+title: Edge Case
+layout: category
+permalink: /categories/edge-case/
+taxonomy: Edge Case
+---
+
+Sample post listing for the category `Edge Case`.
diff --git a/docs/_pages/home.md b/docs/_pages/home.md
index 90f6dba7a89e..15090361e93d 100644
--- a/docs/_pages/home.md
+++ b/docs/_pages/home.md
@@ -1,41 +1,38 @@
 ---
 layout: splash
 permalink: /
+hidden: true
 header:
   overlay_color: "#5e616c"
   overlay_image: /assets/images/mm-home-page-feature.jpg
-  cta_label: " Install Now"
-  cta_url: "/docs/quick-start-guide/"
-  caption:
-excerpt: 'A flexible two-column Jekyll theme. Perfect for personal sites, blogs, and portfolios hosted on GitHub or your own server.
 Latest release v4.10.0

 {::nomarkdown} {:/nomarkdown}'
+  actions:
+    - label: " Install now"
+      url: "/docs/quick-start-guide/"
+excerpt: >
+  A flexible two-column Jekyll theme. Perfect for building personal sites, blogs, and portfolios.

+  Latest release v4.27.3
 feature_row:
   - image_path: /assets/images/mm-customizable-feature.png
     alt: "customizable"
-    title: "Super Customizable"
+    title: "Super customizable"
     excerpt: "Everything from the menus, sidebars, comments, and more can be configured or set with YAML Front Matter."
     url: "/docs/configuration/"
     btn_class: "btn--primary"
-    btn_label: "Learn More"
+    btn_label: "Learn more"
   - image_path: /assets/images/mm-responsive-feature.png
     alt: "fully responsive"
-    title: "Responsive Layouts"
-    excerpt: "Built on HTML5 + CSS3. All layouts are fully responsive with helpers to augment your content."
+    title: "Responsive layouts"
+    excerpt: "Built with HTML5 + CSS3. All layouts are fully responsive with helpers to augment your content."
     url: "/docs/layouts/"
     btn_class: "btn--primary"
-    btn_label: "Learn More"
+    btn_label: "Learn more"
   - image_path: /assets/images/mm-free-feature.png
     alt: "100% free"
-    title: "100% Free"
-    excerpt: "Free to use however you want under the MIT License. Clone it, fork it, customize it, whatever!"
+    title: "100% free"
+    excerpt: "Free to use however you want under the MIT License. Clone it, fork it, customize it... whatever!"
     url: "/docs/license/"
     btn_class: "btn--primary"
-    btn_label: "Learn More"
-github:
-  - excerpt: '{::nomarkdown} {:/nomarkdown}'
-intro:
-  - excerpt: 'Get notified when I add new stuff   [ @mmistakes](https://twitter.com/mmistakes){: .btn .btn--twitter} [ Tip Me](https://www.paypal.me/mmistakes){: .btn .btn--primary}'
+    btn_label: "Learn more"      
 ---
 
-{% include feature_row id="intro" type="center" %}
-
-{% include feature_row %}
\ No newline at end of file
+{% include feature_row %}
diff --git a/docs/_pages/markup.md b/docs/_pages/markup.md
new file mode 100644
index 000000000000..147a719ae258
--- /dev/null
+++ b/docs/_pages/markup.md
@@ -0,0 +1,8 @@
+---
+title: Markup
+layout: tag
+permalink: /tags/markup/
+taxonomy: markup
+---
+
+Sample post listing for the tag `markup`.
diff --git a/docs/_pages/page-archive.html b/docs/_pages/page-archive.html
index a4e515abc721..ada3f64fb9ce 100644
--- a/docs/_pages/page-archive.html
+++ b/docs/_pages/page-archive.html
@@ -5,6 +5,7 @@
 author_profile: false
 ---
 
-{% for post in site.pages %}
+{% assign posts = site.pages | where_exp: "post", "post.hidden != true" %}
+{% for post in posts %}
   {% include archive-single.html %}
-{% endfor %}
\ No newline at end of file
+{% endfor %}
diff --git a/docs/_pages/pets.md b/docs/_pages/pets.md
new file mode 100644
index 000000000000..1ecc1f3b565f
--- /dev/null
+++ b/docs/_pages/pets.md
@@ -0,0 +1,10 @@
+---
+title: Pets
+layout: collection
+permalink: /pets/
+collection: pets
+entries_layout: grid
+classes: wide
+---
+
+Sample document listing for the collection `_pets`.
diff --git a/docs/_pages/portfolio-archive.html b/docs/_pages/portfolio-archive.html
deleted file mode 100644
index f206c570ebc4..000000000000
--- a/docs/_pages/portfolio-archive.html
+++ /dev/null
@@ -1,12 +0,0 @@
----
-layout: archive
-title: "Portfolio"
-permalink: /portfolio/
-author_profile: false
----
-
-

-  {% for post in site.portfolio %}
-    {% include archive-single.html type="grid" %}
-  {% endfor %}
-

\ No newline at end of file
diff --git a/docs/_pages/portfolio-archive.md b/docs/_pages/portfolio-archive.md
new file mode 100644
index 000000000000..019082f49185
--- /dev/null
+++ b/docs/_pages/portfolio-archive.md
@@ -0,0 +1,10 @@
+---
+title: Portfolio
+layout: collection
+permalink: /portfolio/
+collection: portfolio
+entries_layout: grid
+classes: wide
+---
+
+Sample document listing for the collection `_portfolio`.
diff --git a/docs/_pages/recipes-archive.html b/docs/_pages/recipes-archive.html
deleted file mode 100644
index b5e2dfc246a9..000000000000
--- a/docs/_pages/recipes-archive.html
+++ /dev/null
@@ -1,10 +0,0 @@
----
-layout: archive
-title: "Recipes"
-permalink: /recipes/
-author_profile: false
----
-
-{% for post in site.recipes %}
-  {% include archive-single.html %}
-{% endfor %}
\ No newline at end of file
diff --git a/docs/_pages/recipes-archive.md b/docs/_pages/recipes-archive.md
new file mode 100644
index 000000000000..96a36cf7fc72
--- /dev/null
+++ b/docs/_pages/recipes-archive.md
@@ -0,0 +1,9 @@
+---
+layout: collection
+title: "Recipes"
+collection: recipes
+permalink: /recipes/
+author_profile: false
+---
+
+Sample document listing for the collection `_recipes`.
\ No newline at end of file
diff --git a/docs/_pages/sitemap.md b/docs/_pages/sitemap.md
index 2f1417d09069..bb6e1831a4c1 100644
--- a/docs/_pages/sitemap.md
+++ b/docs/_pages/sitemap.md
@@ -5,7 +5,7 @@ permalink: /sitemap/
 author_profile: false
 ---
 
-A list of all the posts and pages found on the site. For you robots out there is an [XML version]({{ "sitemap.xml" | absolute_url }}) available for digesting as well.
+A list of all the posts and pages found on the site. For you robots out there is an [XML version]({{ "sitemap.xml" | relative_url }}) available for digesting as well.
 
 
Pages

 {% for post in site.pages %}
diff --git a/docs/_pages/splash-page.md b/docs/_pages/splash-page.md
index f0cd57b04a5a..f11bc0b0737b 100644
--- a/docs/_pages/splash-page.md
+++ b/docs/_pages/splash-page.md
@@ -7,8 +7,9 @@ header:
   overlay_color: "#000"
   overlay_filter: "0.5"
   overlay_image: /assets/images/unsplash-image-1.jpg
-  cta_label: "Download"
-  cta_url: "https://github.com/mmistakes/minimal-mistakes/"
+  actions:
+    - label: "Download"
+      url: "https://github.com/mmistakes/minimal-mistakes/"
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
 excerpt: "Bacon ipsum dolor sit amet salami ham hock ham, hamburger corned beef short ribs kielbasa biltong t-bone drumstick tri-tip tail sirloin pork chop."
 intro: 
@@ -19,6 +20,7 @@ feature_row:
     title: "Placeholder 1"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
   - image_path: /assets/images/unsplash-gallery-image-2-th.jpg
+    image_caption: "Image courtesy of [Unsplash](https://unsplash.com/)"
     alt: "placeholder image 2"
     title: "Placeholder 2"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
diff --git a/docs/_pages/tag-archive.html b/docs/_pages/tag-archive.html
deleted file mode 100644
index b30a57f5ac5f..000000000000
--- a/docs/_pages/tag-archive.html
+++ /dev/null
@@ -1,16 +0,0 @@
----
-layout: archive
-permalink: /tags/
-title: "Posts by Tag"
-author_profile: true
----
-
-{% include group-by-array collection=site.posts field="tags" %}
-
-{% for tag in group_names %}
-  {% assign posts = group_items[forloop.index0] %}
-  
{{ tag }}

-  {% for post in posts %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
diff --git a/docs/_pages/tag-archive.md b/docs/_pages/tag-archive.md
new file mode 100644
index 000000000000..3f4e3f0df86c
--- /dev/null
+++ b/docs/_pages/tag-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Tag"
+permalink: /tags/
+layout: tags
+author_profile: true
+---
diff --git a/docs/_pages/year-archive.html b/docs/_pages/year-archive.html
deleted file mode 100644
index 13135a91ddab..000000000000
--- a/docs/_pages/year-archive.html
+++ /dev/null
@@ -1,14 +0,0 @@
----
-layout: archive
-permalink: /year-archive/
-title: "Posts by Year"
-author_profile: true
----
-
-{% assign postsByYear = site.posts | group_by_exp:"post", "post.date | date: '%Y'"  %}
-{% for year in postsByYear %}
-  
{{ year.name }}

-  {% for post in year.items %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
\ No newline at end of file
diff --git a/docs/_pages/year-archive.md b/docs/_pages/year-archive.md
new file mode 100644
index 000000000000..1021452ad951
--- /dev/null
+++ b/docs/_pages/year-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Year"
+permalink: /year-archive/
+layout: posts
+author_profile: true
+---
diff --git a/docs/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md b/docs/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
index cc4fd5e52ff7..a8dccf09c792 100644
--- a/docs/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
+++ b/docs/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
@@ -19,10 +19,10 @@ Nested and mixed lists are an interesting beast. It's a corner case to make sure
 
 1. ordered item
 2. ordered item 
-  * **unordered**
-  * **unordered** 
-    1. ordered item
-    2. ordered item
+   * **unordered**
+   * **unordered** 
+     1. ordered item
+     2. ordered item
 3. ordered item
 4. ordered item
 
@@ -30,10 +30,10 @@ Nested and mixed lists are an interesting beast. It's a corner case to make sure
 
 1. ordered item
 2. ordered item 
-  * **unordered**
-  * **unordered** 
-    * unordered item
-    * unordered item
+   * **unordered**
+   * **unordered** 
+     * unordered item
+     * unordered item
 3. ordered item
 4. ordered item
 
@@ -43,8 +43,8 @@ Nested and mixed lists are an interesting beast. It's a corner case to make sure
 * unordered item 
   1. ordered
   2. ordered 
-    * unordered item
-    * unordered item
+     * unordered item
+     * unordered item
 * unordered item
 * unordered item
 
@@ -57,4 +57,10 @@ Nested and mixed lists are an interesting beast. It's a corner case to make sure
     1. **ordered item**
     2. **ordered item**
 * unordered item
-* unordered item
\ No newline at end of file
+* unordered item
+
+### Task Lists
+
+- [x] Finish my changes
+- [ ] Push my commits to GitHub
+- [ ] Open a pull request
\ No newline at end of file
diff --git a/docs/_posts/2009-10-05-edge-case-multiline-excerpt.md b/docs/_posts/2009-10-05-edge-case-multiline-excerpt.md
new file mode 100644
index 000000000000..6acc568a0655
--- /dev/null
+++ b/docs/_posts/2009-10-05-edge-case-multiline-excerpt.md
@@ -0,0 +1,6 @@
+---
+title: "Edge Case: Post with multiline excerpt"
+---
+
+Et ex ullamco duis don't
+combine these words quis laborum sunt sint. Nisi et Lorem reprehenderit cupidatat. Aliqua fugiat aliquip officia culpa elit. Adipisicing do eu duis aute et aute amet anim ut cillum aliqua. Aliqua adipisicing occaecat et ullamco fugiat.
\ No newline at end of file
diff --git a/docs/_posts/2009-10-06-edge-case-broken-highlighting.md b/docs/_posts/2009-10-06-edge-case-broken-highlighting.md
new file mode 100644
index 000000000000..bdf5b0be2715
--- /dev/null
+++ b/docs/_posts/2009-10-06-edge-case-broken-highlighting.md
@@ -0,0 +1,48 @@
+---
+title: "Edge Case: Invalid syntax highlight languages"
+categories:
+  - Edge Case
+tags:
+  - content
+  - css
+  - edge case
+---
+
+Good highlighting:
+
+```ruby
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+```
+
+Good (but dumb) highlighting:
+
+```
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+```
+
+Bad highlighting:
+
+```invalid
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+```
diff --git a/docs/_posts/2010-02-05-post-notice.md b/docs/_posts/2010-02-05-post-notice.md
index 071c7892e6c4..da63f9a32152 100644
--- a/docs/_posts/2010-02-05-post-notice.md
+++ b/docs/_posts/2010-02-05-post-notice.md
@@ -17,6 +17,16 @@ When using Kramdown `{: .notice}` can be added after a sentence to assign the `.
 **Primary Notice:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. [Praesent libero](#). Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
 {: .notice--primary}
 
+

+**Primary Notice with code block:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. [Praesent libero](#). Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
+
+```html
+
+  Some body.
+
+```
+

+
 **Info Notice:** Lorem ipsum dolor sit amet, [consectetur adipiscing elit](#). Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
 {: .notice--info}
 
diff --git a/docs/_posts/2010-06-02-post-video-youtube.md b/docs/_posts/2010-06-02-post-video-youtube.md
index 16bc910c38da..686f622b9e70 100644
--- a/docs/_posts/2010-06-02-post-video-youtube.md
+++ b/docs/_posts/2010-06-02-post-video-youtube.md
@@ -8,4 +8,4 @@ tags:
 
 YouTube video embed below.
 
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/_posts/2010-08-05-post-header-overlay-image-og-override.md b/docs/_posts/2010-08-05-post-header-overlay-image-og-override.md
index 89656ccfa76e..e8501b7f53a7 100644
--- a/docs/_posts/2010-08-05-post-header-overlay-image-og-override.md
+++ b/docs/_posts/2010-08-05-post-header-overlay-image-og-override.md
@@ -4,7 +4,9 @@ header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   og_image: /assets/images/page-header-og-image.png
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Learn more"
+      url: "https://unsplash.com"
 categories:
   - Layout
   - Uncategorized
@@ -22,5 +24,7 @@ header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   og_image: /assets/images/page-header-og-image.png
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Learn more"
+      url: "https://unsplash.com"
 ```
\ No newline at end of file
diff --git a/docs/_posts/2010-08-05-post-image-linked.md b/docs/_posts/2010-08-05-post-image-linked.md
index af3f3fe9f779..a59cd117126e 100644
--- a/docs/_posts/2010-08-05-post-image-linked.md
+++ b/docs/_posts/2010-08-05-post-image-linked.md
@@ -7,4 +7,4 @@ tags:
   - Post Formats
 ---
 
-[![foo](https://farm5.staticflickr.com/4073/4939853213_33ffc0290b_b.jpg)](https://flic.kr/p/8ww3fZ)
\ No newline at end of file
+[![foo](https://live.staticflickr.com/8361/8400335147_5fabaa504c_o.jpg)](https://flic.kr/p/dNiUYB)
\ No newline at end of file
diff --git a/docs/_posts/2010-08-06-post-image-linked-caption.md b/docs/_posts/2010-08-06-post-image-linked-caption.md
index ada6f6a73ed6..67be312084cd 100644
--- a/docs/_posts/2010-08-06-post-image-linked-caption.md
+++ b/docs/_posts/2010-08-06-post-image-linked-caption.md
@@ -8,14 +8,14 @@ tags:
 ---
 
 {% capture fig_img %}
-[![Foo](https://farm5.staticflickr.com/4134/4940462712_7c28420b27_b.jpg)](https://flic.kr/p/8wzarA)
+[![Foo](https://images.unsplash.com/photo-1541943869728-4bd4f450c8f5?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=800&fit=max&ixid=eyJhcHBfaWQiOjF9)](https://unsplash.com/)
 {% endcapture %}
 
 {% capture fig_caption %}
-Stairs? Were we're going we don't need no stairs.
+Image with a caption.
 {% endcapture %}
 
 

   {{ fig_img | markdownify | remove: "
" | remove: "
" }}
   
{{ fig_caption | markdownify | remove: "
" | remove: "
" }}

-

\ No newline at end of file
+

diff --git a/docs/_posts/2010-08-07-post-image-caption.md b/docs/_posts/2010-08-07-post-image-caption.md
index 0f67dda1c593..7606e55e9bac 100644
--- a/docs/_posts/2010-08-07-post-image-caption.md
+++ b/docs/_posts/2010-08-07-post-image-caption.md
@@ -8,7 +8,7 @@ tags:
 ---
 
 {% capture fig_img %}
-![Foo]({{ "/assets/images/unsplash-gallery-image-3.jpg" | absolute_url }})
+![Foo]({{ "/assets/images/unsplash-gallery-image-3.jpg" | relative_url }})
 {% endcapture %}
 
 

diff --git a/docs/_posts/2010-09-09-post-gallery.md b/docs/_posts/2010-09-09-post-gallery.md
index f7a9e91ce9cb..3bdd4ff3f477 100644
--- a/docs/_posts/2010-09-09-post-gallery.md
+++ b/docs/_posts/2010-09-09-post-gallery.md
@@ -131,4 +131,12 @@ And place it like so:
 
 And for giggles one more gallery just to make sure this works. To fill page content container add `class="full"`.
 
-{% include gallery id="gallery3" class="full" caption="This is a third gallery example with two images and fills the entire content container." %}
\ No newline at end of file
+{% include gallery id="gallery3" class="full" caption="This is a third gallery example with two images and fills the entire content container." %}
+
+Gallery column layout can be overrided by setting a `layout`.
+
+```liquid
+{% raw %}{% include gallery id="gallery" layout="half" caption="This is a half gallery layout example." %}{% endraw %}
+```
+
+{% include gallery id="gallery" layout="half" caption="This is a half gallery layout example." %}
\ No newline at end of file
diff --git a/docs/_posts/2012-01-02-layout-comments.md b/docs/_posts/2012-01-02-layout-comments.md
index cf697b80a601..c138699cdabc 100644
--- a/docs/_posts/2012-01-02-layout-comments.md
+++ b/docs/_posts/2012-01-02-layout-comments.md
@@ -9,4 +9,4 @@ tags:
   - layout
 ---
 
-This post should display comments.
\ No newline at end of file
+This post should display comments if a `provider` is enabled.
\ No newline at end of file
diff --git a/docs/_posts/2012-01-02-layout-post-date-disabled.md b/docs/_posts/2012-01-02-layout-post-date-disabled.md
new file mode 100644
index 000000000000..a10a3e4648eb
--- /dev/null
+++ b/docs/_posts/2012-01-02-layout-post-date-disabled.md
@@ -0,0 +1,18 @@
+---
+title: "Layout: Post Date Disabled"
+show_date: false
+tags:
+  - post date
+---
+
+This post has the date disabled. The date this post was published should not be showing if `show_date: false` is set in `_config.yml` or in this post's YAML Front Matter.
+
+If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on.
+
+I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still.
+
+Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more.
+
+Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights.
+
+Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance.
\ No newline at end of file
diff --git a/docs/_posts/2012-01-02-layout-post-date.md b/docs/_posts/2012-01-02-layout-post-date.md
new file mode 100644
index 000000000000..b31c9a275b5c
--- /dev/null
+++ b/docs/_posts/2012-01-02-layout-post-date.md
@@ -0,0 +1,18 @@
+---
+title: "Layout: Post Date Enabled"
+show_date: true
+tags:
+  - post date
+---
+
+This post has post date enabled. The date the post was published should show if `show_date: true` is added to it's YAML Front Matter or as a default in `_config.yml`.
+
+If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on.
+
+I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still.
+
+Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more.
+
+Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights.
+
+Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance.
\ No newline at end of file
diff --git a/docs/_posts/2012-01-03-layout-table-of-contents-include-post.md b/docs/_posts/2012-01-03-layout-table-of-contents-include-post.md
new file mode 100644
index 000000000000..622b04da1d69
--- /dev/null
+++ b/docs/_posts/2012-01-03-layout-table-of-contents-include-post.md
@@ -0,0 +1,139 @@
+---
+title: "Layout: Post with Nested Table of Contents via Helper"
+tags:
+  - table of contents
+---
+
+Tests table of contents with multiple levels to verify indentation is readible via helper include (deprecated).
+
+```
+{% raw %}{% include toc %}{% endraw %}
+```
+
+{% include toc %}
+
+# Enim laboris id ea elit elit deserunt
+
+Magna incididunt elit id enim nisi quis excepteur reprehenderit Lorem dolore dolore ad enim. Labore esse elit excepteur et elit dolor. Elit ut consectetur labore velit elit esse voluptate id commodo. Magna cillum officia consequat non occaecat mollit esse nisi quis.
+
+Nostrud veniam excepteur commodo enim pariatur velit est. Dolor consequat elit occaecat enim veniam ullamco qui est anim ex elit. Est minim aute magna laborum reprehenderit magna reprehenderit ullamco voluptate id sit aliqua. Id labore veniam ad duis aliquip commodo qui ex ut ipsum irure. In et sit ea cupidatat consectetur in nisi amet in cupidatat excepteur commodo amet.
+
+## 2 Sit adipisicing tempor duis velit cupidatat occaecat do amet
+
+Ad non dolore irure in. In do ut nostrud reprehenderit consequat aliqua sunt culpa voluptate amet minim ea. Eu dolore deserunt consectetur eu in minim sit nulla id id est amet consectetur. Tempor dolore ipsum magna amet velit aliquip ea anim non eu Lorem deserunt. Irure excepteur id adipisicing elit dolor ipsum eiusmod non nulla nisi sint qui et. Occaecat pariatur tempor ex nisi pariatur.
+
+Proident culpa nostrud id est qui fugiat duis aute. Cillum commodo pariatur nostrud culpa Lorem exercitation non. Consequat elit deserunt dolore voluptate sunt labore minim ut consequat minim.
+
+Sunt pariatur in ex non nulla proident ex ullamco Lorem do ipsum. Cillum est mollit reprehenderit excepteur labore labore elit dolore adipisicing ad quis quis aliqua sunt. Proident amet est reprehenderit deserunt amet cupidatat incididunt irure est elit.
+
+### 2.1 Ex et quis exercitation fugiat excepteur eiusmod mollit consequat id pariatur non adipisicing magna tempor
+
+Nostrud sunt nostrud incididunt adipisicing officia esse minim irure duis dolore adipisicing cupidatat. Eu non labore veniam ad sunt pariatur qui. Irure reprehenderit qui elit duis cillum sit officia consectetur sint deserunt do aute velit. Do id occaecat magna occaecat reprehenderit veniam pariatur Lorem. Officia sit cupidatat adipisicing laborum.
+
+#### 2.1.1 Ut nostrud reprehenderit proident culpa enim irure cupidatat sunt ex ea minim nostrud
+
+Laborum laboris et ut proident sit qui pariatur nisi commodo. Deserunt eiusmod eiusmod elit anim exercitation quis. Anim laboris irure minim elit fugiat velit esse officia amet reprehenderit id. Dolor eiusmod incididunt excepteur sint aute qui esse nostrud. Nisi qui adipisicing consectetur enim pariatur sint veniam esse.
+
+#### 2.1.2 Nisi non nisi ullamco ipsum cillum
+Minim officia tempor eiusmod sint magna reprehenderit do amet ex velit. Irure nulla ut veniam eu veniam proident esse pariatur cillum. Esse anim et proident cillum esse magna sint.
+
+#### 2.1.3 Ut pariatur do do eiusmod consequat do pariatur nisi ex anim reprehenderit nostrud
+Reprehenderit consectetur tempor labore dolore ad. Ullamco qui sunt quis deserunt id ipsum sit qui nisi esse deserunt ad exercitation. Dolore qui in mollit ex qui minim et ipsum reprehenderit. Tempor magna ipsum proident voluptate mollit quis consectetur veniam non aliquip cupidatat nisi culpa aute.
+
+##### 2.1.1.1 Ut aute quis ipsum fugiat dolor
+Occaecat excepteur et ea et exercitation ad aute minim incididunt incididunt aute sint officia aliquip. Quis cupidatat nostrud dolor consequat laboris eu ullamco qui esse excepteur aute. Veniam ut ipsum aute Lorem proident minim ea fugiat Lorem cillum. Qui esse id minim consequat ullamco aliqua pariatur ea mollit. Minim ea ipsum laborum consequat esse mollit pariatur. Voluptate sit voluptate non ut consectetur irure laboris ex adipisicing dolore elit aliquip velit. In eu veniam voluptate incididunt aute eu reprehenderit ut id voluptate.
+
+##### 2.1.1.2 Consequat nostrud quis officia et aliquip quis magna mollit veniam
+Magna duis exercitation dolor amet. Ea irure laborum sit officia reprehenderit enim aute magna duis. Elit fugiat ut proident sit.
+
+###### 2.1.1.1.1 Id cillum proident labore occaecat reprehenderit excepteur fugiat est
+
+Irure qui veniam incididunt irure consequat mollit consectetur est nostrud deserunt eiusmod nostrud quis. Eiusmod id proident eu aute exercitation irure consectetur sit dolor dolor in esse. Qui eu dolor ea est magna amet laborum qui irure. Reprehenderit excepteur voluptate fugiat exercitation voluptate laboris nostrud qui magna et officia.
+
+###### 2.1.1.1.2 In consectetur ea qui quis culpa nulla
+
+Ad quis duis dolore voluptate laborum eiusmod consequat sint. Cupidatat officia ex laborum ad non mollit excepteur ea. Nostrud elit in consequat sunt adipisicing reprehenderit ipsum proident irure. Sint velit laborum sint laboris ea. Veniam occaecat et in Lorem proident minim deserunt labore laborum reprehenderit. Consequat laborum deserunt culpa consectetur. Incididunt reprehenderit amet esse duis dolore pariatur adipisicing quis elit.
+
+###### 2.1.1.1.3 Culpa magna pariatur magna officia adipisicing ex minim ea do est
+
+Dolore reprehenderit aute ex id. Ipsum laboris sit quis enim labore ut sint cillum exercitation. Commodo aliqua exercitation enim sunt velit do laborum mollit irure dolor.
+
+###### 2.1.1.1.4 Veniam ipsum non reprehenderit pariatur
+
+Laboris amet quis sunt id dolor consectetur Lorem id aliquip laboris fugiat. Non ex magna deserunt veniam eiusmod. Irure culpa culpa dolore pariatur. Elit enim deserunt ut amet adipisicing elit laborum exercitation cupidatat et. Aliqua aliqua laborum exercitation commodo reprehenderit reprehenderit amet laboris ea ea ex amet in. Aute minim voluptate et ipsum culpa consequat.
+
+##### 2.1.1.3 Ut qui labore officia ad laboris eu amet minim tempor qui cupidatat duis aute
+
+In in dolore laboris irure est consequat magna ea non aute cupidatat tempor. Officia sit pariatur consequat laborum aliqua nulla anim nisi aliquip reprehenderit consequat. Ad duis labore minim consequat reprehenderit labore ex minim cillum magna incididunt adipisicing dolor. Non velit mollit minim consectetur minim. Cillum elit et amet est reprehenderit non. Elit adipisicing nostrud ea veniam occaecat commodo deserunt.
+
+##### 2.1.1.4 Magna ipsum nisi velit anim
+
+Eiusmod tempor dolor proident pariatur consequat sit non nostrud. Eiusmod duis elit esse Lorem dolore et minim elit consectetur eu ullamco. Adipisicing sunt excepteur eu mollit in nostrud.
+
+###### 2.1.1.4.1 Mollit nulla est tempor fugiat occaecat nostrud
+
+Exercitation eu labore Lorem culpa id enim ut officia aute proident in est irure. Nostrud adipisicing magna elit tempor ipsum culpa in incididunt consectetur incididunt veniam aute tempor sint. Officia est consectetur sint sint nostrud proident mollit. Dolore duis proident mollit consectetur tempor.
+
+###### 2.1.1.2.1 Culpa aliquip irure et nostrud esse consequat fugiat dolor
+
+Ad ut commodo elit amet officia ipsum labore do amet. Eiusmod sint irure magna proident nisi adipisicing mollit excepteur mollit proident culpa duis. Est reprehenderit consequat eiusmod deserunt duis ipsum esse amet incididunt.
+
+#### 2.1.4 Laboris exercitation nisi tempor dolore
+
+Elit culpa est eiusmod nostrud occaecat. Labore incididunt nostrud consectetur sint. Ut pariatur laborum incididunt culpa proident incididunt veniam veniam laboris adipisicing mollit. Ullamco magna tempor fugiat veniam in ipsum nisi mollit labore amet et sit quis. In consectetur fugiat Lorem culpa veniam minim. Irure aliqua est mollit consectetur id Lorem velit minim sit velit. Eiusmod magna do dolor est id reprehenderit minim fugiat minim incididunt incididunt laboris velit consequat.
+
+### 2.2 Officia irure duis et est sunt
+
+Consequat anim quis non nulla. Eiusmod pariatur sunt non culpa culpa ipsum nulla anim in. Non ad exercitation ut reprehenderit ut dolor laborum tempor ad qui magna fugiat irure. Sint commodo ea sint sunt. Irure qui pariatur tempor veniam reprehenderit amet est. Amet laboris proident Lorem deserunt proident duis esse do sit eu dolor qui duis eu. Mollit laboris nisi aute nulla consectetur exercitation nulla aliqua anim.
+
+## 3 Laborum eu magna proident proident tempor
+
+Occaecat aliqua id voluptate mollit aliquip. Elit excepteur magna esse commodo pariatur reprehenderit in in quis. Id dolore proident proident mollit tempor duis magna ullamco nulla velit consequat. In ut est aliquip in commodo ullamco sit sint.
+
+### 3.1 Amet enim do laboris ipsum aliqua eiusmod non eu
+
+Laborum magna deserunt do anim quis proident adipisicing. Dolore qui ex minim reprehenderit. Consectetur in cillum ad dolore ut id deserunt irure aute sint magna dolore adipisicing.
+
+### 3.2 Do exercitation ex elit incididunt sit cupidatat
+
+Excepteur aliqua nisi ullamco sunt fugiat laborum elit aliquip officia culpa. Est exercitation enim laborum amet exercitation. Eu quis qui eiusmod incididunt id do aliquip nostrud do esse enim excepteur enim pariatur. Aute adipisicing velit non culpa quis exercitation. Quis cupidatat anim occaecat Lorem ad mollit aute eiusmod quis dolor duis. Proident anim et nostrud ut aliquip irure adipisicing reprehenderit proident dolore magna. Consequat eu fugiat esse proident duis eu proident fugiat laboris ea veniam nisi reprehenderit.
+
+### 3.3 Officia aliquip fugiat ex pariatur nisi et nostrud adipisicing eu minim laboris eiusmod ea sunt
+
+Consectetur irure elit nulla elit non officia. Culpa Lorem minim dolor laboris enim labore do minim laborum. Fugiat deserunt nisi ut do incididunt incididunt ea anim exercitation sit duis. Irure esse pariatur labore enim labore qui anim culpa laborum velit consequat. Culpa in adipisicing excepteur est ipsum. In reprehenderit eiusmod ad ad non.
+
+### 3.4 Ipsum velit laborum est nostrud qui enim ullamco velit dolor Lorem magna
+
+Nulla magna dolor minim commodo. Sunt nulla cupidatat consequat eiusmod elit irure eiusmod excepteur. Sit incididunt irure minim magna. Tempor ipsum exercitation minim sunt labore dolor ullamco veniam enim nisi veniam adipisicing occaecat proident.
+
+### 3.5 Officia fugiat fugiat voluptate ullamco eiusmod duis minim aliqua consequat consectetur qui do sunt fugiat
+
+Non aute culpa irure qui aute adipisicing aute id commodo id. Laborum ullamco laboris velit in quis duis ut consequat do minim. In minim amet ut reprehenderit et voluptate. In quis Lorem occaecat nostrud excepteur nostrud dolore in nulla ad Lorem nisi. Dolor exercitation Lorem qui sint aute ipsum officia eiusmod aliquip Lorem sit. Reprehenderit ex veniam excepteur laboris magna dolore fugiat sit exercitation esse et consequat in sit. Incididunt pariatur ad esse anim aute do id eu.
+
+#### 3.5.1 Mollit laborum ea aliquip mollit quis commodo fugiat tempor deserunt exercitation sint culpa ipsum tempor
+
+Est cillum laborum cupidatat ullamco cupidatat magna laborum enim duis consequat est eu. Magna cillum Lorem proident non ut officia. Esse irure et laboris eu occaecat aute.
+
+##### 3.5.1.1 Nisi anim commodo consequat quis amet
+
+Sunt eu dolor enim enim consectetur et anim irure dolor velit cillum. Esse reprehenderit cillum incididunt adipisicing amet nostrud adipisicing. Minim mollit nostrud ipsum ea ut sit ex elit. Do esse ad et ipsum nisi sint anim culpa excepteur ipsum. Commodo nisi irure qui reprehenderit incididunt.
+
+###### 3.5.1.1.1 Culpa nulla Lorem adipisicing ut sit cupidatat laborum laborum cupidatat proident
+
+Dolore dolor sit sunt anim eu amet consectetur quis ea proident ex aliqua. Sunt laborum consectetur consectetur enim velit eiusmod labore commodo commodo laboris deserunt. Eiusmod enim do amet laborum commodo qui.
+
+### 3.6 Reprehenderit culpa consectetur veniam minim cillum in nostrud
+
+Lorem dolore sit aliqua tempor do voluptate ut esse. Minim velit ad velit commodo minim laborum. Qui qui reprehenderit non proident ullamco veniam aliquip.
+
+## 4 Laboris aute consequat id eu et Lorem amet
+
+Ad qui voluptate dolor veniam. Veniam mollit aute eiusmod eu labore incididunt sint proident. Non minim consequat anim sint. Aliquip non nisi nostrud proident. Eiusmod ut duis commodo sunt laboris irure eu. Laboris quis amet ad qui officia.
+
+## 5 Esse eu consequat consequat aliqua fugiat nulla ad labore consectetur eu pariatur nisi aute
+
+Duis proident ullamco fugiat aliqua sunt anim ea do irure est amet quis nulla cillum. Commodo voluptate dolor culpa sint aliquip voluptate exercitation anim cillum ad eu in amet. Sint fugiat qui commodo quis ex eu commodo officia aliquip irure. Non dolore elit excepteur id laboris irure consequat magna consectetur. Qui proident deserunt culpa tempor sit aute velit proident cillum ea.
+
+## 6 Aliquip sunt laborum excepteur cupidatat officia ad tempor veniam esse amet ea commodo sunt
+
+Ex minim pariatur est nisi exercitation exercitation reprehenderit id aliqua deserunt est. Laborum ullamco do ipsum minim ipsum aliquip voluptate voluptate aliqua. Magna proident velit veniam et minim commodo officia officia mollit nisi. Excepteur occaecat deserunt irure adipisicing minim adipisicing cupidatat non anim exercitation ex. Amet quis sunt sint veniam non id nisi ipsum mollit voluptate quis tempor tempor.
diff --git a/docs/_posts/2012-01-03-layout-table-of-contents-indent-post.md b/docs/_posts/2012-01-03-layout-table-of-contents-indent-post.md
new file mode 100644
index 000000000000..e36f8104ccd4
--- /dev/null
+++ b/docs/_posts/2012-01-03-layout-table-of-contents-indent-post.md
@@ -0,0 +1,134 @@
+---
+title: "Layout: Post with Nested Table of Contents"
+tags:
+  - table of contents
+toc: true
+---
+
+Tests table of contents with multiple levels to verify indentation is readible.
+
+# Enim laboris id ea elit elit deserunt
+
+Magna incididunt elit id enim nisi quis excepteur reprehenderit Lorem dolore dolore ad enim. Labore esse elit excepteur et elit dolor. Elit ut consectetur labore velit elit esse voluptate id commodo. Magna cillum officia consequat non occaecat mollit esse nisi quis.
+
+Nostrud veniam excepteur commodo enim pariatur velit est. Dolor consequat elit occaecat enim veniam ullamco qui est anim ex elit. Est minim aute magna laborum reprehenderit magna reprehenderit ullamco voluptate id sit aliqua. Id labore veniam ad duis aliquip commodo qui ex ut ipsum irure. In et sit ea cupidatat consectetur in nisi amet in cupidatat excepteur commodo amet.
+
+## 2 Sit adipisicing tempor duis velit cupidatat occaecat do amet
+
+Ad non dolore irure in. In do ut nostrud reprehenderit consequat aliqua sunt culpa voluptate amet minim ea. Eu dolore deserunt consectetur eu in minim sit nulla id id est amet consectetur. Tempor dolore ipsum magna amet velit aliquip ea anim non eu Lorem deserunt. Irure excepteur id adipisicing elit dolor ipsum eiusmod non nulla nisi sint qui et. Occaecat pariatur tempor ex nisi pariatur.
+
+Proident culpa nostrud id est qui fugiat duis aute. Cillum commodo pariatur nostrud culpa Lorem exercitation non. Consequat elit deserunt dolore voluptate sunt labore minim ut consequat minim.
+
+Sunt pariatur in ex non nulla proident ex ullamco Lorem do ipsum. Cillum est mollit reprehenderit excepteur labore labore elit dolore adipisicing ad quis quis aliqua sunt. Proident amet est reprehenderit deserunt amet cupidatat incididunt irure est elit.
+
+### 2.1 Ex et quis exercitation fugiat excepteur eiusmod mollit consequat id pariatur non adipisicing magna tempor
+
+Nostrud sunt nostrud incididunt adipisicing officia esse minim irure duis dolore adipisicing cupidatat. Eu non labore veniam ad sunt pariatur qui. Irure reprehenderit qui elit duis cillum sit officia consectetur sint deserunt do aute velit. Do id occaecat magna occaecat reprehenderit veniam pariatur Lorem. Officia sit cupidatat adipisicing laborum.
+
+#### 2.1.1 Ut nostrud reprehenderit proident culpa enim irure cupidatat sunt ex ea minim nostrud
+
+Laborum laboris et ut proident sit qui pariatur nisi commodo. Deserunt eiusmod eiusmod elit anim exercitation quis. Anim laboris irure minim elit fugiat velit esse officia amet reprehenderit id. Dolor eiusmod incididunt excepteur sint aute qui esse nostrud. Nisi qui adipisicing consectetur enim pariatur sint veniam esse.
+
+#### 2.1.2 Nisi non nisi ullamco ipsum cillum
+Minim officia tempor eiusmod sint magna reprehenderit do amet ex velit. Irure nulla ut veniam eu veniam proident esse pariatur cillum. Esse anim et proident cillum esse magna sint.
+
+#### 2.1.3 Ut pariatur do do eiusmod consequat do pariatur nisi ex anim reprehenderit nostrud
+Reprehenderit consectetur tempor labore dolore ad. Ullamco qui sunt quis deserunt id ipsum sit qui nisi esse deserunt ad exercitation. Dolore qui in mollit ex qui minim et ipsum reprehenderit. Tempor magna ipsum proident voluptate mollit quis consectetur veniam non aliquip cupidatat nisi culpa aute.
+
+##### 2.1.1.1 Ut aute quis ipsum fugiat dolor
+Occaecat excepteur et ea et exercitation ad aute minim incididunt incididunt aute sint officia aliquip. Quis cupidatat nostrud dolor consequat laboris eu ullamco qui esse excepteur aute. Veniam ut ipsum aute Lorem proident minim ea fugiat Lorem cillum. Qui esse id minim consequat ullamco aliqua pariatur ea mollit. Minim ea ipsum laborum consequat esse mollit pariatur. Voluptate sit voluptate non ut consectetur irure laboris ex adipisicing dolore elit aliquip velit. In eu veniam voluptate incididunt aute eu reprehenderit ut id voluptate.
+
+##### 2.1.1.2 Consequat nostrud quis officia et aliquip quis magna mollit veniam
+Magna duis exercitation dolor amet. Ea irure laborum sit officia reprehenderit enim aute magna duis. Elit fugiat ut proident sit.
+
+###### 2.1.1.1.1 Id cillum proident labore occaecat reprehenderit excepteur fugiat est
+
+Irure qui veniam incididunt irure consequat mollit consectetur est nostrud deserunt eiusmod nostrud quis. Eiusmod id proident eu aute exercitation irure consectetur sit dolor dolor in esse. Qui eu dolor ea est magna amet laborum qui irure. Reprehenderit excepteur voluptate fugiat exercitation voluptate laboris nostrud qui magna et officia.
+
+###### 2.1.1.1.2 In consectetur ea qui quis culpa nulla
+
+Ad quis duis dolore voluptate laborum eiusmod consequat sint. Cupidatat officia ex laborum ad non mollit excepteur ea. Nostrud elit in consequat sunt adipisicing reprehenderit ipsum proident irure. Sint velit laborum sint laboris ea. Veniam occaecat et in Lorem proident minim deserunt labore laborum reprehenderit. Consequat laborum deserunt culpa consectetur. Incididunt reprehenderit amet esse duis dolore pariatur adipisicing quis elit.
+
+###### 2.1.1.1.3 Culpa magna pariatur magna officia adipisicing ex minim ea do est
+
+Dolore reprehenderit aute ex id. Ipsum laboris sit quis enim labore ut sint cillum exercitation. Commodo aliqua exercitation enim sunt velit do laborum mollit irure dolor.
+
+###### 2.1.1.1.4 Veniam ipsum non reprehenderit pariatur
+
+Laboris amet quis sunt id dolor consectetur Lorem id aliquip laboris fugiat. Non ex magna deserunt veniam eiusmod. Irure culpa culpa dolore pariatur. Elit enim deserunt ut amet adipisicing elit laborum exercitation cupidatat et. Aliqua aliqua laborum exercitation commodo reprehenderit reprehenderit amet laboris ea ea ex amet in. Aute minim voluptate et ipsum culpa consequat.
+
+##### 2.1.1.3 Ut qui labore officia ad laboris eu amet minim tempor qui cupidatat duis aute
+
+In in dolore laboris irure est consequat magna ea non aute cupidatat tempor. Officia sit pariatur consequat laborum aliqua nulla anim nisi aliquip reprehenderit consequat. Ad duis labore minim consequat reprehenderit labore ex minim cillum magna incididunt adipisicing dolor. Non velit mollit minim consectetur minim. Cillum elit et amet est reprehenderit non. Elit adipisicing nostrud ea veniam occaecat commodo deserunt.
+
+##### 2.1.1.4 Magna ipsum nisi velit anim
+
+Eiusmod tempor dolor proident pariatur consequat sit non nostrud. Eiusmod duis elit esse Lorem dolore et minim elit consectetur eu ullamco. Adipisicing sunt excepteur eu mollit in nostrud.
+
+###### 2.1.1.4.1 Mollit nulla est tempor fugiat occaecat nostrud
+
+Exercitation eu labore Lorem culpa id enim ut officia aute proident in est irure. Nostrud adipisicing magna elit tempor ipsum culpa in incididunt consectetur incididunt veniam aute tempor sint. Officia est consectetur sint sint nostrud proident mollit. Dolore duis proident mollit consectetur tempor.
+
+###### 2.1.1.2.1 Culpa aliquip irure et nostrud esse consequat fugiat dolor
+
+Ad ut commodo elit amet officia ipsum labore do amet. Eiusmod sint irure magna proident nisi adipisicing mollit excepteur mollit proident culpa duis. Est reprehenderit consequat eiusmod deserunt duis ipsum esse amet incididunt.
+
+#### 2.1.4 Laboris exercitation nisi tempor dolore
+
+Elit culpa est eiusmod nostrud occaecat. Labore incididunt nostrud consectetur sint. Ut pariatur laborum incididunt culpa proident incididunt veniam veniam laboris adipisicing mollit. Ullamco magna tempor fugiat veniam in ipsum nisi mollit labore amet et sit quis. In consectetur fugiat Lorem culpa veniam minim. Irure aliqua est mollit consectetur id Lorem velit minim sit velit. Eiusmod magna do dolor est id reprehenderit minim fugiat minim incididunt incididunt laboris velit consequat.
+
+### 2.2 Officia irure duis et est sunt
+
+Consequat anim quis non nulla. Eiusmod pariatur sunt non culpa culpa ipsum nulla anim in. Non ad exercitation ut reprehenderit ut dolor laborum tempor ad qui magna fugiat irure. Sint commodo ea sint sunt. Irure qui pariatur tempor veniam reprehenderit amet est. Amet laboris proident Lorem deserunt proident duis esse do sit eu dolor qui duis eu. Mollit laboris nisi aute nulla consectetur exercitation nulla aliqua anim.
+
+## 3 Laborum eu magna proident proident tempor
+
+Occaecat aliqua id voluptate mollit aliquip. Elit excepteur magna esse commodo pariatur reprehenderit in in quis. Id dolore proident proident mollit tempor duis magna ullamco nulla velit consequat. In ut est aliquip in commodo ullamco sit sint.
+
+### 3.1 Amet enim do laboris ipsum aliqua eiusmod non eu
+
+Laborum magna deserunt do anim quis proident adipisicing. Dolore qui ex minim reprehenderit. Consectetur in cillum ad dolore ut id deserunt irure aute sint magna dolore adipisicing.
+
+### 3.2 Do exercitation ex elit incididunt sit cupidatat
+
+Excepteur aliqua nisi ullamco sunt fugiat laborum elit aliquip officia culpa. Est exercitation enim laborum amet exercitation. Eu quis qui eiusmod incididunt id do aliquip nostrud do esse enim excepteur enim pariatur. Aute adipisicing velit non culpa quis exercitation. Quis cupidatat anim occaecat Lorem ad mollit aute eiusmod quis dolor duis. Proident anim et nostrud ut aliquip irure adipisicing reprehenderit proident dolore magna. Consequat eu fugiat esse proident duis eu proident fugiat laboris ea veniam nisi reprehenderit.
+
+### 3.3 Officia aliquip fugiat ex pariatur nisi et nostrud adipisicing eu minim laboris eiusmod ea sunt
+
+Consectetur irure elit nulla elit non officia. Culpa Lorem minim dolor laboris enim labore do minim laborum. Fugiat deserunt nisi ut do incididunt incididunt ea anim exercitation sit duis. Irure esse pariatur labore enim labore qui anim culpa laborum velit consequat. Culpa in adipisicing excepteur est ipsum. In reprehenderit eiusmod ad ad non.
+
+### 3.4 Ipsum velit laborum est nostrud qui enim ullamco velit dolor Lorem magna
+
+Nulla magna dolor minim commodo. Sunt nulla cupidatat consequat eiusmod elit irure eiusmod excepteur. Sit incididunt irure minim magna. Tempor ipsum exercitation minim sunt labore dolor ullamco veniam enim nisi veniam adipisicing occaecat proident.
+
+### 3.5 Officia fugiat fugiat voluptate ullamco eiusmod duis minim aliqua consequat consectetur qui do sunt fugiat
+
+Non aute culpa irure qui aute adipisicing aute id commodo id. Laborum ullamco laboris velit in quis duis ut consequat do minim. In minim amet ut reprehenderit et voluptate. In quis Lorem occaecat nostrud excepteur nostrud dolore in nulla ad Lorem nisi. Dolor exercitation Lorem qui sint aute ipsum officia eiusmod aliquip Lorem sit. Reprehenderit ex veniam excepteur laboris magna dolore fugiat sit exercitation esse et consequat in sit. Incididunt pariatur ad esse anim aute do id eu.
+
+#### 3.5.1 Mollit laborum ea aliquip mollit quis commodo fugiat tempor deserunt exercitation sint culpa ipsum tempor
+
+Est cillum laborum cupidatat ullamco cupidatat magna laborum enim duis consequat est eu. Magna cillum Lorem proident non ut officia. Esse irure et laboris eu occaecat aute.
+
+##### 3.5.1.1 Nisi anim commodo consequat quis amet
+
+Sunt eu dolor enim enim consectetur et anim irure dolor velit cillum. Esse reprehenderit cillum incididunt adipisicing amet nostrud adipisicing. Minim mollit nostrud ipsum ea ut sit ex elit. Do esse ad et ipsum nisi sint anim culpa excepteur ipsum. Commodo nisi irure qui reprehenderit incididunt.
+
+###### 3.5.1.1.1 Culpa nulla Lorem adipisicing ut sit cupidatat laborum laborum cupidatat proident
+
+Dolore dolor sit sunt anim eu amet consectetur quis ea proident ex aliqua. Sunt laborum consectetur consectetur enim velit eiusmod labore commodo commodo laboris deserunt. Eiusmod enim do amet laborum commodo qui.
+
+### 3.6 Reprehenderit culpa consectetur veniam minim cillum in nostrud
+
+Lorem dolore sit aliqua tempor do voluptate ut esse. Minim velit ad velit commodo minim laborum. Qui qui reprehenderit non proident ullamco veniam aliquip.
+
+## 4 Laboris aute consequat id eu et Lorem amet
+
+Ad qui voluptate dolor veniam. Veniam mollit aute eiusmod eu labore incididunt sint proident. Non minim consequat anim sint. Aliquip non nisi nostrud proident. Eiusmod ut duis commodo sunt laboris irure eu. Laboris quis amet ad qui officia.
+
+## 5 Esse eu consequat consequat aliqua fugiat nulla ad labore consectetur eu pariatur nisi aute
+
+Duis proident ullamco fugiat aliqua sunt anim ea do irure est amet quis nulla cillum. Commodo voluptate dolor culpa sint aliquip voluptate exercitation anim cillum ad eu in amet. Sint fugiat qui commodo quis ex eu commodo officia aliquip irure. Non dolore elit excepteur id laboris irure consequat magna consectetur. Qui proident deserunt culpa tempor sit aute velit proident cillum ea.
+
+## 6 Aliquip sunt laborum excepteur cupidatat officia ad tempor veniam esse amet ea commodo sunt
+
+Ex minim pariatur est nisi exercitation exercitation reprehenderit id aliqua deserunt est. Laborum ullamco do ipsum minim ipsum aliquip voluptate voluptate aliqua. Magna proident velit veniam et minim commodo officia officia mollit nisi. Excepteur occaecat deserunt irure adipisicing minim adipisicing cupidatat non anim exercitation ex. Amet quis sunt sint veniam non id nisi ipsum mollit voluptate quis tempor tempor.
diff --git a/docs/_posts/2012-01-03-layout-table-of-contents-post.md b/docs/_posts/2012-01-03-layout-table-of-contents-post.md
index c1253414da2d..01c14a2cf451 100644
--- a/docs/_posts/2012-01-03-layout-table-of-contents-post.md
+++ b/docs/_posts/2012-01-03-layout-table-of-contents-post.md
@@ -1,5 +1,5 @@
 ---
-title: "Layout: Post with Table Of Contents"
+title: "Layout: Post with Table of Contents"
 header:
   image: assets/images/unsplash-image-9.jpg
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
@@ -95,4 +95,4 @@ Make any link standout more when applying the `.btn` class.
 ## Notices
 
 **Watch out!** You can also add notices by appending `{: .notice}` to a paragraph.
-{: .notice}
+{: .notice}
\ No newline at end of file
diff --git a/docs/_posts/2012-01-03-layout-table-of-contents-sticky.md b/docs/_posts/2012-01-03-layout-table-of-contents-sticky.md
new file mode 100644
index 000000000000..a8eae408204d
--- /dev/null
+++ b/docs/_posts/2012-01-03-layout-table-of-contents-sticky.md
@@ -0,0 +1,93 @@
+---
+title: "Layout: Post with Sticky Table of Contents"
+tags:
+  - table of contents
+toc: true
+toc_sticky: true
+---
+
+"Stick" table of contents to the top of a page by adding `toc_sticky: true` to its YAML Front Matter.
+
+```yaml
+---
+toc: true
+toc_sticky: true
+---
+```
+
+## HTML Elements
+
+Below is just about everything you'll need to style in the theme. Check the source code to see the many embedded elements within paragraphs.
+
+## Body text
+
+Lorem ipsum dolor sit amet, test link adipiscing elit. **This is strong**. Nullam dignissim convallis est. Quisque aliquam.
+
+![Smithsonian Image]({{ site.url }}{{ site.baseurl }}/assets/images/3953273590_704e3899d5_m.jpg)
+{: .image-right}
+
+*This is emphasized*. Donec faucibus. Nunc iaculis suscipit dui. 53 = 125. Water is H2O. Nam sit amet sem. Aliquam libero nisi, imperdiet at, tincidunt nec, gravida vehicula, nisl. The New York Times (That’s a citation). Underline.Maecenas ornare tortor. Donec sed tellus eget sapien fringilla nonummy. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus.
+
+HTML and CSS are our tools. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus. Praesent mattis, massa quis luctus fermentum, turpis mi volutpat justo, eu volutpat enim diam eget metus.
+
+### Blockquotes
+
+> Lorem ipsum dolor sit amet, test link adipiscing elit. Nullam dignissim convallis est. Quisque aliquam.
+
+## List Types
+
+### Ordered Lists
+
+1. Item one
+   1. sub item one
+   2. sub item two
+   3. sub item three
+2. Item two
+
+### Unordered Lists
+
+* Item one
+* Item two
+* Item three
+
+## Tables
+
+| Header1 | Header2 | Header3 |
+|:--------|:-------:|--------:|
+| cell1   | cell2   | cell3   |
+| cell4   | cell5   | cell6   |
+|----
+| cell1   | cell2   | cell3   |
+| cell4   | cell5   | cell6   |
+|=====
+| Foot1   | Foot2   | Foot3
+{: rules="groups"}
+
+## Code Snippets
+
+```css
+#container {
+  float: left;
+  margin: 0 -240px 0 0;
+  width: 100%;
+}
+```
+
+## Buttons
+
+Make any link standout more when applying the `.btn` class.
+
+```html
+Success Button
+```
+
+
+
+
+
+
+
+## Notices
+
+**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph.
+{: .notice}
\ No newline at end of file
diff --git a/docs/_posts/2012-03-15-layout-author-override.md b/docs/_posts/2012-03-15-layout-author-override.md
index 50635b9d2c45..333fc161970d 100644
--- a/docs/_posts/2012-03-15-layout-author-override.md
+++ b/docs/_posts/2012-03-15-layout-author-override.md
@@ -2,31 +2,44 @@
 title: "Layout: Author Override"
 author: Billy Rick
 excerpt: "A post to test author overrides using a data file."
+last_modified_at: 2018-09-10T12:32:27-04:00
 ---
 
 Sites that may have content authored from various individuals can be accommodated by using [data files](https://jekyllrb.com/docs/datafiles/).
 
 To attribute 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. Anything variables found under `author` in `_config.yml` can be used (e.g. `name`, `avatar`, `uri`, social media profiles, etc.).
+**Step 1.** Create `_data/authors.yml` and add authors using the following format. Anything 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"
-  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"
-  twitter: "extravagantman"
+  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"
-  email: "cornelius@thewhip.com"
-  bio: "I ordered what?"
-  avatar: "/assets/images/bio-photo.jpg"
-  twitter: "rhymeswithsackit"
+  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. 
diff --git a/docs/_posts/2012-03-15-layout-header-image-external.md b/docs/_posts/2012-03-15-layout-header-image-external.md
index 8dd7a01ed303..1795bdcd13fa 100644
--- a/docs/_posts/2012-03-15-layout-header-image-external.md
+++ b/docs/_posts/2012-03-15-layout-header-image-external.md
@@ -1,7 +1,7 @@
 ---
 title: "Layout: Header Image (External URL)"
 header:
-  image: https://farm5.staticflickr.com/4140/4939863887_84705982fd_b.jpg
+  image: https://live.staticflickr.com/8084/8396909762_813a2b1829_h.jpg
 categories:
   - Layout
   - Uncategorized
diff --git a/docs/_posts/2012-03-15-layout-header-overlay-image-tagline.md b/docs/_posts/2012-03-15-layout-header-overlay-image-tagline.md
new file mode 100644
index 000000000000..32588bde9b53
--- /dev/null
+++ b/docs/_posts/2012-03-15-layout-header-overlay-image-tagline.md
@@ -0,0 +1,28 @@
+---
+title: "Layout: Header Image Overlay with Custom Tagline"
+tagline: "This is a custom tagline content which overrides the *default* page excerpt."
+header:
+  overlay_image: /assets/images/unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+categories:
+  - Layout
+  - Uncategorized
+tags:
+  - edge case
+  - image
+  - layout
+last_modified_at: 2020-01-07T13:05:25-05:00
+---
+
+This post should display a **header with an overlay image** and **custom tagline**, if the theme supports it.
+
+Non-square images can provide some unique styling issues.
+
+This post tests overlay header images with custom `page.tagline`.
+
+```yaml
+tagline: "This is a custom tagline content which overrides the default page excerpt."
+header:
+  overlay_image: /assets/images/unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+```
\ No newline at end of file
diff --git a/docs/_posts/2012-03-15-layout-header-overlay-image.md b/docs/_posts/2012-03-15-layout-header-overlay-image.md
index 11ecba0e80c3..e2b1a1965e1e 100644
--- a/docs/_posts/2012-03-15-layout-header-overlay-image.md
+++ b/docs/_posts/2012-03-15-layout-header-overlay-image.md
@@ -3,7 +3,9 @@ title: "Layout: Header Image Overlay"
 header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Learn more"
+      url: "https://unsplash.com"
 categories:
   - Layout
   - Uncategorized
@@ -11,7 +13,7 @@ tags:
   - edge case
   - image
   - layout
-last_modified_at: 2016-11-03T11:45:09-04:00
+last_modified_at: 2018-03-20T16:00:52-04:00
 ---
 
 This post should display a **header with an overlay image**, if the theme supports it.
@@ -24,7 +26,7 @@ This post tests overlay header images.
 
 You can use it by specifying the opacity (between 0 and 1) of a black overlay like so:
 
-![transparent black overlay]({{ "/assets/images/mm-header-overlay-black-filter.jpg" | absolute_url }})
+![transparent black overlay]({{ "/assets/images/mm-header-overlay-black-filter.jpg" | relative_url }})
 
 ```yaml
 excerpt: "This post should [...]"
@@ -32,13 +34,14 @@ 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)"
-  cta_label: "More Info"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "More Info"
+      url: "https://unsplash.com"
 ```
 
 Or if you want to do more fancy things, go full rgba:
 
-![transparent red overlay]({{ "/assets/images/mm-header-overlay-red-filter.jpg" | absolute_url }})
+![transparent red overlay]({{ "/assets/images/mm-header-overlay-red-filter.jpg" | relative_url }})
 
 ```yaml
 excerpt: "This post should [...]"
@@ -46,6 +49,7 @@ header:
   overlay_image: /assets/images/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"
+  actions:
+    - label: "More Info"
+      url: "https://unsplash.com"
 ```
\ No newline at end of file
diff --git a/docs/_posts/2012-03-15-layout-more-tag.md b/docs/_posts/2012-03-15-layout-more-tag.md
index 45940a6ed57b..c6cdc44fb7c1 100644
--- a/docs/_posts/2012-03-15-layout-more-tag.md
+++ b/docs/_posts/2012-03-15-layout-more-tag.md
@@ -1,5 +1,6 @@
 ---
 title: "Layout: More Tag"
+excerpt_separator: 
 categories:
   - Layout
   - Uncategorized
@@ -11,7 +12,7 @@ tags:
 
 This content is before the [excerpt separator tag](http://jekyllrb.com/docs/posts/#post-excerpts).
 
-Right after this sentence there should be a **continue reading** link of some sort in archive-index pages.
+Additional content before the more tag.
 
 
 
diff --git a/docs/_posts/2012-03-15-layout-sidebar-custom.md b/docs/_posts/2012-03-15-layout-sidebar-custom.md
index ee49173eba29..3b3739bc8ce6 100644
--- a/docs/_posts/2012-03-15-layout-sidebar-custom.md
+++ b/docs/_posts/2012-03-15-layout-sidebar-custom.md
@@ -1,14 +1,16 @@
 ---
 title: "Layout: Sidebar Custom"
 excerpt: "A post with custom sidebar content."
+last_modified_at: 2021-06-23T07:53:04-04:00
 author_profile: false
 sidebar:
   - title: "Title"
-    image: http://placehold.it/350x250
+    image: "/assets/images/350x250.png"
     image_alt: "image"
     text: "Some text here."
   - title: "Another Title"
     text: "More text here."
+    nav: sidebar-sample
 ---
 
 This post has a custom sidebar set in the post's YAML Front Matter.
@@ -18,9 +20,10 @@ An example of how that YAML could look is:
 ```yaml
 sidebar:
   - title: "Title"
-    image: http://placehold.it/350x250
+    image: "/assets/images/your-image.jpg"
     image_alt: "image"
     text: "Some text here."
   - title: "Another Title"
     text: "More text here."
+    nav: sidebar-sample
 ```
\ No newline at end of file
diff --git a/docs/_posts/2013-01-10-markup-image-alignment.md b/docs/_posts/2013-01-10-markup-image-alignment.md
index b92dab67b340..8c4a40e0a09b 100644
--- a/docs/_posts/2013-01-10-markup-image-alignment.md
+++ b/docs/_posts/2013-01-10-markup-image-alignment.md
@@ -19,7 +19,7 @@ The image above happens to be **centered**.
 
 ![image-left]({{ site.url }}{{ site.baseurl }}/assets/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**.
 
-As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished!
+As you can see there should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished!
 
 And now for a **massively large image**. It also has **no alignment**.
 
@@ -49,7 +49,7 @@ The figure above happens to be **centered**. The caption also has a link in it,
 
 The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**.
 
-As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished!
+As you can see there should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished!
 
 And now for a **massively large image**. It also has **no alignment**.
 
diff --git a/docs/_posts/2016-02-24-welcome-to-jekyll.md b/docs/_posts/2016-02-24-welcome-to-jekyll.md
index 521593642c60..024fc97dc96f 100644
--- a/docs/_posts/2016-02-24-welcome-to-jekyll.md
+++ b/docs/_posts/2016-02-24-welcome-to-jekyll.md
@@ -1,7 +1,7 @@
 ---
 title:  "Welcome to Jekyll!"
 header:
-  teaser: "https://farm5.staticflickr.com/4076/4940499208_b79b77fb0a_z.jpg"
+  teaser: "/assets/images/500x300.png"
 categories: 
   - Jekyll
 tags:
diff --git a/docs/_posts/2016-09-21-gemified-theme-alpha.md b/docs/_posts/2016-09-21-gemified-theme-alpha.md
index 42a3764eab3d..db2467980fac 100644
--- a/docs/_posts/2016-09-21-gemified-theme-alpha.md
+++ b/docs/_posts/2016-09-21-gemified-theme-alpha.md
@@ -1,6 +1,6 @@
 ---
 title:  "Gemified Theme -- Alpha Release"
-last_modified_at: 2017-10-20T12:29:34-04:00
+last_modified_at: 2018-03-20T16:00:58-04:00
 categories: 
   - Jekyll
 tags:
@@ -56,7 +56,6 @@ group :jekyll_plugins do
   gem "jekyll-sitemap"
   gem "jekyll-gist"
   gem "jekyll-feed"
-  gem "jemoji"
 end
 ```
 
@@ -68,17 +67,17 @@ Run `bundle install` (or `bundle update` if you're updating an existing repo) to
 
 Add `theme: "minimal-mistakes-jekyll"` to your `_config.yml` file.
 
-If you're migrating from an existing Minimal Mistakes site you shouldn't have to change anything else after this. If it's a new site consult then docs to [properly config]({{ "/docs/configuration/" | absolute_url }}).
+If you're migrating from an existing Minimal Mistakes site you shouldn't have to change anything else after this. If it's a new site consult then docs to [properly config]({{ "/docs/configuration/" | relative_url }}).
 
-**Please Note:** Paths for image headers, overlays, teasers, [galleries]({{ "/docs/helpers/#gallery" | absolute_url }}), and [feature rows]({{ "/docs/helpers/#feature-row" | absolute_url }}) have changed and now 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 applies for image references in `_config.yml` and `author.yml`.
+**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 now 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 applies for image references in `_config.yml` and `author.yml`.
 {: .notice--danger}
 
 ## Step 5: `jekyll new` Tweaks
 
 If this is a new site be sure to add the following files to `_data/` and customize as you see fit. There is currently no way of bundling them in with the theme, so be sure to consult the docs on how to properly use both.
 
-- [`_data/ui-text.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml) - UI text [documentation]({{ "/docs/ui-text/" | absolute_url }})
-- [`_data/navigation.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml) - navigation [documentation]({{ "/docs/navigation/" | absolute_url }})
+- [`_data/ui-text.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml) - UI text [documentation]({{ "/docs/ui-text/" | relative_url }})
+- [`_data/navigation.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml) - navigation [documentation]({{ "/docs/navigation/" | relative_url }})
 
 You'll also need to: 
 
diff --git a/docs/_posts/2016-10-06-gemified-theme-beta.md b/docs/_posts/2016-10-06-gemified-theme-beta.md
index ae6e88bfbe96..5889f3c629f5 100644
--- a/docs/_posts/2016-10-06-gemified-theme-beta.md
+++ b/docs/_posts/2016-10-06-gemified-theme-beta.md
@@ -1,6 +1,6 @@
 ---
 title:  "Gemified Theme -- Beta Release"
-last_modified_at: 2017-10-20T12:29:16-04:00
+last_modified_at: 2018-03-20T16:01:04-04:00
 categories: 
   - Jekyll
 tags:
@@ -52,17 +52,17 @@ Run `bundle install` (or `bundle update` if you're updating an existing repo) to
 
 Add `theme: "minimal-mistakes-jekyll"` to your `_config.yml` file.
 
-If you're migrating from an existing Minimal Mistakes site you shouldn't have to change anything else after this. If it's a new site consult then docs to [properly config]({{ "/docs/configuration/" | absolute_url }}).
+If you're migrating from an existing Minimal Mistakes site you shouldn't have to change anything else after this. If it's a new site consult then docs to [properly config]({{ "/docs/configuration/" | relative_url }}).
 
-**Please Note:** Paths for image headers, overlays, teasers, [galleries]({{ "/docs/helpers/#gallery" | absolute_url }}), and [feature rows]({{ "/docs/helpers/#feature-row" | absolute_url }}) have changed and now 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.
+**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 now 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}
 
 ## Step 5: `jekyll new` Tweaks
 
 If this is a new site be sure to add the following files to `_data/` and customize as you see fit. There is currently no way of bundling them in with the theme, so be sure to consult the docs on how to properly use both.
 
-- [`_data/ui-text.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml) - UI text [documentation]({{ "/docs/ui-text/" | absolute_url }})
-- [`_data/navigation.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml) - navigation [documentation]({{ "/docs/navigation/" | absolute_url }})
+- [`_data/ui-text.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml) - UI text [documentation]({{ "/docs/ui-text/" | relative_url }})
+- [`_data/navigation.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml) - navigation [documentation]({{ "/docs/navigation/" | relative_url }})
 
 You'll also need to: 
 
diff --git a/docs/_posts/2017-01-23-layout-header-video.md b/docs/_posts/2017-01-23-layout-header-video.md
index 5b45e6c3de71..f1aab7490ca8 100644
--- a/docs/_posts/2017-01-23-layout-header-video.md
+++ b/docs/_posts/2017-01-23-layout-header-video.md
@@ -2,7 +2,7 @@
 title: "Layout: Header Video"
 header:
   video:
-    id: XsxDH4HcOWA
+    id: -PVofD2A9t8
     provider: youtube
 categories:
   - Layout
@@ -23,20 +23,20 @@ This post should display a **header with a responsive video**, if the theme supp
 
 ### YouTube
 
-To embed the following YouTube video at url `https://www.youtube.com/watch?v=XsxDH4HcOWA` (long version) or `https://youtu.be/XsxDH4HcOWA` (short version) into a post or page's main content you'd use: 
+To embed the following YouTube video at url `https://www.youtube.com/watch?v=-PVofD2A9t8` (long version) or `https://youtu.be/-PVofD2A9t8` (short version) into a post or page's main content you'd use: 
 
 ```liquid
-{% raw %}{% include video id="XsxDH4HcOWA" provider="youtube" %}{% endraw %}
+{% raw %}{% include video id="-PVofD2A9t8" provider="youtube" %}{% endraw %}
 ```
 
-{% include video id="XsxDH4HcOWA" provider="youtube" %}
+{% include video id="-PVofD2A9t8" provider="youtube" %}
 
 To embed it as a video header you'd use the following YAML Front Matter
 
 ```yaml
 header:
   video:
-    id: XsxDH4HcOWA
+    id: -PVofD2A9t8
     provider: youtube
 ```
 
diff --git a/docs/_posts/2017-11-28-post-exclude-search.md b/docs/_posts/2017-11-28-post-exclude-search.md
index 742bcb231fdf..821e4edd1900 100644
--- a/docs/_posts/2017-11-28-post-exclude-search.md
+++ b/docs/_posts/2017-11-28-post-exclude-search.md
@@ -3,10 +3,27 @@ title:  "Exclude Post from Search Index"
 search: false
 categories: 
   - Jekyll
+last_modified_at: 2018-02-19T08:06:00-05:00
 ---
 
 This post should not appear in the search index because it has the following YAML Front Matter:
 
 ```yaml
 search: false
+```
+
+**Note:** `search: false` only works to exclude posts when using Lunr as a search provider.
+{: .notice--info}
+
+To exclude files when using Algolia as a search provider add an array to `algolia.files_to_exclude` in your `_config.yml`. For more configuration options be sure to check their [full documentation](https://community.algolia.com/jekyll-algolia/options.html).
+
+```yaml
+algolia:
+  # Exclude more files from indexing
+  files_to_exclude:
+    - index.html
+    - index.md
+    - excluded-file.html
+    - _posts/2017-11-28-post-exclude-search.md
+    - subdirectory/*.html
 ```
\ No newline at end of file
diff --git a/docs/assets/images/350x250.png b/docs/assets/images/350x250.png
new file mode 100644
index 000000000000..cb4d5edbe8e7
Binary files /dev/null and b/docs/assets/images/350x250.png differ
diff --git a/docs/assets/images/dracula-code-block.jpg b/docs/assets/images/dracula-code-block.jpg
new file mode 100644
index 000000000000..4d9e202ec9b7
Binary files /dev/null and b/docs/assets/images/dracula-code-block.jpg differ
diff --git a/docs/assets/images/google-custom-search-engine-layout.png b/docs/assets/images/google-custom-search-engine-layout.png
new file mode 100644
index 000000000000..362cd8e72d3f
Binary files /dev/null and b/docs/assets/images/google-custom-search-engine-layout.png differ
diff --git a/docs/assets/images/mm-header-overlay-custom-filter.jpg b/docs/assets/images/mm-header-overlay-custom-filter.jpg
new file mode 100644
index 000000000000..7f0cff974496
Binary files /dev/null and b/docs/assets/images/mm-header-overlay-custom-filter.jpg differ
diff --git a/docs/assets/images/mm-masthead-logo.png b/docs/assets/images/mm-masthead-logo.png
new file mode 100644
index 000000000000..65daae9fdb94
Binary files /dev/null and b/docs/assets/images/mm-masthead-logo.png differ
diff --git a/docs/assets/images/mm-post-date-example.png b/docs/assets/images/mm-post-date-example.png
new file mode 100644
index 000000000000..a209b97dc1c0
Binary files /dev/null and b/docs/assets/images/mm-post-date-example.png differ
diff --git a/minimal-mistakes-jekyll.gemspec b/minimal-mistakes-jekyll.gemspec
index 83d2db66664f..e6f14e845094 100644
--- a/minimal-mistakes-jekyll.gemspec
+++ b/minimal-mistakes-jekyll.gemspec
@@ -1,9 +1,11 @@
-# coding: utf-8
+require "json"
+
+package_json = JSON.parse(File.read("package.json"))
 
 Gem::Specification.new do |spec|
   spec.name                    = "minimal-mistakes-jekyll"
-  spec.version                 = "4.10.0"
-  spec.authors                 = ["Michael Rose"]
+  spec.version                 = package_json["version"]
+  spec.authors                 = ["Michael Rose", "iBug"]
 
   spec.summary                 = %q{A flexible two-column Jekyll theme.}
   spec.homepage                = "https://github.com/mmistakes/minimal-mistakes"
@@ -15,14 +17,13 @@ Gem::Specification.new do |spec|
     f.match(%r{^(assets|_(data|includes|layouts|sass)/|(LICENSE|README|CHANGELOG)((\.(txt|md|markdown)|$)))}i)
   end
 
-  spec.add_runtime_dependency "jekyll", "~> 3.6"
+  spec.add_runtime_dependency "jekyll", ">= 3.7", "< 5.0"
   spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
-  spec.add_runtime_dependency "jekyll-sitemap", "~> 1.1"
-  spec.add_runtime_dependency "jekyll-gist", "~> 1.4"
-  spec.add_runtime_dependency "jekyll-feed", "~> 0.9.2"
-  spec.add_runtime_dependency "jekyll-data", "~> 1.0"
-  spec.add_runtime_dependency "jemoji", "~> 0.8"
+  spec.add_runtime_dependency "jekyll-sitemap", "~> 1.3"
+  spec.add_runtime_dependency "jekyll-gist", "~> 1.5"
+  spec.add_runtime_dependency "jekyll-feed", "~> 0.1"
+  spec.add_runtime_dependency "jekyll-include-cache", "~> 0.1"
 
-  spec.add_development_dependency "bundler", "~> 1.12"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake", ">= 12.3.3"
 end
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 000000000000..845c4ccc0501
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,31 @@
+{
+  "name": "minimal-mistakes",
+  "version": "4.27.2",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "minimal-mistakes",
+      "version": "4.27.2",
+      "license": "MIT",
+      "devDependencies": {
+        "uglify-js": "^3.17.4"
+      },
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/uglify-js": {
+      "version": "3.17.4",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.17.4.tgz",
+      "integrity": "sha512-T9q82TJI9e/C1TAxYvfb16xO120tMVFZrGA3f9/P4424DNu6ypK103y0GPFVa17yotwSyZW5iYXgjYHkGrJW/g==",
+      "dev": true,
+      "bin": {
+        "uglifyjs": "bin/uglifyjs"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
index 10a7b912f005..6b37ff2dd6b0 100644
--- a/package.json
+++ b/package.json
@@ -1,12 +1,17 @@
 {
   "name": "minimal-mistakes",
-  "version": "4.10.0",
-  "description": "Minimal Mistakes Jekyll theme npm build scripts",
+  "private": true,
+  "version": "4.27.3",
+  "description": "Minimal Mistakes 2 column Jekyll theme.",
   "repository": {
     "type": "git",
-    "url": "git://github.com/mmistakes/minimal-mistakes.git"
+    "url": "https://github.com/mmistakes/minimal-mistakes.git"
   },
-  "keywords": ["jekyll", "theme", "minimal"],
+  "keywords": [
+    "jekyll",
+    "theme",
+    "minimal"
+  ],
   "author": "Michael Rose",
   "license": "MIT",
   "bugs": {
@@ -17,16 +22,6 @@
     "node": ">= 0.10.0"
   },
   "devDependencies": {
-    "npm-run-all": "^1.7.0",
-    "onchange": "^2.2.0",
-    "uglify-js": "^2.6.1"
-  },
-  "scripts": {
-    "uglify":
-      "uglifyjs assets/js/vendor/jquery/jquery-3.3.1.min.js assets/js/plugins/jquery.fitvids.js assets/js/plugins/jquery.greedy-navigation.js assets/js/plugins/jquery.magnific-popup.js assets/js/plugins/jquery.smooth-scroll.min.js assets/js/_main.js -c -m -o assets/js/main.min.js",
-    "add-banner": "node banner.js",
-    "watch:js":
-      "onchange \"assets/js/**/*.js\" -e \"assets/js/main.min.js\" -- npm run build:js",
-    "build:js": "npm run uglify && npm run add-banner"
+    "uglify-js": "^3.17.4"
   }
 }
diff --git a/staticman.yml b/staticman.yml
index c8e0ec5c2583..61b95925167f 100644
--- a/staticman.yml
+++ b/staticman.yml
@@ -3,7 +3,7 @@
 # For example, you can have one property to handle comment submission and
 # another one to handle posts.
 # To encrypt strings use the following endpoint:
-# https://api.staticman.net/v2/encrypt/{TEXT TO BE ENCRYPTED}
+# https://{your Staticman API URL}/v[2|3]/encrypt/{TEXT TO BE ENCRYPTED}
 
 comments:
   # (*) REQUIRED
@@ -25,7 +25,7 @@ comments:
   # request.
   branch: "master"
 
-  commitMessage: "New comment"
+  commitMessage: "New comment by {fields.name}"
 
   # (*) REQUIRED
   #
@@ -83,7 +83,7 @@ comments:
   # (*) REQUIRED
   #
   # Destination path (directory) for the data files. Accepts placeholders.
-  path: "docs/_data/comments/{options.slug}" # "/_data/comments/{options.slug}" (default)
+  path: "docs/_data/comments/{options.slug}" # "_data/comments/{options.slug}" (default)
 
   # Names of required files. If any of these isn't in the request or is empty,
   # an error will be thrown.
diff --git a/test/Gemfile b/test/Gemfile
index 8c142a8aad4b..635ea6c0f660 100644
--- a/test/Gemfile
+++ b/test/Gemfile
@@ -2,9 +2,9 @@ source "https://rubygems.org"
 
 # use local theme gem for testing
 gem "minimal-mistakes-jekyll", path: "../"
-
 group :jekyll_plugins do
   gem 'jekyll-algolia', '~> 1.0'
 end
 
-gem "wdm", "~> 0.1.0" if Gem.win_platform?
\ No newline at end of file
+gem "wdm", "~> 0.1.0" if Gem.win_platform?
+gem "webrick"
\ No newline at end of file
diff --git a/test/_config.yml b/test/_config.yml
index 66b902ea4be7..14b39288f6f2 100644
--- a/test/_config.yml
+++ b/test/_config.yml
@@ -10,18 +10,21 @@ minimal_mistakes_skin    : "default" # "air", "aqua", "contrast", "dark", "dirt"
 
 # Site Settings
 locale                   : "en-US"
-title                    : "Minimal Mistakes Development Test Site"
+title                    : "Minimal Mistakes"
 title_separator          : "-"
+subtitle                 : "Development Test Site"
 name                     : "Your Name"
 description              : "Minimal Mistakes theme test."
 url                      : # the base hostname & protocol for your site e.g. "https://mmistakes.github.io"
 baseurl                  : "/test"
 repository               : # GitHub username/repo-name e.g. "mmistakes/minimal-mistakes"
 teaser                   : # path of fallback teaser image, e.g. "/assets/images/500x300.png"
+logo                     : "/assets/images/apple-touch-icon.png" # path of logo image to display in the masthead, e.g. "/assets/images/88x88.png"
+masthead_title           : "Custom Title" # overrides the website title displayed in the masthead, use " " for no title
 # breadcrumbs            : false # true, false (default)
 words_per_minute         : 200
 comments:
-  provider               : # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman", "custom"
+  provider               : # false (default), "disqus", "discourse", "facebook", "staticman", "utterances", "giscus", "custom"
   disqus:
     shortname            : # https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname-
   discourse:
@@ -31,27 +34,26 @@ comments:
     appid                :
     num_posts            : # 5 (default)
     colorscheme          : # "light" (default), "dark"
-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"
+  utterances:
+    theme                : # "github-light" (default), "github-dark"
+    issue_term           : # "pathname" (default)
+  giscus:
+    repo_id              : # Shown during giscus setup at https://giscus.app
+    category_name        : # Full text name of the category
+    category_id          : # Shown during giscus setup at https://giscus.app
+    discussion_term      : # "pathname" (default), "url", "title", "og:title"
+    reactions_enabled    : # '1' for enabled (default), '0' for disabled
+    theme                : # "light" (default), "dark", "dark_dimmed", "transparent_dark", "preferred_color_scheme"
+  staticman:
+    branch               : # "master"
+    endpoint             : # "https://{your Staticman v3 API}/v3/entry/github/"
 atom_feed:
   path                   : # blank (default) uses feed.xml
 search                   : true # true, false (default)
 search_full_content      : true # true, false (default)
-search_provider          : "algolia"
+search_provider          : "lunr"
+lunr:
+  search_within_pages    : true
 algolia:
   application_id         : "QB6HVGBSBA"
   index_name             : "dev_minimal-mistakes"
@@ -77,10 +79,12 @@ 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/
+    - https://github.com/
 
 # Analytics
 analytics:
-  provider               : false # false (default), "google", "google-universal", "custom"
+  provider               : false # false (default), "google", "google-universal", "google-gtag", "custom"
   google:
     tracking_id          :
 
@@ -89,33 +93,36 @@ analytics:
 author:
   name             : "Your Name"
   avatar           : "/assets/images/bio-photo.jpg"
-  bio              : "I am an amazing person."
+  bio              : "I am an **amazing** person."
   location         : "Somewhere"
-  email            :
-  uri              :
-  home             : # null (default), "absolute or relative url to link to author home"
-  bitbucket        :
-  codepen          :
-  dribbble         :
-  flickr           :
-  facebook         :
-  foursquare       :
-  github           :
-  google_plus      :
-  keybase          :
-  instagram        :
-  lastfm           :
-  linkedin         :
-  pinterest        :
-  soundcloud       :
-  stackoverflow    : # "123456/username" (the last part of your profile url, e.g. http://stackoverflow.com/users/123456/username)
-  steam            :
-  tumblr           :
-  twitter          : "mmistakes"
-  vine             :
-  weibo            :
-  xing             :
-  youtube          : # "https://youtube.com/c/MichaelRoseDesign"
+  links:
+    - label: "Your Website"
+      icon: "fas fa-fw fa-link"
+      url: "https://your-site.com"
+    - label: "Twitter"
+      icon: "fab fa-fw fa-twitter-square"
+      url: "https://twitter.com/"
+    - label: "GitHub"
+      icon: "fab fa-fw fa-github"
+      url: "https://github.com/"
+    - label: "Instagram"
+      icon: "fab fa-fw fa-instagram"
+      url: "https://instagram.com/"
+
+
+# Site Footer
+footer:
+  links:
+    - label: "Twitter"
+      icon: "fab fa-fw fa-twitter-square"
+      url: "https://twitter.com/"
+    - label: "GitHub"
+      icon: "fab fa-fw fa-github"
+      url: "https://github.com/"
+    - label: "Instagram"
+      icon: "fab fa-fw fa-instagram"
+      url: "https://instagram.com/"
+  since: "2013"
 
 
 # Reading Files
@@ -196,7 +203,7 @@ plugins:
   - jekyll-sitemap
   - jekyll-gist
   - jekyll-feed
-  - jemoji
+  - jekyll-include-cache
 
 # mimic GitHub Pages with --safe
 whitelist:
@@ -204,7 +211,7 @@ whitelist:
   - jekyll-sitemap
   - jekyll-gist
   - jekyll-feed
-  - jemoji
+  - jekyll-include-cache
 
 
 # Archives
@@ -215,8 +222,8 @@ whitelist:
 #  - Archive page should exist at path when using Liquid method or you can
 #    expect broken links (especially with breadcrumbs enabled)
 #  - /tags/my-awesome-tag/index.html ~> path: /tags/
-#  -  path: /categories/
-#  -  path: /
+#  - /categories/my-awesome-category/index.html ~> path: /categories/
+#  - /my-awesome-category/index.html ~> path: /
 category_archive:
   type: liquid
   path: /categories/
diff --git a/test/_data/authors.yml b/test/_data/authors.yml
index d1ba8c629723..256ee1fe1812 100644
--- a/test/_data/authors.yml
+++ b/test/_data/authors.yml
@@ -2,17 +2,27 @@
 
 Billy Rick:
   name        : "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"
-  twitter     : "extravagantman"
-  google_plus : "BillyRick"
+  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"
-  email       : "cornelius@thewhip.com"
   bio         : "I ordered what?"
   avatar      : "/assets/images/bio-photo.jpg"
-  twitter     : "rhymeswithsackit"
-  google_plus : "CorneliusFiddlebone"
\ No newline at end of file
+  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"
\ No newline at end of file
diff --git a/test/_data/navigation.yml b/test/_data/navigation.yml
index 97fe339e8502..8adf5972eefb 100644
--- a/test/_data/navigation.yml
+++ b/test/_data/navigation.yml
@@ -8,46 +8,54 @@ main:
     url: /collection-archive/
   - title: "Sitemap"
     url: /sitemap/
+  - title: "Extra Menu Item 1"
+    url: /
+  - title: "Extra Menu Item 2"
+    url: /
+  - title: "Extra Menu Item Long Title"
+    url: /
 
 # sidebar navigation list sample
 sidebar-sample:
   - title: "Parent Page A"
     children:
       - title: "Child Page A1"
-        url: /
+        url: /child-page-a1/
       - title: "Child Page A2"
-        url: /
+        url: /child-page-a2/
       - title: "Child Page A3"
-        url: /
+        url: /child-page-a3/
       - title: "Child Page A4"
-        url: /
+        url: /child-page-a4/
   - title: "Parent Page B"
     children:
       - title: "Child Page B1"
-        url: /
+        url: /child-page-b1/
       - title: "Child Page B2"
-        url: /
+        url: /child-page-b2/
       - title: "Child Page B3"
-        url: /
+        url: /child-page-b3/
       - title: "Child Page B4"
-        url: /
+        url: /child-page-b4/
       - title: "Child Page B5"
-        url: /
+        url: /child-page-b5/
   - title: "Parent Page C"
     children:
       - title: "Child Page C1"
-        url: /
+        url: /child-page-c1/
       - title: "Child Page C2"
-        url: /
+        url: /child-page-c2/
       - title: "Child Page C3"
-        url: /
+        url: /child-page-c3/
       - title: "Child Page C4"
-        url: /
+        url: /child-page-c4/
       - title: "Child Page C5"
-        url: /
+        url: /child-page-c5/
   - title: "Parent Page D"
     children:
       - title: "Child Page D1"
-        url: /
+        url: /child-page-d1/
       - title: "Child Page D2"
-        url: /
\ No newline at end of file
+        url: /child-page-d2/
+      - title: "Child Page D3 (External)"
+        url: https://your-domain.com
\ No newline at end of file
diff --git a/test/_pages/404.md b/test/_pages/404.md
index 9d0f86066123..b3025a6053b5 100644
--- a/test/_pages/404.md
+++ b/test/_pages/404.md
@@ -5,12 +5,4 @@ sitemap: false
 permalink: /404.html
 ---
 
-Sorry, but the page you were trying to view does not exist --- perhaps you can try searching for it below.
-
-
-
+Sorry, but the page you were trying to view does not exist.
diff --git a/test/_pages/archive-layout-with-content.md b/test/_pages/archive-layout-with-content.md
index 4b6c010f88f5..1616b07b04e2 100644
--- a/test/_pages/archive-layout-with-content.md
+++ b/test/_pages/archive-layout-with-content.md
@@ -211,9 +211,4 @@ Still sticking with science and Albert Einstein's E = MC2, which shou
 
 ### Variable Tag
 
-This allows you to denote variables.
-
-{% include base_path %}
-{% for post in site.pages %}
-{% include archive-single.html %}
-{% endfor %}
\ No newline at end of file
+This allows you to denote variables.
\ No newline at end of file
diff --git a/test/_pages/category-archive-grid.md b/test/_pages/category-archive-grid.md
new file mode 100644
index 000000000000..3558be0a0db9
--- /dev/null
+++ b/test/_pages/category-archive-grid.md
@@ -0,0 +1,7 @@
+---
+title: "Posts by Category (grid view)"
+layout: categories
+permalink: /categories-grid/
+entries_layout: grid
+author_profile: true
+---
diff --git a/test/_pages/category-archive.html b/test/_pages/category-archive.html
deleted file mode 100644
index c9e03e1563a4..000000000000
--- a/test/_pages/category-archive.html
+++ /dev/null
@@ -1,16 +0,0 @@
----
-layout: archive
-permalink: /categories/
-title: "Posts by Category"
-author_profile: true
----
-
-{% include group-by-array collection=site.posts field="categories" %}
-
-{% for category in group_names %}
-  {% assign posts = group_items[forloop.index0] %}
-  
{{ category }}

-  {% for post in posts %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
\ No newline at end of file
diff --git a/test/_pages/category-archive.md b/test/_pages/category-archive.md
new file mode 100644
index 000000000000..4cb3860e91be
--- /dev/null
+++ b/test/_pages/category-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Category"
+layout: categories
+permalink: /categories/
+author_profile: true
+---
diff --git a/test/_pages/collection-archive-grid.html b/test/_pages/collection-archive-grid.html
new file mode 100644
index 000000000000..3280bf7bdf79
--- /dev/null
+++ b/test/_pages/collection-archive-grid.html
@@ -0,0 +1,28 @@
+---
+layout: archive
+title: "Posts by Collection (grid view)"
+permalink: /collection-archive-grid/
+entries_layout: grid
+author_profile: true
+---
+
+{% assign entries_layout = page.entries_layout | default: 'list' %}
+{% capture written_label %}'None'{% endcapture %}
+
+{% for collection in site.collections %}
+  {% unless collection.output == false or collection.label == "posts" %}
+    

+      {% capture label %}{{ collection.label }}{% endcapture %}
+      {% if label != written_label %}
+        
{{ label }}

+        {% capture written_label %}{{ label }}{% endcapture %}
+      {% endif %}
+      

+        {% for post in collection.docs %}
+          {% include archive-single.html type=entries_layout %}
+        {% endfor %}
+      

+      {{ site.data.ui-text[site.locale].back_to_top | default: 'Back to Top' }} ↑
+    

+  {% endunless %}
+{% endfor %}
diff --git a/test/_pages/collection-archive.html b/test/_pages/collection-archive.html
index 80d281642917..219592b6d8e9 100644
--- a/test/_pages/collection-archive.html
+++ b/test/_pages/collection-archive.html
@@ -17,7 +17,7 @@ 
{{ label }}

   {% endunless %}
   {% for post in collection.docs %}
     {% unless collection.output == false or collection.label == "posts" %}
-      {% include archive-single.html %}
+      {% include archive-single.html type=page.entries_layout %}
     {% endunless %}
   {% endfor %}
-{% endfor %}
\ No newline at end of file
+{% endfor %}
diff --git a/test/_pages/edge-case-grid.md b/test/_pages/edge-case-grid.md
new file mode 100644
index 000000000000..c2f73e5a2a93
--- /dev/null
+++ b/test/_pages/edge-case-grid.md
@@ -0,0 +1,9 @@
+---
+title: Edge Case (grid view)
+layout: category
+permalink: /categories/edge-case-grid/
+taxonomy: Edge Case
+entries_layout: grid
+---
+
+Sample post listing for the category `Edge Case`.
diff --git a/test/_pages/edge-case.md b/test/_pages/edge-case.md
new file mode 100644
index 000000000000..016138a4675a
--- /dev/null
+++ b/test/_pages/edge-case.md
@@ -0,0 +1,8 @@
+---
+title: Edge Case
+layout: category
+permalink: /categories/edge-case/
+taxonomy: Edge Case
+---
+
+Sample post listing for the category `Edge Case`.
diff --git a/test/_pages/markup-grid.md b/test/_pages/markup-grid.md
new file mode 100644
index 000000000000..7ebf0badbdd7
--- /dev/null
+++ b/test/_pages/markup-grid.md
@@ -0,0 +1,9 @@
+---
+title: Markup (grid view)
+layout: tag
+permalink: /tags/markup-grid/
+taxonomy: markup
+entries_layout: grid
+---
+
+Sample post listing for the tag `markup`.
diff --git a/test/_pages/markup.md b/test/_pages/markup.md
new file mode 100644
index 000000000000..147a719ae258
--- /dev/null
+++ b/test/_pages/markup.md
@@ -0,0 +1,8 @@
+---
+title: Markup
+layout: tag
+permalink: /tags/markup/
+taxonomy: markup
+---
+
+Sample post listing for the tag `markup`.
diff --git a/test/_pages/page-archive-grid.html b/test/_pages/page-archive-grid.html
new file mode 100644
index 000000000000..269dc2a16403
--- /dev/null
+++ b/test/_pages/page-archive-grid.html
@@ -0,0 +1,16 @@
+---
+layout: archive
+title: "Page Archive"
+permalink: /page-archive-grid/
+entries_layout: grid
+author_profile: false
+---
+
+{% assign entries_layout = page.entries_layout | default: 'list' %}
+

+  

+    {% for post in site.pages %}
+      {% include archive-single.html type=entries_layout %}
+    {% endfor %}
+  

+

diff --git a/test/_pages/page-archive.html b/test/_pages/page-archive.html
index a4e515abc721..ce11172ed489 100644
--- a/test/_pages/page-archive.html
+++ b/test/_pages/page-archive.html
@@ -7,4 +7,4 @@
 
 {% for post in site.pages %}
   {% include archive-single.html %}
-{% endfor %}
\ No newline at end of file
+{% endfor %}
diff --git a/test/_pages/portfolio-archive.html b/test/_pages/portfolio-archive.html
deleted file mode 100644
index f206c570ebc4..000000000000
--- a/test/_pages/portfolio-archive.html
+++ /dev/null
@@ -1,12 +0,0 @@
----
-layout: archive
-title: "Portfolio"
-permalink: /portfolio/
-author_profile: false
----
-
-

-  {% for post in site.portfolio %}
-    {% include archive-single.html type="grid" %}
-  {% endfor %}
-

\ No newline at end of file
diff --git a/test/_pages/portfolio-archive.md b/test/_pages/portfolio-archive.md
new file mode 100644
index 000000000000..019082f49185
--- /dev/null
+++ b/test/_pages/portfolio-archive.md
@@ -0,0 +1,10 @@
+---
+title: Portfolio
+layout: collection
+permalink: /portfolio/
+collection: portfolio
+entries_layout: grid
+classes: wide
+---
+
+Sample document listing for the collection `_portfolio`.
diff --git a/test/_pages/recipes-archive.html b/test/_pages/recipes-archive.html
deleted file mode 100644
index b5e2dfc246a9..000000000000
--- a/test/_pages/recipes-archive.html
+++ /dev/null
@@ -1,10 +0,0 @@
----
-layout: archive
-title: "Recipes"
-permalink: /recipes/
-author_profile: false
----
-
-{% for post in site.recipes %}
-  {% include archive-single.html %}
-{% endfor %}
\ No newline at end of file
diff --git a/test/_pages/recipes-archive.md b/test/_pages/recipes-archive.md
new file mode 100644
index 000000000000..cdde1e4e6594
--- /dev/null
+++ b/test/_pages/recipes-archive.md
@@ -0,0 +1,9 @@
+---
+layout: collection
+title: "Recipes"
+collection: recipes
+permalink: /recipes-archive/
+author_profile: false
+---
+
+Sample document listing for the collection `_recipes`.
\ No newline at end of file
diff --git a/test/_pages/sitemap.md b/test/_pages/sitemap.md
index ebdd40533535..24d4009dc9ff 100644
--- a/test/_pages/sitemap.md
+++ b/test/_pages/sitemap.md
@@ -5,7 +5,7 @@ permalink: /sitemap/
 author_profile: false
 ---
 
-A list of all the posts and pages found on the site. For you robots out there is an [XML version]({{ base_path }}/sitemap.xml) available for digesting as well.
+A list of all the posts and pages found on the site. For you robots out there is an [XML version]({{ '/sitemap.xml' | relative_url }}) available for digesting as well.
 
 
Pages

 {% for post in site.pages %}
diff --git a/test/_pages/splash-page.md b/test/_pages/splash-page.md
index f0cd57b04a5a..81d56258cbfe 100644
--- a/test/_pages/splash-page.md
+++ b/test/_pages/splash-page.md
@@ -7,14 +7,16 @@ header:
   overlay_color: "#000"
   overlay_filter: "0.5"
   overlay_image: /assets/images/unsplash-image-1.jpg
-  cta_label: "Download"
-  cta_url: "https://github.com/mmistakes/minimal-mistakes/"
+  actions:
+    - label: "Learn More"
+      url: "/terms/"
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
 excerpt: "Bacon ipsum dolor sit amet salami ham hock ham, hamburger corned beef short ribs kielbasa biltong t-bone drumstick tri-tip tail sirloin pork chop."
 intro: 
   - excerpt: 'Nullam suscipit et nam, tellus velit pellentesque at malesuada, enim eaque. Quis nulla, netus tempor in diam gravida tincidunt, *proin faucibus* voluptate felis id sollicitudin. Centered with `type="center"`'
 feature_row:
   - image_path: assets/images/unsplash-gallery-image-1-th.jpg
+    image_caption: "Image courtesy of [Unsplash](https://unsplash.com/)"
     alt: "placeholder image 1"
     title: "Placeholder 1"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
diff --git a/test/_pages/tag-archive-grid.md b/test/_pages/tag-archive-grid.md
new file mode 100644
index 000000000000..fa4df8137729
--- /dev/null
+++ b/test/_pages/tag-archive-grid.md
@@ -0,0 +1,7 @@
+---
+title: "Posts by Tag (grid view)"
+permalink: /tags-grid/
+layout: tags
+entries_layout: grid
+author_profile: true
+---
diff --git a/test/_pages/tag-archive.html b/test/_pages/tag-archive.html
deleted file mode 100644
index b30a57f5ac5f..000000000000
--- a/test/_pages/tag-archive.html
+++ /dev/null
@@ -1,16 +0,0 @@
----
-layout: archive
-permalink: /tags/
-title: "Posts by Tag"
-author_profile: true
----
-
-{% include group-by-array collection=site.posts field="tags" %}
-
-{% for tag in group_names %}
-  {% assign posts = group_items[forloop.index0] %}
-  
{{ tag }}

-  {% for post in posts %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
diff --git a/test/_pages/tag-archive.md b/test/_pages/tag-archive.md
new file mode 100644
index 000000000000..3f4e3f0df86c
--- /dev/null
+++ b/test/_pages/tag-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Tag"
+permalink: /tags/
+layout: tags
+author_profile: true
+---
diff --git a/test/_pages/year-archive-grid.md b/test/_pages/year-archive-grid.md
new file mode 100644
index 000000000000..5029212cd32d
--- /dev/null
+++ b/test/_pages/year-archive-grid.md
@@ -0,0 +1,7 @@
+---
+title: "Posts by Year (grid view)"
+permalink: /year-archive-grid/
+layout: posts
+entries_layout: grid
+author_profile: true
+---
diff --git a/test/_pages/year-archive.html b/test/_pages/year-archive.html
deleted file mode 100644
index 13135a91ddab..000000000000
--- a/test/_pages/year-archive.html
+++ /dev/null
@@ -1,14 +0,0 @@
----
-layout: archive
-permalink: /year-archive/
-title: "Posts by Year"
-author_profile: true
----
-
-{% assign postsByYear = site.posts | group_by_exp:"post", "post.date | date: '%Y'"  %}
-{% for year in postsByYear %}
-  
{{ year.name }}

-  {% for post in year.items %}
-    {% include archive-single.html %}
-  {% endfor %}
-{% endfor %}
\ No newline at end of file
diff --git a/test/_pages/year-archive.md b/test/_pages/year-archive.md
new file mode 100644
index 000000000000..1021452ad951
--- /dev/null
+++ b/test/_pages/year-archive.md
@@ -0,0 +1,6 @@
+---
+title: "Posts by Year"
+permalink: /year-archive/
+layout: posts
+author_profile: true
+---
diff --git a/test/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md b/test/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
index cc4fd5e52ff7..5e3ecedcaffd 100644
--- a/test/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
+++ b/test/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md
@@ -57,4 +57,12 @@ Nested and mixed lists are an interesting beast. It's a corner case to make sure
     1. **ordered item**
     2. **ordered item**
 * unordered item
-* unordered item
\ No newline at end of file
+* unordered item
+
+### Task Lists
+
+- [x] Finish my changes
+- [ ] Push my commits to GitHub
+- [ ] Open a pull request
+  - [ ] Follow discussions
+  - [x] Push new commits
\ No newline at end of file
diff --git a/test/_posts/2009-06-01-edge-case-many-tags.md b/test/_posts/2009-06-01-edge-case-many-tags.md
index f43509f119cc..af9209596ea6 100644
--- a/test/_posts/2009-06-01-edge-case-many-tags.md
+++ b/test/_posts/2009-06-01-edge-case-many-tags.md
@@ -44,6 +44,8 @@ tags:
   - Unseen
   - video
   - YouTube
+  - U:R:COOL
+  - C#
 ---
 
 This post has many tags.
\ No newline at end of file
diff --git a/test/_posts/2009-10-05-edge-case-multiline-excerpt.md b/test/_posts/2009-10-05-edge-case-multiline-excerpt.md
new file mode 100644
index 000000000000..6acc568a0655
--- /dev/null
+++ b/test/_posts/2009-10-05-edge-case-multiline-excerpt.md
@@ -0,0 +1,6 @@
+---
+title: "Edge Case: Post with multiline excerpt"
+---
+
+Et ex ullamco duis don't
+combine these words quis laborum sunt sint. Nisi et Lorem reprehenderit cupidatat. Aliqua fugiat aliquip officia culpa elit. Adipisicing do eu duis aute et aute amet anim ut cillum aliqua. Aliqua adipisicing occaecat et ullamco fugiat.
\ No newline at end of file
diff --git a/test/_posts/2010-02-05-post-notice.md b/test/_posts/2010-02-05-post-notice.md
index 071c7892e6c4..da63f9a32152 100644
--- a/test/_posts/2010-02-05-post-notice.md
+++ b/test/_posts/2010-02-05-post-notice.md
@@ -17,6 +17,16 @@ When using Kramdown `{: .notice}` can be added after a sentence to assign the `.
 **Primary Notice:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. [Praesent libero](#). Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
 {: .notice--primary}
 
+

+**Primary Notice with code block:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. [Praesent libero](#). Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
+
+```html
+
+  Some body.
+
+```
+

+
 **Info Notice:** Lorem ipsum dolor sit amet, [consectetur adipiscing elit](#). Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
 {: .notice--info}
 
diff --git a/test/_posts/2010-06-02-post-video-youtube.md b/test/_posts/2010-06-02-post-video-youtube.md
index 16bc910c38da..686f622b9e70 100644
--- a/test/_posts/2010-06-02-post-video-youtube.md
+++ b/test/_posts/2010-06-02-post-video-youtube.md
@@ -8,4 +8,4 @@ tags:
 
 YouTube video embed below.
 
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/test/_posts/2010-08-05-post-header-overlay-image-og-override.md b/test/_posts/2010-08-05-post-header-overlay-image-og-override.md
index 89656ccfa76e..01630ace8dcb 100644
--- a/test/_posts/2010-08-05-post-header-overlay-image-og-override.md
+++ b/test/_posts/2010-08-05-post-header-overlay-image-og-override.md
@@ -4,7 +4,9 @@ header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   og_image: /assets/images/page-header-og-image.png
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Learn More"
+      url: "https://unsplash.com"
 categories:
   - Layout
   - Uncategorized
@@ -22,5 +24,7 @@ header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   og_image: /assets/images/page-header-og-image.png
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Learn More"
+      url: "https://unsplash.com"
 ```
\ No newline at end of file
diff --git a/test/_posts/2010-08-05-post-image-linked.md b/test/_posts/2010-08-05-post-image-linked.md
index af3f3fe9f779..a59cd117126e 100644
--- a/test/_posts/2010-08-05-post-image-linked.md
+++ b/test/_posts/2010-08-05-post-image-linked.md
@@ -7,4 +7,4 @@ tags:
   - Post Formats
 ---
 
-[![foo](https://farm5.staticflickr.com/4073/4939853213_33ffc0290b_b.jpg)](https://flic.kr/p/8ww3fZ)
\ No newline at end of file
+[![foo](https://live.staticflickr.com/8361/8400335147_5fabaa504c_o.jpg)](https://flic.kr/p/dNiUYB)
\ No newline at end of file
diff --git a/test/_posts/2010-08-06-post-image-linked-caption.md b/test/_posts/2010-08-06-post-image-linked-caption.md
index ada6f6a73ed6..f9b09ba135db 100644
--- a/test/_posts/2010-08-06-post-image-linked-caption.md
+++ b/test/_posts/2010-08-06-post-image-linked-caption.md
@@ -8,7 +8,7 @@ tags:
 ---
 
 {% capture fig_img %}
-[![Foo](https://farm5.staticflickr.com/4134/4940462712_7c28420b27_b.jpg)](https://flic.kr/p/8wzarA)
+[![Foo](https://images.unsplash.com/photo-1541943869728-4bd4f450c8f5?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=800&fit=max&ixid=eyJhcHBfaWQiOjF9)](https://unsplash.com/)
 {% endcapture %}
 
 {% capture fig_caption %}
@@ -18,4 +18,4 @@ Stairs? Were we're going we don't need no stairs.
 

   {{ fig_img | markdownify | remove: "
" | remove: "
" }}
   
{{ fig_caption | markdownify | remove: "
" | remove: "
" }}

-

\ No newline at end of file
+

diff --git a/test/_posts/2010-08-07-post-image-caption.md b/test/_posts/2010-08-07-post-image-caption.md
index 227f7ece2e30..d50d4635df9e 100644
--- a/test/_posts/2010-08-07-post-image-caption.md
+++ b/test/_posts/2010-08-07-post-image-caption.md
@@ -7,10 +7,8 @@ tags:
   - Post Formats
 ---
 
-{% include base_path %}
-
 {% capture fig_img %}
-![Foo]({{ basepath }}/assets/images/unsplash-gallery-image-3.jpg)
+![Foo]({{ '/assets/images/unsplash-gallery-image-3.jpg' | relative_url }})
 {% endcapture %}
 
 

diff --git a/test/_posts/2010-09-09-post-gallery.md b/test/_posts/2010-09-09-post-gallery.md
index f7a9e91ce9cb..3bdd4ff3f477 100644
--- a/test/_posts/2010-09-09-post-gallery.md
+++ b/test/_posts/2010-09-09-post-gallery.md
@@ -131,4 +131,12 @@ And place it like so:
 
 And for giggles one more gallery just to make sure this works. To fill page content container add `class="full"`.
 
-{% include gallery id="gallery3" class="full" caption="This is a third gallery example with two images and fills the entire content container." %}
\ No newline at end of file
+{% include gallery id="gallery3" class="full" caption="This is a third gallery example with two images and fills the entire content container." %}
+
+Gallery column layout can be overrided by setting a `layout`.
+
+```liquid
+{% raw %}{% include gallery id="gallery" layout="half" caption="This is a half gallery layout example." %}{% endraw %}
+```
+
+{% include gallery id="gallery" layout="half" caption="This is a half gallery layout example." %}
\ No newline at end of file
diff --git a/test/_posts/2012-01-02-layout-post-date-disabled.md b/test/_posts/2012-01-02-layout-post-date-disabled.md
new file mode 100644
index 000000000000..a10a3e4648eb
--- /dev/null
+++ b/test/_posts/2012-01-02-layout-post-date-disabled.md
@@ -0,0 +1,18 @@
+---
+title: "Layout: Post Date Disabled"
+show_date: false
+tags:
+  - post date
+---
+
+This post has the date disabled. The date this post was published should not be showing if `show_date: false` is set in `_config.yml` or in this post's YAML Front Matter.
+
+If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on.
+
+I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still.
+
+Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more.
+
+Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights.
+
+Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance.
\ No newline at end of file
diff --git a/test/_posts/2012-01-02-layout-post-date.md b/test/_posts/2012-01-02-layout-post-date.md
new file mode 100644
index 000000000000..b31c9a275b5c
--- /dev/null
+++ b/test/_posts/2012-01-02-layout-post-date.md
@@ -0,0 +1,18 @@
+---
+title: "Layout: Post Date Enabled"
+show_date: true
+tags:
+  - post date
+---
+
+This post has post date enabled. The date the post was published should show if `show_date: true` is added to it's YAML Front Matter or as a default in `_config.yml`.
+
+If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on.
+
+I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still.
+
+Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more.
+
+Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights.
+
+Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance.
\ No newline at end of file
diff --git a/test/_posts/2012-01-03-layout-table-of-contents-include-post.md b/test/_posts/2012-01-03-layout-table-of-contents-include-post.md
new file mode 100644
index 000000000000..622b04da1d69
--- /dev/null
+++ b/test/_posts/2012-01-03-layout-table-of-contents-include-post.md
@@ -0,0 +1,139 @@
+---
+title: "Layout: Post with Nested Table of Contents via Helper"
+tags:
+  - table of contents
+---
+
+Tests table of contents with multiple levels to verify indentation is readible via helper include (deprecated).
+
+```
+{% raw %}{% include toc %}{% endraw %}
+```
+
+{% include toc %}
+
+# Enim laboris id ea elit elit deserunt
+
+Magna incididunt elit id enim nisi quis excepteur reprehenderit Lorem dolore dolore ad enim. Labore esse elit excepteur et elit dolor. Elit ut consectetur labore velit elit esse voluptate id commodo. Magna cillum officia consequat non occaecat mollit esse nisi quis.
+
+Nostrud veniam excepteur commodo enim pariatur velit est. Dolor consequat elit occaecat enim veniam ullamco qui est anim ex elit. Est minim aute magna laborum reprehenderit magna reprehenderit ullamco voluptate id sit aliqua. Id labore veniam ad duis aliquip commodo qui ex ut ipsum irure. In et sit ea cupidatat consectetur in nisi amet in cupidatat excepteur commodo amet.
+
+## 2 Sit adipisicing tempor duis velit cupidatat occaecat do amet
+
+Ad non dolore irure in. In do ut nostrud reprehenderit consequat aliqua sunt culpa voluptate amet minim ea. Eu dolore deserunt consectetur eu in minim sit nulla id id est amet consectetur. Tempor dolore ipsum magna amet velit aliquip ea anim non eu Lorem deserunt. Irure excepteur id adipisicing elit dolor ipsum eiusmod non nulla nisi sint qui et. Occaecat pariatur tempor ex nisi pariatur.
+
+Proident culpa nostrud id est qui fugiat duis aute. Cillum commodo pariatur nostrud culpa Lorem exercitation non. Consequat elit deserunt dolore voluptate sunt labore minim ut consequat minim.
+
+Sunt pariatur in ex non nulla proident ex ullamco Lorem do ipsum. Cillum est mollit reprehenderit excepteur labore labore elit dolore adipisicing ad quis quis aliqua sunt. Proident amet est reprehenderit deserunt amet cupidatat incididunt irure est elit.
+
+### 2.1 Ex et quis exercitation fugiat excepteur eiusmod mollit consequat id pariatur non adipisicing magna tempor
+
+Nostrud sunt nostrud incididunt adipisicing officia esse minim irure duis dolore adipisicing cupidatat. Eu non labore veniam ad sunt pariatur qui. Irure reprehenderit qui elit duis cillum sit officia consectetur sint deserunt do aute velit. Do id occaecat magna occaecat reprehenderit veniam pariatur Lorem. Officia sit cupidatat adipisicing laborum.
+
+#### 2.1.1 Ut nostrud reprehenderit proident culpa enim irure cupidatat sunt ex ea minim nostrud
+
+Laborum laboris et ut proident sit qui pariatur nisi commodo. Deserunt eiusmod eiusmod elit anim exercitation quis. Anim laboris irure minim elit fugiat velit esse officia amet reprehenderit id. Dolor eiusmod incididunt excepteur sint aute qui esse nostrud. Nisi qui adipisicing consectetur enim pariatur sint veniam esse.
+
+#### 2.1.2 Nisi non nisi ullamco ipsum cillum
+Minim officia tempor eiusmod sint magna reprehenderit do amet ex velit. Irure nulla ut veniam eu veniam proident esse pariatur cillum. Esse anim et proident cillum esse magna sint.
+
+#### 2.1.3 Ut pariatur do do eiusmod consequat do pariatur nisi ex anim reprehenderit nostrud
+Reprehenderit consectetur tempor labore dolore ad. Ullamco qui sunt quis deserunt id ipsum sit qui nisi esse deserunt ad exercitation. Dolore qui in mollit ex qui minim et ipsum reprehenderit. Tempor magna ipsum proident voluptate mollit quis consectetur veniam non aliquip cupidatat nisi culpa aute.
+
+##### 2.1.1.1 Ut aute quis ipsum fugiat dolor
+Occaecat excepteur et ea et exercitation ad aute minim incididunt incididunt aute sint officia aliquip. Quis cupidatat nostrud dolor consequat laboris eu ullamco qui esse excepteur aute. Veniam ut ipsum aute Lorem proident minim ea fugiat Lorem cillum. Qui esse id minim consequat ullamco aliqua pariatur ea mollit. Minim ea ipsum laborum consequat esse mollit pariatur. Voluptate sit voluptate non ut consectetur irure laboris ex adipisicing dolore elit aliquip velit. In eu veniam voluptate incididunt aute eu reprehenderit ut id voluptate.
+
+##### 2.1.1.2 Consequat nostrud quis officia et aliquip quis magna mollit veniam
+Magna duis exercitation dolor amet. Ea irure laborum sit officia reprehenderit enim aute magna duis. Elit fugiat ut proident sit.
+
+###### 2.1.1.1.1 Id cillum proident labore occaecat reprehenderit excepteur fugiat est
+
+Irure qui veniam incididunt irure consequat mollit consectetur est nostrud deserunt eiusmod nostrud quis. Eiusmod id proident eu aute exercitation irure consectetur sit dolor dolor in esse. Qui eu dolor ea est magna amet laborum qui irure. Reprehenderit excepteur voluptate fugiat exercitation voluptate laboris nostrud qui magna et officia.
+
+###### 2.1.1.1.2 In consectetur ea qui quis culpa nulla
+
+Ad quis duis dolore voluptate laborum eiusmod consequat sint. Cupidatat officia ex laborum ad non mollit excepteur ea. Nostrud elit in consequat sunt adipisicing reprehenderit ipsum proident irure. Sint velit laborum sint laboris ea. Veniam occaecat et in Lorem proident minim deserunt labore laborum reprehenderit. Consequat laborum deserunt culpa consectetur. Incididunt reprehenderit amet esse duis dolore pariatur adipisicing quis elit.
+
+###### 2.1.1.1.3 Culpa magna pariatur magna officia adipisicing ex minim ea do est
+
+Dolore reprehenderit aute ex id. Ipsum laboris sit quis enim labore ut sint cillum exercitation. Commodo aliqua exercitation enim sunt velit do laborum mollit irure dolor.
+
+###### 2.1.1.1.4 Veniam ipsum non reprehenderit pariatur
+
+Laboris amet quis sunt id dolor consectetur Lorem id aliquip laboris fugiat. Non ex magna deserunt veniam eiusmod. Irure culpa culpa dolore pariatur. Elit enim deserunt ut amet adipisicing elit laborum exercitation cupidatat et. Aliqua aliqua laborum exercitation commodo reprehenderit reprehenderit amet laboris ea ea ex amet in. Aute minim voluptate et ipsum culpa consequat.
+
+##### 2.1.1.3 Ut qui labore officia ad laboris eu amet minim tempor qui cupidatat duis aute
+
+In in dolore laboris irure est consequat magna ea non aute cupidatat tempor. Officia sit pariatur consequat laborum aliqua nulla anim nisi aliquip reprehenderit consequat. Ad duis labore minim consequat reprehenderit labore ex minim cillum magna incididunt adipisicing dolor. Non velit mollit minim consectetur minim. Cillum elit et amet est reprehenderit non. Elit adipisicing nostrud ea veniam occaecat commodo deserunt.
+
+##### 2.1.1.4 Magna ipsum nisi velit anim
+
+Eiusmod tempor dolor proident pariatur consequat sit non nostrud. Eiusmod duis elit esse Lorem dolore et minim elit consectetur eu ullamco. Adipisicing sunt excepteur eu mollit in nostrud.
+
+###### 2.1.1.4.1 Mollit nulla est tempor fugiat occaecat nostrud
+
+Exercitation eu labore Lorem culpa id enim ut officia aute proident in est irure. Nostrud adipisicing magna elit tempor ipsum culpa in incididunt consectetur incididunt veniam aute tempor sint. Officia est consectetur sint sint nostrud proident mollit. Dolore duis proident mollit consectetur tempor.
+
+###### 2.1.1.2.1 Culpa aliquip irure et nostrud esse consequat fugiat dolor
+
+Ad ut commodo elit amet officia ipsum labore do amet. Eiusmod sint irure magna proident nisi adipisicing mollit excepteur mollit proident culpa duis. Est reprehenderit consequat eiusmod deserunt duis ipsum esse amet incididunt.
+
+#### 2.1.4 Laboris exercitation nisi tempor dolore
+
+Elit culpa est eiusmod nostrud occaecat. Labore incididunt nostrud consectetur sint. Ut pariatur laborum incididunt culpa proident incididunt veniam veniam laboris adipisicing mollit. Ullamco magna tempor fugiat veniam in ipsum nisi mollit labore amet et sit quis. In consectetur fugiat Lorem culpa veniam minim. Irure aliqua est mollit consectetur id Lorem velit minim sit velit. Eiusmod magna do dolor est id reprehenderit minim fugiat minim incididunt incididunt laboris velit consequat.
+
+### 2.2 Officia irure duis et est sunt
+
+Consequat anim quis non nulla. Eiusmod pariatur sunt non culpa culpa ipsum nulla anim in. Non ad exercitation ut reprehenderit ut dolor laborum tempor ad qui magna fugiat irure. Sint commodo ea sint sunt. Irure qui pariatur tempor veniam reprehenderit amet est. Amet laboris proident Lorem deserunt proident duis esse do sit eu dolor qui duis eu. Mollit laboris nisi aute nulla consectetur exercitation nulla aliqua anim.
+
+## 3 Laborum eu magna proident proident tempor
+
+Occaecat aliqua id voluptate mollit aliquip. Elit excepteur magna esse commodo pariatur reprehenderit in in quis. Id dolore proident proident mollit tempor duis magna ullamco nulla velit consequat. In ut est aliquip in commodo ullamco sit sint.
+
+### 3.1 Amet enim do laboris ipsum aliqua eiusmod non eu
+
+Laborum magna deserunt do anim quis proident adipisicing. Dolore qui ex minim reprehenderit. Consectetur in cillum ad dolore ut id deserunt irure aute sint magna dolore adipisicing.
+
+### 3.2 Do exercitation ex elit incididunt sit cupidatat
+
+Excepteur aliqua nisi ullamco sunt fugiat laborum elit aliquip officia culpa. Est exercitation enim laborum amet exercitation. Eu quis qui eiusmod incididunt id do aliquip nostrud do esse enim excepteur enim pariatur. Aute adipisicing velit non culpa quis exercitation. Quis cupidatat anim occaecat Lorem ad mollit aute eiusmod quis dolor duis. Proident anim et nostrud ut aliquip irure adipisicing reprehenderit proident dolore magna. Consequat eu fugiat esse proident duis eu proident fugiat laboris ea veniam nisi reprehenderit.
+
+### 3.3 Officia aliquip fugiat ex pariatur nisi et nostrud adipisicing eu minim laboris eiusmod ea sunt
+
+Consectetur irure elit nulla elit non officia. Culpa Lorem minim dolor laboris enim labore do minim laborum. Fugiat deserunt nisi ut do incididunt incididunt ea anim exercitation sit duis. Irure esse pariatur labore enim labore qui anim culpa laborum velit consequat. Culpa in adipisicing excepteur est ipsum. In reprehenderit eiusmod ad ad non.
+
+### 3.4 Ipsum velit laborum est nostrud qui enim ullamco velit dolor Lorem magna
+
+Nulla magna dolor minim commodo. Sunt nulla cupidatat consequat eiusmod elit irure eiusmod excepteur. Sit incididunt irure minim magna. Tempor ipsum exercitation minim sunt labore dolor ullamco veniam enim nisi veniam adipisicing occaecat proident.
+
+### 3.5 Officia fugiat fugiat voluptate ullamco eiusmod duis minim aliqua consequat consectetur qui do sunt fugiat
+
+Non aute culpa irure qui aute adipisicing aute id commodo id. Laborum ullamco laboris velit in quis duis ut consequat do minim. In minim amet ut reprehenderit et voluptate. In quis Lorem occaecat nostrud excepteur nostrud dolore in nulla ad Lorem nisi. Dolor exercitation Lorem qui sint aute ipsum officia eiusmod aliquip Lorem sit. Reprehenderit ex veniam excepteur laboris magna dolore fugiat sit exercitation esse et consequat in sit. Incididunt pariatur ad esse anim aute do id eu.
+
+#### 3.5.1 Mollit laborum ea aliquip mollit quis commodo fugiat tempor deserunt exercitation sint culpa ipsum tempor
+
+Est cillum laborum cupidatat ullamco cupidatat magna laborum enim duis consequat est eu. Magna cillum Lorem proident non ut officia. Esse irure et laboris eu occaecat aute.
+
+##### 3.5.1.1 Nisi anim commodo consequat quis amet
+
+Sunt eu dolor enim enim consectetur et anim irure dolor velit cillum. Esse reprehenderit cillum incididunt adipisicing amet nostrud adipisicing. Minim mollit nostrud ipsum ea ut sit ex elit. Do esse ad et ipsum nisi sint anim culpa excepteur ipsum. Commodo nisi irure qui reprehenderit incididunt.
+
+###### 3.5.1.1.1 Culpa nulla Lorem adipisicing ut sit cupidatat laborum laborum cupidatat proident
+
+Dolore dolor sit sunt anim eu amet consectetur quis ea proident ex aliqua. Sunt laborum consectetur consectetur enim velit eiusmod labore commodo commodo laboris deserunt. Eiusmod enim do amet laborum commodo qui.
+
+### 3.6 Reprehenderit culpa consectetur veniam minim cillum in nostrud
+
+Lorem dolore sit aliqua tempor do voluptate ut esse. Minim velit ad velit commodo minim laborum. Qui qui reprehenderit non proident ullamco veniam aliquip.
+
+## 4 Laboris aute consequat id eu et Lorem amet
+
+Ad qui voluptate dolor veniam. Veniam mollit aute eiusmod eu labore incididunt sint proident. Non minim consequat anim sint. Aliquip non nisi nostrud proident. Eiusmod ut duis commodo sunt laboris irure eu. Laboris quis amet ad qui officia.
+
+## 5 Esse eu consequat consequat aliqua fugiat nulla ad labore consectetur eu pariatur nisi aute
+
+Duis proident ullamco fugiat aliqua sunt anim ea do irure est amet quis nulla cillum. Commodo voluptate dolor culpa sint aliquip voluptate exercitation anim cillum ad eu in amet. Sint fugiat qui commodo quis ex eu commodo officia aliquip irure. Non dolore elit excepteur id laboris irure consequat magna consectetur. Qui proident deserunt culpa tempor sit aute velit proident cillum ea.
+
+## 6 Aliquip sunt laborum excepteur cupidatat officia ad tempor veniam esse amet ea commodo sunt
+
+Ex minim pariatur est nisi exercitation exercitation reprehenderit id aliqua deserunt est. Laborum ullamco do ipsum minim ipsum aliquip voluptate voluptate aliqua. Magna proident velit veniam et minim commodo officia officia mollit nisi. Excepteur occaecat deserunt irure adipisicing minim adipisicing cupidatat non anim exercitation ex. Amet quis sunt sint veniam non id nisi ipsum mollit voluptate quis tempor tempor.
diff --git a/test/_posts/2012-01-03-layout-table-of-contents-indent-post.md b/test/_posts/2012-01-03-layout-table-of-contents-indent-post.md
new file mode 100644
index 000000000000..e36f8104ccd4
--- /dev/null
+++ b/test/_posts/2012-01-03-layout-table-of-contents-indent-post.md
@@ -0,0 +1,134 @@
+---
+title: "Layout: Post with Nested Table of Contents"
+tags:
+  - table of contents
+toc: true
+---
+
+Tests table of contents with multiple levels to verify indentation is readible.
+
+# Enim laboris id ea elit elit deserunt
+
+Magna incididunt elit id enim nisi quis excepteur reprehenderit Lorem dolore dolore ad enim. Labore esse elit excepteur et elit dolor. Elit ut consectetur labore velit elit esse voluptate id commodo. Magna cillum officia consequat non occaecat mollit esse nisi quis.
+
+Nostrud veniam excepteur commodo enim pariatur velit est. Dolor consequat elit occaecat enim veniam ullamco qui est anim ex elit. Est minim aute magna laborum reprehenderit magna reprehenderit ullamco voluptate id sit aliqua. Id labore veniam ad duis aliquip commodo qui ex ut ipsum irure. In et sit ea cupidatat consectetur in nisi amet in cupidatat excepteur commodo amet.
+
+## 2 Sit adipisicing tempor duis velit cupidatat occaecat do amet
+
+Ad non dolore irure in. In do ut nostrud reprehenderit consequat aliqua sunt culpa voluptate amet minim ea. Eu dolore deserunt consectetur eu in minim sit nulla id id est amet consectetur. Tempor dolore ipsum magna amet velit aliquip ea anim non eu Lorem deserunt. Irure excepteur id adipisicing elit dolor ipsum eiusmod non nulla nisi sint qui et. Occaecat pariatur tempor ex nisi pariatur.
+
+Proident culpa nostrud id est qui fugiat duis aute. Cillum commodo pariatur nostrud culpa Lorem exercitation non. Consequat elit deserunt dolore voluptate sunt labore minim ut consequat minim.
+
+Sunt pariatur in ex non nulla proident ex ullamco Lorem do ipsum. Cillum est mollit reprehenderit excepteur labore labore elit dolore adipisicing ad quis quis aliqua sunt. Proident amet est reprehenderit deserunt amet cupidatat incididunt irure est elit.
+
+### 2.1 Ex et quis exercitation fugiat excepteur eiusmod mollit consequat id pariatur non adipisicing magna tempor
+
+Nostrud sunt nostrud incididunt adipisicing officia esse minim irure duis dolore adipisicing cupidatat. Eu non labore veniam ad sunt pariatur qui. Irure reprehenderit qui elit duis cillum sit officia consectetur sint deserunt do aute velit. Do id occaecat magna occaecat reprehenderit veniam pariatur Lorem. Officia sit cupidatat adipisicing laborum.
+
+#### 2.1.1 Ut nostrud reprehenderit proident culpa enim irure cupidatat sunt ex ea minim nostrud
+
+Laborum laboris et ut proident sit qui pariatur nisi commodo. Deserunt eiusmod eiusmod elit anim exercitation quis. Anim laboris irure minim elit fugiat velit esse officia amet reprehenderit id. Dolor eiusmod incididunt excepteur sint aute qui esse nostrud. Nisi qui adipisicing consectetur enim pariatur sint veniam esse.
+
+#### 2.1.2 Nisi non nisi ullamco ipsum cillum
+Minim officia tempor eiusmod sint magna reprehenderit do amet ex velit. Irure nulla ut veniam eu veniam proident esse pariatur cillum. Esse anim et proident cillum esse magna sint.
+
+#### 2.1.3 Ut pariatur do do eiusmod consequat do pariatur nisi ex anim reprehenderit nostrud
+Reprehenderit consectetur tempor labore dolore ad. Ullamco qui sunt quis deserunt id ipsum sit qui nisi esse deserunt ad exercitation. Dolore qui in mollit ex qui minim et ipsum reprehenderit. Tempor magna ipsum proident voluptate mollit quis consectetur veniam non aliquip cupidatat nisi culpa aute.
+
+##### 2.1.1.1 Ut aute quis ipsum fugiat dolor
+Occaecat excepteur et ea et exercitation ad aute minim incididunt incididunt aute sint officia aliquip. Quis cupidatat nostrud dolor consequat laboris eu ullamco qui esse excepteur aute. Veniam ut ipsum aute Lorem proident minim ea fugiat Lorem cillum. Qui esse id minim consequat ullamco aliqua pariatur ea mollit. Minim ea ipsum laborum consequat esse mollit pariatur. Voluptate sit voluptate non ut consectetur irure laboris ex adipisicing dolore elit aliquip velit. In eu veniam voluptate incididunt aute eu reprehenderit ut id voluptate.
+
+##### 2.1.1.2 Consequat nostrud quis officia et aliquip quis magna mollit veniam
+Magna duis exercitation dolor amet. Ea irure laborum sit officia reprehenderit enim aute magna duis. Elit fugiat ut proident sit.
+
+###### 2.1.1.1.1 Id cillum proident labore occaecat reprehenderit excepteur fugiat est
+
+Irure qui veniam incididunt irure consequat mollit consectetur est nostrud deserunt eiusmod nostrud quis. Eiusmod id proident eu aute exercitation irure consectetur sit dolor dolor in esse. Qui eu dolor ea est magna amet laborum qui irure. Reprehenderit excepteur voluptate fugiat exercitation voluptate laboris nostrud qui magna et officia.
+
+###### 2.1.1.1.2 In consectetur ea qui quis culpa nulla
+
+Ad quis duis dolore voluptate laborum eiusmod consequat sint. Cupidatat officia ex laborum ad non mollit excepteur ea. Nostrud elit in consequat sunt adipisicing reprehenderit ipsum proident irure. Sint velit laborum sint laboris ea. Veniam occaecat et in Lorem proident minim deserunt labore laborum reprehenderit. Consequat laborum deserunt culpa consectetur. Incididunt reprehenderit amet esse duis dolore pariatur adipisicing quis elit.
+
+###### 2.1.1.1.3 Culpa magna pariatur magna officia adipisicing ex minim ea do est
+
+Dolore reprehenderit aute ex id. Ipsum laboris sit quis enim labore ut sint cillum exercitation. Commodo aliqua exercitation enim sunt velit do laborum mollit irure dolor.
+
+###### 2.1.1.1.4 Veniam ipsum non reprehenderit pariatur
+
+Laboris amet quis sunt id dolor consectetur Lorem id aliquip laboris fugiat. Non ex magna deserunt veniam eiusmod. Irure culpa culpa dolore pariatur. Elit enim deserunt ut amet adipisicing elit laborum exercitation cupidatat et. Aliqua aliqua laborum exercitation commodo reprehenderit reprehenderit amet laboris ea ea ex amet in. Aute minim voluptate et ipsum culpa consequat.
+
+##### 2.1.1.3 Ut qui labore officia ad laboris eu amet minim tempor qui cupidatat duis aute
+
+In in dolore laboris irure est consequat magna ea non aute cupidatat tempor. Officia sit pariatur consequat laborum aliqua nulla anim nisi aliquip reprehenderit consequat. Ad duis labore minim consequat reprehenderit labore ex minim cillum magna incididunt adipisicing dolor. Non velit mollit minim consectetur minim. Cillum elit et amet est reprehenderit non. Elit adipisicing nostrud ea veniam occaecat commodo deserunt.
+
+##### 2.1.1.4 Magna ipsum nisi velit anim
+
+Eiusmod tempor dolor proident pariatur consequat sit non nostrud. Eiusmod duis elit esse Lorem dolore et minim elit consectetur eu ullamco. Adipisicing sunt excepteur eu mollit in nostrud.
+
+###### 2.1.1.4.1 Mollit nulla est tempor fugiat occaecat nostrud
+
+Exercitation eu labore Lorem culpa id enim ut officia aute proident in est irure. Nostrud adipisicing magna elit tempor ipsum culpa in incididunt consectetur incididunt veniam aute tempor sint. Officia est consectetur sint sint nostrud proident mollit. Dolore duis proident mollit consectetur tempor.
+
+###### 2.1.1.2.1 Culpa aliquip irure et nostrud esse consequat fugiat dolor
+
+Ad ut commodo elit amet officia ipsum labore do amet. Eiusmod sint irure magna proident nisi adipisicing mollit excepteur mollit proident culpa duis. Est reprehenderit consequat eiusmod deserunt duis ipsum esse amet incididunt.
+
+#### 2.1.4 Laboris exercitation nisi tempor dolore
+
+Elit culpa est eiusmod nostrud occaecat. Labore incididunt nostrud consectetur sint. Ut pariatur laborum incididunt culpa proident incididunt veniam veniam laboris adipisicing mollit. Ullamco magna tempor fugiat veniam in ipsum nisi mollit labore amet et sit quis. In consectetur fugiat Lorem culpa veniam minim. Irure aliqua est mollit consectetur id Lorem velit minim sit velit. Eiusmod magna do dolor est id reprehenderit minim fugiat minim incididunt incididunt laboris velit consequat.
+
+### 2.2 Officia irure duis et est sunt
+
+Consequat anim quis non nulla. Eiusmod pariatur sunt non culpa culpa ipsum nulla anim in. Non ad exercitation ut reprehenderit ut dolor laborum tempor ad qui magna fugiat irure. Sint commodo ea sint sunt. Irure qui pariatur tempor veniam reprehenderit amet est. Amet laboris proident Lorem deserunt proident duis esse do sit eu dolor qui duis eu. Mollit laboris nisi aute nulla consectetur exercitation nulla aliqua anim.
+
+## 3 Laborum eu magna proident proident tempor
+
+Occaecat aliqua id voluptate mollit aliquip. Elit excepteur magna esse commodo pariatur reprehenderit in in quis. Id dolore proident proident mollit tempor duis magna ullamco nulla velit consequat. In ut est aliquip in commodo ullamco sit sint.
+
+### 3.1 Amet enim do laboris ipsum aliqua eiusmod non eu
+
+Laborum magna deserunt do anim quis proident adipisicing. Dolore qui ex minim reprehenderit. Consectetur in cillum ad dolore ut id deserunt irure aute sint magna dolore adipisicing.
+
+### 3.2 Do exercitation ex elit incididunt sit cupidatat
+
+Excepteur aliqua nisi ullamco sunt fugiat laborum elit aliquip officia culpa. Est exercitation enim laborum amet exercitation. Eu quis qui eiusmod incididunt id do aliquip nostrud do esse enim excepteur enim pariatur. Aute adipisicing velit non culpa quis exercitation. Quis cupidatat anim occaecat Lorem ad mollit aute eiusmod quis dolor duis. Proident anim et nostrud ut aliquip irure adipisicing reprehenderit proident dolore magna. Consequat eu fugiat esse proident duis eu proident fugiat laboris ea veniam nisi reprehenderit.
+
+### 3.3 Officia aliquip fugiat ex pariatur nisi et nostrud adipisicing eu minim laboris eiusmod ea sunt
+
+Consectetur irure elit nulla elit non officia. Culpa Lorem minim dolor laboris enim labore do minim laborum. Fugiat deserunt nisi ut do incididunt incididunt ea anim exercitation sit duis. Irure esse pariatur labore enim labore qui anim culpa laborum velit consequat. Culpa in adipisicing excepteur est ipsum. In reprehenderit eiusmod ad ad non.
+
+### 3.4 Ipsum velit laborum est nostrud qui enim ullamco velit dolor Lorem magna
+
+Nulla magna dolor minim commodo. Sunt nulla cupidatat consequat eiusmod elit irure eiusmod excepteur. Sit incididunt irure minim magna. Tempor ipsum exercitation minim sunt labore dolor ullamco veniam enim nisi veniam adipisicing occaecat proident.
+
+### 3.5 Officia fugiat fugiat voluptate ullamco eiusmod duis minim aliqua consequat consectetur qui do sunt fugiat
+
+Non aute culpa irure qui aute adipisicing aute id commodo id. Laborum ullamco laboris velit in quis duis ut consequat do minim. In minim amet ut reprehenderit et voluptate. In quis Lorem occaecat nostrud excepteur nostrud dolore in nulla ad Lorem nisi. Dolor exercitation Lorem qui sint aute ipsum officia eiusmod aliquip Lorem sit. Reprehenderit ex veniam excepteur laboris magna dolore fugiat sit exercitation esse et consequat in sit. Incididunt pariatur ad esse anim aute do id eu.
+
+#### 3.5.1 Mollit laborum ea aliquip mollit quis commodo fugiat tempor deserunt exercitation sint culpa ipsum tempor
+
+Est cillum laborum cupidatat ullamco cupidatat magna laborum enim duis consequat est eu. Magna cillum Lorem proident non ut officia. Esse irure et laboris eu occaecat aute.
+
+##### 3.5.1.1 Nisi anim commodo consequat quis amet
+
+Sunt eu dolor enim enim consectetur et anim irure dolor velit cillum. Esse reprehenderit cillum incididunt adipisicing amet nostrud adipisicing. Minim mollit nostrud ipsum ea ut sit ex elit. Do esse ad et ipsum nisi sint anim culpa excepteur ipsum. Commodo nisi irure qui reprehenderit incididunt.
+
+###### 3.5.1.1.1 Culpa nulla Lorem adipisicing ut sit cupidatat laborum laborum cupidatat proident
+
+Dolore dolor sit sunt anim eu amet consectetur quis ea proident ex aliqua. Sunt laborum consectetur consectetur enim velit eiusmod labore commodo commodo laboris deserunt. Eiusmod enim do amet laborum commodo qui.
+
+### 3.6 Reprehenderit culpa consectetur veniam minim cillum in nostrud
+
+Lorem dolore sit aliqua tempor do voluptate ut esse. Minim velit ad velit commodo minim laborum. Qui qui reprehenderit non proident ullamco veniam aliquip.
+
+## 4 Laboris aute consequat id eu et Lorem amet
+
+Ad qui voluptate dolor veniam. Veniam mollit aute eiusmod eu labore incididunt sint proident. Non minim consequat anim sint. Aliquip non nisi nostrud proident. Eiusmod ut duis commodo sunt laboris irure eu. Laboris quis amet ad qui officia.
+
+## 5 Esse eu consequat consequat aliqua fugiat nulla ad labore consectetur eu pariatur nisi aute
+
+Duis proident ullamco fugiat aliqua sunt anim ea do irure est amet quis nulla cillum. Commodo voluptate dolor culpa sint aliquip voluptate exercitation anim cillum ad eu in amet. Sint fugiat qui commodo quis ex eu commodo officia aliquip irure. Non dolore elit excepteur id laboris irure consequat magna consectetur. Qui proident deserunt culpa tempor sit aute velit proident cillum ea.
+
+## 6 Aliquip sunt laborum excepteur cupidatat officia ad tempor veniam esse amet ea commodo sunt
+
+Ex minim pariatur est nisi exercitation exercitation reprehenderit id aliqua deserunt est. Laborum ullamco do ipsum minim ipsum aliquip voluptate voluptate aliqua. Magna proident velit veniam et minim commodo officia officia mollit nisi. Excepteur occaecat deserunt irure adipisicing minim adipisicing cupidatat non anim exercitation ex. Amet quis sunt sint veniam non id nisi ipsum mollit voluptate quis tempor tempor.
diff --git a/test/_posts/2012-01-03-layout-table-of-contents-post.md b/test/_posts/2012-01-03-layout-table-of-contents-post.md
index 792847cd2c53..01c14a2cf451 100644
--- a/test/_posts/2012-01-03-layout-table-of-contents-post.md
+++ b/test/_posts/2012-01-03-layout-table-of-contents-post.md
@@ -1,5 +1,5 @@
 ---
-title: "Layout: Post with Table Of Contents"
+title: "Layout: Post with Table of Contents"
 header:
   image: assets/images/unsplash-image-9.jpg
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
diff --git a/test/_posts/2012-01-03-layout-table-of-contents-sticky.md b/test/_posts/2012-01-03-layout-table-of-contents-sticky.md
new file mode 100644
index 000000000000..a8eae408204d
--- /dev/null
+++ b/test/_posts/2012-01-03-layout-table-of-contents-sticky.md
@@ -0,0 +1,93 @@
+---
+title: "Layout: Post with Sticky Table of Contents"
+tags:
+  - table of contents
+toc: true
+toc_sticky: true
+---
+
+"Stick" table of contents to the top of a page by adding `toc_sticky: true` to its YAML Front Matter.
+
+```yaml
+---
+toc: true
+toc_sticky: true
+---
+```
+
+## HTML Elements
+
+Below is just about everything you'll need to style in the theme. Check the source code to see the many embedded elements within paragraphs.
+
+## Body text
+
+Lorem ipsum dolor sit amet, test link adipiscing elit. **This is strong**. Nullam dignissim convallis est. Quisque aliquam.
+
+![Smithsonian Image]({{ site.url }}{{ site.baseurl }}/assets/images/3953273590_704e3899d5_m.jpg)
+{: .image-right}
+
+*This is emphasized*. Donec faucibus. Nunc iaculis suscipit dui. 53 = 125. Water is H2O. Nam sit amet sem. Aliquam libero nisi, imperdiet at, tincidunt nec, gravida vehicula, nisl. The New York Times (That’s a citation). Underline.Maecenas ornare tortor. Donec sed tellus eget sapien fringilla nonummy. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus.
+
+HTML and CSS are our tools. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus. Praesent mattis, massa quis luctus fermentum, turpis mi volutpat justo, eu volutpat enim diam eget metus.
+
+### Blockquotes
+
+> Lorem ipsum dolor sit amet, test link adipiscing elit. Nullam dignissim convallis est. Quisque aliquam.
+
+## List Types
+
+### Ordered Lists
+
+1. Item one
+   1. sub item one
+   2. sub item two
+   3. sub item three
+2. Item two
+
+### Unordered Lists
+
+* Item one
+* Item two
+* Item three
+
+## Tables
+
+| Header1 | Header2 | Header3 |
+|:--------|:-------:|--------:|
+| cell1   | cell2   | cell3   |
+| cell4   | cell5   | cell6   |
+|----
+| cell1   | cell2   | cell3   |
+| cell4   | cell5   | cell6   |
+|=====
+| Foot1   | Foot2   | Foot3
+{: rules="groups"}
+
+## Code Snippets
+
+```css
+#container {
+  float: left;
+  margin: 0 -240px 0 0;
+  width: 100%;
+}
+```
+
+## Buttons
+
+Make any link standout more when applying the `.btn` class.
+
+```html
+Success Button
+```
+
+
+
+
+
+
+
+## Notices
+
+**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph.
+{: .notice}
\ No newline at end of file
diff --git a/test/_posts/2012-03-15-layout-author-override.md b/test/_posts/2012-03-15-layout-author-override.md
index 50635b9d2c45..280a7bdfb47b 100644
--- a/test/_posts/2012-03-15-layout-author-override.md
+++ b/test/_posts/2012-03-15-layout-author-override.md
@@ -8,25 +8,37 @@ Sites that may have content authored from various individuals can be accommodate
 
 To attribute 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. Anything variables found under `author` in `_config.yml` can be used (e.g. `name`, `avatar`, `uri`, social media profiles, etc.).
+**Step 1.** Create `_data/authors.yml` and add authors using the following format. Anything 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"
-  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"
-  twitter: "extravagantman"
+  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"
-  email: "cornelius@thewhip.com"
-  bio: "I ordered what?"
-  avatar: "/assets/images/bio-photo.jpg"
-  twitter: "rhymeswithsackit"
+  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. 
diff --git a/test/_posts/2012-03-15-layout-header-image-external.md b/test/_posts/2012-03-15-layout-header-image-external.md
index 8dd7a01ed303..1795bdcd13fa 100644
--- a/test/_posts/2012-03-15-layout-header-image-external.md
+++ b/test/_posts/2012-03-15-layout-header-image-external.md
@@ -1,7 +1,7 @@
 ---
 title: "Layout: Header Image (External URL)"
 header:
-  image: https://farm5.staticflickr.com/4140/4939863887_84705982fd_b.jpg
+  image: https://live.staticflickr.com/8084/8396909762_813a2b1829_h.jpg
 categories:
   - Layout
   - Uncategorized
diff --git a/test/_posts/2012-03-15-layout-header-overlay-image-tagline.md b/test/_posts/2012-03-15-layout-header-overlay-image-tagline.md
new file mode 100644
index 000000000000..32588bde9b53
--- /dev/null
+++ b/test/_posts/2012-03-15-layout-header-overlay-image-tagline.md
@@ -0,0 +1,28 @@
+---
+title: "Layout: Header Image Overlay with Custom Tagline"
+tagline: "This is a custom tagline content which overrides the *default* page excerpt."
+header:
+  overlay_image: /assets/images/unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+categories:
+  - Layout
+  - Uncategorized
+tags:
+  - edge case
+  - image
+  - layout
+last_modified_at: 2020-01-07T13:05:25-05:00
+---
+
+This post should display a **header with an overlay image** and **custom tagline**, if the theme supports it.
+
+Non-square images can provide some unique styling issues.
+
+This post tests overlay header images with custom `page.tagline`.
+
+```yaml
+tagline: "This is a custom tagline content which overrides the default page excerpt."
+header:
+  overlay_image: /assets/images/unsplash-image-1.jpg
+  caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
+```
\ No newline at end of file
diff --git a/test/_posts/2012-03-15-layout-header-overlay-image.md b/test/_posts/2012-03-15-layout-header-overlay-image.md
index feaadd5a4cc3..4973a041ba92 100644
--- a/test/_posts/2012-03-15-layout-header-overlay-image.md
+++ b/test/_posts/2012-03-15-layout-header-overlay-image.md
@@ -3,7 +3,11 @@ title: "Layout: Header Image Overlay"
 header:
   overlay_image: /assets/images/unsplash-image-1.jpg
   caption: "Photo credit: [**Unsplash**](https://unsplash.com)"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "Call to action 1"
+      url: "https://github.com"
+    - label: "Call to action 2"
+      url: "https://mademistakes.com"
 categories:
   - Layout
   - Uncategorized
@@ -14,8 +18,6 @@ tags:
 last_modified_at: 2016-05-02T11:39:01-04:00
 ---
 
-{% include base_path %}
-
 This post should display a **header with an overlay image**, if the theme supports it.
 
 Non-square images can provide some unique styling issues.
@@ -26,7 +28,7 @@ This post tests overlay header images.
 
 You can use it by specifying the opacity (between 0 and 1) of a black overlay like so:
 
-![transparent black overlay]({{ basepath }}/assets/images/mm-header-overlay-black-filter.jpg)
+![transparent black overlay]({{ '/assets/images/mm-header-overlay-black-filter.jpg' | relative_url }})
 
 ```yaml
 excerpt: "This post should [...]"
@@ -34,13 +36,14 @@ 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)"
-  cta_label: "More Info"
-  cta_url: "https://unsplash.com"
+  actions:
+    - label: "More Info"
+      url: "https://unsplash.com"
 ```
 
 Or if you want to do more fancy things, go full rgba:
 
-![transparent red overlay]({{ basepath }}/assets/images/mm-header-overlay-red-filter.jpg)
+![transparent red overlay]({{ '/assets/images/mm-header-overlay-red-filter.jpg' | relative_url }})
 
 ```yaml
 excerpt: "This post should [...]"
@@ -48,6 +51,7 @@ header:
   overlay_image: /assets/images/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"
+  actions:
+    - label: "More Info"
+      url: "https://unsplash.com"
 ```
\ No newline at end of file
diff --git a/test/_posts/2012-03-15-layout-more-tag.md b/test/_posts/2012-03-15-layout-more-tag.md
index 45940a6ed57b..c6cdc44fb7c1 100644
--- a/test/_posts/2012-03-15-layout-more-tag.md
+++ b/test/_posts/2012-03-15-layout-more-tag.md
@@ -1,5 +1,6 @@
 ---
 title: "Layout: More Tag"
+excerpt_separator: 
 categories:
   - Layout
   - Uncategorized
@@ -11,7 +12,7 @@ tags:
 
 This content is before the [excerpt separator tag](http://jekyllrb.com/docs/posts/#post-excerpts).
 
-Right after this sentence there should be a **continue reading** link of some sort in archive-index pages.
+Additional content before the more tag.
 
 
 
diff --git a/test/_posts/2012-03-15-layout-sidebar-custom.md b/test/_posts/2012-03-15-layout-sidebar-custom.md
index ee49173eba29..c594ae4807af 100644
--- a/test/_posts/2012-03-15-layout-sidebar-custom.md
+++ b/test/_posts/2012-03-15-layout-sidebar-custom.md
@@ -7,8 +7,9 @@ sidebar:
     image: http://placehold.it/350x250
     image_alt: "image"
     text: "Some text here."
-  - title: "Another Title"
-    text: "More text here."
+    nav: sidebar-sample
+  - title: Another sidebar nav
+    nav: sidebar-sample
 ---
 
 This post has a custom sidebar set in the post's YAML Front Matter.
diff --git a/test/_posts/2013-01-11-markup-html-tags-and-formatting.md b/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
index f7d9437a1f5d..1fdc6dbdcd75 100644
--- a/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
+++ b/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
@@ -11,6 +11,7 @@ tags:
   - html
   - markup
 toc: true
+toc_sticky: true
 ---
 
 A variety of common markup showing how the theme styles them.
diff --git a/test/_posts/2016-02-24-welcome-to-jekyll.md b/test/_posts/2016-02-24-welcome-to-jekyll.md
index 521593642c60..bbfca0b9c9a6 100644
--- a/test/_posts/2016-02-24-welcome-to-jekyll.md
+++ b/test/_posts/2016-02-24-welcome-to-jekyll.md
@@ -8,9 +8,11 @@ tags:
   - update
 ---
 
-You'll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated.
+You'll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in [many different ways](https://jekyllrb.com/docs/usage/), but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated.
 
-To add new posts, simply add a file in the `_posts` directory that follows the convention `YYYY-MM-DD-name-of-post.ext` and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
+To add new posts, simply add a file in the `_posts`[^posts] directory that follows the convention `YYYY-MM-DD-name-of-post.ext` and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
+
+[^posts]: Footnote test.
 
 Jekyll also offers powerful support for code snippets:
 
diff --git a/test/_posts/2017-01-23-layout-header-video.md b/test/_posts/2017-01-23-layout-header-video.md
index 5b45e6c3de71..f1aab7490ca8 100644
--- a/test/_posts/2017-01-23-layout-header-video.md
+++ b/test/_posts/2017-01-23-layout-header-video.md
@@ -2,7 +2,7 @@
 title: "Layout: Header Video"
 header:
   video:
-    id: XsxDH4HcOWA
+    id: -PVofD2A9t8
     provider: youtube
 categories:
   - Layout
@@ -23,20 +23,20 @@ This post should display a **header with a responsive video**, if the theme supp
 
 ### YouTube
 
-To embed the following YouTube video at url `https://www.youtube.com/watch?v=XsxDH4HcOWA` (long version) or `https://youtu.be/XsxDH4HcOWA` (short version) into a post or page's main content you'd use: 
+To embed the following YouTube video at url `https://www.youtube.com/watch?v=-PVofD2A9t8` (long version) or `https://youtu.be/-PVofD2A9t8` (short version) into a post or page's main content you'd use: 
 
 ```liquid
-{% raw %}{% include video id="XsxDH4HcOWA" provider="youtube" %}{% endraw %}
+{% raw %}{% include video id="-PVofD2A9t8" provider="youtube" %}{% endraw %}
 ```
 
-{% include video id="XsxDH4HcOWA" provider="youtube" %}
+{% include video id="-PVofD2A9t8" provider="youtube" %}
 
 To embed it as a video header you'd use the following YAML Front Matter
 
 ```yaml
 header:
   video:
-    id: XsxDH4HcOWA
+    id: -PVofD2A9t8
     provider: youtube
 ```
 
diff --git a/test/_posts/2017-11-28-post-exclude-search.md b/test/_posts/2017-11-28-post-exclude-search.md
index 742bcb231fdf..cb5b55d83735 100644
--- a/test/_posts/2017-11-28-post-exclude-search.md
+++ b/test/_posts/2017-11-28-post-exclude-search.md
@@ -3,10 +3,27 @@ title:  "Exclude Post from Search Index"
 search: false
 categories: 
   - Jekyll
+last_modified_at: 2018-02-19T08:05:34-05:00
 ---
 
 This post should not appear in the search index because it has the following YAML Front Matter:
 
 ```yaml
 search: false
+```
+
+**Note:** `search: false` only works to exclude posts when using **Lunr** as a search provider.
+{: .notice--info}
+
+To exclude files when using **Algolia** as a search provider add an array to `algolia.files_to_exclude` in your `_config.yml`. For more configuration options be sure to check their [full documentation](https://community.algolia.com/jekyll-algolia/options.html).
+
+```yaml
+algolia:
+  # Exclude more files from indexing
+  files_to_exclude:
+    - index.html
+    - index.md
+    - excluded-file.html
+    - _posts/2017-11-28-post-exclude-search.md
+    - subdirectory/*.html
 ```
\ No newline at end of file
diff --git a/test/assets/images/apple-touch-icon.png b/test/assets/images/apple-touch-icon.png
new file mode 100644
index 000000000000..51f879190642
Binary files /dev/null and b/test/assets/images/apple-touch-icon.png differ
diff --git a/test/index.html b/test/index.html
index b95bb1f56f4c..98d8242ce999 100644
--- a/test/index.html
+++ b/test/index.html
@@ -2,3 +2,5 @@
 layout: home
 author_profile: true
 ---
+
+
This text should appear above the recent posts.