Class: Jekyll::Reader

Inherits:
Object
  • Object
show all
Defined in:
lib/jekyll/reader.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(site) ⇒ Reader

Returns a new instance of Reader.



7
8
9
 
# File 'lib/jekyll/reader.rb', line 7

def initialize(site)
  @site = site
end

Instance Attribute Details

#site ⇒ Object (readonly)

Returns the value of attribute site.



5
6
7
 
# File 'lib/jekyll/reader.rb', line 5

def site
  @site
end

Instance Method Details

#filter_entries(entries, base_directory = nil) ⇒ Object

Filter out any files/directories that are hidden or backup files (start with “.” or “#” or end with “~”), or contain site content (start with “_”), or are excluded in the site configuration, unless they are web server files such as ‘.htaccess’.

entries - The Array of String file/directory entries to filter. base_directory - The string representing the optional base directory.

Returns the Array of filtered entries.



116
117
118
 
# File 'lib/jekyll/reader.rb', line 116

def filter_entries(entries, base_directory = nil)
  EntryFilter.new(site, base_directory).filter(entries)
end

#get_entries(dir, subfolder) ⇒ Object

Read the entries from a particular directory for processing

dir - The String representing the relative path of the directory to read. subfolder - The String representing the directory to read.

Returns the list of entries to process



126
127
128
129
130
131
 
# File 'lib/jekyll/reader.rb', line 126

def get_entries(dir, subfolder)
  base = site.in_source_dir(dir, subfolder)
  return [] unless File.exist?(base)
  entries = Dir.chdir(base) { filter_entries(Dir["**/*"], base) }
  entries.delete_if { |e| File.directory?(site.in_source_dir(base, e)) }
end

#read ⇒ Object

Read Site data from disk and load it into internal data structures.

Returns nothing.



14
15
16
17
18
19
20
21
 
# File 'lib/jekyll/reader.rb', line 14

def read
  @site.layouts = LayoutReader.new(site).read
  read_directories
  sort_files!
  @site.data = DataReader.new(site).read(site.config["data_dir"])
  CollectionReader.new(site).read
  ThemeAssetsReader.new(site).read
end

#read_directories(dir = "") ⇒ Object

Recursively traverse directories to find pages and static files that will become part of the site according to the rules in filter_entries.

dir - The String relative path of the directory to read. Default: ”.

Returns nothing.



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
 
# File 'lib/jekyll/reader.rb', line 37

def read_directories(dir = "")
  base = site.in_source_dir(dir)

  return unless File.directory?(base)

  dot = Dir.chdir(base) { filter_entries(Dir.entries("."), base) }
  dot_dirs = dot.select { |file| File.directory?(@site.in_source_dir(base, file)) }
  dot_files = (dot - dot_dirs)
  dot_pages = dot_files.select do |file|
    Utils.has_yaml_header?(@site.in_source_dir(base, file))
  end
  dot_static_files = dot_files - dot_pages

  retrieve_posts(dir)
  retrieve_dirs(base, dir, dot_dirs)
  retrieve_pages(dir, dot_pages)
  retrieve_static_files(dir, dot_static_files)
end

#retrieve_dirs(_base, dir, dot_dirs) ⇒ Object

Recursively traverse directories with the read_directories function.

base - The String representing the site’s base directory. dir - The String representing the directory to traverse down. dot_dirs - The Array of subdirectories in the dir.

Returns nothing.



75
76
77
78
79
80
81
82
83
 
# File 'lib/jekyll/reader.rb', line 75

def retrieve_dirs(_base, dir, dot_dirs)
  dot_dirs.each do |file|
    dir_path = site.in_source_dir(dir, file)
    rel_path = File.join(dir, file)
    unless @site.dest.chomp("/") == dir_path
      @site.reader.read_directories(rel_path)
    end
  end
end

#retrieve_pages(dir, dot_pages) ⇒ Object

Retrieve all the pages from the current directory, add them to the site and sort them.

dir - The String representing the directory retrieve the pages from. dot_pages - The Array of pages in the dir.

Returns nothing.



92
93
94
 
# File 'lib/jekyll/reader.rb', line 92

def retrieve_pages(dir, dot_pages)
  site.pages.concat(PageReader.new(site, dir).read(dot_pages))
end

#retrieve_posts(dir) ⇒ Object

Retrieves all the posts(posts/drafts) from the given directory and add them to the site and sort them.

dir - The String representing the directory to retrieve the posts from.

Returns nothing.



62
63
64
65
66
 
# File 'lib/jekyll/reader.rb', line 62

def retrieve_posts(dir)
  return if outside_configured_directory?(dir)
  site.posts.docs.concat(post_reader.read_posts(dir))
  site.posts.docs.concat(post_reader.read_drafts(dir)) if site.show_drafts
end

#retrieve_static_files(dir, dot_static_files) ⇒ Object

Retrieve all the static files from the current directory, add them to the site and sort them.

dir - The directory retrieve the static files from. dot_static_files - The static files in the dir.

Returns nothing.



103
104
105
 
# File 'lib/jekyll/reader.rb', line 103

def retrieve_static_files(dir, dot_static_files)
  site.static_files.concat(StaticFileReader.new(site, dir).read(dot_static_files))
end

#sort_files! ⇒ Object

Sorts posts, pages, and static files.



24
25
26
27
28
 
# File 'lib/jekyll/reader.rb', line 24

def sort_files!
  site.collections.each_value { |c| c.docs.sort! }
  site.pages.sort_by!(&:name)
  site.static_files.sort_by!(&:relative_path)
end