Module: Middleman::Sitemap::Extensions::Traversal

Included in:
Resource
Defined in:
middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb

Instance Method Summary collapse

Instance Method Details

#childrenArray<Middleman::Sitemap::Resource>

This resource's child resources



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 92

def children
  return [] unless directory_index?

  base_path = if eponymous_directory?
                eponymous_directory_path
              else
                path.sub(@app.config[:index_file].to_s, '')
              end

  prefix = /^#{base_path.sub("/", "\\/")}/

  @store.resources.select do |sub_resource|
    if sub_resource.path == path || sub_resource.path !~ prefix
      false
    else
      inner_path = sub_resource.path.sub(prefix, '')
      parts = inner_path.split('/')
      if parts.length == 1
        true
      elsif parts.length == 2
        parts.last == @app.config[:index_file]
      else
        false
      end
    end
  end
end

#directory_index?Boolean

Whether this resource is either a directory index, or has the same name as an existing directory in the source

Returns:

  • (Boolean)


130
131
132
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 130

def directory_index?
  path.include?(@app.config[:index_file]) || path =~ /\/$/ || eponymous_directory?
end

#eponymous_directory?Boolean

Whether the resource has the same name as a directory in the source (e.g., if the resource is named 'gallery.html' and a path exists named 'gallery/', this would return true)

Returns:

  • (Boolean)


137
138
139
140
141
142
143
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 137

def eponymous_directory?
  return true if !path.end_with?("/#{@app.config[:index_file]}") && destination_path.end_with?("/#{@app.config[:index_file]}")

  @app.files.by_type(:source).watchers.any? do |source|
    (source.directory + Pathname(eponymous_directory_path)).directory?
  end
end

#eponymous_directory_pathString

The path for this resource if it were a directory, and not a file (e.g., for 'gallery.html' this would return 'gallery/')

Returns:

  • (String)


148
149
150
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 148

def eponymous_directory_path
  path.sub(ext, '/').sub(/\/$/, '') + '/'
end

#parent(_recurse = false) ⇒ Middleman::Sitemap::Resource?

This resource's parent resource



17
18
19
20
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 17

def parent(_recurse = false)
  max_recursion = @app.config[:max_traversal_recursion] || 99
  parent_helper(path, max_recursion)
end

#parent_helper(child_path, max_recursion) ⇒ Object



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 22

def parent_helper(child_path, max_recursion)
  # What is the configured format for index pages.
  index_file = @app.config[:index_file]
  parts = child_path.split('/')
  # Reduce the path by the current page to get the parent level path.
  current_page = parts.pop
  # Does the current page has the name of an index file?
  is_index = current_page == index_file
  # Is the `current_page` in the traversal root?
  # Note: `traversal_root` is `/` for non localized pages and `/[lang]/` for
  # localized pages.
  at_traversal_root = !(child_path =~ /^#{traversal_root}#{current_page}$/).nil?

  # Check that we have any path parts left after the pop because if we
  # don't, `current_page` is either root or another file under root.
  # Also, if we are `at_traversal_root`, we consider this root.
  if parts.empty? || at_traversal_root
    # If this `is_index`, the `current_page` is root and there is no parent.
    return nil if is_index

    # `current_page` must be a page under root, let's return the root
    # index page of the `traversal_root` (`/` or `/[lang]/`).
    return @store.by_path("#{traversal_root}#{index_file}")
  end

  # Get the index file for the parent path parts, e.g.: `/blog/index.html`
  # for `/blog/`.
  index_by_parts = proc do |subparts|
    found = @store.by_destination_path("#{subparts.join('/')}/#{index_file}")
    return found unless found.nil?
  end

  # Get a file that has the name of the parent path parts e.g.:
  # `/blog.html` for `/blog/`.
  file_by_parts = proc do |subparts|
    test_expr = Regexp.escape(subparts.join('/'))
    # eponymous reverse-lookup
    found = @store.resources.find do |candidate|
      candidate.path =~ %r{^#{test_expr}(?:\.[a-zA-Z0-9]+|\/)$}
    end
    return found unless found.nil?
  end

  # Try to find a file matching the parent path name and return it.
  # E.g. `parts == ['en', 'blog']`, we try to find: `/en/blog.html`
  file_by_parts.call(parts)

  # Try to find an non-localized parent instead if `traversal_root`
  # indicates the path is localized and there are still more parts
  # remaining, and return it.
  # E.g. `parts == ['en', 'blog']`, we try to find: `/blog.html`
  file_by_parts.call(parts[1..-1]) if traversal_root != '/' && parts.length > 1

  # Now let's drop the last part of the path to try to find an index
  # file in the path above `current_page`'s path and return it.
  # E.g. `parts == ['en', 'blog']`, we try to find: `/en/index.html`
  parts.pop if is_index
  index_by_parts.call(parts)

  # Lastly, check for an non-localized index index file in the path
  # above `current_page`'s path and return it.
  # E.g. `parts == ['en', 'blog']`, we try to find: `/index.html`
  index_by_parts.call(parts[1..-1] || '') if traversal_root == "#{parts.first}/"
  return parent_helper(parts.join('/'), max_recursion - 1) if !parts.empty? && max_recursion.positive?

  nil
end

#siblingsArray<Middleman::Sitemap::Resource>

This resource's sibling resources



122
123
124
125
126
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 122

def siblings
  return [] unless parent

  parent.children.reject { |p| p == self }
end

#traversal_rootObject



5
6
7
8
9
10
11
12
13
# File 'middleman-core/lib/middleman-core/sitemap/extensions/traversal.rb', line 5

def traversal_root
  root = if !@app.extensions[:i18n]
           '/'
         else
           @app.extensions[:i18n].path_root(::I18n.locale)
         end

  root.sub(/^\//, '')
end