module Middleman::CoreExtensions::Routing

Public Instance Methods

page(url, opts={}, &block) click to toggle source

The page method allows the layout to be set on a specific path

page "/about.html", :layout => false
page "/", :layout => :homepage_layout

@param [String] url @param [Hash] opts @return [void]

# File lib/middleman-core/core_extensions/routing.rb, line 31
def page(url, opts={}, &block)
  blocks = Array(block)

  # Default layout
  opts[:layout] = config[:layout] if opts[:layout].nil?

  # If the url is a regexp
  if url.is_a?(Regexp) || url.include?('*')

    # Use the metadata loop for matching against paths at runtime
    sitemap.provides_metadata_for_path(url) do |_|
      { options: opts, blocks: blocks }
    end

    return
  end

  # Normalized path
  url = '/' + Middleman::Util.normalize_path(url)
  if url.end_with?('/') || File.directory?(File.join(source_dir, url))
    url = File.join(url, config[:index_file])
  end

  # Setup proxy
  if target = opts.delete(:proxy)
    # TODO: deprecate proxy through page?
    proxy(url, target, opts, &block)
    return
  elsif opts.delete(:ignore)
    # TODO: deprecate ignore through page?
    ignore(url)
  end

  # Setup a metadata matcher for rendering those options
  sitemap.provides_metadata_for_path(url) do |_|
    { options: opts, blocks: blocks }
  end
end
with_layout(layout_name, &block) click to toggle source

Takes a block which allows many pages to have the same layout

with_layout :admin do
  page "/admin/"
  page "/admin/login.html"
end

@param [String, Symbol] layout_name @return [void]

# File lib/middleman-core/core_extensions/routing.rb, line 14
def with_layout(layout_name, &block)
  old_layout = config[:layout]

  config[:layout] = layout_name
  instance_exec(&block) if block_given?
ensure
  config[:layout] = old_layout
end