Skip to content

Commit 06f8f82

Browse files
committed
Update configure.md
1 parent 91b1f80 commit 06f8f82

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

cheatsheets/jekyll/configure.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Note that YAML uses `null`, while Ruby uses `nil`.
3838

3939
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.
4040

41-
Therefore you can generally **omit** this key.
41+
Therefore you can generally **omit** this key.
4242

4343
This works both locally and on GH Pages, using a theme directly or using Remote Theme plugin.
4444

@@ -149,7 +149,7 @@ Add strict Liquid settings so Jekyll will fail on bad syntax.
149149

150150
From [Liquid Options](https://jekyllrb.com/docs/configuration/liquid/) in the docs.
151151

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.
153153

154154
```yaml
155155
liquid:
@@ -158,9 +158,13 @@ liquid:
158158
strict_filters: true
159159
```
160160

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.
162162

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.
164168

165169
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.
166170

@@ -180,5 +184,3 @@ title:
180184
```
181185

182186
I had issues in other parts of my `jekyll-blog-demo` repo so I stopped using all the strict settings.
183-
184-

0 commit comments

Comments
 (0)