jekyll 4.2.1 → 4.2.2

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 -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,62 +1,62 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- class LayoutReader
5
- attr_reader :site
6
-
7
- def initialize(site)
8
- @site = site
9
- @layouts = {}
10
- end
11
-
12
- def read
13
- layout_entries.each do |layout_file|
14
- @layouts[layout_name(layout_file)] = \
15
- Layout.new(site, layout_directory, layout_file)
16
- end
17
-
18
- theme_layout_entries.each do |layout_file|
19
- @layouts[layout_name(layout_file)] ||= \
20
- Layout.new(site, theme_layout_directory, layout_file)
21
- end
22
-
23
- @layouts
24
- end
25
-
26
- def layout_directory
27
- @layout_directory ||= site.in_source_dir(site.config["layouts_dir"])
28
- end
29
-
30
- def theme_layout_directory
31
- @theme_layout_directory ||= site.theme.layouts_path if site.theme
32
- end
33
-
34
- private
35
-
36
- def layout_entries
37
- entries_in layout_directory
38
- end
39
-
40
- def theme_layout_entries
41
- theme_layout_directory ? entries_in(theme_layout_directory) : []
42
- end
43
-
44
- def entries_in(dir)
45
- entries = []
46
- within(dir) do
47
- entries = EntryFilter.new(site).filter(Dir["**/*.*"])
48
- end
49
- entries
50
- end
51
-
52
- def layout_name(file)
53
- file.split(".")[0..-2].join(".")
54
- end
55
-
56
- def within(directory)
57
- return unless File.exist?(directory)
58
-
59
- Dir.chdir(directory) { yield }
60
- end
61
- end
62
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ class LayoutReader
5
+ attr_reader :site
6
+
7
+ def initialize(site)
8
+ @site = site
9
+ @layouts = {}
10
+ end
11
+
12
+ def read
13
+ layout_entries.each do |layout_file|
14
+ @layouts[layout_name(layout_file)] = \
15
+ Layout.new(site, layout_directory, layout_file)
16
+ end
17
+
18
+ theme_layout_entries.each do |layout_file|
19
+ @layouts[layout_name(layout_file)] ||= \
20
+ Layout.new(site, theme_layout_directory, layout_file)
21
+ end
22
+
23
+ @layouts
24
+ end
25
+
26
+ def layout_directory
27
+ @layout_directory ||= site.in_source_dir(site.config["layouts_dir"])
28
+ end
29
+
30
+ def theme_layout_directory
31
+ @theme_layout_directory ||= site.theme.layouts_path if site.theme
32
+ end
33
+
34
+ private
35
+
36
+ def layout_entries
37
+ entries_in layout_directory
38
+ end
39
+
40
+ def theme_layout_entries
41
+ theme_layout_directory ? entries_in(theme_layout_directory) : []
42
+ end
43
+
44
+ def entries_in(dir)
45
+ entries = []
46
+ within(dir) do
47
+ entries = EntryFilter.new(site).filter(Dir["**/*.*"])
48
+ end
49
+ entries
50
+ end
51
+
52
+ def layout_name(file)
53
+ file.split(".")[0..-2].join(".")
54
+ end
55
+
56
+ def within(directory)
57
+ return unless File.exist?(directory)
58
+
59
+ Dir.chdir(directory) { yield }
60
+ end
61
+ end
62
+ end
@@ -1,25 +1,25 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- class PageReader
5
- attr_reader :site, :dir, :unfiltered_content
6
-
7
- def initialize(site, dir)
8
- @site = site
9
- @dir = dir
10
- @unfiltered_content = []
11
- end
12
-
13
- # Create a new `Jekyll::Page` object for each entry in a given array.
14
- #
15
- # files - An array of file names inside `@dir`
16
- #
17
- # Returns an array of publishable `Jekyll::Page` objects.
18
- def read(files)
19
- files.each do |page|
20
- @unfiltered_content << Page.new(@site, @site.source, @dir, page)
21
- end
22
- @unfiltered_content.select { |page| site.publisher.publish?(page) }
23
- end
24
- end
25
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ class PageReader
5
+ attr_reader :site, :dir, :unfiltered_content
6
+
7
+ def initialize(site, dir)
8
+ @site = site
9
+ @dir = dir
10
+ @unfiltered_content = []
11
+ end
12
+
13
+ # Create a new `Jekyll::Page` object for each entry in a given array.
14
+ #
15
+ # files - An array of file names inside `@dir`
16
+ #
17
+ # Returns an array of publishable `Jekyll::Page` objects.
18
+ def read(files)
19
+ files.each do |page|
20
+ @unfiltered_content << Page.new(@site, @site.source, @dir, page)
21
+ end
22
+ @unfiltered_content.select { |page| site.publisher.publish?(page) }
23
+ end
24
+ end
25
+ end
@@ -1,85 +1,85 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- class PostReader
5
- attr_reader :site, :unfiltered_content
6
-
7
- def initialize(site)
8
- @site = site
9
- end
10
-
11
- # Read all the files in <source>/<dir>/_drafts and create a new
12
- # Document object with each one.
13
- #
14
- # dir - The String relative path of the directory to read.
15
- #
16
- # Returns nothing.
17
- def read_drafts(dir)
18
- read_publishable(dir, "_drafts", Document::DATELESS_FILENAME_MATCHER)
19
- end
20
-
21
- # Read all the files in <source>/<dir>/_posts and create a new Document
22
- # object with each one.
23
- #
24
- # dir - The String relative path of the directory to read.
25
- #
26
- # Returns nothing.
27
- def read_posts(dir)
28
- read_publishable(dir, "_posts", Document::DATE_FILENAME_MATCHER)
29
- end
30
-
31
- # Read all the files in <source>/<dir>/<magic_dir> and create a new
32
- # Document object with each one insofar as it matches the regexp matcher.
33
- #
34
- # dir - The String relative path of the directory to read.
35
- #
36
- # Returns nothing.
37
- def read_publishable(dir, magic_dir, matcher)
38
- read_content(dir, magic_dir, matcher)
39
- .tap { |docs| docs.each(&:read) }
40
- .select { |doc| processable?(doc) }
41
- end
42
-
43
- # Read all the content files from <source>/<dir>/magic_dir
44
- # and return them with the type klass.
45
- #
46
- # dir - The String relative path of the directory to read.
47
- # magic_dir - The String relative directory to <dir>,
48
- # looks for content here.
49
- # klass - The return type of the content.
50
- #
51
- # Returns klass type of content files
52
- def read_content(dir, magic_dir, matcher)
53
- @site.reader.get_entries(dir, magic_dir).map do |entry|
54
- next unless matcher.match?(entry)
55
-
56
- path = @site.in_source_dir(File.join(dir, magic_dir, entry))
57
- Document.new(path,
58
- :site => @site,
59
- :collection => @site.posts)
60
- end.tap(&:compact!)
61
- end
62
-
63
- private
64
-
65
- def processable?(doc)
66
- if doc.content.nil?
67
- Jekyll.logger.debug "Skipping:", "Content in #{doc.relative_path} is nil"
68
- false
69
- elsif !doc.content.valid_encoding?
70
- Jekyll.logger.debug "Skipping:", "#{doc.relative_path} is not valid UTF-8"
71
- false
72
- else
73
- publishable?(doc)
74
- end
75
- end
76
-
77
- def publishable?(doc)
78
- site.publisher.publish?(doc).tap do |will_publish|
79
- if !will_publish && site.publisher.hidden_in_the_future?(doc)
80
- Jekyll.logger.warn "Skipping:", "#{doc.relative_path} has a future date"
81
- end
82
- end
83
- end
84
- end
85
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ class PostReader
5
+ attr_reader :site, :unfiltered_content
6
+
7
+ def initialize(site)
8
+ @site = site
9
+ end
10
+
11
+ # Read all the files in <source>/<dir>/_drafts and create a new
12
+ # Document object with each one.
13
+ #
14
+ # dir - The String relative path of the directory to read.
15
+ #
16
+ # Returns nothing.
17
+ def read_drafts(dir)
18
+ read_publishable(dir, "_drafts", Document::DATELESS_FILENAME_MATCHER)
19
+ end
20
+
21
+ # Read all the files in <source>/<dir>/_posts and create a new Document
22
+ # object with each one.
23
+ #
24
+ # dir - The String relative path of the directory to read.
25
+ #
26
+ # Returns nothing.
27
+ def read_posts(dir)
28
+ read_publishable(dir, "_posts", Document::DATE_FILENAME_MATCHER)
29
+ end
30
+
31
+ # Read all the files in <source>/<dir>/<magic_dir> and create a new
32
+ # Document object with each one insofar as it matches the regexp matcher.
33
+ #
34
+ # dir - The String relative path of the directory to read.
35
+ #
36
+ # Returns nothing.
37
+ def read_publishable(dir, magic_dir, matcher)
38
+ read_content(dir, magic_dir, matcher)
39
+ .tap { |docs| docs.each(&:read) }
40
+ .select { |doc| processable?(doc) }
41
+ end
42
+
43
+ # Read all the content files from <source>/<dir>/magic_dir
44
+ # and return them with the type klass.
45
+ #
46
+ # dir - The String relative path of the directory to read.
47
+ # magic_dir - The String relative directory to <dir>,
48
+ # looks for content here.
49
+ # klass - The return type of the content.
50
+ #
51
+ # Returns klass type of content files
52
+ def read_content(dir, magic_dir, matcher)
53
+ @site.reader.get_entries(dir, magic_dir).map do |entry|
54
+ next unless matcher.match?(entry)
55
+
56
+ path = @site.in_source_dir(File.join(dir, magic_dir, entry))
57
+ Document.new(path,
58
+ :site => @site,
59
+ :collection => @site.posts)
60
+ end.tap(&:compact!)
61
+ end
62
+
63
+ private
64
+
65
+ def processable?(doc)
66
+ if doc.content.nil?
67
+ Jekyll.logger.debug "Skipping:", "Content in #{doc.relative_path} is nil"
68
+ false
69
+ elsif !doc.content.valid_encoding?
70
+ Jekyll.logger.debug "Skipping:", "#{doc.relative_path} is not valid UTF-8"
71
+ false
72
+ else
73
+ publishable?(doc)
74
+ end
75
+ end
76
+
77
+ def publishable?(doc)
78
+ site.publisher.publish?(doc).tap do |will_publish|
79
+ if !will_publish && site.publisher.hidden_in_the_future?(doc)
80
+ Jekyll.logger.warn "Skipping:", "#{doc.relative_path} has a future date"
81
+ end
82
+ end
83
+ end
84
+ end
85
+ end
@@ -1,25 +1,25 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- class StaticFileReader
5
- attr_reader :site, :dir, :unfiltered_content
6
-
7
- def initialize(site, dir)
8
- @site = site
9
- @dir = dir
10
- @unfiltered_content = []
11
- end
12
-
13
- # Create a new StaticFile object for every entry in a given list of basenames.
14
- #
15
- # files - an array of file basenames.
16
- #
17
- # Returns an array of static files.
18
- def read(files)
19
- files.each do |file|
20
- @unfiltered_content << StaticFile.new(@site, @site.source, @dir, file)
21
- end
22
- @unfiltered_content
23
- end
24
- end
25
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ class StaticFileReader
5
+ attr_reader :site, :dir, :unfiltered_content
6
+
7
+ def initialize(site, dir)
8
+ @site = site
9
+ @dir = dir
10
+ @unfiltered_content = []
11
+ end
12
+
13
+ # Create a new StaticFile object for every entry in a given list of basenames.
14
+ #
15
+ # files - an array of file basenames.
16
+ #
17
+ # Returns an array of static files.
18
+ def read(files)
19
+ files.each do |file|
20
+ @unfiltered_content << StaticFile.new(@site, @site.source, @dir, file)
21
+ end
22
+ @unfiltered_content
23
+ end
24
+ end
25
+ end
@@ -1,52 +1,52 @@
1
- # frozen_string_literal: true
2
-
3
- module Jekyll
4
- class ThemeAssetsReader
5
- attr_reader :site
6
-
7
- def initialize(site)
8
- @site = site
9
- end
10
-
11
- def read
12
- return unless site.theme&.assets_path
13
-
14
- Find.find(site.theme.assets_path) do |path|
15
- next if File.directory?(path)
16
-
17
- if File.symlink?(path)
18
- Jekyll.logger.warn "Theme reader:", "Ignored symlinked asset: #{path}"
19
- else
20
- read_theme_asset(path)
21
- end
22
- end
23
- end
24
-
25
- private
26
-
27
- def read_theme_asset(path)
28
- base = site.theme.root
29
- dir = File.dirname(path.sub("#{site.theme.root}/", ""))
30
- name = File.basename(path)
31
-
32
- if Utils.has_yaml_header?(path)
33
- append_unless_exists site.pages,
34
- Jekyll::Page.new(site, base, dir, name)
35
- else
36
- append_unless_exists site.static_files,
37
- Jekyll::StaticFile.new(site, base, "/#{dir}", name)
38
- end
39
- end
40
-
41
- def append_unless_exists(haystack, new_item)
42
- if haystack.any? { |file| file.relative_path == new_item.relative_path }
43
- Jekyll.logger.debug "Theme:",
44
- "Ignoring #{new_item.relative_path} in theme due to existing file " \
45
- "with that path in site."
46
- return
47
- end
48
-
49
- haystack << new_item
50
- end
51
- end
52
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Jekyll
4
+ class ThemeAssetsReader
5
+ attr_reader :site
6
+
7
+ def initialize(site)
8
+ @site = site
9
+ end
10
+
11
+ def read
12
+ return unless site.theme&.assets_path
13
+
14
+ Find.find(site.theme.assets_path) do |path|
15
+ next if File.directory?(path)
16
+
17
+ if File.symlink?(path)
18
+ Jekyll.logger.warn "Theme reader:", "Ignored symlinked asset: #{path}"
19
+ else
20
+ read_theme_asset(path)
21
+ end
22
+ end
23
+ end
24
+
25
+ private
26
+
27
+ def read_theme_asset(path)
28
+ base = site.theme.root
29
+ dir = File.dirname(path.sub("#{site.theme.root}/", ""))
30
+ name = File.basename(path)
31
+
32
+ if Utils.has_yaml_header?(path)
33
+ append_unless_exists site.pages,
34
+ Jekyll::Page.new(site, base, dir, name)
35
+ else
36
+ append_unless_exists site.static_files,
37
+ Jekyll::StaticFile.new(site, base, "/#{dir}", name)
38
+ end
39
+ end
40
+
41
+ def append_unless_exists(haystack, new_item)
42
+ if haystack.any? { |file| file.relative_path == new_item.relative_path }
43
+ Jekyll.logger.debug "Theme:",
44
+ "Ignoring #{new_item.relative_path} in theme due to existing file " \
45
+ "with that path in site."
46
+ return
47
+ end
48
+
49
+ haystack << new_item
50
+ end
51
+ end
52
+ end