Class: Jekyll::Site
- Inherits:
-
Object
- Object
- Jekyll::Site
- Defined in:
- lib/jekyll/site.rb
Instance Attribute Summary collapse
-
#dest ⇒ Object
Returns the value of attribute dest.
-
#layouts ⇒ Object
Returns the value of attribute layouts.
-
#posts ⇒ Object
Returns the value of attribute posts.
-
#source ⇒ Object
Returns the value of attribute source.
Instance Method Summary collapse
-
#initialize(source, dest) ⇒ Site
constructor
Initialize the site
source
is String path to the source directory containing the proto-sitedest
is the String path to the directory where the generated site should be written. -
#process ⇒ Object
Do the actual work of processing the site and generating the real deal.
-
#read_layouts ⇒ Object
Read all the files in <source>/_layouts into memory for later use.
-
#read_posts(base) ⇒ Object
Read all the files in <base>/_posts and create a new Post object with each one.
-
#site_payload ⇒ Object
The Hash payload containing site-wide data.
-
#transform_pages(dir = '') ⇒ Object
Copy all regular files from <source> to <dest>/ ignoring any files/directories that are hidden (start with “.”) or contain site content (start with “_”) unless they are “_posts” directories The
dir
String is a relative path used to call this method recursively as it descends through directories. -
#write_posts ⇒ Object
Write each post to <dest>/<year>/<month>/<day>/<slug>.
Constructor Details
#initialize(source, dest) ⇒ Site
Initialize the site
+source+ is String path to the source directory containing
the proto-site
+dest+ is the String path to the directory where the generated
site should be written
Returns <Site>
14 15 16 17 18 19 |
# File 'lib/jekyll/site.rb', line 14 def initialize(source, dest) self.source = source self.dest = dest self.layouts = {} self.posts = [] end |
Instance Attribute Details
#dest ⇒ Object
Returns the value of attribute dest.
4 5 6 |
# File 'lib/jekyll/site.rb', line 4 def dest @dest end |
#layouts ⇒ Object
Returns the value of attribute layouts.
5 6 7 |
# File 'lib/jekyll/site.rb', line 5 def layouts @layouts end |
#posts ⇒ Object
Returns the value of attribute posts.
5 6 7 |
# File 'lib/jekyll/site.rb', line 5 def posts @posts end |
#source ⇒ Object
Returns the value of attribute source.
4 5 6 |
# File 'lib/jekyll/site.rb', line 4 def source @source end |
Instance Method Details
#process ⇒ Object
Do the actual work of processing the site and generating the real deal.
Returns nothing
25 26 27 28 29 |
# File 'lib/jekyll/site.rb', line 25 def process self.read_layouts self.transform_pages self.write_posts end |
#read_layouts ⇒ Object
Read all the files in <source>/_layouts into memory for later use.
Returns nothing
35 36 37 38 39 40 41 42 43 44 45 46 |
# File 'lib/jekyll/site.rb', line 35 def read_layouts base = File.join(self.source, "_layouts") entries = Dir.entries(base) entries = entries.reject { |e| File.directory?(File.join(base, e)) } entries.each do |f| name = f.split(".")[0..-2].join(".") self.layouts[name] = Layout.new(base, f) end rescue Errno::ENOENT => e # ignore missing layout dir end |
#read_posts(base) ⇒ Object
Read all the files in <base>/_posts and create a new Post object with each one.
Returns nothing
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/jekyll/site.rb', line 52 def read_posts(base) entries = Dir.entries(base) entries = entries.reject { |e| File.directory?(e) } entries.each do |f| p = Post.new(base, f) if Post.valid?(f) p.do_layout({}, {}, {}) self.posts << p end end self.posts.sort! rescue Errno::ENOENT => e # ignore missing layout dir end |
#site_payload ⇒ Object
The Hash payload containing site-wide data
Returns => {“time” => <Time>, “posts” => [<Post>]}
119 120 121 122 123 124 125 126 127 128 129 130 131 |
# File 'lib/jekyll/site.rb', line 119 def site_payload # Build the category hash map of category ( names => arrays of posts ) # then sort each array in reverse order categories = Hash.new { |hash,key| hash[key] = Array.new } self.posts.each { |p| p.categories.each { |c| categories[c] << p } } categories.values.map { |cats| cats.sort! { |a,b| b <=> a} } {"site" => { "time" => Time.now, "posts" => self.posts.sort { |a,b| b <=> a }, "categories" => categories }} end |
#transform_pages(dir = '') ⇒ Object
Copy all regular files from <source> to <dest>/ ignoring any files/directories that are hidden (start with “.”) or contain site content (start with “_”) unless they are “_posts” directories
The +dir+ String is a relative path used to call this method
recursively as it descends through directories
Returns nothing
86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 |
# File 'lib/jekyll/site.rb', line 86 def transform_pages(dir = '') base = File.join(self.source, dir) entries = Dir.entries(base) entries = entries.reject { |e| (e != '_posts') and ['.', '_'].include?(e[0..0]) } entries.each do |f| if f == '_posts' read_posts(File.join(base, f)) elsif File.directory?(File.join(base, f)) next if self.dest.sub(/\/$/, '') == File.join(base, f) transform_pages(File.join(dir, f)) else first3 = File.open(File.join(self.source, dir, f)) { |fd| fd.read(3) } # if the file appears to have a YAML header then process it as a page if first3 == "---" page = Page.new(self.source, dir, f) page.add_layout(self.layouts, site_payload) page.write(self.dest) # otherwise copy the file without transforming it else FileUtils.mkdir_p(File.join(self.dest, dir)) FileUtils.cp(File.join(self.source, dir, f), File.join(self.dest, dir, f)) end end end end |
#write_posts ⇒ Object
Write each post to <dest>/<year>/<month>/<day>/<slug>
Returns nothing
72 73 74 75 76 77 |
# File 'lib/jekyll/site.rb', line 72 def write_posts self.posts.each do |post| post.add_layout(self.layouts, site_payload) post.write(self.dest) end end |