Class: Moft::Page
Instance Attribute Summary collapse
-
#basename ⇒ Object
Returns the value of attribute basename.
-
#content ⇒ Object
Returns the value of attribute content.
-
#data ⇒ Object
Returns the value of attribute data.
-
#dir ⇒ Object
The generated directory into which the page will be placed upon generation.
-
#ext ⇒ Object
Returns the value of attribute ext.
-
#name ⇒ Object
Returns the value of attribute name.
-
#output ⇒ Object
Returns the value of attribute output.
-
#pager ⇒ Object
Returns the value of attribute pager.
-
#site ⇒ Object
Returns the value of attribute site.
Instance Method Summary collapse
-
#destination(dest) ⇒ Object
Obtain destination path.
-
#html? ⇒ Boolean
Returns the Boolean of whether this Page is HTML or not.
-
#index? ⇒ Boolean
Returns the Boolean of whether this Page is an index file or not.
-
#initialize(site, base, dir, name) ⇒ Page
constructor
Initialize a new Page.
-
#inspect ⇒ Object
Returns the object as a debug String.
-
#permalink ⇒ Object
The full path and filename of the post.
-
#process(name) ⇒ Object
Extract information from the page filename.
-
#render(layouts, site_payload) ⇒ Object
Add any necessary layouts to this post.
-
#template ⇒ Object
The template of the permalink.
-
#to_liquid ⇒ Object
Convert this Page’s data to a Hash suitable for use by Liquid.
-
#url ⇒ Object
The generated relative url of this page.
Methods included from Convertible
#converter, #do_layout, #output_ext, #read_yaml, #render_all_layouts, #render_liquid, #to_s, #transform, #write
Constructor Details
#initialize(site, base, dir, name) ⇒ Page
Initialize a new Page.
site - The Site object. base - The String path to the source. dir - The String path between the source and the file. name - The String filename of the file.
16 17 18 19 20 21 22 23 24 |
# File 'lib/moft/page.rb', line 16 def initialize(site, base, dir, name) @site = site @base = base @dir = dir @name = name self.process(name) self.read_yaml(File.join(base, dir), name) end |
Instance Attribute Details
#basename ⇒ Object
Returns the value of attribute basename.
7 8 9 |
# File 'lib/moft/page.rb', line 7 def basename @basename end |
#content ⇒ Object
Returns the value of attribute content.
8 9 10 |
# File 'lib/moft/page.rb', line 8 def content @content end |
#data ⇒ Object
Returns the value of attribute data.
8 9 10 |
# File 'lib/moft/page.rb', line 8 def data @data end |
#dir ⇒ Object
The generated directory into which the page will be placed upon generation. This is derived from the permalink or, if permalink is absent, we be ‘/’
Returns the String destination directory.
31 32 33 |
# File 'lib/moft/page.rb', line 31 def dir url[-1, 1] == '/' ? url : File.dirname(url) end |
#ext ⇒ Object
Returns the value of attribute ext.
7 8 9 |
# File 'lib/moft/page.rb', line 7 def ext @ext end |
#name ⇒ Object
Returns the value of attribute name.
7 8 9 |
# File 'lib/moft/page.rb', line 7 def name @name end |
#output ⇒ Object
Returns the value of attribute output.
8 9 10 |
# File 'lib/moft/page.rb', line 8 def output @output end |
#pager ⇒ Object
Returns the value of attribute pager.
6 7 8 |
# File 'lib/moft/page.rb', line 6 def pager @pager end |
#site ⇒ Object
Returns the value of attribute site.
6 7 8 |
# File 'lib/moft/page.rb', line 6 def site @site end |
Instance Method Details
#destination(dest) ⇒ Object
Obtain destination path.
dest - The String path to the destination dir.
Returns the destination file path String.
124 125 126 127 128 129 130 |
# File 'lib/moft/page.rb', line 124 def destination(dest) # The url needs to be unescaped in order to preserve the correct # filename. path = File.join(dest, CGI.unescape(self.url)) path = File.join(path, "index.html") if self.url =~ /\/$/ path end |
#html? ⇒ Boolean
Returns the Boolean of whether this Page is HTML or not.
138 139 140 |
# File 'lib/moft/page.rb', line 138 def html? output_ext == '.html' end |
#index? ⇒ Boolean
Returns the Boolean of whether this Page is an index file or not.
143 144 145 |
# File 'lib/moft/page.rb', line 143 def index? basename == 'index' end |
#inspect ⇒ Object
Returns the object as a debug String.
133 134 135 |
# File 'lib/moft/page.rb', line 133 def inspect "#<Moft:Page @name=#{self.name.inspect}>" end |
#permalink ⇒ Object
The full path and filename of the post. Defined in the YAML of the post body.
Returns the String permalink or nil if none has been set.
39 40 41 |
# File 'lib/moft/page.rb', line 39 def permalink self.data && self.data['permalink'] end |
#process(name) ⇒ Object
Extract information from the page filename.
name - The String filename of the page file.
Returns nothing.
89 90 91 92 |
# File 'lib/moft/page.rb', line 89 def process(name) self.ext = File.extname(name) self.basename = name[0 .. -self.ext.length-1] end |
#render(layouts, site_payload) ⇒ Object
Add any necessary layouts to this post
layouts - The Hash of => “layout”. site_payload - The site payload Hash.
Returns nothing.
100 101 102 103 104 105 106 107 |
# File 'lib/moft/page.rb', line 100 def render(layouts, site_payload) payload = { "page" => self.to_liquid, 'paginator' => pager.to_liquid }.deep_merge(site_payload) do_layout(payload, layouts) end |
#template ⇒ Object
The template of the permalink.
Returns the template String.
46 47 48 49 50 51 52 53 54 55 56 57 58 |
# File 'lib/moft/page.rb', line 46 def template if self.site.permalink_style == :pretty if index? && html? "/:path/" elsif html? "/:path/:basename/" else "/:path/:basename:output_ext" end else "/:path/:basename:output_ext" end end |
#to_liquid ⇒ Object
Convert this Page’s data to a Hash suitable for use by Liquid.
Returns the Hash representation of this Page.
112 113 114 115 116 117 |
# File 'lib/moft/page.rb', line 112 def to_liquid self.data.deep_merge({ "url" => self.url, "content" => self.content, "path" => self.data['path'] || File.join(@dir, @name).sub(/\A\//, '') }) end |
#url ⇒ Object
The generated relative url of this page. e.g. /about.html.
Returns the String url.
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 |
# File 'lib/moft/page.rb', line 63 def url return @url if @url url = if permalink permalink else { "path" => @dir, "basename" => self.basename, "output_ext" => self.output_ext, }.inject(template) { |result, token| result.gsub(/:#{token.first}/, token.last) }.gsub(/\/\//, "/") end # sanitize url @url = url.split('/').reject{ |part| part =~ /^\.+$/ }.join('/') @url += "/" if url =~ /\/$/ @url end |