jekyll 4.2.1 → 4.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +350 -350
  3. data/LICENSE +21 -21
  4. data/README.markdown +86 -86
  5. data/exe/jekyll +57 -57
  6. data/lib/blank_template/_config.yml +3 -3
  7. data/lib/blank_template/_layouts/default.html +12 -12
  8. data/lib/blank_template/_sass/main.scss +9 -9
  9. data/lib/blank_template/assets/css/main.scss +4 -4
  10. data/lib/blank_template/index.md +8 -8
  11. data/lib/jekyll/cache.rb +190 -190
  12. data/lib/jekyll/cleaner.rb +111 -111
  13. data/lib/jekyll/collection.rb +309 -309
  14. data/lib/jekyll/command.rb +105 -105
  15. data/lib/jekyll/commands/build.rb +93 -93
  16. data/lib/jekyll/commands/clean.rb +45 -45
  17. data/lib/jekyll/commands/doctor.rb +177 -177
  18. data/lib/jekyll/commands/help.rb +34 -34
  19. data/lib/jekyll/commands/new.rb +172 -169
  20. data/lib/jekyll/commands/new_theme.rb +40 -40
  21. data/lib/jekyll/commands/serve/live_reload_reactor.rb +122 -122
  22. data/lib/jekyll/commands/serve/livereload_assets/livereload.js +1183 -1183
  23. data/lib/jekyll/commands/serve/servlet.rb +202 -202
  24. data/lib/jekyll/commands/serve/websockets.rb +81 -81
  25. data/lib/jekyll/commands/serve.rb +362 -362
  26. data/lib/jekyll/configuration.rb +313 -313
  27. data/lib/jekyll/converter.rb +54 -54
  28. data/lib/jekyll/converters/identity.rb +41 -41
  29. data/lib/jekyll/converters/markdown/kramdown_parser.rb +199 -199
  30. data/lib/jekyll/converters/markdown.rb +113 -113
  31. data/lib/jekyll/converters/smartypants.rb +70 -70
  32. data/lib/jekyll/convertible.rb +257 -257
  33. data/lib/jekyll/deprecator.rb +50 -50
  34. data/lib/jekyll/document.rb +544 -544
  35. data/lib/jekyll/drops/collection_drop.rb +20 -20
  36. data/lib/jekyll/drops/document_drop.rb +70 -70
  37. data/lib/jekyll/drops/drop.rb +293 -293
  38. data/lib/jekyll/drops/excerpt_drop.rb +19 -19
  39. data/lib/jekyll/drops/jekyll_drop.rb +32 -32
  40. data/lib/jekyll/drops/site_drop.rb +66 -66
  41. data/lib/jekyll/drops/static_file_drop.rb +14 -14
  42. data/lib/jekyll/drops/unified_payload_drop.rb +26 -26
  43. data/lib/jekyll/drops/url_drop.rb +140 -140
  44. data/lib/jekyll/entry_filter.rb +121 -121
  45. data/lib/jekyll/errors.rb +20 -20
  46. data/lib/jekyll/excerpt.rb +201 -201
  47. data/lib/jekyll/external.rb +79 -79
  48. data/lib/jekyll/filters/date_filters.rb +110 -110
  49. data/lib/jekyll/filters/grouping_filters.rb +64 -64
  50. data/lib/jekyll/filters/url_filters.rb +98 -98
  51. data/lib/jekyll/filters.rb +535 -535
  52. data/lib/jekyll/frontmatter_defaults.rb +240 -240
  53. data/lib/jekyll/generator.rb +5 -5
  54. data/lib/jekyll/hooks.rb +107 -107
  55. data/lib/jekyll/inclusion.rb +32 -32
  56. data/lib/jekyll/layout.rb +67 -67
  57. data/lib/jekyll/liquid_extensions.rb +22 -22
  58. data/lib/jekyll/liquid_renderer/file.rb +77 -77
  59. data/lib/jekyll/liquid_renderer/table.rb +55 -55
  60. data/lib/jekyll/liquid_renderer.rb +80 -80
  61. data/lib/jekyll/log_adapter.rb +151 -151
  62. data/lib/jekyll/mime.types +866 -866
  63. data/lib/jekyll/page.rb +217 -217
  64. data/lib/jekyll/page_excerpt.rb +25 -25
  65. data/lib/jekyll/page_without_a_file.rb +14 -14
  66. data/lib/jekyll/path_manager.rb +74 -74
  67. data/lib/jekyll/plugin.rb +92 -92
  68. data/lib/jekyll/plugin_manager.rb +115 -115
  69. data/lib/jekyll/profiler.rb +58 -58
  70. data/lib/jekyll/publisher.rb +23 -23
  71. data/lib/jekyll/reader.rb +192 -192
  72. data/lib/jekyll/readers/collection_reader.rb +23 -23
  73. data/lib/jekyll/readers/data_reader.rb +79 -79
  74. data/lib/jekyll/readers/layout_reader.rb +62 -62
  75. data/lib/jekyll/readers/page_reader.rb +25 -25
  76. data/lib/jekyll/readers/post_reader.rb +85 -85
  77. data/lib/jekyll/readers/static_file_reader.rb +25 -25
  78. data/lib/jekyll/readers/theme_assets_reader.rb +52 -52
  79. data/lib/jekyll/regenerator.rb +195 -195
  80. data/lib/jekyll/related_posts.rb +52 -52
  81. data/lib/jekyll/renderer.rb +265 -265
  82. data/lib/jekyll/site.rb +551 -551
  83. data/lib/jekyll/static_file.rb +208 -208
  84. data/lib/jekyll/stevenson.rb +60 -60
  85. data/lib/jekyll/tags/highlight.rb +110 -110
  86. data/lib/jekyll/tags/include.rb +275 -275
  87. data/lib/jekyll/tags/link.rb +42 -42
  88. data/lib/jekyll/tags/post_url.rb +106 -106
  89. data/lib/jekyll/theme.rb +86 -86
  90. data/lib/jekyll/theme_builder.rb +121 -121
  91. data/lib/jekyll/url.rb +167 -167
  92. data/lib/jekyll/utils/ansi.rb +57 -57
  93. data/lib/jekyll/utils/exec.rb +26 -26
  94. data/lib/jekyll/utils/internet.rb +37 -37
  95. data/lib/jekyll/utils/platforms.rb +67 -67
  96. data/lib/jekyll/utils/thread_event.rb +31 -31
  97. data/lib/jekyll/utils/win_tz.rb +75 -75
  98. data/lib/jekyll/utils.rb +367 -367
  99. data/lib/jekyll/version.rb +5 -5
  100. data/lib/jekyll.rb +195 -195
  101. data/lib/site_template/.gitignore +5 -5
  102. data/lib/site_template/404.html +25 -25
  103. data/lib/site_template/_config.yml +55 -55
  104. data/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb +29 -29
  105. data/lib/site_template/about.markdown +18 -18
  106. data/lib/site_template/index.markdown +6 -6
  107. data/lib/theme_template/CODE_OF_CONDUCT.md.erb +74 -74
  108. data/lib/theme_template/Gemfile +4 -4
  109. data/lib/theme_template/LICENSE.txt.erb +21 -21
  110. data/lib/theme_template/README.md.erb +52 -52
  111. data/lib/theme_template/_layouts/default.html +1 -1
  112. data/lib/theme_template/_layouts/page.html +5 -5
  113. data/lib/theme_template/_layouts/post.html +5 -5
  114. data/lib/theme_template/example/_config.yml.erb +1 -1
  115. data/lib/theme_template/example/_post.md +12 -12
  116. data/lib/theme_template/example/index.html +14 -14
  117. data/lib/theme_template/example/style.scss +7 -7
  118. data/lib/theme_template/gitignore.erb +6 -6
  119. data/lib/theme_template/theme.gemspec.erb +16 -16
  120. data/rubocop/jekyll/assert_equal_literal_actual.rb +149 -149
  121. data/rubocop/jekyll/no_p_allowed.rb +23 -23
  122. data/rubocop/jekyll/no_puts_allowed.rb +23 -23
  123. data/rubocop/jekyll.rb +5 -5
  124. metadata +3 -3
@@ -1,177 +1,177 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- module Commands
5
- class Doctor < Command
6
- class << self
7
- def init_with_program(prog)
8
- prog.command(:doctor) do |c|
9
- c.syntax "doctor"
10
- c.description "Search site and print specific deprecation warnings"
11
- c.alias(:hyde)
12
-
13
- c.option "config", "--config CONFIG_FILE[,CONFIG_FILE2,...]", Array,
14
- "Custom configuration file"
15
-
16
- c.action do |_, options|
17
- Jekyll::Commands::Doctor.process(options)
18
- end
19
- end
20
- end
21
-
22
- def process(options)
23
- site = Jekyll::Site.new(configuration_from_options(options))
24
- site.reset
25
- site.read
26
- site.generate
27
-
28
- if healthy?(site)
29
- Jekyll.logger.info "Your test results", "are in. Everything looks fine."
30
- else
31
- abort
32
- end
33
- end
34
-
35
- def healthy?(site)
36
- [
37
- fsnotify_buggy?(site),
38
- !deprecated_relative_permalinks(site),
39
- !conflicting_urls(site),
40
- !urls_only_differ_by_case(site),
41
- proper_site_url?(site),
42
- properly_gathered_posts?(site),
43
- ].all?
44
- end
45
-
46
- def properly_gathered_posts?(site)
47
- return true if site.config["collections_dir"].empty?
48
-
49
- posts_at_root = site.in_source_dir("_posts")
50
- return true unless File.directory?(posts_at_root)
51
-
52
- Jekyll.logger.warn "Warning:",
53
- "Detected '_posts' directory outside custom `collections_dir`!"
54
- Jekyll.logger.warn "",
55
- "Please move '#{posts_at_root}' into the custom directory at " \
56
- "'#{site.in_source_dir(site.config["collections_dir"])}'"
57
- false
58
- end
59
-
60
- def deprecated_relative_permalinks(site)
61
- if site.config["relative_permalinks"]
62
- Jekyll::Deprecator.deprecation_message "Your site still uses relative permalinks," \
63
- " which was removed in Jekyll v3.0.0."
64
- true
65
- end
66
- end
67
-
68
- def conflicting_urls(site)
69
- conflicting_urls = false
70
- destination_map(site).each do |dest, paths|
71
- next unless paths.size > 1
72
-
73
- conflicting_urls = true
74
- Jekyll.logger.warn "Conflict:",
75
- "The following destination is shared by multiple files."
76
- Jekyll.logger.warn "", "The written file may end up with unexpected contents."
77
- Jekyll.logger.warn "", dest.to_s.cyan
78
- paths.each { |path| Jekyll.logger.warn "", " - #{path}" }
79
- Jekyll.logger.warn ""
80
- end
81
- conflicting_urls
82
- end
83
-
84
- def fsnotify_buggy?(_site)
85
- return true unless Utils::Platforms.osx?
86
-
87
- if Dir.pwd != `pwd`.strip
88
- Jekyll.logger.error <<~STR
89
- We have detected that there might be trouble using fsevent on your
90
- operating system, you can read https://github.com/thibaudgg/rb-fsevent/wiki/no-fsevents-fired-(OSX-bug)
91
- for possible work arounds or you can work around it immediately
92
- with `--force-polling`.
93
- STR
94
-
95
- false
96
- end
97
-
98
- true
99
- end
100
-
101
- def urls_only_differ_by_case(site)
102
- urls_only_differ_by_case = false
103
- urls = case_insensitive_urls(site.pages + site.docs_to_write, site.dest)
104
- urls.each_value do |real_urls|
105
- next unless real_urls.uniq.size > 1
106
-
107
- urls_only_differ_by_case = true
108
- Jekyll.logger.warn "Warning:", "The following URLs only differ" \
109
- " by case. On a case-insensitive file system one of the URLs" \
110
- " will be overwritten by the other: #{real_urls.join(", ")}"
111
- end
112
- urls_only_differ_by_case
113
- end
114
-
115
- def proper_site_url?(site)
116
- url = site.config["url"]
117
- [
118
- url_exists?(url),
119
- url_valid?(url),
120
- url_absolute(url),
121
- ].all?
122
- end
123
-
124
- private
125
-
126
- def destination_map(site)
127
- {}.tap do |result|
128
- site.each_site_file do |thing|
129
- next if allow_used_permalink?(thing)
130
-
131
- dest_path = thing.destination(site.dest)
132
- (result[dest_path] ||= []) << thing.path
133
- end
134
- end
135
- end
136
-
137
- def allow_used_permalink?(item)
138
- defined?(JekyllRedirectFrom) && item.is_a?(JekyllRedirectFrom::RedirectPage)
139
- end
140
-
141
- def case_insensitive_urls(things, destination)
142
- things.each_with_object({}) do |thing, memo|
143
- dest = thing.destination(destination)
144
- (memo[dest.downcase] ||= []) << dest
145
- end
146
- end
147
-
148
- def url_exists?(url)
149
- return true unless url.nil? || url.empty?
150
-
151
- Jekyll.logger.warn "Warning:", "You didn't set an URL in the config file, "\
152
- "you may encounter problems with some plugins."
153
- false
154
- end
155
-
156
- def url_valid?(url)
157
- Addressable::URI.parse(url)
158
- true
159
- # Addressable::URI#parse only raises a TypeError
160
- # https://git.io/vFfbx
161
- rescue TypeError
162
- Jekyll.logger.warn "Warning:", "The site URL does not seem to be valid, "\
163
- "check the value of `url` in your config file."
164
- false
165
- end
166
-
167
- def url_absolute(url)
168
- return true if url.is_a?(String) && Addressable::URI.parse(url).absolute?
169
-
170
- Jekyll.logger.warn "Warning:", "Your site URL does not seem to be absolute, "\
171
- "check the value of `url` in your config file."
172
- false
173
- end
174
- end
175
- end
176
- end
177
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ module Commands
5
+ class Doctor < Command
6
+ class << self
7
+ def init_with_program(prog)
8
+ prog.command(:doctor) do |c|
9
+ c.syntax "doctor"
10
+ c.description "Search site and print specific deprecation warnings"
11
+ c.alias(:hyde)
12
+
13
+ c.option "config", "--config CONFIG_FILE[,CONFIG_FILE2,...]", Array,
14
+ "Custom configuration file"
15
+
16
+ c.action do |_, options|
17
+ Jekyll::Commands::Doctor.process(options)
18
+ end
19
+ end
20
+ end
21
+
22
+ def process(options)
23
+ site = Jekyll::Site.new(configuration_from_options(options))
24
+ site.reset
25
+ site.read
26
+ site.generate
27
+
28
+ if healthy?(site)
29
+ Jekyll.logger.info "Your test results", "are in. Everything looks fine."
30
+ else
31
+ abort
32
+ end
33
+ end
34
+
35
+ def healthy?(site)
36
+ [
37
+ fsnotify_buggy?(site),
38
+ !deprecated_relative_permalinks(site),
39
+ !conflicting_urls(site),
40
+ !urls_only_differ_by_case(site),
41
+ proper_site_url?(site),
42
+ properly_gathered_posts?(site),
43
+ ].all?
44
+ end
45
+
46
+ def properly_gathered_posts?(site)
47
+ return true if site.config["collections_dir"].empty?
48
+
49
+ posts_at_root = site.in_source_dir("_posts")
50
+ return true unless File.directory?(posts_at_root)
51
+
52
+ Jekyll.logger.warn "Warning:",
53
+ "Detected '_posts' directory outside custom `collections_dir`!"
54
+ Jekyll.logger.warn "",
55
+ "Please move '#{posts_at_root}' into the custom directory at " \
56
+ "'#{site.in_source_dir(site.config["collections_dir"])}'"
57
+ false
58
+ end
59
+
60
+ def deprecated_relative_permalinks(site)
61
+ if site.config["relative_permalinks"]
62
+ Jekyll::Deprecator.deprecation_message "Your site still uses relative permalinks," \
63
+ " which was removed in Jekyll v3.0.0."
64
+ true
65
+ end
66
+ end
67
+
68
+ def conflicting_urls(site)
69
+ conflicting_urls = false
70
+ destination_map(site).each do |dest, paths|
71
+ next unless paths.size > 1
72
+
73
+ conflicting_urls = true
74
+ Jekyll.logger.warn "Conflict:",
75
+ "The following destination is shared by multiple files."
76
+ Jekyll.logger.warn "", "The written file may end up with unexpected contents."
77
+ Jekyll.logger.warn "", dest.to_s.cyan
78
+ paths.each { |path| Jekyll.logger.warn "", " - #{path}" }
79
+ Jekyll.logger.warn ""
80
+ end
81
+ conflicting_urls
82
+ end
83
+
84
+ def fsnotify_buggy?(_site)
85
+ return true unless Utils::Platforms.osx?
86
+
87
+ if Dir.pwd != `pwd`.strip
88
+ Jekyll.logger.error <<~STR
89
+ We have detected that there might be trouble using fsevent on your
90
+ operating system, you can read https://github.com/thibaudgg/rb-fsevent/wiki/no-fsevents-fired-(OSX-bug)
91
+ for possible work arounds or you can work around it immediately
92
+ with `--force-polling`.
93
+ STR
94
+
95
+ false
96
+ end
97
+
98
+ true
99
+ end
100
+
101
+ def urls_only_differ_by_case(site)
102
+ urls_only_differ_by_case = false
103
+ urls = case_insensitive_urls(site.pages + site.docs_to_write, site.dest)
104
+ urls.each_value do |real_urls|
105
+ next unless real_urls.uniq.size > 1
106
+
107
+ urls_only_differ_by_case = true
108
+ Jekyll.logger.warn "Warning:", "The following URLs only differ" \
109
+ " by case. On a case-insensitive file system one of the URLs" \
110
+ " will be overwritten by the other: #{real_urls.join(", ")}"
111
+ end
112
+ urls_only_differ_by_case
113
+ end
114
+
115
+ def proper_site_url?(site)
116
+ url = site.config["url"]
117
+ [
118
+ url_exists?(url),
119
+ url_valid?(url),
120
+ url_absolute(url),
121
+ ].all?
122
+ end
123
+
124
+ private
125
+
126
+ def destination_map(site)
127
+ {}.tap do |result|
128
+ site.each_site_file do |thing|
129
+ next if allow_used_permalink?(thing)
130
+
131
+ dest_path = thing.destination(site.dest)
132
+ (result[dest_path] ||= []) << thing.path
133
+ end
134
+ end
135
+ end
136
+
137
+ def allow_used_permalink?(item)
138
+ defined?(JekyllRedirectFrom) && item.is_a?(JekyllRedirectFrom::RedirectPage)
139
+ end
140
+
141
+ def case_insensitive_urls(things, destination)
142
+ things.each_with_object({}) do |thing, memo|
143
+ dest = thing.destination(destination)
144
+ (memo[dest.downcase] ||= []) << dest
145
+ end
146
+ end
147
+
148
+ def url_exists?(url)
149
+ return true unless url.nil? || url.empty?
150
+
151
+ Jekyll.logger.warn "Warning:", "You didn't set an URL in the config file, "\
152
+ "you may encounter problems with some plugins."
153
+ false
154
+ end
155
+
156
+ def url_valid?(url)
157
+ Addressable::URI.parse(url)
158
+ true
159
+ # Addressable::URI#parse only raises a TypeError
160
+ # https://git.io/vFfbx
161
+ rescue TypeError
162
+ Jekyll.logger.warn "Warning:", "The site URL does not seem to be valid, "\
163
+ "check the value of `url` in your config file."
164
+ false
165
+ end
166
+
167
+ def url_absolute(url)
168
+ return true if url.is_a?(String) && Addressable::URI.parse(url).absolute?
169
+
170
+ Jekyll.logger.warn "Warning:", "Your site URL does not seem to be absolute, "\
171
+ "check the value of `url` in your config file."
172
+ false
173
+ end
174
+ end
175
+ end
176
+ end
177
+ end
@@ -1,34 +1,34 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- module Commands
5
- class Help < Command
6
- class << self
7
- def init_with_program(prog)
8
- prog.command(:help) do |c|
9
- c.syntax "help [subcommand]"
10
- c.description "Show the help message, optionally for a given subcommand."
11
-
12
- c.action do |args, _|
13
- cmd = (args.first || "").to_sym
14
- if args.empty?
15
- Jekyll.logger.info prog.to_s
16
- elsif prog.has_command? cmd
17
- Jekyll.logger.info prog.commands[cmd].to_s
18
- else
19
- invalid_command(prog, cmd)
20
- abort
21
- end
22
- end
23
- end
24
- end
25
-
26
- def invalid_command(prog, cmd)
27
- Jekyll.logger.error "Error:",
28
- "Hmm... we don't know what the '#{cmd}' command is."
29
- Jekyll.logger.info "Valid commands:", prog.commands.keys.join(", ")
30
- end
31
- end
32
- end
33
- end
34
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ module Commands
5
+ class Help < Command
6
+ class << self
7
+ def init_with_program(prog)
8
+ prog.command(:help) do |c|
9
+ c.syntax "help [subcommand]"
10
+ c.description "Show the help message, optionally for a given subcommand."
11
+
12
+ c.action do |args, _|
13
+ cmd = (args.first || "").to_sym
14
+ if args.empty?
15
+ Jekyll.logger.info prog.to_s
16
+ elsif prog.has_command? cmd
17
+ Jekyll.logger.info prog.commands[cmd].to_s
18
+ else
19
+ invalid_command(prog, cmd)
20
+ abort
21
+ end
22
+ end
23
+ end
24
+ end
25
+
26
+ def invalid_command(prog, cmd)
27
+ Jekyll.logger.error "Error:",
28
+ "Hmm... we don't know what the '#{cmd}' command is."
29
+ Jekyll.logger.info "Valid commands:", prog.commands.keys.join(", ")
30
+ end
31
+ end
32
+ end
33
+ end
34
+ end