Class: Middleman::Sitemap::Resource

Inherits:
Object
  • Object
show all
Includes:
Extensions::ContentType, Extensions::Traversal
Defined in:
lib/middleman-core/sitemap/resource.rb

Overview

Sitemap Resource class

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Extensions::ContentType

#content_type

Methods included from Extensions::Traversal

#children, #directory_index?, #eponymous_directory?, #eponymous_directory_path, #parent, #siblings

Constructor Details

#initialize(store, path, source_file = nil) ⇒ Resource

Initialize resource with parent store and URL

Parameters:



38
39
40
41
42
43
44
45
46
47
 
# File 'lib/middleman-core/sitemap/resource.rb', line 38

def initialize(store, path, source_file=nil)
  @store       = store
  @app         = @store.app
  @path        = path
  @source_file = source_file

  @destination_paths = [@path]

  @local_metadata = { :options => {}, :locals => {}, :page => {}, :blocks => [] }
end

Instance Attribute Details

#app ⇒ Middleman::Application (readonly)

Returns:



15
16
17
 
# File 'lib/middleman-core/sitemap/resource.rb', line 15

def app
  @app
end

#path ⇒ String (readonly)

The source path of this resource (relative to the source directory, without template extensions)

Returns:



24
25
26
 
# File 'lib/middleman-core/sitemap/resource.rb', line 24

def path
  @path
end

#store ⇒ Middleman::Sitemap::Store (readonly)

Returns:



19
20
21
 
# File 'lib/middleman-core/sitemap/resource.rb', line 19

def store
  @store
end

Instance Method Details

#add_metadata(metadata = {}, &block) ⇒ Object

Merge in new metadata specific to this resource.

Parameters:

  • metadata (Hash) (defaults to: {}) —

    A metadata block like provides_metadata_for_path takes



80
81
82
83
84
85
86
87
 
# File 'lib/middleman-core/sitemap/resource.rb', line 80

def add_metadata(metadata={}, &block)
  metadata = metadata.dup
  if metadata.has_key?(:blocks)
    @local_metadata[:blocks] << metadata.delete(:blocks)
  end
  @local_metadata.deep_merge!(metadata)
  @local_metadata[:blocks] << block if block_given?
end

#binary? ⇒ Boolean

Whether the source file is binary.

Returns:

  • (Boolean) 


169
170
171
 
# File 'lib/middleman-core/sitemap/resource.rb', line 169

def binary?
  ::Middleman::Util.binary?(source_file)
end

#destination_path ⇒ String

Get the output/preview URL for this resource

Returns:



91
92
93
 
# File 'lib/middleman-core/sitemap/resource.rb', line 91

def destination_path
  @destination_paths.last
end

#destination_path=(path) ⇒ void

This method returns an undefined value.

Set the output/preview URL for this resource

Parameters:



98
99
100
 
# File 'lib/middleman-core/sitemap/resource.rb', line 98

def destination_path=(path)
  @destination_paths << path
end

#ext ⇒ String

Extension of the path (i.e. ‘.js’)

Returns:



104
105
106
 
# File 'lib/middleman-core/sitemap/resource.rb', line 104

def ext
  File.extname(path)
end

#metadata ⇒ Hash

Get the metadata for both the current source_file and the current path

Returns:

  • (Hash) 


58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/middleman-core/sitemap/resource.rb', line 58

def metadata
  result = store.metadata_for_path(path).dup

  file_meta = store.metadata_for_file(source_file).dup
  if file_meta.has_key?(:blocks)
    result[:blocks] << file_meta.delete(:blocks)
  end
  result.deep_merge!(file_meta)

  local_meta = @local_metadata.dup
  if local_meta.has_key?(:blocks)
    result[:blocks] << local_meta.delete(:blocks)
  end
  result.deep_merge!(local_meta)

  result[:blocks] = result[:blocks].flatten.compact

  result
end

#render(opts = {}, locs = {}, &block) ⇒ String

Render this resource

Returns:



114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/middleman-core/sitemap/resource.rb', line 114

def render(opts={}, locs={}, &block)
  if !template?
    return app.template_data_for_file(source_file)
  end

  relative_source = Pathname(source_file).relative_path_from(Pathname(app.root))

  instrument "render.resource", :path => relative_source  do
    md   = metadata.dup
    opts = md[:options].deep_merge(opts)

    # Pass "renderer_options" hash from frontmatter along to renderer
    if md[:page]["renderer_options"]
      opts[:renderer_options] = {}
      md[:page]["renderer_options"].each do |k, v|
        opts[:renderer_options][k.to_sym] = v
      end
    end

    locs = md[:locals].deep_merge(locs)

    # Forward remaining data to helpers
    if md.has_key?(:page)
      app.data.store("page", md[:page])
    end

    blocks = Array(md[:blocks]).dup
    blocks << block if block_given?

    app.current_path ||= self.destination_path

    # Certain output file types don't use layouts
    if !opts.has_key?(:layout)
      opts[:layout] = false if %w(.js .json .css .txt).include?(self.ext)
    end

    app.render_template(source_file, locs, opts, blocks)
  end
end

#request_path ⇒ Object 



108
109
110
 
# File 'lib/middleman-core/sitemap/resource.rb', line 108

def request_path
  self.destination_path
end

#source_file ⇒ String

Set the on-disk source file for this resource attr_reader :source_file

Returns:



30
31
32
 
# File 'lib/middleman-core/sitemap/resource.rb', line 30

def source_file
  @source_file || get_source_file
end

#template? ⇒ Boolean

Whether this resource has a template file

Returns:

  • (Boolean) 


51
52
53
54
 
# File 'lib/middleman-core/sitemap/resource.rb', line 51

def template?
  return false if source_file.nil?
  !::Tilt[source_file].nil?
end

#url ⇒ String

A path without the directory index - so foo/index.html becomes just foo. Best for linking.

Returns:



157
158
159
160
161
162
163
164
 
# File 'lib/middleman-core/sitemap/resource.rb', line 157

def url
  url_path = destination_path
  if app.strip_index_file
    url_path = url_path.sub(/(^|\/)#{Regexp.escape(app.index_file)}$/,
                            app.trailing_slash ? '/' : '')
  end
  File.join(app.respond_to?(:http_prefix) ? app.http_prefix : '/', url_path)
end