Permalink
Cannot retrieve contributors at this time
require "rubygems" | |
require 'rake' | |
require 'yaml' | |
require 'time' | |
SOURCE = "." | |
CONFIG = { | |
'version' => "0.3.0", | |
'themes' => File.join(SOURCE, "_includes", "themes"), | |
'layouts' => File.join(SOURCE, "_layouts"), | |
'posts' => File.join(SOURCE, "_posts"), | |
'post_ext' => "md", | |
'theme_package_version' => "0.1.0" | |
} | |
# Path configuration helper | |
module JB | |
class Path | |
SOURCE = "." | |
Paths = { | |
:layouts => "_layouts", | |
:themes => "_includes/themes", | |
:theme_assets => "assets/themes", | |
:theme_packages => "_theme_packages", | |
:posts => "_posts" | |
} | |
def self.base | |
SOURCE | |
end | |
# build a path relative to configured path settings. | |
def self.build(path, opts = {}) | |
opts[:root] ||= SOURCE | |
path = "#{opts[:root]}/#{Paths[path.to_sym]}/#{opts[:node]}".split("/") | |
path.compact! | |
File.__send__ :join, path | |
end | |
end #Path | |
end #JB | |
# Usage: rake post title="A Title" [date="2012-02-09"] [tags=[tag1,tag2]] [category="category"] | |
desc "Begin a new post in #{CONFIG['posts']}" | |
task :post do | |
abort("rake aborted: '#{CONFIG['posts']}' directory not found.") unless FileTest.directory?(CONFIG['posts']) | |
title = ENV["title"] || "new-post" | |
tags = ENV["tags"] || "[]" | |
category = ENV["category"] || "" | |
category = "\"#{category.gsub(/-/,' ')}\"" if !category.empty? | |
slug = title.downcase.strip.gsub(' ', '-').gsub(/[^\w-]/, '') | |
begin | |
date = (ENV['date'] ? Time.parse(ENV['date']) : Time.now).strftime('%Y-%m-%d') | |
rescue => e | |
puts "Error - date format must be YYYY-MM-DD, please check you typed it correctly!" | |
exit -1 | |
end | |
filename = File.join(CONFIG['posts'], "#{date}-#{slug}.#{CONFIG['post_ext']}") | |
if File.exist?(filename) | |
abort("rake aborted!") if ask("#{filename} already exists. Do you want to overwrite?", ['y', 'n']) == 'n' | |
end | |
puts "Creating new post: #{filename}" | |
open(filename, 'w') do |post| | |
post.puts "---" | |
post.puts "layout: post" | |
post.puts "title: \"#{title.gsub(/-/,' ')}\"" | |
post.puts 'description: ""' | |
post.puts "category: #{category}" | |
post.puts "tags: #{tags}" | |
post.puts "---" | |
post.puts "{% include JB/setup %}" | |
end | |
end # task :post | |
# Usage: rake page name="about.html" | |
# You can also specify a sub-directory path. | |
# If you don't specify a file extention we create an index.html at the path specified | |
desc "Create a new page." | |
task :page do | |
name = ENV["name"] || "new-page.md" | |
filename = File.join(SOURCE, "#{name}") | |
filename = File.join(filename, "index.html") if File.extname(filename) == "" | |
title = File.basename(filename, File.extname(filename)).gsub(/[\W\_]/, " ").gsub(/\b\w/){$&.upcase} | |
if File.exist?(filename) | |
abort("rake aborted!") if ask("#{filename} already exists. Do you want to overwrite?", ['y', 'n']) == 'n' | |
end | |
mkdir_p File.dirname(filename) | |
puts "Creating new page: #{filename}" | |
open(filename, 'w') do |post| | |
post.puts "---" | |
post.puts "layout: page" | |
post.puts "title: \"#{title}\"" | |
post.puts 'description: ""' | |
post.puts "---" | |
post.puts "{% include JB/setup %}" | |
end | |
end # task :page | |
desc "Launch preview environment" | |
task :preview do | |
system "jekyll serve -w" | |
end # task :preview | |
# Public: Alias - Maintains backwards compatability for theme switching. | |
task :switch_theme => "theme:switch" | |
namespace :theme do | |
# Public: Switch from one theme to another for your blog. | |
# | |
# name - String, Required. name of the theme you want to switch to. | |
# The theme must be installed into your JB framework. | |
# | |
# Examples | |
# | |
# rake theme:switch name="the-program" | |
# | |
# Returns Success/failure messages. | |
desc "Switch between Jekyll-bootstrap themes." | |
task :switch do | |
theme_name = ENV["name"].to_s | |
theme_path = File.join(CONFIG['themes'], theme_name) | |
settings_file = File.join(theme_path, "settings.yml") | |
non_layout_files = ["settings.yml"] | |
abort("rake aborted: name cannot be blank") if theme_name.empty? | |
abort("rake aborted: '#{theme_path}' directory not found.") unless FileTest.directory?(theme_path) | |
abort("rake aborted: '#{CONFIG['layouts']}' directory not found.") unless FileTest.directory?(CONFIG['layouts']) | |
Dir.glob("#{theme_path}/*") do |filename| | |
next if non_layout_files.include?(File.basename(filename).downcase) | |
puts "Generating '#{theme_name}' layout: #{File.basename(filename)}" | |
open(File.join(CONFIG['layouts'], File.basename(filename)), 'w') do |page| | |
page.puts "---" | |
page.puts File.read(settings_file) if File.exist?(settings_file) | |
page.puts "layout: default" unless File.basename(filename, ".html").downcase == "default" | |
page.puts "---" | |
page.puts "{% include JB/setup %}" | |
page.puts "{% include themes/#{theme_name}/#{File.basename(filename)} %}" | |
end | |
end | |
puts "=> Theme successfully switched!" | |
puts "=> Reload your web-page to check it out =)" | |
end # task :switch | |
# Public: Install a theme using the theme packager. | |
# Version 0.1.0 simple 1:1 file matching. | |
# | |
# git - String, Optional path to the git repository of the theme to be installed. | |
# name - String, Optional name of the theme you want to install. | |
# Passing name requires that the theme package already exist. | |
# | |
# Examples | |
# | |
# rake theme:install git="https://github.com/jekyllbootstrap/theme-twitter.git" | |
# rake theme:install name="cool-theme" | |
# | |
# Returns Success/failure messages. | |
desc "Install theme" | |
task :install do | |
if ENV["git"] | |
manifest = theme_from_git_url(ENV["git"]) | |
name = manifest["name"] | |
else | |
name = ENV["name"].to_s.downcase | |
end | |
packaged_theme_path = JB::Path.build(:theme_packages, :node => name) | |
abort("rake aborted! | |
=> ERROR: 'name' cannot be blank") if name.empty? | |
abort("rake aborted! | |
=> ERROR: '#{packaged_theme_path}' directory not found. | |
=> Installable themes can be added via git. You can find some here: http://github.com/jekyllbootstrap | |
=> To download+install run: `rake theme:install git='[PUBLIC-CLONE-URL]'` | |
=> example : rake theme:install git='git@github.com:jekyllbootstrap/theme-the-program.git' | |
") unless FileTest.directory?(packaged_theme_path) | |
manifest = verify_manifest(packaged_theme_path) | |
# Get relative paths to packaged theme files | |
# Exclude directories as they'll be recursively created. Exclude meta-data files. | |
packaged_theme_files = [] | |
FileUtils.cd(packaged_theme_path) { | |
Dir.glob("**/*.*") { |f| | |
next if ( FileTest.directory?(f) || f =~ /^(manifest|readme|packager)/i ) | |
packaged_theme_files << f | |
} | |
} | |
# Mirror each file into the framework making sure to prompt if already exists. | |
packaged_theme_files.each do |filename| | |
file_install_path = File.join(JB::Path.base, filename) | |
if File.exist? file_install_path and ask("#{file_install_path} already exists. Do you want to overwrite?", ['y', 'n']) == 'n' | |
next | |
else | |
mkdir_p File.dirname(file_install_path) | |
cp_r File.join(packaged_theme_path, filename), file_install_path | |
end | |
end | |
puts "=> #{name} theme has been installed!" | |
puts "=> ---" | |
if ask("=> Want to switch themes now?", ['y', 'n']) == 'y' | |
system("rake switch_theme name='#{name}'") | |
end | |
end | |
# Public: Package a theme using the theme packager. | |
# The theme must be structured using valid JB API. | |
# In other words packaging is essentially the reverse of installing. | |
# | |
# name - String, Required name of the theme you want to package. | |
# | |
# Examples | |
# | |
# rake theme:package name="twitter" | |
# | |
# Returns Success/failure messages. | |
desc "Package theme" | |
task :package do | |
name = ENV["name"].to_s.downcase | |
theme_path = JB::Path.build(:themes, :node => name) | |
asset_path = JB::Path.build(:theme_assets, :node => name) | |
abort("rake aborted: name cannot be blank") if name.empty? | |
abort("rake aborted: '#{theme_path}' directory not found.") unless FileTest.directory?(theme_path) | |
abort("rake aborted: '#{asset_path}' directory not found.") unless FileTest.directory?(asset_path) | |
## Mirror theme's template directory (_includes) | |
packaged_theme_path = JB::Path.build(:themes, :root => JB::Path.build(:theme_packages, :node => name)) | |
mkdir_p packaged_theme_path | |
cp_r theme_path, packaged_theme_path | |
## Mirror theme's asset directory | |
packaged_theme_assets_path = JB::Path.build(:theme_assets, :root => JB::Path.build(:theme_packages, :node => name)) | |
mkdir_p packaged_theme_assets_path | |
cp_r asset_path, packaged_theme_assets_path | |
## Log packager version | |
packager = {"packager" => {"version" => CONFIG["theme_package_version"].to_s } } | |
open(JB::Path.build(:theme_packages, :node => "#{name}/packager.yml"), "w") do |page| | |
page.puts packager.to_yaml | |
end | |
puts "=> '#{name}' theme is packaged and available at: #{JB::Path.build(:theme_packages, :node => name)}" | |
end | |
end # end namespace :theme | |
# Internal: Download and process a theme from a git url. | |
# Notice we don't know the name of the theme until we look it up in the manifest. | |
# So we'll have to change the folder name once we get the name. | |
# | |
# url - String, Required url to git repository. | |
# | |
# Returns theme manifest hash | |
def theme_from_git_url(url) | |
tmp_path = JB::Path.build(:theme_packages, :node => "_tmp") | |
abort("rake aborted: system call to git clone failed") if !system("git clone #{url} #{tmp_path}") | |
manifest = verify_manifest(tmp_path) | |
new_path = JB::Path.build(:theme_packages, :node => manifest["name"]) | |
if File.exist?(new_path) && ask("=> #{new_path} theme package already exists. Override?", ['y', 'n']) == 'n' | |
remove_dir(tmp_path) | |
abort("rake aborted: '#{manifest["name"]}' already exists as theme package.") | |
end | |
remove_dir(new_path) if File.exist?(new_path) | |
mv(tmp_path, new_path) | |
manifest | |
end | |
# Internal: Process theme package manifest file. | |
# | |
# theme_path - String, Required. File path to theme package. | |
# | |
# Returns theme manifest hash | |
def verify_manifest(theme_path) | |
manifest_path = File.join(theme_path, "manifest.yml") | |
manifest_file = File.open( manifest_path ) | |
abort("rake aborted: repo must contain valid manifest.yml") unless File.exist? manifest_file | |
manifest = YAML.load( manifest_file ) | |
manifest_file.close | |
manifest | |
end | |
def ask(message, valid_options) | |
if valid_options | |
answer = get_stdin("#{message} #{valid_options.to_s.gsub(/"/, '').gsub(/, /,'/')} ") while !valid_options.include?(answer) | |
else | |
answer = get_stdin(message) | |
end | |
answer | |
end | |
def get_stdin(message) | |
print message | |
STDIN.gets.chomp | |
end | |
#Load custom rake scripts | |
Dir['_rake/*.rake'].each { |r| load r } |