bridgetown-core 0.18.6 → 0.20.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (97) hide show
  1. checksums.yaml +4 -4
  2. data/bin/bridgetown +6 -0
  3. data/bridgetown-core.gemspec +4 -4
  4. data/lib/bridgetown-core.rb +46 -13
  5. data/lib/bridgetown-core/cleaner.rb +7 -1
  6. data/lib/bridgetown-core/collection.rb +173 -77
  7. data/lib/bridgetown-core/commands/apply.rb +4 -3
  8. data/lib/bridgetown-core/commands/base.rb +9 -0
  9. data/lib/bridgetown-core/commands/concerns/actions.rb +0 -5
  10. data/lib/bridgetown-core/commands/configure.rb +66 -0
  11. data/lib/bridgetown-core/commands/console.rb +4 -0
  12. data/lib/bridgetown-core/commands/new.rb +28 -1
  13. data/lib/bridgetown-core/commands/plugins.rb +1 -0
  14. data/lib/bridgetown-core/concerns/data_accessible.rb +1 -0
  15. data/lib/bridgetown-core/concerns/site/configurable.rb +7 -3
  16. data/lib/bridgetown-core/concerns/site/content.rb +57 -15
  17. data/lib/bridgetown-core/concerns/site/processable.rb +1 -0
  18. data/lib/bridgetown-core/concerns/site/renderable.rb +26 -0
  19. data/lib/bridgetown-core/concerns/site/writable.rb +11 -1
  20. data/lib/bridgetown-core/concerns/validatable.rb +1 -0
  21. data/lib/bridgetown-core/configuration.rb +39 -19
  22. data/lib/bridgetown-core/configurations/.keep +0 -0
  23. data/lib/bridgetown-core/configurations/bt-postcss.rb +26 -0
  24. data/lib/bridgetown-core/configurations/bt-postcss/postcss.config.js +21 -0
  25. data/lib/bridgetown-core/configurations/minitesting.rb +95 -0
  26. data/lib/bridgetown-core/configurations/netlify.rb +6 -0
  27. data/lib/bridgetown-core/configurations/netlify/netlify.sh +14 -0
  28. data/lib/bridgetown-core/configurations/netlify/netlify.toml +44 -0
  29. data/lib/bridgetown-core/configurations/purgecss.rb +49 -0
  30. data/lib/bridgetown-core/configurations/stimulus.rb +49 -0
  31. data/lib/bridgetown-core/configurations/swup.rb +37 -0
  32. data/lib/bridgetown-core/configurations/tailwindcss.rb +29 -0
  33. data/lib/bridgetown-core/configurations/tailwindcss/css_imports.css +4 -0
  34. data/lib/bridgetown-core/configurations/tailwindcss/postcss.config.js +12 -0
  35. data/lib/bridgetown-core/configurations/turbo.rb +16 -0
  36. data/lib/bridgetown-core/converter.rb +14 -0
  37. data/lib/bridgetown-core/converters/erb_templates.rb +6 -13
  38. data/lib/bridgetown-core/converters/identity.rb +0 -9
  39. data/lib/bridgetown-core/converters/markdown.rb +14 -4
  40. data/lib/bridgetown-core/converters/markdown/kramdown_parser.rb +3 -0
  41. data/lib/bridgetown-core/current.rb +10 -0
  42. data/lib/bridgetown-core/document.rb +6 -14
  43. data/lib/bridgetown-core/drops/collection_drop.rb +1 -1
  44. data/lib/bridgetown-core/drops/page_drop.rb +4 -0
  45. data/lib/bridgetown-core/drops/resource_drop.rb +81 -0
  46. data/lib/bridgetown-core/drops/site_drop.rb +33 -8
  47. data/lib/bridgetown-core/drops/unified_payload_drop.rb +4 -0
  48. data/lib/bridgetown-core/entry_filter.rb +10 -23
  49. data/lib/bridgetown-core/errors.rb +0 -2
  50. data/lib/bridgetown-core/filters.rb +4 -3
  51. data/lib/bridgetown-core/generator.rb +2 -1
  52. data/lib/bridgetown-core/generators/prototype_generator.rb +37 -19
  53. data/lib/bridgetown-core/layout.rb +2 -2
  54. data/lib/bridgetown-core/liquid_renderer/file.rb +1 -0
  55. data/lib/bridgetown-core/liquid_renderer/table.rb +1 -0
  56. data/lib/bridgetown-core/model/base.rb +138 -0
  57. data/lib/bridgetown-core/model/builder_origin.rb +40 -0
  58. data/lib/bridgetown-core/model/file_origin.rb +119 -0
  59. data/lib/bridgetown-core/model/origin.rb +38 -0
  60. data/lib/bridgetown-core/page.rb +9 -1
  61. data/lib/bridgetown-core/plugin.rb +2 -26
  62. data/lib/bridgetown-core/plugin_manager.rb +0 -2
  63. data/lib/bridgetown-core/publisher.rb +7 -1
  64. data/lib/bridgetown-core/reader.rb +25 -12
  65. data/lib/bridgetown-core/readers/data_reader.rb +3 -4
  66. data/lib/bridgetown-core/readers/post_reader.rb +1 -1
  67. data/lib/bridgetown-core/regenerator.rb +8 -1
  68. data/lib/bridgetown-core/related_posts.rb +1 -1
  69. data/lib/bridgetown-core/renderer.rb +5 -12
  70. data/lib/bridgetown-core/resource/base.rb +275 -0
  71. data/lib/bridgetown-core/resource/destination.rb +49 -0
  72. data/lib/bridgetown-core/resource/permalink_processor.rb +179 -0
  73. data/lib/bridgetown-core/resource/taxonomy_term.rb +25 -0
  74. data/lib/bridgetown-core/resource/taxonomy_type.rb +47 -0
  75. data/lib/bridgetown-core/resource/transformer.rb +173 -0
  76. data/lib/bridgetown-core/ruby_template_view.rb +13 -2
  77. data/lib/bridgetown-core/site.rb +9 -1
  78. data/lib/bridgetown-core/static_file.rb +33 -10
  79. data/lib/bridgetown-core/url.rb +1 -0
  80. data/lib/bridgetown-core/utils.rb +40 -40
  81. data/lib/bridgetown-core/utils/platforms.rb +1 -0
  82. data/lib/bridgetown-core/version.rb +2 -2
  83. data/lib/site_template/README.md +70 -0
  84. data/lib/site_template/frontend/javascript/index.js.erb +11 -0
  85. data/lib/site_template/frontend/styles/index.css +19 -0
  86. data/lib/site_template/{package.json → package.json.erb} +14 -8
  87. data/lib/site_template/postcss.config.js.erb +11 -0
  88. data/lib/site_template/src/_components/footer.liquid +1 -1
  89. data/lib/site_template/src/_posts/0000-00-00-welcome-to-bridgetown.md.erb +1 -1
  90. data/lib/site_template/{webpack.config.js → webpack.config.js.erb} +47 -5
  91. metadata +67 -42
  92. data/lib/bridgetown-core/page_without_a_file.rb +0 -14
  93. data/lib/bridgetown-core/readers/collection_reader.rb +0 -23
  94. data/lib/bridgetown-core/utils/exec.rb +0 -26
  95. data/lib/bridgetown-core/utils/internet.rb +0 -37
  96. data/lib/bridgetown-core/utils/win_tz.rb +0 -75
  97. data/lib/site_template/frontend/javascript/index.js +0 -3
@@ -0,0 +1,119 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Bridgetown
4
+ module Model
5
+ class FileOrigin < Origin
6
+ YAML_FRONT_MATTER_REGEXP = %r!\A(---\s*\n.*?\n?)^((---|\.\.\.)\s*$\n?)!m.freeze
7
+
8
+ class << self
9
+ def handle_scheme?(scheme)
10
+ scheme == "file"
11
+ end
12
+
13
+ def data_file_extensions
14
+ %w(.yaml .yml .json .csv .tsv).freeze
15
+ end
16
+ end
17
+
18
+ def read
19
+ @data = (in_data_collection? ? read_file_data : read_frontmatter) || {}
20
+ @data[:_id_] = id
21
+ @data[:_origin_] = self
22
+ @data[:_collection_] = collection
23
+ @data[:_content_] = @content if @content
24
+
25
+ @data
26
+ rescue StandardError => e
27
+ handle_read_error(e)
28
+ end
29
+
30
+ def url
31
+ @url = URI.parse(id)
32
+ end
33
+
34
+ def relative_path
35
+ @relative_path ||= Pathname.new(
36
+ Addressable::URI.unescape(url.path.delete_prefix("/"))
37
+ )
38
+ end
39
+
40
+ def collection
41
+ return @collection if @collection
42
+
43
+ collection_name = if url.host.ends_with?(".collection")
44
+ url.host.chomp(".collection")
45
+ else
46
+ "pages"
47
+ end
48
+ @collection = Bridgetown::Current.site.collections[collection_name]
49
+ end
50
+
51
+ def original_path
52
+ @original_path ||= relative_path.expand_path(Bridgetown::Current.site.source)
53
+ end
54
+
55
+ def exists?
56
+ File.exist?(original_path)
57
+ end
58
+
59
+ private
60
+
61
+ def in_data_collection?
62
+ original_path.extname.downcase.in?(self.class.data_file_extensions) &&
63
+ collection.data?
64
+ end
65
+
66
+ def read_file_data
67
+ case original_path.extname.downcase
68
+ when ".csv"
69
+ {
70
+ array:
71
+ CSV.read(original_path,
72
+ headers: true,
73
+ encoding: Bridgetown::Current.site.config["encoding"]).map(&:to_hash),
74
+ }
75
+ when ".tsv"
76
+ {
77
+ array:
78
+ CSV.read(original_path,
79
+ col_sep: "\t",
80
+ headers: true,
81
+ encoding: Bridgetown::Current.site.config["encoding"]).map(&:to_hash),
82
+ }
83
+ else
84
+ yaml_data = SafeYAML.load_file(original_path)
85
+ yaml_data.is_a?(Array) ? { array: yaml_data } : yaml_data
86
+ end
87
+ end
88
+
89
+ def read_frontmatter
90
+ @content = File.read(
91
+ original_path, **Bridgetown::Utils.merged_file_read_opts(Bridgetown::Current.site, {})
92
+ )
93
+ content_match = @content.match(YAML_FRONT_MATTER_REGEXP)
94
+ if content_match
95
+ @content = content_match.post_match
96
+ SafeYAML.load(content_match[1])
97
+ else
98
+ yaml_data = SafeYAML.load_file(original_path)
99
+ yaml_data.is_a?(Array) ? { array: yaml_data } : yaml_data
100
+ end
101
+ end
102
+
103
+ def handle_read_error(error)
104
+ if error.is_a? Psych::SyntaxError
105
+ Bridgetown.logger.error "Error:",
106
+ "YAML Exception reading #{original_path}: #{error.message}"
107
+ else
108
+ Bridgetown.logger.error "Error:",
109
+ "could not read file #{original_path}: #{error.message}"
110
+ end
111
+
112
+ if Bridgetown::Current.site.config["strict_front_matter"] ||
113
+ error.is_a?(Bridgetown::Errors::FatalException)
114
+ raise error
115
+ end
116
+ end
117
+ end
118
+ end
119
+ end
@@ -0,0 +1,38 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Bridgetown
4
+ module Model
5
+ # Abstract Superclass
6
+ class Origin
7
+ extend ActiveSupport::DescendantsTracker
8
+
9
+ # @return [String]
10
+ attr_accessor :id
11
+
12
+ # Override in subclass
13
+ def self.handle_scheme?(_scheme)
14
+ false
15
+ end
16
+
17
+ def initialize(id)
18
+ self.id = id
19
+ end
20
+
21
+ def read
22
+ raise "Implement #read in a subclass of Bridgetown::Model::Origin"
23
+ end
24
+
25
+ # @return [Pathname]
26
+ def relative_path
27
+ raise "Implement #relative_path in a subclass of Bridgetown::Model::Origin"
28
+ end
29
+
30
+ def exists?
31
+ raise "Implement #exists? in a subclass of Bridgetown::Model::Origin"
32
+ end
33
+ end
34
+ end
35
+ end
36
+
37
+ require "bridgetown-core/model/builder_origin"
38
+ require "bridgetown-core/model/file_origin"
@@ -47,7 +47,7 @@ module Bridgetown
47
47
  read_yaml(PathManager.join(base, dir), name)
48
48
 
49
49
  data.default_proc = proc do |_, key|
50
- site.frontmatter_defaults.find(relative_path, type, key)
50
+ site.frontmatter_defaults.find(relative_path, type, key.to_s)
51
51
  end
52
52
 
53
53
  Bridgetown::Hooks.trigger :pages, :post_init, self
@@ -116,6 +116,7 @@ module Bridgetown
116
116
  permalink: permalink
117
117
  ).to_s
118
118
  end
119
+ alias_method :relative_url, :url
119
120
 
120
121
  # Returns a hash of URL placeholder names (as symbols) mapping to the
121
122
  # desired placeholder replacements. For details see "url.rb"
@@ -218,4 +219,11 @@ module Bridgetown
218
219
  true
219
220
  end
220
221
  end
222
+
223
+ # set up virtual page class for future compatibility
224
+ class GeneratedPage < Page
225
+ def read_yaml(_base, _name, _opts = {})
226
+ self.data ||= HashWithDotAccess::Hash.new
227
+ end
228
+ end
221
229
  end
@@ -2,6 +2,8 @@
2
2
 
3
3
  module Bridgetown
4
4
  class Plugin
5
+ extend ActiveSupport::DescendantsTracker
6
+
5
7
  PRIORITIES = {
6
8
  low: -10,
7
9
  highest: 100,
@@ -12,32 +14,6 @@ module Bridgetown
12
14
 
13
15
  SourceManifest = Struct.new(:origin, :components, :content, :layouts, keyword_init: true)
14
16
 
15
- #
16
-
17
- def self.inherited(const)
18
- catch_inheritance(const) do |const_|
19
- catch_inheritance(const_)
20
- end
21
- end
22
-
23
- #
24
-
25
- def self.catch_inheritance(const)
26
- const.define_singleton_method :inherited do |const_|
27
- (@children ||= Set.new).add const_
28
- yield const_ if block_given?
29
- end
30
- end
31
-
32
- #
33
-
34
- def self.descendants
35
- @children ||= Set.new
36
- out = @children.map(&:descendants)
37
- out << self unless superclass == Plugin
38
- Set.new(out).flatten
39
- end
40
-
41
17
  # Get or set the priority of this plugin. When called without an
42
18
  # argument it returns the priority. When an argument is given, it will
43
19
  # set the priority.
@@ -1,7 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require "zeitwerk"
4
-
5
3
  module Bridgetown
6
4
  class PluginManager
7
5
  PLUGINS_GROUP = :bridgetown_plugins
@@ -2,6 +2,7 @@
2
2
 
3
3
  module Bridgetown
4
4
  class Publisher
5
+ # @param site [Bridgetown::Site]
5
6
  def initialize(site)
6
7
  @site = site
7
8
  end
@@ -11,7 +12,12 @@ module Bridgetown
11
12
  end
12
13
 
13
14
  def hidden_in_the_future?(thing)
14
- thing.respond_to?(:date) && !@site.future && thing.date.to_i > @site.time.to_i
15
+ return false unless thing.respond_to?(:date)
16
+
17
+ future_allowed =
18
+ thing.respond_to?(:collection) && thing.collection.metadata.future || @site.future
19
+ thing_time = thing.date.is_a?(Date) ? thing.date.to_time.to_i : thing.date.to_i
20
+ !future_allowed && thing_time > @site.time.to_i
15
21
  end
16
22
 
17
23
  private
@@ -11,20 +11,29 @@ module Bridgetown
11
11
  # Read Site data from disk and load it into internal data structures.
12
12
  #
13
13
  # Returns nothing.
14
- # rubocop:disable Metrics/AbcSize
15
- def read
16
- @site.defaults_reader.read
17
- @site.layouts = LayoutReader.new(site).read
14
+ def read # rubocop:todo Metrics/AbcSize
15
+ site.defaults_reader.read
16
+ site.layouts = LayoutReader.new(site).read
18
17
  read_directories
19
18
  read_included_excludes
20
19
  sort_files!
21
- @site.data = DataReader.new(site).read(site.config["data_dir"])
22
- CollectionReader.new(site).read
20
+ read_collections
21
+ site.data = if site.uses_resource?
22
+ site.collections.data.merge_data_resources
23
+ else
24
+ DataReader.new(site).read
25
+ end
23
26
  Bridgetown::PluginManager.source_manifests.map(&:content).compact.each do |plugin_content_dir|
24
27
  PluginContentReader.new(site, plugin_content_dir).read
25
28
  end
26
29
  end
27
- # rubocop:enable Metrics/AbcSize
30
+
31
+ def read_collections
32
+ site.collections.each_value do |collection|
33
+ collection.read unless !site.uses_resource? &&
34
+ collection.legacy_reader?
35
+ end
36
+ end
28
37
 
29
38
  # Sorts posts, pages, and static files.
30
39
  def sort_files!
@@ -61,7 +70,7 @@ module Bridgetown
61
70
  end
62
71
  end
63
72
 
64
- retrieve_posts(dir)
73
+ retrieve_posts(dir) unless site.uses_resource?
65
74
  retrieve_dirs(base, dir, dot_dirs)
66
75
  retrieve_pages(dir, dot_pages)
67
76
  retrieve_static_files(dir, dot_static_files)
@@ -102,6 +111,13 @@ module Bridgetown
102
111
  #
103
112
  # Returns nothing.
104
113
  def retrieve_pages(dir, dot_pages)
114
+ if site.uses_resource?
115
+ dot_pages.each do |page_path|
116
+ site.collections.pages.send(:read_resource, site.in_source_dir(dir, page_path))
117
+ end
118
+ return
119
+ end
120
+
105
121
  site.pages.concat(PageReader.new(site, dir).read(dot_pages))
106
122
  end
107
123
 
@@ -126,7 +142,7 @@ module Bridgetown
126
142
  #
127
143
  # Returns the Array of filtered entries.
128
144
  def filter_entries(entries, base_directory = nil)
129
- EntryFilter.new(site, base_directory).filter(entries)
145
+ EntryFilter.new(site, base_directory: base_directory).filter(entries)
130
146
  end
131
147
 
132
148
  # Read the entries from a particular directory for processing
@@ -165,14 +181,11 @@ module Bridgetown
165
181
  end
166
182
 
167
183
  def read_included_excludes
168
- entry_filter = EntryFilter.new(site)
169
-
170
184
  site.include.each do |entry|
171
185
  next if entry == ".htaccess"
172
186
 
173
187
  entry_path = site.in_source_dir(entry)
174
188
  next if File.directory?(entry_path)
175
- next if entry_filter.symlink?(entry_path)
176
189
 
177
190
  read_included_file(entry_path) if File.file?(entry_path)
178
191
  end
@@ -16,8 +16,8 @@ module Bridgetown
16
16
  #
17
17
  # Returns @content, a Hash of the .yaml, .yml,
18
18
  # .json, and .csv files in the base directory
19
- def read(dir)
20
- base = site.in_source_dir(dir)
19
+ def read
20
+ base = site.in_source_dir(site.config.data_dir)
21
21
  read_data_to(base, @content)
22
22
  merge_environment_specific_metadata!
23
23
  @content = @content.with_dot_access
@@ -31,7 +31,7 @@ module Bridgetown
31
31
  #
32
32
  # Returns nothing
33
33
  def read_data_to(dir, data)
34
- return unless File.directory?(dir) && !@entry_filter.symlink?(dir)
34
+ return unless File.directory?(dir)
35
35
 
36
36
  entries = Dir.chdir(dir) do
37
37
  Dir["*.{yaml,yml,json,csv,tsv}"] + Dir["*"].select { |fn| File.directory?(fn) }
@@ -39,7 +39,6 @@ module Bridgetown
39
39
 
40
40
  entries.each do |entry|
41
41
  path = @site.in_source_dir(dir, entry)
42
- next if @entry_filter.symlink?(path)
43
42
 
44
43
  if File.directory?(path)
45
44
  read_data_to(
@@ -98,7 +98,7 @@ module Bridgetown
98
98
  if item.is_a?(Document)
99
99
  site.posts.docs << item
100
100
  elsif item.is_a?(StaticFile)
101
- site.posts.files << item
101
+ site.posts.static_files << item
102
102
  site.static_files << item
103
103
  end
104
104
 
@@ -19,7 +19,7 @@ module Bridgetown
19
19
  # Checks if a renderable object needs to be regenerated
20
20
  #
21
21
  # Returns a boolean.
22
- def regenerate?(document)
22
+ def regenerate?(document) # rubocop:todo Metrics/CyclomaticComplexity
23
23
  return true if disabled
24
24
 
25
25
  case document
@@ -27,6 +27,8 @@ module Bridgetown
27
27
  regenerate_page?(document)
28
28
  when Document
29
29
  regenerate_document?(document)
30
+ when Bridgetown::Resource::Base
31
+ regenerate_resource?(document)
30
32
  else
31
33
  source_path = document.respond_to?(:path) ? document.path : nil
32
34
  dest_path = document.destination(@site.dest) if document.respond_to?(:destination)
@@ -176,6 +178,11 @@ module Bridgetown
176
178
  )
177
179
  end
178
180
 
181
+ # TODO: need to manage dependencies, but for now always regenerate
182
+ def regenerate_resource?(_resource)
183
+ true
184
+ end
185
+
179
186
  def existing_file_modified?(path)
180
187
  # If one of this file dependencies have been modified,
181
188
  # set the regeneration bit for both the dependency and the file to true
@@ -42,7 +42,7 @@ module Bridgetown
42
42
  end
43
43
 
44
44
  def lsi_related_posts
45
- self.class.lsi.find_related(post, 11)
45
+ self.class.lsi.find_related(post, 11) - [post]
46
46
  end
47
47
 
48
48
  def most_recent_posts
@@ -1,6 +1,8 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Bridgetown
4
+ # This class handles the output rendering and layout placement of pages and
5
+ # documents. For rendering of resources in particular, see Bridgetown::Resource::Transformer
4
6
  class Renderer
5
7
  attr_reader :document, :site
6
8
 
@@ -121,21 +123,11 @@ module Bridgetown
121
123
  "in #{document.relative_path} does not exist."
122
124
  end
123
125
 
124
- def converters_for_layout(layout)
125
- site.converters.select do |converter|
126
- if converter.method(:matches).arity == 1
127
- converter.matches(layout.ext)
128
- else
129
- converter.matches(layout.ext, layout)
130
- end
131
- end.sort
132
- end
133
-
134
126
  # Render layout content into document.output
135
127
  #
136
128
  # Returns String rendered content
137
129
  def render_layout(output, layout)
138
- layout_converters = converters_for_layout(layout)
130
+ layout_converters = site.matched_converters_for_convertible(layout)
139
131
 
140
132
  layout_content = layout.content.dup
141
133
  layout_converters.reduce(layout_content) do |layout_output, converter|
@@ -163,7 +155,8 @@ module Bridgetown
163
155
 
164
156
  def permalink_ext
165
157
  document_permalink = document.permalink
166
- if document_permalink && !document_permalink.end_with?("/")
158
+ if document_permalink &&
159
+ !document_permalink.end_with?("/")
167
160
  permalink_ext = File.extname(document_permalink)
168
161
  permalink_ext unless permalink_ext.empty?
169
162
  end