Module: Bridgetown::Site::Content

Included in:
Bridgetown::Site
Defined in:
lib/bridgetown-core/concerns/site/content.rb

Overview

Content is king!

Instance Method Summary collapse

Instance Method Details

#add_generated_page(generated_page) ⇒ Object 



112
113
114
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 112

def add_generated_page(generated_page)
  generated_pages << generated_page
end

#categories ⇒ Object 



25
26
27
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 25

def categories
  taxonomies.category
end

#collection_names ⇒ Array<String>

An array of collection names.

Returns:

  • (Array<String>) —

    an array of collection names from the configuration, or an empty array if the config["collections"] key is not set.



66
67
68
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 66

def collection_names
  Array(config.collections&.keys)
end

#collections ⇒ HashWithDotAccess::Hash{String, Symbol => Collection}, HashWithDotAccess::Hash

The list of collections labels and their corresponding Collection instances.

If config['collections'] is set, a new instance of Collection is created for each entry in the collections configuration.

If config["collections"] is not specified, a blank hash is returned.

Returns:



54
55
56
57
58
59
60
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 54

def collections
  @collections ||= collection_names.each_with_object(
    HashWithDotAccess::Hash.new
  ) do |name, hsh|
    hsh[name] = Bridgetown::Collection.new(self, name)
  end
end

#frontend_manifest ⇒ Hash

Loads and memoizes the parsed frontend bundler manifest file (if available)

Returns:

  • (Hash) 


119
120
121
122
123
124
125
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 119

def frontend_manifest
  @frontend_manifest ||= begin
    manifest_file = File.join(frontend_bundling_path, "manifest.json")

    JSON.parse(File.read(manifest_file)) if File.exist?(manifest_file)
  end
end

#metadata ⇒ HashWithDotAccess::Hash

Returns the contents of the site metadata file or a blank hash

Returns:



32
33
34
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 32

def metadata
  signals["site_metadata"] ||= HashWithDotAccess::Hash.new
end

#resources ⇒ Array<Bridgetown::Resource::Base> Also known as: contents

Get all loaded resources.

Returns:



90
91
92
93
94
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 90

def resources
  collections.each_with_object(Set.new) do |(_, collection), set|
    set.merge(collection.resources)
  end.to_a
end

#resources_grouped_by_taxonomy(taxonomy) ⇒ Object 



8
9
10
11
12
13
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 8

def resources_grouped_by_taxonomy(taxonomy)
  data.site_taxonomies_hash ||= {}
  data.site_taxonomies_hash[taxonomy.label] ||= taxonomy.terms.transform_values do |terms|
    terms.map(&:resource).sort.reverse
  end
end

#resources_to_write ⇒ Object 



98
99
100
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 98

def resources_to_write
  resources.select(&:write?)
end

#site_payload ⇒ Hash Also known as: to_liquid

The Hash payload containing site-wide data.

Returns:

  • (Hash) —

    Returns a hash in the structure of { "site" => data }



39
40
41
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 39

def site_payload
  Bridgetown::Drops::UnifiedPayloadDrop.new self
end

#static_files_to_write ⇒ Array<StaticFile>

Get the static files to be written

Returns:

  • (Array<StaticFile>) —

    an array of files which should be written and that respond_to :write?

See Also:



108
109
110
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 108

def static_files_to_write
  static_files.select(&:write?)
end

#tags ⇒ Object 



21
22
23
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 21

def tags
  taxonomies.tag
end

#taxonomies ⇒ Object 



15
16
17
18
19
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 15

def taxonomies
  taxonomy_types.transform_values do |taxonomy|
    resources_grouped_by_taxonomy(taxonomy)
  end
end

#taxonomy_types ⇒ Array<Bridgetown::Resource::TaxonomyType>

Returns:



71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/bridgetown-core/concerns/site/content.rb', line 71

def taxonomy_types
  @taxonomy_types ||= config.taxonomies.to_dot_h do |label, key_or_metadata|
    key = key_or_metadata
    tax_metadata = if key_or_metadata.is_a? Hash
                     key = key_or_metadata["key"]
                     key_or_metadata.reject { |k| k == "key" }
                   else
                     HashWithDotAccess::Hash.new
                   end

    [label, Bridgetown::Resource::TaxonomyType.new(
      site: self, label:, key:, metadata: tax_metadata
    ),]
  end
end