You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: cheatsheets/jekyll/configure.md
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ Note that YAML uses `null`, while Ruby uses `nil`.
38
38
39
39
From the [docs](https://jekyllrb.com/docs/plugins/installation/), a gem listed in the `:jekyll_plugins` group of the `Gemfile` will **always** get activated, even if it is not listed in the `plugins` field of the config.
40
40
41
-
Therefore you can generally **omit** this key.
41
+
Therefore you can generally **omit** this key.
42
42
43
43
This works both locally and on GH Pages, using a theme directly or using Remote Theme plugin.
44
44
@@ -149,7 +149,7 @@ Add strict Liquid settings so Jekyll will fail on bad syntax.
149
149
150
150
From [Liquid Options](https://jekyllrb.com/docs/configuration/liquid/) in the docs.
151
151
152
-
Change error mode from `warn` to `strict`. And also make invalid variables and filters cause errors.
152
+
Change the error mode from `warn` to `strict`. And make any invalid variables and filters cause build errors.
153
153
154
154
```yaml
155
155
liquid:
@@ -158,9 +158,13 @@ liquid:
158
158
strict_filters: true
159
159
```
160
160
161
-
Note that this also applies to the code in your theme.
161
+
These are mutually exclusive settings according to the docs. Though my YAML linter doesn't like having the 1st line and the last 2 lines together.
162
162
163
-
This can be annoying - for example the Minima theme's `post.html` layout uses `site.minima.date_format` and `site.disqus.short_name` as optional config values. So to do a build, you have to set them as empty in your config, or override the layout.
163
+
You may have issues caused by your _theme_ and not your actual code
164
+
165
+
Which you'll have to leave out some fields covered above.
166
+
167
+
Or you adjust for it. For example, the Minima theme's `post.html` layout uses `site.minima.date_format` and `site.disqus.short_name` as optional config values. So to do a build, you have to set them as empty in your config, or override the layout.
164
168
165
169
And it is not safe to set the entire `site.minima` to null for example, as you might affect other values used by the theme. Plus that is not actually effective because you get the error anyway on the last level.
166
170
@@ -180,5 +184,3 @@ title:
180
184
```
181
185
182
186
I had issues in other parts of my `jekyll-blog-demo` repo so I stopped using all the strict settings.
0 commit comments