jekyll 4.2.0 → 4.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (124) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +350 -347
  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 +169 -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 -365
  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 -260
  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 -270
  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