From 8de5331a811b9aa8122a57664e1127d10f639836 Mon Sep 17 00:00:00 2001
From: Staticman
Date: Sat, 23 Jun 2018 23:42:58 +0100
Subject: [PATCH 001/176] New comment (#1715)
---
.../comments/welcome-to-jekyll/comment-1529792272424.yml | 7 +++++++
1 file changed, 7 insertions(+)
create mode 100644 docs/_data/comments/welcome-to-jekyll/comment-1529792272424.yml
diff --git a/docs/_data/comments/welcome-to-jekyll/comment-1529792272424.yml b/docs/_data/comments/welcome-to-jekyll/comment-1529792272424.yml
new file mode 100644
index 000000000000..13289e6fa054
--- /dev/null
+++ b/docs/_data/comments/welcome-to-jekyll/comment-1529792272424.yml
@@ -0,0 +1,7 @@
+_id: 44fe8b10-7733-11e8-a9b3-5b9ff79eceda
+message: "Hey Michael,\r\nI was using your theme and found out that I cant use the collapsible markdown feature. Could you please let me know if there is any solution to this ? Eg code is below\r\n\r\n## collapsible markdown?\r\n\r\nCLICK ME\r\n
\r\n\r\n#### yes, even hidden code blocks!\r\n\r\n```python\r\nprint(\"hello world!\")\r\n```\r\n\r\n
\r\n"
+name: VIpin Kumar
+email: eeafc03a07852a239754fb68cca903b3
+url: ''
+hidden: ''
+date: '2018-06-23T22:17:52.423Z'
From fc3e7a61769253f10d325525b0a7a334166f49ac Mon Sep 17 00:00:00 2001
From: Staticman
Date: Sat, 23 Jun 2018 23:47:26 +0100
Subject: [PATCH 002/176] New comment (#1716)
---
.../comments/welcome-to-jekyll/comment-1529794012288.yml | 9 +++++++++
1 file changed, 9 insertions(+)
create mode 100644 docs/_data/comments/welcome-to-jekyll/comment-1529794012288.yml
diff --git a/docs/_data/comments/welcome-to-jekyll/comment-1529794012288.yml b/docs/_data/comments/welcome-to-jekyll/comment-1529794012288.yml
new file mode 100644
index 000000000000..0a749b8b1d99
--- /dev/null
+++ b/docs/_data/comments/welcome-to-jekyll/comment-1529794012288.yml
@@ -0,0 +1,9 @@
+_id: 5217d3c0-7737-11e8-a9b3-5b9ff79eceda
+message: >-
+ You're mixing Markdown inside of HTML elements, which is why it's not working.
+ Look at Kramdown's documentation as they have ways of enabling it I believe.
+name: Michael Rose
+email: 1ce71bc10b86565464b612093d89707e
+url: 'https://mademistakes.com'
+hidden: ''
+date: '2018-06-23T22:46:52.287Z'
From 8d2625bdf2cbb21899db2f2c8a3b18dd858f6d4b Mon Sep 17 00:00:00 2001
From: Flohw
Date: Tue, 10 Jul 2018 21:59:12 +0200
Subject: [PATCH 003/176] Update french labels (#1741)
---
_data/ui-text.yml | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/_data/ui-text.yml b/_data/ui-text.yml
index 327f6c0b65b5..412abeaf88ca 100644
--- a/_data/ui-text.yml
+++ b/_data/ui-text.yml
@@ -105,7 +105,7 @@ fr: &DEFAULT_FR
pagination_next : "Suivant"
breadcrumb_home_label : "Accueil"
breadcrumb_separator : "/"
- menu_label :
+ menu_label : "Menu"
toc_label : "Sur cette page"
ext_link_label : "Lien direct"
less_than : "moins de"
@@ -116,7 +116,7 @@ fr: &DEFAULT_FR
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"
@@ -126,7 +126,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é."
From f1231ce2435d04bc001ec92268d7a9adbdd6df7a Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 10 Jul 2018 16:00:25 -0400
Subject: [PATCH 004/176] Update CHANGELOG and history
---
CHANGELOG.md | 6 ++++++
docs/_docs/18-history.md | 8 +++++++-
2 files changed, 13 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 995f0b50ca25..27bdbd4b899b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## Unreleased
+
+### Enhancements
+
+* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
+
## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0)
### Enhancements
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index fe6f4f60f31d..30338074cd0b 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,10 +4,16 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-06-22T16:19:35-04:00
+last_modified_at: 2018-07-10T16:00:16-04:00
toc: true
---
+## Unreleased
+
+### Enhancements
+
+* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
+
## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0)
### Enhancements
From a3fe9487cea88bc6b33e4a0cca41f338d541f71c Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Thu, 19 Jul 2018 11:26:33 -0400
Subject: [PATCH 005/176] Add note about updating Gemfile when forking theme
---
CHANGELOG.md | 1 +
docs/_docs/01-quick-start-guide.md | 5 ++++-
docs/_docs/18-history.md | 3 ++-
3 files changed, 7 insertions(+), 2 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 27bdbd4b899b..eac2a6888bc8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+* Add documentation note to update root `Gemfile` when forking theme.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0)
diff --git a/docs/_docs/01-quick-start-guide.md b/docs/_docs/01-quick-start-guide.md
index a63cc30710ce..f3bd9c1158b3 100644
--- a/docs/_docs/01-quick-start-guide.md
+++ b/docs/_docs/01-quick-start-guide.md
@@ -2,7 +2,7 @@
title: "Quick-Start Guide"
permalink: /docs/quick-start-guide/
excerpt: "How to quickly install and setup Minimal Mistakes for use with GitHub Pages."
-last_modified_at: 2018-03-20T15:58:49-04:00
+last_modified_at: 2018-07-19T11:25:25-04:00
redirect_from:
- /theme-setup/
toc: true
@@ -96,6 +96,9 @@ If you forked or downloaded the `minimal-mistakes-jekyll` repo you can safely re
- `screenshot-layouts.png`
- `screenshot.png`
+**Note:** If forking the theme be sure to update `Gemfile` as well. The one found at the root of the project is for building the theme's Ruby gem and is missing dependencies. To properly setup a [`Gemfile`](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/Gemfile) with the theme, consult the "[Install Dependencies](https://mmistakes.github.io/minimal-mistakes/docs/installation/)" section.
+{: .notice--warning}
+
## Setup Your Site
Depending on the path you took installing Minimal Mistakes you'll setup things a little differently.
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 30338074cd0b..610c7ce67436 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-07-10T16:00:16-04:00
+last_modified_at: 2018-07-19T11:26:24-04:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+* Add documentation note to update root `Gemfile` when forking theme.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
## [4.12.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.0)
From 99f727138fb54f18769b0ff3c8478a2c4463ccb5 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Thu, 19 Jul 2018 11:31:49 -0400
Subject: [PATCH 006/176] Fix link
---
docs/_docs/01-quick-start-guide.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/_docs/01-quick-start-guide.md b/docs/_docs/01-quick-start-guide.md
index f3bd9c1158b3..fb62d7d5365a 100644
--- a/docs/_docs/01-quick-start-guide.md
+++ b/docs/_docs/01-quick-start-guide.md
@@ -2,7 +2,7 @@
title: "Quick-Start Guide"
permalink: /docs/quick-start-guide/
excerpt: "How to quickly install and setup Minimal Mistakes for use with GitHub Pages."
-last_modified_at: 2018-07-19T11:25:25-04:00
+last_modified_at: 2018-07-19T11:31:38-04:00
redirect_from:
- /theme-setup/
toc: true
@@ -96,7 +96,7 @@ If you forked or downloaded the `minimal-mistakes-jekyll` repo you can safely re
- `screenshot-layouts.png`
- `screenshot.png`
-**Note:** If forking the theme be sure to update `Gemfile` as well. The one found at the root of the project is for building the theme's Ruby gem and is missing dependencies. To properly setup a [`Gemfile`](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/Gemfile) with the theme, consult the "[Install Dependencies](https://mmistakes.github.io/minimal-mistakes/docs/installation/)" section.
+**Note:** If forking the theme be sure to update `Gemfile` as well. The one found at the root of the project is for building the theme's Ruby gem and is missing dependencies. To properly setup a [`Gemfile`](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/Gemfile) with the theme, consult the "[Install Dependencies](https://mmistakes.github.io/minimal-mistakes/docs/installation/#install-dependencies)" section.
{: .notice--warning}
## Setup Your Site
From 89d3cb3d02a35c91a74d841f2c3ba23e45afe581 Mon Sep 17 00:00:00 2001
From: Christian Oliff
Date: Tue, 24 Jul 2018 23:38:49 +0900
Subject: [PATCH 007/176] Update font awesome (#1754)
* Update scripts.html
* update to 5.2.0
REF: https://github.com/FortAwesome/Font-Awesome/releases
---
_includes/scripts.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_includes/scripts.html b/_includes/scripts.html
index 7169d99f011b..4c15d3251706 100644
--- a/_includes/scripts.html
+++ b/_includes/scripts.html
@@ -9,7 +9,7 @@
{% endfor %}
{% else %}
-
+
{% endif %}
{% if site.search == true or page.layout == "search" %}
From 9cfa4865fd5a755794a0994ccd0520ab5212fc3c Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 24 Jul 2018 10:40:02 -0400
Subject: [PATCH 008/176] Update CHANGELOG and history
---
CHANGELOG.md | 1 +
docs/_docs/18-history.md | 5 +++--
2 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index eac2a6888bc8..e06a665d6891 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+* 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.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 610c7ce67436..e234190c55fc 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-07-19T11:26:24-04:00
+last_modified_at: 2018-07-24T10:39:51-04:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+* 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.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
@@ -25,7 +26,7 @@ toc: true
* 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)
+* 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)
From 3c48a2ed02e7c90250d579d9345beab5e01e1abd Mon Sep 17 00:00:00 2001
From: Brian Exelbierd
Date: Tue, 24 Jul 2018 16:43:54 +0200
Subject: [PATCH 009/176] Allow time to be shown with a header image overlay
(#1756)
Fix `read_time` logic in header image overlay
---
_includes/page__hero.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_includes/page__hero.html b/_includes/page__hero.html
index 61d4cf418eb7..c05b346b9164 100644
--- a/_includes/page__hero.html
+++ b/_includes/page__hero.html
@@ -45,7 +45,7 @@
{% if page.header.show_overlay_excerpt != false and page.excerpt %}
{{ page.excerpt | markdownify | remove: "
" | remove: "
" }}
{% endif %}
- {% if site.read_time and page.read_time %}
+ {% if page.read_time %}
{% include read-time.html %}
{% endif %}
{% if page.header.cta_url %}
From 120ba7a0b0035c282e022bb0a1148774b8651636 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 24 Jul 2018 10:44:39 -0400
Subject: [PATCH 010/176] Update CHANGELOG and history
---
CHANGELOG.md | 4 ++++
docs/_docs/18-history.md | 6 +++++-
2 files changed, 9 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e06a665d6891..7ff254dff73a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,10 @@
* Add documentation note to update root `Gemfile` when forking theme.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
+### Bug Fixes
+
+* 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
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index e234190c55fc..70cba0cf8c13 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-07-24T10:39:51-04:00
+last_modified_at: 2018-07-24T10:44:32-04:00
toc: true
---
@@ -16,6 +16,10 @@ toc: true
* Add documentation note to update root `Gemfile` when forking theme.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
+### Bug Fixes
+
+* 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
From c427b9bd394100f7696e28f8b0165444d8d21025 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gasser=20Lo=C3=AFc?=
Date: Tue, 7 Aug 2018 15:49:00 -0400
Subject: [PATCH 011/176] Add french translations (#1769)
---
_data/ui-text.yml | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/_data/ui-text.yml b/_data/ui-text.yml
index 412abeaf88ca..7177db4f03f0 100644
--- a/_data/ui-text.yml
+++ b/_data/ui-text.yml
@@ -109,7 +109,7 @@ fr: &DEFAULT_FR
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 :"
@@ -137,6 +137,9 @@ 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_placeholder_text : "Entrez votre recherche..."
+ results_found : "Aucun résultat trouvé"
+ back_to_top : "Retour en haut"
fr-FR:
<<: *DEFAULT_FR
fr-BE:
From 2be90f8f4aa959e3170a60d352923f81fe28504d Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 7 Aug 2018 15:50:53 -0400
Subject: [PATCH 012/176] Update CHANGELOG and history
---
CHANGELOG.md | 1 +
docs/_docs/18-history.md | 3 ++-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7ff254dff73a..b95773c1e24b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+* Add missing French localized UI text strings. [#1769](https://github.com/mmistakes/minimal-mistakes/pull/1769)
* 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.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 70cba0cf8c13..c545d9cf7f46 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-07-24T10:44:32-04:00
+last_modified_at: 2018-08-07T15:50:40-04:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+* Add missing French localized UI text strings. [#1769](https://github.com/mmistakes/minimal-mistakes/pull/1769)
* 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.
* Add missing French translations. [#1741](https://github.com/mmistakes/minimal-mistakes/pull/1741)
From 858b5cc2a4d5f1820af8c6e654ff4121f8f04827 Mon Sep 17 00:00:00 2001
From: genghisun
Date: Wed, 8 Aug 2018 03:52:32 +0800
Subject: [PATCH 013/176] remove the slash at the beginning of the 'path' in
staticman.yml's example (#1772)
---
docs/_docs/05-configuration.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md
index 53caa39c8986..63843e18e25a 100644
--- a/docs/_docs/05-configuration.md
+++ b/docs/_docs/05-configuration.md
@@ -376,7 +376,7 @@ comments:
options:
format : "iso8601"
moderation : true
- path : "/_data/comments/{options.slug}" (default)
+ path : "_data/comments/{options.slug}"
requiredFields : ["name", "email", "message"]
transforms:
email : md5
From ecd17482472550e076315c3e4b4c308b6d741558 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 7 Aug 2018 15:55:19 -0400
Subject: [PATCH 014/176] Remove slash at the beginning of `path` in
staticman.yml example
---
CHANGELOG.md | 1 +
docs/_docs/18-history.md | 3 ++-
staticman.yml | 2 +-
3 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b95773c1e24b..eb0d330db3a2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@
### 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)
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index c545d9cf7f46..0fb704914829 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-08-07T15:50:40-04:00
+last_modified_at: 2018-08-07T15:55:09-04:00
toc: true
---
@@ -19,6 +19,7 @@ toc: true
### 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)
diff --git a/staticman.yml b/staticman.yml
index c8e0ec5c2583..ef88f093441a 100644
--- a/staticman.yml
+++ b/staticman.yml
@@ -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.
From 4cfbede6e417bc424235849623191f6b72657d53 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 7 Aug 2018 22:54:25 -0400
Subject: [PATCH 015/176] Bump dependencies
---
minimal-mistakes-jekyll.gemspec | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/minimal-mistakes-jekyll.gemspec b/minimal-mistakes-jekyll.gemspec
index 113cce0f0bc9..d53303744dc7 100644
--- a/minimal-mistakes-jekyll.gemspec
+++ b/minimal-mistakes-jekyll.gemspec
@@ -15,14 +15,14 @@ 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"
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-sitemap", "~> 1.2"
+ spec.add_runtime_dependency "jekyll-gist", "~> 1.5"
+ spec.add_runtime_dependency "jekyll-feed", "~> 0.10"
spec.add_runtime_dependency "jekyll-data", "~> 1.0"
- spec.add_runtime_dependency "jemoji", "~> 0.8"
+ spec.add_runtime_dependency "jemoji", "~> 0.10"
- spec.add_development_dependency "bundler", "~> 1.12"
+ spec.add_development_dependency "bundler", "~> 1.15"
spec.add_development_dependency "rake", "~> 10.0"
end
From 77601086019829fbcd2edf4fc133d8a0f29ceb6c Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 7 Aug 2018 22:59:46 -0400
Subject: [PATCH 016/176] =?UTF-8?q?Release=204.12.1=20=F0=9F=92=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
CHANGELOG.md | 2 +-
_layouts/default.html | 2 +-
_sass/minimal-mistakes.scss | 2 +-
assets/js/main.min.js | 10 +++++-----
docs/_docs/18-history.md | 4 ++--
docs/_layouts/default.html | 2 +-
docs/_pages/home.md | 2 +-
minimal-mistakes-jekyll.gemspec | 2 +-
package.json | 4 ++--
9 files changed, 15 insertions(+), 15 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb0d330db3a2..5d3d43fcd568 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,4 @@
-## Unreleased
+## [4.12.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.12.1)
### Enhancements
diff --git a/_layouts/default.html b/_layouts/default.html
index 822e24eb0ac6..21fe9126ca93 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -3,7 +3,7 @@
-
-
{% endfor %}
-{% endif %}
\ No newline at end of file
+{% endif %}
From a5e96659a0886906ff235b5c3a3034fdcf81a6aa Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 16 Sep 2018 18:17:37 -0400
Subject: [PATCH 072/176] Update CHANGELOG and history
---
CHANGELOG.md | 1 +
docs/_docs/18-history.md | 3 ++-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6a12d6c9fee5..a05e7c8fd41c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+- Remove unneeded `HandheldFriendly` and `MobileOptimized` meta tags. [#1837](https://github.com/mmistakes/minimal-mistakes/pull/1837)
- Update Font Awesome to version `5.3.1`. [#1830](https://github.com/mmistakes/minimal-mistakes/pull/1830)
- Always load Google 404 Linkhelp script over HTTPS. [#1829](https://github.com/mmistakes/minimal-mistakes/pull/1829)
- Remove deprecated `base_path` include helper.
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index c05a6097eac7..335f9d6263bf 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-09-16T18:14:56-04:00
+last_modified_at:2018-09-16T18:17:29-04:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+- Remove unneeded `HandheldFriendly` and `MobileOptimized` meta tags. [#1837](https://github.com/mmistakes/minimal-mistakes/pull/1837)
- Update Font Awesome to version `5.3.1`. [#1830](https://github.com/mmistakes/minimal-mistakes/pull/1830)
- Always load Google 404 Linkhelp script over HTTPS. [#1829](https://github.com/mmistakes/minimal-mistakes/pull/1829)
- Remove deprecated `base_path` include helper.
From 2f1b8f3321f39a0cb3b82428a9c21b69deb68212 Mon Sep 17 00:00:00 2001
From: Christian Oliff
Date: Mon, 17 Sep 2018 07:18:46 +0900
Subject: [PATCH 073/176] Update algolia-search-scripts.html (#1836)
not needed for HTML5 and saves a few bytes by removing
---
_includes/search/algolia-search-scripts.html | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/_includes/search/algolia-search-scripts.html b/_includes/search/algolia-search-scripts.html
index 1ec021df257e..ff9507b98ce4 100644
--- a/_includes/search/algolia-search-scripts.html
+++ b/_includes/search/algolia-search-scripts.html
@@ -1,7 +1,7 @@
-
-
+
+
-
+
{% endif %}
{% if site.search == true or page.layout == "search" %}
From 85237fda1e5303dee127f80b0c6ee223cd3422cc Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Tue, 13 Nov 2018 09:35:54 -0500
Subject: [PATCH 104/176] Update CHANGELOG and history
---
CHANGELOG.md | 2 +-
docs/_docs/18-history.md | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 615d511036f3..0d73b67e1cbe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,7 +10,7 @@
- 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.3.1`. [#1830](https://github.com/mmistakes/minimal-mistakes/pull/1830)
+- 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.
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 0f9b8f8d392a..3f72665d86a5 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-10-29T10:09:31-04:00
+last_modified_at: 2018-11-13T09:35:43-05:00
toc: true
---
@@ -20,7 +20,7 @@ toc: true
- 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.3.1`. [#1830](https://github.com/mmistakes/minimal-mistakes/pull/1830)
+- 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.
From d786c190c7399d101b8aa3c882ba64967fd881b4 Mon Sep 17 00:00:00 2001
From: Alex Malaszkiewicz
Date: Tue, 13 Nov 2018 15:37:14 +0100
Subject: [PATCH 105/176] Add rel attribute to social media links in author
profile and fotter (#1924)
---
_includes/author-profile-custom-links.html | 2 +-
_includes/author-profile.html | 48 +++++++++++-----------
_includes/footer.html | 2 +-
3 files changed, 26 insertions(+), 26 deletions(-)
diff --git a/_includes/author-profile-custom-links.html b/_includes/author-profile-custom-links.html
index cf86521afb4e..b89ffcb7df6c 100644
--- a/_includes/author-profile-custom-links.html
+++ b/_includes/author-profile-custom-links.html
@@ -1,6 +1,6 @@
+
{% when "custom" %}
{% endcase %}
diff --git a/docs/_config.yml b/docs/_config.yml
index 4f087b6dc996..cbe7238411b3 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -22,7 +22,7 @@ teaser : # path of fallback teaser image, e.g. "/assets/images
# breadcrumbs : false # true, false (default)
words_per_minute : 200
comments:
- provider : "staticman_v2" # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman_v2", "staticman" "custom"
+ provider : "staticman_v2" # false (default), "disqus", "discourse", "facebook", "google-plus", "staticman_v2", "staticman", "utterances", "custom"
disqus:
shortname :
discourse:
@@ -32,6 +32,8 @@ comments:
appid :
num_posts : # 5 (default)
colorscheme : # "light" (default), "dark"
+ utterances:
+ theme : # "github-light" (default), "github-dark"
staticman:
allowedFields : # ['name', 'email', 'url', 'message']
branch : "master"
diff --git a/docs/_docs/02-structure.md b/docs/_docs/02-structure.md
index a177c5728c67..5c7016364d8d 100644
--- a/docs/_docs/02-structure.md
+++ b/docs/_docs/02-structure.md
@@ -17,7 +17,7 @@ minimal-mistakes
| └── ui-text.yml # text used throughout the theme's UI
├── _includes
| ├── analytics-providers # snippets for analytics (Google and custom)
-| ├── comments-providers # snippets for comments (Disqus, Facebook, Google+, and custom)
+| ├── comments-providers # snippets for comments
| ├── footer # custom snippets to add to site footer
| ├── head # custom snippets to add to site head
| ├── feature_row # feature row helper
diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md
index a2413971f7c0..03fba71552aa 100644
--- a/docs/_docs/05-configuration.md
+++ b/docs/_docs/05-configuration.md
@@ -2,7 +2,7 @@
title: "Configuration"
permalink: /docs/configuration/
excerpt: "Settings for configuring and customizing the theme."
-last_modified_at: 2018-11-19T15:35:29-05:00
+last_modified_at: 2018-11-21T14:46:33-05:00
toc: true
---
@@ -274,7 +274,7 @@ To disable reading time for a post, add `read_time: false` its YAML Front Matter
### Comments
-[**Disqus**](https://disqus.com/), [**Discourse**](https://www.discourse.org/), [**Facebook**](https://developers.facebook.com/docs/plugins/comments), **Google+**, and static-based commenting via [**Staticman**](https://staticman.net/) are built into the theme. First set the comment provider you'd like to use:
+[**Disqus**](https://disqus.com/), [**Discourse**](https://www.discourse.org/), [**Facebook**](https://developers.facebook.com/docs/plugins/comments), **Google+**, [**utterances**](https://utteranc.es/), and static-based commenting via [**Staticman**](https://staticman.net/) are built into the theme. First set the comment provider you'd like to use:
| Name | Comment Provider |
| ---------------- | ------------------------- |
@@ -284,6 +284,7 @@ To disable reading time for a post, add `read_time: false` its YAML Front Matter
| **google-plus** | Google+ Comments |
| **staticman_v2** | Staticman v2 |
| **staticman** | Staticman v1 (deprecated) |
+| **utterances** | utterances |
| **custom** | Other |
Then add `comments: true` to each document you want comments visible on.
@@ -323,9 +324,9 @@ For guidance on how to set up Discourse for embedding comments from a topic on a
```yaml
comments:
- provider : "discourse"
+ provider: "discourse"
discourse:
- server : # meta.discourse.org
+ server: # meta.discourse.org
```
**Note:** Do not include `http://` or `https://` when setting your Discourse `server`. The theme automatically prepends the URL `//`, following a scheme-less pattern.
@@ -337,11 +338,31 @@ To enable Facebook Comments choose how many comments you'd like visible per post
```yaml
comments:
- provider : "facebook"
+ provider: "facebook"
facebook:
- appid : # optional
- num_posts : # 5 (default)
- colorscheme : # "light" (default), "dark"
+ appid: # optional
+ num_posts: # 5 (default)
+ colorscheme: # "light" (default), "dark"
+```
+
+#### utterances Comments
+
+To use utterances you will need to [install the app](https://github.com/apps/utterances) to your GitHub repository by adding the following to `_config.yml`:
+
+```yaml
+repository: # GitHub username/repo-name e.g. "mmistakes/minimal-mistakes"
+```
+
+**Note:** Make sure the repo is public, otherwise your readers will not be able to view the issues/comments. The [issues feature](https://guides.github.com/features/issues/) also needs to be active on your repo.
+{: .notice--warning}
+
+To enable utterances on the front end set `comments.provider` and the color theme of the widget.
+
+```yaml
+comments:
+ provider: "utterances"
+ utterances:
+ theme: "github-light" # "github-dark"
```
#### Static-Based Comments via Staticman
@@ -361,11 +382,11 @@ Transform user comments into `_data` files that live inside of your GitHub repos
##### Configure Staticman
-**Staticman v3**
+###### Staticman v3
Due to the support for GitLab, the URL scheme has been changed. Bewteen `v3` and `/entry`, one needs to input a Git service provider (either `github` or `gitlab`). Apart from that, the setup for GitHub remains the same.
-**Staticman v2**
+###### Staticman v2
Default settings have been provided in [`staticman.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/staticman.yml) and are commented to guide you through setup. View the [full list of configurations](https://staticman.net/docs/configuration).
@@ -406,7 +427,7 @@ comments:
**Note:** Staticman is currently compatible with GitHub and GitLab based repositories. [Support for GitLab Pages](https://github.com/eduardoboucas/staticman/issues/22) is already available at [Staticman v3](https://github.com/eduardoboucas/staticman/pull/219).
{: .notice--warning}
-**Staticman v1 (deprecated)**
+###### Staticman v1 (deprecated)
Default settings have been provided in `_config.yml`. The important ones to set are `provider: "staticman"`, `branch`, and `path`. View the [full list of configurations](https://staticman.net/docs/configuration).
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index fa2f2983f00e..2156a816b3c2 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-11-21T14:16:10-05:00
+last_modified_at: 2018-11-21T14:55:38-05:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+- 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.
diff --git a/docs/_pages/about.md b/docs/_pages/about.md
index 7a669687a03b..10cb1fb47f36 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-06-04T12:04:24-04:00
+last_modified_at: 2018-11-21T14:49:33-05:00
toc: true
---
@@ -31,7 +31,7 @@ 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), Google+, [Discourse](https://www.discourse.org/), [utterances](https://utteranc.es/), static-based via [Staticman v1 and v2](https://staticman.net/), and custom).
- [Google Analytics](https://www.google.com/analytics/) support.
- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ) Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
diff --git a/test/_config.yml b/test/_config.yml
index 331a33d38cc8..412c01819bc2 100644
--- a/test/_config.yml
+++ b/test/_config.yml
@@ -21,7 +21,7 @@ teaser : # path of fallback teaser image, e.g. "/assets/images
# 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", "google-plus", "staticman", "utterances", "custom"
disqus:
shortname : # https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname-
discourse:
@@ -31,6 +31,8 @@ comments:
appid :
num_posts : # 5 (default)
colorscheme : # "light" (default), "dark"
+ utterances:
+ theme : # "github-light" (default), "github-dark"
staticman:
allowedFields : ['name', 'email', 'url', 'message']
branch : # "master", "gh-pages"
From b2b66378ac35d200022fa4f7ac87906e80d8d190 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Wed, 21 Nov 2018 15:16:11 -0500
Subject: [PATCH 118/176] Update localized text list
---
README.md | 2 +-
docs/_pages/about.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index b53938933dfb..135e3d0067a1 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
- Optional [header images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#headers), [custom sidebars](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#sidebars), [table of contents](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#table-of-contents), [galleries](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery), related posts, [breadcrumb links](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#breadcrumb-navigation-beta), [navigation lists](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list), and more.
- Commenting support (powered by [Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), Google+, [Discourse](https://www.discourse.org/), static-based via [Staticman v1 and v2](https://staticman.net/), and custom).
- [Google Analytics](https://www.google.com/analytics/) support.
-- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
+- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hindi, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
## Skins (Color Variations)
diff --git a/docs/_pages/about.md b/docs/_pages/about.md
index 10cb1fb47f36..142e3e87dabd 100644
--- a/docs/_pages/about.md
+++ b/docs/_pages/about.md
@@ -33,7 +33,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
- 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/), [utterances](https://utteranc.es/), static-based via [Staticman v1 and v2](https://staticman.net/), and custom).
- [Google Analytics](https://www.google.com/analytics/) support.
-- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ) Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
+- UI localized text in English (default), Brazilian Portuguese (Português brasileiro), Chinese, Danish, Dutch, French (Français), German (Deutsch), Greek, Hindi, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
## Demo Pages
From e24e25965073336bbae3dfb537e9055a6e33b025 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 19:02:37 -0500
Subject: [PATCH 119/176] Update README.md
---
README.md | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index 135e3d0067a1..d180dac59319 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,14 @@
[![Ruby gem](https://img.shields.io/gem/v/minimal-mistakes-jekyll.svg)](https://rubygems.org/gems/minimal-mistakes-jekyll)
[![Tip Me via PayPal](https://img.shields.io/badge/PayPal-tip%20me-green.svg?logo=paypal)](https://www.paypal.me/mmistakes)
-Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your personal site, blog, or portfolio on GitHub or self-hosting on your own server. As the name implies -- styling is purposely minimalistic to be enhanced and customized by you :smile:.
+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).
+**If you enjoy this theme, please consider [supporting me](https://www.paypal.me/mmistakes) for developing and maintaining it.**
+
+[![Support via PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.me/mmistakes)
+
**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.
[![Minimal Mistakes live preview][2]][1]
@@ -20,14 +24,14 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
## 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/), and [utterances](https://utteranc.es/)).
- [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, Hindi, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
From e4af8a40363141b2c3d44bc435e28c15e744840e Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 19:48:19 -0500
Subject: [PATCH 120/176] Update theme documentation
---
README.md | 30 ++++---
docs/_docs/01-quick-start-guide.md | 74 ++++++++---------
docs/_docs/03-installation.md | 12 +--
docs/_docs/04-upgrading.md | 12 +--
docs/_docs/05-configuration.md | 122 +++++++++++++----------------
docs/_docs/07-navigation.md | 6 +-
docs/_docs/10-layouts.md | 40 +++++-----
docs/_docs/14-helpers.md | 12 +--
docs/_docs/15-utility-classes.md | 6 +-
docs/_docs/16-stylesheets.md | 18 ++---
docs/_docs/17-javascript.md | 2 +-
docs/_docs/19-contributing.md | 2 +-
12 files changed, 169 insertions(+), 167 deletions(-)
diff --git a/README.md b/README.md
index d180dac59319..818f4f1d6774 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# [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)
[![Jekyll](https://img.shields.io/badge/jekyll-%3E%3D%203.6-blue.svg)](https://jekyllrb.com/)
@@ -22,7 +22,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building per
![layout examples](screenshot-layouts.png)
-## Notable Features
+## Notable features
- Bundled as a "theme gem" for easier installation/upgrading.
- Compatible with GitHub Pages.
@@ -35,7 +35,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building per
- [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, Hindi, Hungarian, Indonesian, Italian (Italiano), Japanese, Korean, Nepali (Nepalese), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Turkish (Türkçe), and Vietnamese.
-## Skins (Color Variations)
+## Skins (color variations)
This theme comes in nine different skins (including the default one).
@@ -51,7 +51,7 @@ This theme comes in nine different skins (including the default one).
| --- | --- | --- |
| ![aqua skin](https://mmistakes.github.io/minimal-mistakes/assets/images/aqua-skin-archive.png) | ![neon skin](https://mmistakes.github.io/minimal-mistakes/assets/images/neon-skin-archive.png) | ![plum skin](https://mmistakes.github.io/minimal-mistakes/assets/images/plum-skin-archive.png) |
-## Demo Pages
+## Demo pages
| Name | Description |
| ------------------------------------------- | ----------------------------------------------------- |
@@ -76,11 +76,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.
-### Ruby Gem Method
+### Gem-based method
-1. Install the theme as a Ruby Gem by adding it to your `Gemfile` like so:
+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.
+
+This allows for easier installation and updating as you don't have to manage any of the theme files. To install:
+
+1. Add the following to your `Gemfile`:
```ruby
gem "minimal-mistakes-jekyll"
@@ -100,7 +104,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:
@@ -110,13 +118,15 @@ To update the theme run `bundle update`.
gem "github-pages", 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](http://bundler.io/) command:
```bash
bundle
```
-3. Add `remote_theme: "mmistakes/minimal-mistakes"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
+4. Add `remote_theme: "mmistakes/minimal-mistakes@4.13.0"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
## Usage
diff --git a/docs/_docs/01-quick-start-guide.md b/docs/_docs/01-quick-start-guide.md
index 6110443db96a..d11b54b137ee 100644
--- a/docs/_docs/01-quick-start-guide.md
+++ b/docs/_docs/01-quick-start-guide.md
@@ -2,15 +2,15 @@
title: "Quick-Start Guide"
permalink: /docs/quick-start-guide/
excerpt: "How to quickly install and setup Minimal Mistakes for use with GitHub Pages."
-last_modified_at: 2018-11-18T12:59:42-05:00
+last_modified_at: 2018-11-25T19:29:40-05:00
redirect_from:
- /theme-setup/
toc: true
---
-Minimal Mistakes has been developed as a [Jekyll theme gem](http://jekyllrb.com/docs/themes/) for easier use. It is also 100% compatible with GitHub Pages --- just with slightly different installation process.
+Minimal Mistakes has been developed as a [Gem-based theme](http://jekyllrb.com/docs/themes/) for easier use. It is also 100% compatible with GitHub Pages when used as a remote theme.
-## Installing the Theme
+## Installing the theme
If you're running Jekyll v3.5+ and self-hosting you can quickly install the theme as a Ruby gem.
@@ -22,53 +22,57 @@ If you're running Jekyll v3.5+ and self-hosting you can quickly install the them
**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.
{: .notice--warning}
-### Ruby Gem Method
+### Gem-based method
-Add this line to your Jekyll site's `Gemfile`:
+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. This allows for easier installation and updating as you don't have to manage any of the theme files.
-```ruby
-gem "minimal-mistakes-jekyll"
-```
+To install as a Gem-based theme:
-Add these lines to your Jekyll site's `_config.yml` file:
+1. Add the following to your `Gemfile`:
-```yaml
-theme: minimal-mistakes-jekyll
+ ```ruby
+ gem "minimal-mistakes-jekyll"
+ ```
-plugins:
- - jekyll-include-cache
-```
+2. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
-Then run Bundler to install the theme gem and dependencies:
+ ```bash
+ bundle
+ ```
-```bash
-bundle install
-```
+3. Set the `theme` in your project's Jekyll `_config.yml` file:
-### GitHub Pages Method
+ ```yaml
+ theme: minimal-mistakes-jekyll
+ ```
-GitHub Pages has added [full support](https://github.com/blog/2464-use-any-theme-with-github-pages) for any GitHub-hosted theme.
+To update the theme run `bundle update`.
-Replace `gem "jekyll"` with:
-
-```ruby
-gem "github-pages", group: :jekyll_plugins
-```
+### Remote theme method
-Add `gem "jekyll-include-cache"`
-
-Run `bundle update` and verify that all gems install properly.
+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.
-Add `remote_theme: "mmistakes/minimal-mistakes"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
+To install as a remote theme:
-Add `jekyll-include-cache` to `plugins` like so:
+1. Create/replace the contents of your `Gemfile` with the following:
-```yaml
-plugins:
- - jekyll-include-cache
-```
+ ```ruby
+ source "https://rubygems.org"
+
+ gem "github-pages", group: :jekyll_plugins
+ ```
+
+2. Add `jekyll-include-cache` to the `plugins` array of your `_config.yml`.
+
+3. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
+
+ ```bash
+ bundle
+ ```
+
+4. Add `remote_theme: "mmistakes/minimal-mistakes@4.13.0"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
-You may also optionally specify a branch, [tag](https://github.com/mmistakes/minimal-mistakes/tags), or commit to use by appending an @ and the Git ref (e.g., `mmistakes/minimal-mistakes@4.9.0` or `mmistakes/minimal-mistakes@bbf3cbc5fd64a3e1885f3f99eb90ba92af84063d`). If you don't specify a Git ref, the master branch will be used.
+You may also optionally specify a branch, [tag](https://github.com/mmistakes/minimal-mistakes/tags), or commit to use by appending an @ and the Git ref (e.g., `mmistakes/minimal-mistakes@4.9.0` or `mmistakes/minimal-mistakes@bbf3cbc5fd64a3e1885f3f99eb90ba92af84063d`). This is useful when rolling back to older versions of the theme. If you don't specify a Git ref, the latest on `master` will be used.
---
diff --git a/docs/_docs/03-installation.md b/docs/_docs/03-installation.md
index 10e4748d1e9c..14e0afa76645 100644
--- a/docs/_docs/03-installation.md
+++ b/docs/_docs/03-installation.md
@@ -2,19 +2,19 @@
title: "Installation"
permalink: /docs/installation/
excerpt: "Instructions for installing the theme for new and existing Jekyll based sites."
-last_modified_at: 2018-10-04T20:16:07-04:00
+last_modified_at: 2018-11-25T19:32:34-05:00
toc: true
---
-## Install the Theme
+## Install the theme
-**1.** For a **new site**, install the `minimal-mistakes-jekyll` theme gem or fork the Minimal Mistakes repo on GitHub following the steps outlined in the [*Quick-Start Guide*]({{ "/docs/quick-start-guide/" | relative_url }}).
+**1.** For a **new site**, install the `minimal-mistakes-jekyll` gem, remote theme, or fork the Minimal Mistakes repo on GitHub following the steps outlined in the [*Quick-Start Guide*]({{ "/docs/quick-start-guide/" | relative_url }}).
If you plan to host with GitHub Pages be sure to properly setup [**jekyll-remote-theme**](https://github.com/benbalter/jekyll-remote-theme) as it is required for the theme to work properly.
**2.** For an **existing site** follow the steps outlined in the [*Quick-Start Guide*]({{ "/docs/quick-start-guide/" | relative_url }}). Then work through the guidelines below for migration and setup.
-**3.** And for those who'd like to make substantial edits to the theme, it can be downloaded as a ZIP file to customize.
+**3.** For those who'd like to make substantial edits to the theme, download as a ZIP file to customize.
[ Download Minimal Mistakes Theme](https://github.com/mmistakes/minimal-mistakes/archive/master.zip){: .btn .btn--success}
@@ -24,7 +24,7 @@ If you plan to host with GitHub Pages be sure to properly setup [**jekyll-remote
**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.
{: .notice--warning}
-## Theme Migration
+## Theme migration
To move over any existing content you'll want to copy the contents of your `_posts` folder to the new site. Along with any pages, collections, data files, images, or other assets you may have.
@@ -51,7 +51,7 @@ defaults:
**Post/Page Settings**: Be sure to read through the "Working with..." documentation to learn about all the options available to you. The theme has been designed to be flexible --- with numerous settings for each.
{: .notice--info}
-## Install Dependencies
+## Install dependencies
If this is your first time using Jekyll be sure to read through the [official documentation](https://jekyllrb.com/docs/home/) before jumping in. This guide assumes you have Ruby v2 installed and a basic understanding of how Jekyll works.
diff --git a/docs/_docs/04-upgrading.md b/docs/_docs/04-upgrading.md
index 327883dc8536..d5fa65b4571f 100644
--- a/docs/_docs/04-upgrading.md
+++ b/docs/_docs/04-upgrading.md
@@ -2,7 +2,7 @@
title: "Upgrading"
permalink: /docs/upgrading/
excerpt: "Instructions and suggestions for upgrading the theme."
-last_modified_at: 2018-03-20T15:59:07-04:00
+last_modified_at: 2018-11-25T19:38:20-05:00
toc: true
---
@@ -33,11 +33,11 @@ gem "minimal-mistakes-jekyll", :git => "https://github.com/mmistakes/minimal-mis
For more information on [installing gems from git repositories](http://bundler.io/v1.16/guides/git.html) consult Bundler's documentation.
-## Remote Theme
+## Remote theme
-When setting `remote_theme: "mmistakes/minimal-mistakes"` in your `_config.yml` you may also optionally specify a branch, [tag](https://github.com/mmistakes/minimal-mistakes/tags), or commit to use by appending an @ and the Git ref.
+When setting `remote_theme: "mmistakes/minimal-mistakes@4.13.0"` in your `_config.yml` you may also optionally specify a branch, [tag](https://github.com/mmistakes/minimal-mistakes/tags), or commit to use by appending an @ and the Git ref.
-For example you can roll back to release 4.8.1 with `mmistakes/minimal-mistakes@4.8.1` or a specific commit with `mmistakes/minimal-mistakes@bbf3cbc5fd64a3e1885f3f99eb90ba92af84063d`).
+For example you can roll back to release 4.8.1 with `mmistakes/minimal-mistakes@4.8.1` or a specific commit with `mmistakes/minimal-mistakes@bbf3cbc5fd64a3e1885f3f99eb90ba92af84063d`). For a complete list of theme versions consult the [releases page](https://github.com/mmistakes/minimal-mistakes/releases).
To update the theme on GitHub Pages you'll need to push up a commit to force a rebuild. An empty commit works well if you don't have anything to push at the moment:
@@ -57,7 +57,7 @@ To add it you can do the following:
git remote add upstream https://github.com/{{ site.repository }}.git
```
-### Pull Down Updates
+### Pull down updates
Now you can pull any commits made to theme's `master` branch with:
@@ -67,7 +67,7 @@ git pull upstream master
Depending on the amount of customizations you've made after forking, there's likely to be merge conflicts. Work through any conflicting files Git flags, staging the changes you wish to keep, and then commit them.
-## Update Files Manually
+## Update files manually
Another way of dealing with updates is [downloading the theme](https://github.com/{{ site.repository }}/archive/master.zip) --- replacing your layouts, includes, and assets with the newer ones manually. To be sure that you don't miss any changes it's probably a good idea to review the theme's [commit history](https://github.com/{{ site.repository }}/commits/master) to see what's changed since.
diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md
index 03fba71552aa..2fd1ebeec2c9 100644
--- a/docs/_docs/05-configuration.md
+++ b/docs/_docs/05-configuration.md
@@ -2,7 +2,7 @@
title: "Configuration"
permalink: /docs/configuration/
excerpt: "Settings for configuring and customizing the theme."
-last_modified_at: 2018-11-21T14:46:33-05:00
+last_modified_at: 2018-11-25T19:42:42-05:00
toc: true
---
@@ -13,7 +13,7 @@ Settings that affect your entire site can be changed in [Jekyll's configuration
Take a moment to look over the configuration file included with the theme. Comments have been added to provide examples and default values for most settings. Detailed explanations of each can be found below.
-## Site Settings
+## Site settings
### Theme
@@ -46,42 +46,34 @@ minimal_mistakes_skin: "default" # "air", "aqua", "contrast", "dark", "dirt", "n
#### Aqua skin: `aqua`
-{:.no_toc}
-
#### Contrast skin: `contrast`
-{:.no_toc}
-
#### Dark skin: `dark`
-{:.no_toc}
-
#### Dirt skin: `dirt`
-{:.no_toc}
-
#### Mint skin: `mint`
@@ -89,42 +81,36 @@ minimal_mistakes_skin: "default" # "air", "aqua", "contrast", "dark", "dirt", "n
{:.no_toc}
#### Neon skin: `neon`
-{:.no_toc}
-
#### Neon skin: `plum`
-{:.no_toc}
-
#### Sunrise skin: `sunrise`
-{:.no_toc}
-
-### Site Locale
+### Site locale
`site.locale` is used to declare the primary language for each web page within the site.
@@ -135,7 +121,7 @@ Properly setting the locale is important for associating localized text found in
**Note:** The theme comes with localized text in English (`en`, `en-US`, `en-GB`). If you change `locale` in `_config.yml` to something else, most of the UI text will go blank. Be sure to add the corresponding locale key and translated text to `_data/ui-text.yml` to avoid this.
{: .notice--warning}
-### Site Title
+### Site title
The name of your site. Is used throughout the theme in places like the site masthead and `` tags.
@@ -148,7 +134,7 @@ _Example:_ `title_separator: "|"` would produce page titles like `Sample Page |
**Note:** Long site titles have been known to break the masthead layout. Avoid adding a long "tagline" to the title prevent this from happening eg. `My Awesome Site is the Best Because I Say So".
{: .notice--warning}
-### Site Name
+### Site name
Used to assign a site author. Don't worry, you can override the site author with different ones on specific posts, pages, or collection documents.
@@ -157,7 +143,7 @@ _Example:_ `name: "Michael Rose"`.
**ProTip:** If you want to get crafty with your YAML you can use [anchors](http://www.yaml.org/spec/1.2/spec.html#id2785586) to reuse values. For example `foo: &var "My String"` allows you to reuse `"My String"` elsewhere in `_config.yml` like so... `bar: *var`. You'll see a few examples of this in the provided Jekyll config.
{: .notice--info}
-### Site Description
+### Site description
Fairly obvious. `site.description` describes the site. Used predominantly in meta descriptions for improving SEO.
@@ -172,7 +158,7 @@ GitHub Pages now [forces `https://` for new sites](https://help.github.com/artic
**Note:** Jekyll 3.3 overrides this value with `url: http://localhost:4000` when running `jekyll serve` locally in development. If you want to avoid this behavior set `JEKYLL_ENV=production` to [force the environment](http://jekyllrb.com/docs/configuration/#specifying-a-jekyll-environment-at-build-time) to production.
{: .notice--warning}
-### Site Base URL
+### Site base URL
This little option causes all kinds of confusion in the Jekyll community. If you're not hosting your site as a GitHub Pages Project or in a subfolder (eg: `/blog`), then don't mess with it.
@@ -183,7 +169,7 @@ For more information on how to properly use `site.url` and `site.baseurl` as int
**Note:** When using `baseurl` remember to include it as part of your path when testing your site locally. Values of `url:` and `baseurl: "/blog"` would make your local site visible at `http://localhost:4000/blog` and not `http://localhost:4000`.
{: .notice--warning}
-### Site Repository
+### Site repository
Add your repository name with organization to your site's configuration file, `_config.yml`.
@@ -202,7 +188,7 @@ If you don't set `repository` correctly you may see the following error when try
For more information on how `site.github` data can be used with Jekyll check out [`github-metadata`'s documentation](https://github.com/jekyll/github-metadata).
-### Site Scripts
+### Site scripts
Add scripts to the `` or closing `` elements by assigning paths to either `head_scripts` and/or `footer_scripts`.
@@ -217,7 +203,7 @@ head_scripts:
Consult the [JavaScript documentation]({{ site.baseurl }}{% link _docs/17-javascript.md %}) for more information on working with theme scripts.
{: .notice--info}
-### Site Default Teaser Image
+### Site default teaser image
To assign a fallback teaser image used in the "**Related Posts**" module, place a graphic in the `/assets/images/` directory and add the filename to `_config.yml` like so:
@@ -237,7 +223,7 @@ header:
Example of teaser images found in the related posts module.
-### Breadcrumb Navigation (Beta)
+### Breadcrumb navigation (beta)
Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results:
@@ -252,7 +238,7 @@ breadcrumbs: true # disabled by default
Breadcrumb start link text and separator character can both be changed in the [UI Text data file]({{ "/docs/ui-text/" | relative_url }}).
-### Reading Time
+### Reading time
Enable estimated reading time snippets with `read_time: true` in YAML Front Matter. `200` has been set as the default words per minute value --- which can be changed by adjusting `words_per_minute:` in `_config.yml`.
@@ -332,7 +318,7 @@ comments:
**Note:** Do not include `http://` or `https://` when setting your Discourse `server`. The theme automatically prepends the URL `//`, following a scheme-less pattern.
{: .notice--info}
-#### Facebook Comments
+#### Facebook comments
To enable Facebook Comments choose how many comments you'd like visible per post and the color scheme of the widget.
@@ -345,7 +331,7 @@ comments:
colorscheme: # "light" (default), "dark"
```
-#### utterances Comments
+#### utterances comments
To use utterances you will need to [install the app](https://github.com/apps/utterances) to your GitHub repository by adding the following to `_config.yml`:
@@ -365,7 +351,7 @@ comments:
theme: "github-light" # "github-dark"
```
-#### Static-Based Comments via Staticman
+#### Static-based comments via Staticman
Transform user comments into `_data` files that live inside of your GitHub repository by enabling Staticman.
@@ -375,7 +361,7 @@ Transform user comments into `_data` files that live inside of your GitHub repos
**Note:** Please note that as of September 2018, Staticman is reaching GitHub API limits due to its popularity, and it is recommended by its maintainer that users deploy their own instances for production (use `site.staticman.endpoint`).
{: .notice--warning}
-##### Add Staticman as a Collaborator
+##### Add Staticman as a collaborator
1. Allow Staticman push access to your GitHub repository by clicking on **Settings**, then the **Collaborators** tab and adding `staticmanapp` as a collaborator.
2. To accept the pending invitation visit: `https://api.staticman.net/v2/connect/{your GitHub username}/{your repository name}`. Consult the Staticman "[Get Started](https://staticman.net/docs/index.html)" guide for more info.
@@ -453,7 +439,7 @@ staticman:
format : "iso8601" # "iso8601" (default), "timestamp-seconds", "timestamp-milliseconds"
```
-##### Comment Moderation
+##### Comment moderation
By default comment moderation is enabled in `staticman.yml`. As new comments are submitted Staticman will send a pull request. Merging these in will approve the comment, close the issue, and automatically rebuild your site (if hosted on GitHub Pages).
@@ -464,7 +450,7 @@ To skip this moderation step simply set `moderation: false`.
![pull-request webhook]({{ "/assets/images/mm-staticman-pr-webhook.jpg" | relative_url }})
-##### reCAPTCHA Support (v2 only)
+##### reCAPTCHA support (v2 only)
To enable Google's reCAPTCHA to aid in spam detection you'll need to:
@@ -478,11 +464,11 @@ reCaptcha:
secret: # "PznnZGu3P6eTHRPLORniSq+J61YEf+A9zmColXDM5icqF49gbunH51B8+h+i2IvewpuxtA9TFoK68TuhUp/X3YKmmqhXasegHYabY50fqF9nJh9npWNhvITdkQHeaOqnFXUIwxfiEeUt49Yoa2waRR7a5LdRAP3SVM8hz0KIBT4="
```
-#### Other Comment Providers
+#### Other comment providers
To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/comments-providers/custom.html`.
-### Custom Feed URL
+### Custom feed URL
By default the theme links to `feed.xml` generated in the root of your site by the **jekyll-feed** plugin. To link to an externally hosted feed update `atom_feed` in `_config.yml` like so:
@@ -494,7 +480,7 @@ atom_feed:
**Note:** By default the site feed is linked in two locations: inside the [`` element](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/head.html) and at the bottom of every page in the [site footer](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/footer.html).
{: .notice--info}
-### Site Search
+### Site search
To enable site-wide search add `search: true` to your `_config.yml`.
@@ -584,7 +570,7 @@ Add a Google search box to your site.
**Note:** If your site is new and hasn't been indexed by Google yet, search will be incomplete and won't provide accurate results.
{: .notice--info}
-### SEO, Social Sharing, and Analytics Settings
+### SEO, social sharing, and analytics settings
All optional, but a good idea to take the time setting up to improve SEO and links shared from the site.
@@ -645,7 +631,7 @@ yandex_site_verification: "2132801JL"
To improve the appearance of links shared from your site to social networks like Twitter and Facebook be sure to configure the following.
-##### Site Twitter Username
+##### Site Twitter username
Twitter username for the site. For pages that have custom author Twitter accounts assigned in their YAML Front Matter or data file, they will be attributed as a **creator** in the Twitter Card.
@@ -681,7 +667,7 @@ facebook:
**ProTip:** To debug Open Graph data use [this tool](https://developers.facebook.com/tools/debug/og/object?q=https%3A%2F%2Fmademistakes.com) to test your pages. If content changes aren't reflected you will probably have to hit the **Fetch new scrape information** button to refresh.
{: .notice--info}
-##### Open Graph Default Image
+##### Open Graph default image
For pages that don't have a `header.image` assigned in their YAML Front Matter, `site.og_image` will be used as a fallback. Use your logo, icon, avatar or something else that is meaningful. Just make sure it is place in the `/assets/images/` folder, a minimum size of 120px by 120px, and less than 1MB in file size.
@@ -749,7 +735,7 @@ To use another provider not included with the theme set `provider: "custom"` the
`JEKYLL_ENV=production` to [force the environment](http://jekyllrb.com/docs/configuration/#specifying-a-jekyll-environment-at-build-time) to production.
{: .notice--info}
-## Site Author
+## Site author
Used as the defaults for defining what appears in the author sidebar.
@@ -797,7 +783,7 @@ author:
To customize the author sidebar, read the full [layout documentation]({{ "/docs/layouts/#author-profile" | relative_url }}).
-## Site Footer
+## Site footer
Footer links can be added under the `footer.links` array.
@@ -826,11 +812,11 @@ footer:
To change "Follow:" text that precedes footer links, edit the `follow_label` key in `_data/ui-text.yml`.
-## Reading Files
+## Reading files
Nothing out of the ordinary here. `include` and `exclude` may be the only things you need to alter.
-## Conversion and Markdown Processing
+## Conversion and Markdown processing
Again nothing out of the ordinary here as the theme adheres to the defaults used by GitHub Pages. [**Kramdown**](http://kramdown.gettalong.org/) for Markdown conversion, [**Rouge**](http://rouge.jneen.net/) syntax highlighting, and incremental building disabled. Change them if you need to.
@@ -940,7 +926,7 @@ If you're hosting elsewhere then you don't really have to worry about what is wh
**Note:** The [jekyll-include-cache](https://github.com/benbalter/jekyll-include-cache) plugin needs to be installed in your `Gemfile` and added to the `plugins` array of `_config.yml`. Otherwise you'll throw `Unknown tag 'include_cached'` errors at build.
{: .notice--warning}
-## Archive Settings
+## Archive settings
The theme ships with support for taxonomy (category and tag) pages. GitHub Pages hosted sites need to use a _Liquid only_ approach while those hosted elsewhere can use plugins like [**jekyll-archives**][jekyll-archives] to generate these pages automatically.
@@ -1001,7 +987,7 @@ jekyll-archives:
**Note:** The `archive-taxonomy` layout used by jekyll-archives is provided with the theme and can be found in the `_layouts` folder.
{: .notice--info}
-## HTML Compression
+## HTML compression
If you care at all about performance (and really who doesn't) compressing the HTML files generated by Jekyll is a good thing to do.
diff --git a/docs/_docs/07-navigation.md b/docs/_docs/07-navigation.md
index ae5f8b1ea354..dba977140f98 100644
--- a/docs/_docs/07-navigation.md
+++ b/docs/_docs/07-navigation.md
@@ -6,6 +6,8 @@ last_modified_at: 2018-03-20T15:59:40-04:00
toc: true
---
+Customize site navigational links through a Jekyll data file.
+
## Masthead
The masthead links use a "priority plus" design pattern. Meaning, show as many navigation items that will fit horizontally with a toggle to reveal the rest.
@@ -39,7 +41,7 @@ Optionally, you can add a `description` key per title in the `main` key. This `d
**ProTip:** Put the most important links first so they're always visible and not hidden behind the **menu toggle**.
{: .notice--info}
-## Breadcrumbs (Beta)
+## Breadcrumbs (beta)
Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results:
@@ -66,6 +68,6 @@ breadcrumb_home_label : "Start"
breadcrumb_separator : ">"
```
-## Custom Sidebar Navigation Menu
+## Custom sidebar navigation menu
See the [**sidebars** documentation]({{ "/docs/layouts/#custom-sidebar-navigation-menu" | relative_url }}) for information on setting up a custom navigation menu.
\ No newline at end of file
diff --git a/docs/_docs/10-layouts.md b/docs/_docs/10-layouts.md
index 35002cf60369..deafc7928b2a 100644
--- a/docs/_docs/10-layouts.md
+++ b/docs/_docs/10-layouts.md
@@ -7,7 +7,7 @@ single_layout_gallery:
alt: "single layout with header example"
- image_path: /assets/images/mm-layout-single-meta.png
alt: "single layout with comments and related posts"
-last_modified_at: 2018-11-13T09:29:44-05:00
+last_modified_at: 2018-11-25T19:45:55-05:00
toc: true
toc_label: "Included Layouts"
toc_icon: "columns"
@@ -15,7 +15,7 @@ toc_icon: "columns"
The bread and butter of any theme. Below you'll find the layouts included with Minimal Mistakes, what they look like and the type of content they've been built for.
-## Default Layout
+## Default layout
The base layout all other layouts inherit from. There's not much to this layout apart from pulling in several `_includes`:
@@ -28,7 +28,7 @@ The base layout all other layouts inherit from. There's not much to this layout
**Note:** You won't ever assign this layout directly to a post or page. Instead all other layouts will build off of it by setting `layout: default` in their YAML Front Matter.
{: .notice--warning}
-### Layout Based and User-Defined Classes
+### Layout based and user-defined classes
Class names corresponding to each layout are automatically added to the `` element eg. ``.
@@ -65,7 +65,7 @@ Outputs:
```
-## Compress Layout
+## Compress layout
A Jekyll layout that compresses HTML in pure Liquid. To enable add `layout: compress` to `_layouts/default.html`.
@@ -74,7 +74,7 @@ A Jekyll layout that compresses HTML in pure Liquid. To enable add `layout: comp
* [Documentation](http://jch.penibelst.de/)
-## Single Layout
+## Single layout
The layout you'll likely use the most --- sidebar and main content combo.
@@ -91,7 +91,7 @@ The layout you'll likely use the most --- sidebar and main content combo.
Assign with `layout: single` , or better yet apply as a [Front Matter default]({{ "/docs/configuration/#front-matter-defaults" | relative_url }}) in `_config.yml`.
-### Wide Page
+### Wide page
To expand the main content to the right, filling the space of what is normally occupied by the table of contents. Add the following to a post or page's YAML Front Matter:
@@ -102,7 +102,7 @@ classes: wide
**Note:** If the page contains a table of contents, it will no longer appear to the right. Instead it will be forced into the main content container directly following the page's title.
{: .notice--info}
-### Table of Contents
+### Table of contents
Auto-generated table of contents list for your posts and pages can be enabled by adding `toc: true` to the YAML Front Matter.
@@ -124,7 +124,7 @@ toc_icon: "cog"
---
```
-## Archive Layout
+## Archive layout
Essentially the same as `single` with markup adjustments and some modules removed.
@@ -159,7 +159,7 @@ Post and page excerpts are auto-generated by Jekyll which grabs the first paragr
excerpt: "A unique line of text to describe this post that will display in an archive listing and meta description with SEO benefits."
```
-### Wide Page
+### Wide page
To expand the main content to the right, filling the space of what is normally occupied by the table of contents. Add the following to a post or page's YAML Front Matter:
@@ -167,7 +167,7 @@ To expand the main content to the right, filling the space of what is normally o
classes: wide
```
-### Grid View
+### Grid view
Adding `type=grid` to the `archive-single` helper will display archive posts in a 4 column grid. For example to create an archive displaying all documents in the portfolio collection:
@@ -193,7 +193,7 @@ header:
**Note:** More information on using this `_include` can be found under [**Helpers**]({{ "/docs/helpers/" | relative_url }}).
{: .notice--info}
-## Taxonomy Archives
+## Taxonomy archives
If you have the luxury of using Jekyll plugins, the creation of category and tag archives is greatly simplified. Simply enable support for the [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) plugin with a few `_config.yml` settings as noted in the [**Configuration**]({{ "/docs/configuration/#archive-settings" | relative_url }}) section and you're good to go.
@@ -284,7 +284,7 @@ permalink: /tags/foo-bar/
taxonomy: foo bar
```
-## Home Page Layout
+## Home page layout
A derivative archive page layout to be used as a simple home page. It is built to show a paginated list of recent posts based off of the [pagination settings]({{ "/docs/configuration/#paginate" | relative_url }}) in `_config.yml`.
@@ -321,7 +321,7 @@ paginate_path: /blog/page:num
**Note:** Jekyll can only paginate a single `index.html` file. If you'd like to paginate more pages (e.g. category indexes) you'll need the help of a custom plugin. For more pagination related settings check the [**Configuration**]({{ "/docs/configuration/#paginate" | relative_url }}) section.
{: .notice--info}
-## Splash Page Layout
+## Splash page layout
For full-width landing pages that need a little something extra add `layout: splash` to the YAML Front Matter.
@@ -335,7 +335,7 @@ For full-width landing pages that need a little something extra add `layout: spl
Feature blocks can be assigned and aligned to the `left`, `right`, or `center` with a sprinkling of YAML. For full details on how to use the `feature_row` helper check the [**Content**]({{ "/docs/helpers/" | relative_url }}) section or review a [sample splash page](https://github.com/{{ site.repository }}/blob/master/docs/_pages/splash-page.md).
-## Search Page Layout
+## Search page layout
A page with a search form. Add `layout: search` to the YAML Front Matter similar to [this example](https://github.com/mmistakes/minimal-mistakes/blob/master/test/_pages/search.md) on the test site.
@@ -401,7 +401,7 @@ header:
**ProTip:** Captions written in Markdown are supported, so feel free to add links, or style text. Just be sure to wrap it in quotes.
{: .notice--info}
-### Header Overlay
+### Header overlay
To overlay text on top of a header image you have a few more options:
@@ -485,7 +485,7 @@ header:
url: "#bar"
```
-### OpenGraph & Twitter Card Images
+### Open Graph & Twitter Card images
By default the large page header or overlay images are used for sharing previews. If you'd like to set this image to something else use `page.header.og_image` like:
@@ -504,7 +504,7 @@ header:
The space to the left of a page's main content is blank by default, but has the ability to show an author profile (name, short biography, social media links), custom content, or both.
-### Author Profile
+### Author profile
Add `author_profile: true` to a post or page's YAML Front Matter.
@@ -563,7 +563,7 @@ For example, to color a Reddit icon, simply add a `color` declaration and the co
![Reddit link in author profile with color]({{ "/assets/images/mm-author-profile-reddit-color.png" | relative_url }})
-### Custom Sidebar Content
+### Custom sidebar content
Blocks of content can be added by using the following under `sidebar`:
@@ -594,7 +594,7 @@ sidebar:
**Note:** Custom sidebar content added to a post or page's YAML Front Matter will appear below the author profile if enabled with `author_profile: true`.
{: .notice--info}
-### Custom Sidebar Navigation Menu
+### Custom sidebar navigation menu
To create a sidebar menu[^sidebar-menu] similar to the one found in the theme's documentation pages you'll need to modify a `_data` file and some YAML Front Matter.
@@ -683,7 +683,7 @@ defaults:
---
-## Social Sharing Links
+## Social sharing links
The `single` layout has an option to enable social links at the bottom of posts for sharing on Twitter, Facebook, Google+, and LinkedIn. Similar to the links found in the author sidebar, the theme ships with defaults for the most common social networks.
diff --git a/docs/_docs/14-helpers.md b/docs/_docs/14-helpers.md
index f765ef975bc7..a9f124020014 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-06-11T07:56:49-04:00
+last_modified_at: 2018-11-25T19:46:11-05:00
toc: true
toc_label: "Helpers"
toc_icon: "cogs"
@@ -38,7 +38,7 @@ 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.
-## Group by Array
+## Group by array
[Jekyll Group-By-Array](https://github.com/mushishi78/jekyll-group-by-array) by Max White.
@@ -120,7 +120,7 @@ And then drop-in the gallery include in the body where you'd like it to appear.
**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" | relative_url }}) page layout as a way of arranging and aligning "feature blocks" containing text or image.
@@ -171,7 +171,7 @@ And then drop-in the feature row include in the body where you'd like it to appe
**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. To help with GDPR compliance, the theme is using the privacy enhanced version of both providers out of the box.
@@ -218,7 +218,7 @@ header:
provider: vimeo
```
-## Table of Contents
+## Table of contents
Auto-generated table of contents list for your posts and pages can be enabled using two methods.
@@ -273,7 +273,7 @@ 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.
diff --git a/docs/_docs/15-utility-classes.md b/docs/_docs/15-utility-classes.md
index c0b4d114a40a..f45f2eccc1f6 100644
--- a/docs/_docs/15-utility-classes.md
+++ b/docs/_docs/15-utility-classes.md
@@ -2,7 +2,7 @@
title: "Utility Classes"
permalink: /docs/utility-classes/
excerpt: "CSS classes for aligning text/image, styling buttons and notices, and more."
-last_modified_at: 2018-08-15T09:53:10-04:00
+last_modified_at: 2018-11-25T19:46:43-05:00
toc: true
toc_label: "Utility Classes"
toc_icon: "cogs"
@@ -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,7 +65,7 @@ No wrap text.
{: .text-nowrap}
```
-## Image Alignment
+## Image alignment
Position images with the following classes.
diff --git a/docs/_docs/16-stylesheets.md b/docs/_docs/16-stylesheets.md
index ac626eaf9eb6..78b500fbb1a6 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-03-20T16:00:22-04:00
+last_modified_at: 2018-11-25T19:47:43-05:00
toc: true
---
@@ -71,7 +71,7 @@ $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.
@@ -82,7 +82,7 @@ To mimic the look of type set in a printed book or manuscript you may want to en
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,7 +118,7 @@ $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.
@@ -149,7 +149,7 @@ $type-size-8 : 0.625em; // ~10px
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.
-#### 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.
@@ -179,7 +179,7 @@ $base0e: #c792ea;
$base0f: #ff5370;
```
-##### Solarized Light
+##### Solarized light
![solarized-light-code-block]({{ '/assets/images/solarized-light-code-block.jpg' | relative_url }})
@@ -347,7 +347,7 @@ $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.
@@ -358,7 +358,7 @@ And `$susy` is used for setting [the grid](http://susy.oddbird.net/) the theme u
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 5e788c719e0e..cd6db28a7b59 100644
--- a/docs/_docs/17-javascript.md
+++ b/docs/_docs/17-javascript.md
@@ -46,7 +46,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:.
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:
From a59dd4a84ce881a7e5c6c3ce8437bd6d1d642811 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 19:52:45 -0500
Subject: [PATCH 121/176] Increase font-size
---
_sass/minimal-mistakes/_base.scss | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_sass/minimal-mistakes/_base.scss b/_sass/minimal-mistakes/_base.scss
index ae032aeb4efa..dd94cda17d60 100644
--- a/_sass/minimal-mistakes/_base.scss
+++ b/_sass/minimal-mistakes/_base.scss
@@ -167,7 +167,7 @@ figcaption > code,
td > code {
padding-top: 0.1rem;
padding-bottom: 0.1rem;
- font-size: $type-size-6;
+ font-size: 0.8em;
background: $code-background-color;
border-radius: $border-radius;
From 3cd24c4b699bc3b6b6672d1da34cd64161a114e0 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 19:52:52 -0500
Subject: [PATCH 122/176] Increase padding
---
_sass/minimal-mistakes/_navigation.scss | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_sass/minimal-mistakes/_navigation.scss b/_sass/minimal-mistakes/_navigation.scss
index d732d0ac6717..45deb2c9d79f 100644
--- a/_sass/minimal-mistakes/_navigation.scss
+++ b/_sass/minimal-mistakes/_navigation.scss
@@ -471,7 +471,7 @@
.nav__title {
margin: 0;
- padding: 0.25rem 0.75rem;
+ padding: 0.5rem 0.75rem;
font-family: $sans-serif-narrow;
font-size: $type-size-5;
font-weight: bold;
From cbcc53de31f9068a5617531ca2186cc9bca69ee1 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:19:24 -0500
Subject: [PATCH 123/176] Add focus color
---
_sass/minimal-mistakes/_mixins.scss | 4 ++--
_sass/minimal-mistakes/_variables.scss | 1 +
2 files changed, 3 insertions(+), 2 deletions(-)
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/_variables.scss b/_sass/minimal-mistakes/_variables.scss
index 621ff4481ea5..52b2231a6b58 100644
--- a/_sass/minimal-mistakes/_variables.scss
+++ b/_sass/minimal-mistakes/_variables.scss
@@ -67,6 +67,7 @@ $success-color: #3fa63f !default;
$warning-color: #d67f05 !default;
$danger-color: #ee5f5b !default;
$info-color: #3b9cba !default;
+$focus-color: $primary-color !default;
/* YIQ color contrast */
$yiq-contrasted-dark-default: $dark-gray !default;
From 2729b692f37d99b3a870fbdd786ad37b03da2c4a Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:20:03 -0500
Subject: [PATCH 124/176] Adjust navigation toggles
---
_sass/minimal-mistakes/_navigation.scss | 3 +--
_sass/minimal-mistakes/_search.scss | 5 +++--
_sass/minimal-mistakes/_utilities.scss | 4 ++--
3 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/_sass/minimal-mistakes/_navigation.scss b/_sass/minimal-mistakes/_navigation.scss
index 45deb2c9d79f..d0fe14eebc40 100644
--- a/_sass/minimal-mistakes/_navigation.scss
+++ b/_sass/minimal-mistakes/_navigation.scss
@@ -200,8 +200,7 @@
height: $nav-toggle-height;
border: 0;
outline: none;
- color: #fff;
- background-color: $primary-color;
+ background-color: transparent;
cursor: pointer;
}
diff --git a/_sass/minimal-mistakes/_search.scss b/_sass/minimal-mistakes/_search.scss
index fa2790344367..5ee24517a628 100644
--- a/_sass/minimal-mistakes/_search.scss
+++ b/_sass/minimal-mistakes/_search.scss
@@ -11,16 +11,17 @@
.search__toggle {
margin-left: 1rem;
margin-right: 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%);
}
}
diff --git a/_sass/minimal-mistakes/_utilities.scss b/_sass/minimal-mistakes/_utilities.scss
index 407efc537524..9717281f9a4e 100644
--- a/_sass/minimal-mistakes/_utilities.scss
+++ b/_sass/minimal-mistakes/_utilities.scss
@@ -315,7 +315,7 @@ 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;
@@ -327,7 +327,7 @@ body:hover .visually-hidden button {
left: 0;
width: $navicon-width;
height: $navicon-height;
- background: #fff;
+ background: $primary-color;
-webkit-transition: 0.3s;
transition: 0.3s;
}
From 22a9c523d6be13becc6fe0ed38b065e3489e498f Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:20:15 -0500
Subject: [PATCH 125/176] Use dark syntax highlighting
---
_sass/minimal-mistakes/skins/_dark.scss | 18 ------------------
1 file changed, 18 deletions(-)
diff --git a/_sass/minimal-mistakes/skins/_dark.scss b/_sass/minimal-mistakes/skins/_dark.scss
index 9547a38b44c6..44f1bda06fdd 100644
--- a/_sass/minimal-mistakes/skins/_dark.scss
+++ b/_sass/minimal-mistakes/skins/_dark.scss
@@ -18,24 +18,6 @@ $masthead-link-color: $text-color !default;
$masthead-link-color-hover: mix(#000, $text-color, 20%) !default;
$navicon-link-color-hover: mix(#000, $background-color, 30%) !default;
-/* dark syntax highlighting (base16) */
-$base00: #ffffff !default;
-$base01: #e0e0e0 !default;
-$base02: #d0d0d0 !default;
-$base03: #b0b0b0 !default;
-$base04: #000000 !default;
-$base05: #101010 !default;
-$base06: #151515 !default;
-$base07: #202020 !default;
-$base08: #ff0086 !default;
-$base09: #fd8900 !default;
-$base0a: #aba800 !default;
-$base0b: #00c918 !default;
-$base0c: #1faaaa !default;
-$base0d: #3777e6 !default;
-$base0e: #ad00a1 !default;
-$base0f: #cc6633 !default;
-
.author__urls.social-icons .svg-inline--fa,
.page__footer-follow .social-icons .svg-inline--fa {
color: inherit;
From 31828d3174f765f8d66dde80f63262aef91b7afa Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:37:23 -0500
Subject: [PATCH 126/176] Update CHANGELOG and history
---
CHANGELOG.md | 2 ++
docs/_docs/18-history.md | 4 +++-
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index be0d69df6258..ed603d5bd05c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+- 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)
@@ -20,6 +21,7 @@
### Bug Fixes
+- 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)
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 2156a816b3c2..5ba332eacccf 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-11-21T14:55:38-05:00
+last_modified_at: 2018-11-25T20:37:17-05:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+- 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)
@@ -30,6 +31,7 @@ toc: true
### Bug Fixes
+- 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)
From 8a03ffb4395932e252daf671021e876409f47523 Mon Sep 17 00:00:00 2001
From: Lars Olesen
Date: Mon, 26 Nov 2018 02:40:54 +0100
Subject: [PATCH 127/176] Add Google Drive as video provider (#1967)
---
_includes/video | 2 ++
1 file changed, 2 insertions(+)
diff --git a/_includes/video b/_includes/video
index 38672a2d9ecf..8955c7c49470 100644
--- a/_includes/video
+++ b/_includes/video
@@ -7,5 +7,7 @@
{% elsif video_provider == "youtube" %}
+{% elsif video_provider == "google-drive" %}
+
{% endif %}
From 99ca41c4fe96c3584073dc94a3084bb144b49bbe Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:47:14 -0500
Subject: [PATCH 128/176] Add Google Drive provider documentation
---
docs/_docs/14-helpers.md | 25 ++++++++++++++++++++++---
1 file changed, 22 insertions(+), 3 deletions(-)
diff --git a/docs/_docs/14-helpers.md b/docs/_docs/14-helpers.md
index a9f124020014..15e41bf22a11 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-11-25T19:46:11-05:00
+last_modified_at: 2018-11-25T20:47:01-05:00
toc: true
toc_label: "Helpers"
toc_icon: "cogs"
@@ -173,12 +173,12 @@ And then drop-in the feature row include in the body where you'd like it to appe
## Responsive video embed
-Embed a video from YouTube or Vimeo that responsively sizes to fit the width of its parent. To help with GDPR compliance, the theme is using the privacy enhanced version of both providers out of the box.
+Embed a video from YouTube, Vimeo, or Google Drive 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` |
+| `provider` | **Required** | Hosting provider of the video: `youtube`, vimeo`, or `google-drive` |
### YouTube
@@ -218,6 +218,25 @@ header:
provider: vimeo
```
+### 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
+```
+
## Table of contents
Auto-generated table of contents list for your posts and pages can be enabled using two methods.
From e2ea7994244b1aed773fdd463b4cdf4fb25de348 Mon Sep 17 00:00:00 2001
From: Michael Rose
Date: Sun, 25 Nov 2018 20:47:20 -0500
Subject: [PATCH 129/176] Update CHANGELOG and history
---
CHANGELOG.md | 1 +
docs/_docs/18-history.md | 3 ++-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ed603d5bd05c..063786ea444e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
### Enhancements
+- 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)
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index 5ba332eacccf..5576e3ce76ed 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
excerpt: "Change log of enhancements and bug fixes made to the theme."
sidebar:
nav: docs
-last_modified_at: 2018-11-25T20:37:17-05:00
+last_modified_at: 2018-11-25T20:41:31-05:00
toc: true
---
@@ -12,6 +12,7 @@ toc: true
### Enhancements
+- 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)
From 1a88b6a24ab252268fb2ff6929be42314babd952 Mon Sep 17 00:00:00 2001
From: Kulbhushan Chand <17742733+Kulbhushan-Chand@users.noreply.github.com>
Date: Mon, 26 Nov 2018 07:17:47 +0530
Subject: [PATCH 130/176] Changed schema.org to secure links (https) (#1969)
---
_includes/breadcrumbs.html | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/_includes/breadcrumbs.html b/_includes/breadcrumbs.html
index 82fe2cc47ca9..cba3d415fa4f 100644
--- a/_includes/breadcrumbs.html
+++ b/_includes/breadcrumbs.html
@@ -13,12 +13,12 @@
{% endif %}