Module: Hyde::Helpers

Defined in:
lib/hyde/helpers.rb

Instance Method Summary collapse

Instance Method Details

#content_blocks ⇒ Object 



86
87
88
89
 
# File 'lib/hyde/helpers.rb', line 86

def content_blocks
  $content_blocks ||= Hash.new
  $content_blocks[page.path] ||= Hash.new
end

#content_for(key, &blk) ⇒ Object

Method: content_for (Hyde::Helpers) Content for.

## See also

* {Hyde::Helpers::has_content?}
* {Hyde::Helpers::content_for}
* {Hyde::Helpers::yield_content}



82
83
84
 
# File 'lib/hyde/helpers.rb', line 82

def content_for(key, &blk)
  content_blocks[key.to_sym] = blk
end

#has_content?(key) ⇒ Boolean

Method: has_content? (Hyde::Helpers) Checks if there’s something defined for a given content block.

## Example

See {Hyde::Helpers::content_for} for an example.

## See also

* {Hyde::Helpers::has_content?}
* {Hyde::Helpers::content_for}
* {Hyde::Helpers::yield_content}

Returns:

  • (Boolean) 


102
103
104
 
# File 'lib/hyde/helpers.rb', line 102

def has_content?(key)
  content_blocks.member? key.to_sym
end

#partial(path, locals = {}) ⇒ Object

Method: partial (Hyde::Helpers) Renders a partial.

## Usage

<%= partial path, locals %>

## Description

See [Introduction: Partials](/introduction/partials.html) for more 
info.

## Example

If your ‘_layouts/_banner.erb` looks like this:

<div class='banner'>
  Welcome to <%= start.title %>
</div>

…Then this will embed the partial ‘_layouts/_nav.erb`. The partial will be rendered with `start` being set to the current page.

<%= partial '_banner', :start => page %>



36
37
38
39
 
# File 'lib/hyde/helpers.rb', line 36

def partial(path, locals={})
  partial = Partial[path.to_s, page]  or return ''
  partial.to_html locals.merge(:page => self)
end

#rel(path) ⇒ Object

Method: rel (Hyde::Helpers) Turns a path into a relative path.

## Usage

<%= rel(path) %>

## Description

`rel` takes a given absolute path that begins with a `/` (for instance, 
`/x/y/z.html`) and returns a relative path (maybe `../y/z.html`). This is
useful if your site will not be be hosted on it's own domain.

## Example

   <% page.children.each do |child| %>
     <a href="<%= rel(child.path) %>">
       <%= child.title %>
     </a>
   <% end %>

This may output:

   <a href="../../foo.html">
     Foobar
   </a>

…where the ‘../../` depends on the current page’s path.



67
68
69
70
71
 
# File 'lib/hyde/helpers.rb', line 67

def rel(path)
  depth = page.path.count('/')
  dotdot = depth > 1 ? ('../' * (depth-1)) : './'
  (dotdot[0...-1] + path)
end

#yield_content(key, *args) ⇒ Object

Method: yield_content (Hyde::Helpers) Yield

## Example

See {Hyde::Helpers::content_for} for an example.

## See also

* {Hyde::Helpers::has_content?}
* {Hyde::Helpers::content_for}
* {Hyde::Helpers::yield_content}



117
118
119
120
121
122
123
124
 
# File 'lib/hyde/helpers.rb', line 117

def yield_content(key, *args)
  content = content_blocks[key.to_sym]
  if respond_to?(:block_is_haml?) && block_is_haml?(content)
    capture_haml(*args, &content)
  elsif content
    content.call(*args)
  end
end