2010-05-26 07:23:47 +00:00
require " rubygems "
2011-05-30 04:30:16 +00:00
require " bundler/setup "
2011-08-25 14:52:43 +00:00
require " stringex "
2010-05-26 07:23:47 +00:00
2011-06-22 16:29:23 +00:00
## -- Rsync Deploy config -- ##
# Be sure your public key is listed in your server's ~/.ssh/authorized_keys file
2011-08-25 20:58:02 +00:00
ssh_user = " user@domain.com "
2011-09-25 21:13:42 +00:00
ssh_port = " 22 "
2011-08-25 20:58:02 +00:00
document_root = " ~/website.com/ "
2011-06-29 18:01:06 +00:00
deploy_default = " rsync "
# This will be configured for you when you run config_deploy
deploy_branch = " gh-pages "
2011-06-22 16:29:23 +00:00
2011-08-16 05:49:49 +00:00
## -- Misc Configs -- ##
2011-06-22 16:29:23 +00:00
2011-08-16 05:49:49 +00:00
public_dir = " public " # compiled site directory
source_dir = " source " # source file directory
blog_index_dir = 'source' # directory for your blog's index page (if you put your index in source/blog/index.html, set this to 'source/blog')
deploy_dir = " _deploy " # deploy directory (for Github pages deployment)
stash_dir = " _stash " # directory to stash posts for speedy generation
posts_dir = " _posts " # directory for blog files
themes_dir = " .themes " # directory for blog files
new_post_ext = " markdown " # default new post file extension when using the new_post task
new_page_ext = " markdown " # default new page file extension when using the new_page task
server_port = " 4000 " # port for preview server eg. localhost:4000
2009-11-24 22:53:24 +00:00
2009-11-01 04:17:29 +00:00
2011-07-19 13:06:54 +00:00
desc " Initial setup for Octopress: copies the default theme into the path of Jekyll's generator. Rake install defaults to rake install[classic] to install a different theme run rake install[some_theme_name] "
2011-06-07 14:45:01 +00:00
task :install , :theme do | t , args |
2011-09-04 12:25:04 +00:00
if File . directory? ( source_dir ) || File . directory? ( " sass " )
abort ( " rake aborted! " ) if ask ( " A theme is already installed, proceeding will overwrite existing files. Are you sure? " , [ 'y' , 'n' ] ) == 'n'
end
2011-06-07 14:45:01 +00:00
# copy theme into working Jekyll directories
theme = args . theme || 'classic'
2011-07-19 13:06:54 +00:00
puts " # # Copying " + theme + " theme into ./ #{ source_dir } and ./sass "
2011-07-11 15:55:56 +00:00
mkdir_p source_dir
cp_r " #{ themes_dir } / #{ theme } /source/. " , source_dir
mkdir_p " sass "
cp_r " #{ themes_dir } / #{ theme } /sass/. " , " sass "
mkdir_p " #{ source_dir } / #{ posts_dir } "
mkdir_p public_dir
2011-06-07 14:45:01 +00:00
end
2011-06-11 11:56:04 +00:00
#######################
# Working with Jekyll #
#######################
2010-03-10 18:23:30 +00:00
2011-06-23 03:44:02 +00:00
desc " Generate jekyll site "
task :generate do
2011-08-25 14:36:57 +00:00
raise " # # # You haven't set anything up yet. First run `rake install` to set up an Octopress theme. " unless File . directory? ( source_dir )
2011-06-23 03:44:02 +00:00
puts " # # Generating Site with Jekyll "
2011-09-24 09:31:57 +00:00
system " compass compile --css-dir #{ source_dir } /stylesheets "
2011-06-23 03:44:02 +00:00
system " jekyll "
end
2011-06-11 11:56:04 +00:00
desc " Watch the site and regenerate when it changes "
task :watch do
2011-08-25 14:36:57 +00:00
raise " # # # You haven't set anything up yet. First run `rake install` to set up an Octopress theme. " unless File . directory? ( source_dir )
2011-08-25 14:52:43 +00:00
puts " Starting to watch source with Jekyll and Compass. "
2011-10-11 20:14:41 +00:00
system " compass compile --css-dir #{ source_dir } /stylesheets " unless File . exist? ( " #{ source_dir } /stylesheets/screen.css " )
2011-11-23 13:37:30 +00:00
jekyllPid = Process . spawn ( { " OCTOPRESS_ENV " = > " preview " } , " jekyll --auto " )
2011-09-08 16:54:07 +00:00
compassPid = Process . spawn ( " compass watch " )
2011-08-25 14:52:43 +00:00
trap ( " INT " ) {
2011-09-12 19:36:14 +00:00
[ jekyllPid , compassPid ] . each { | pid | Process . kill ( 9 , pid ) rescue Errno :: ESRCH }
exit 0
2011-08-25 14:52:43 +00:00
}
2011-09-12 19:36:14 +00:00
[ jekyllPid , compassPid ] . each { | pid | Process . wait ( pid ) }
2009-11-25 14:34:32 +00:00
end
2011-06-11 11:56:04 +00:00
desc " preview the site in a web browser "
task :preview do
2011-08-25 14:36:57 +00:00
raise " # # # You haven't set anything up yet. First run `rake install` to set up an Octopress theme. " unless File . directory? ( source_dir )
2011-08-25 14:52:43 +00:00
puts " Starting to watch source with Jekyll and Compass. Starting Rack on port #{ server_port } "
2011-10-11 20:14:41 +00:00
system " compass compile --css-dir #{ source_dir } /stylesheets " unless File . exist? ( " #{ source_dir } /stylesheets/screen.css " )
2011-11-23 13:37:30 +00:00
jekyllPid = Process . spawn ( { " OCTOPRESS_ENV " = > " preview " } , " jekyll --auto " )
2011-09-08 16:54:07 +00:00
compassPid = Process . spawn ( " compass watch " )
rackupPid = Process . spawn ( " rackup --port #{ server_port } " )
2011-08-25 14:52:43 +00:00
trap ( " INT " ) {
2011-09-12 19:36:14 +00:00
[ jekyllPid , compassPid , rackupPid ] . each { | pid | Process . kill ( 9 , pid ) rescue Errno :: ESRCH }
exit 0
2011-08-25 14:52:43 +00:00
}
2011-09-12 19:36:14 +00:00
[ jekyllPid , compassPid , rackupPid ] . each { | pid | Process . wait ( pid ) }
2009-11-06 03:30:03 +00:00
end
2011-07-19 20:09:42 +00:00
# usage rake new_post[my-new-post] or rake new_post['my new post'] or rake new_post (defaults to "new-post")
2011-06-28 02:47:40 +00:00
desc " Begin a new post in #{ source_dir } / #{ posts_dir } "
2011-07-19 20:09:42 +00:00
task :new_post , :title do | t , args |
2011-08-25 14:36:57 +00:00
raise " # # # You haven't set anything up yet. First run `rake install` to set up an Octopress theme. " unless File . directory? ( source_dir )
2011-08-25 14:05:22 +00:00
mkdir_p " #{ source_dir } / #{ posts_dir } "
2011-07-19 20:09:42 +00:00
args . with_defaults ( :title = > 'new-post' )
title = args . title
2011-08-25 14:52:43 +00:00
filename = " #{ source_dir } / #{ posts_dir } / #{ Time . now . strftime ( '%Y-%m-%d' ) } - #{ title . to_url } . #{ new_post_ext } "
2011-09-03 13:06:36 +00:00
if File . exist? ( filename )
2011-09-04 13:47:36 +00:00
abort ( " rake aborted! " ) if ask ( " #{ filename } already exists. Do you want to overwrite? " , [ 'y' , 'n' ] ) == 'n'
2011-09-03 13:06:36 +00:00
end
2011-07-19 20:09:42 +00:00
puts " Creating new post: #{ filename } "
open ( filename , 'w' ) do | post |
2009-12-07 16:55:13 +00:00
post . puts " --- "
2011-04-18 03:49:30 +00:00
post . puts " layout: post "
2011-10-16 09:49:18 +00:00
post . puts " title: \" #{ title . gsub ( / & / , '&' ) } \" "
2011-07-19 20:09:42 +00:00
post . puts " date: #{ Time . now . strftime ( '%Y-%m-%d %H:%M' ) } "
post . puts " comments: true "
2011-07-19 13:06:54 +00:00
post . puts " categories: "
2009-12-07 16:55:13 +00:00
post . puts " --- "
end
end
2011-07-19 20:09:42 +00:00
# usage rake new_page[my-new-page] or rake new_page[my-new-page.html] or rake new_page (defaults to "new-page.markdown")
2011-07-26 23:10:16 +00:00
desc " Create a new page in #{ source_dir } /(filename)/index. #{ new_page_ext } "
2011-07-19 20:09:42 +00:00
task :new_page , :filename do | t , args |
2011-08-25 14:36:57 +00:00
raise " # # # You haven't set anything up yet. First run `rake install` to set up an Octopress theme. " unless File . directory? ( source_dir )
2011-07-19 20:09:42 +00:00
args . with_defaults ( :filename = > 'new-page' )
2011-10-16 14:22:37 +00:00
page_dir = [ source_dir ]
if args . filename . downcase =~ / (^.+ \/ )?(.+) /
filename , dot , extension = $2 . rpartition ( '.' ) . reject ( & :empty? ) # Get filename and extension
title = filename
page_dir . concat ( $1 . downcase . sub ( / ^ \/ / , '' ) . split ( '/' ) ) unless $1 . nil? # Add path to page_dir Array
if extension . nil?
page_dir << filename
filename = " index "
end
extension || = new_page_ext
page_dir = page_dir . map! { | d | d = d . to_url } . join ( '/' ) # Sanitize path
filename = filename . downcase . to_url
2011-07-19 20:09:42 +00:00
mkdir_p page_dir
2011-10-16 14:22:37 +00:00
file = " #{ page_dir } / #{ filename } . #{ extension } "
2011-09-03 13:06:36 +00:00
if File . exist? ( file )
2011-09-04 13:47:36 +00:00
abort ( " rake aborted! " ) if ask ( " #{ file } already exists. Do you want to overwrite? " , [ 'y' , 'n' ] ) == 'n'
2011-09-03 13:06:36 +00:00
end
2011-07-19 20:09:42 +00:00
puts " Creating new page: #{ file } "
open ( file , 'w' ) do | page |
page . puts " --- "
page . puts " layout: page "
2011-10-16 14:22:37 +00:00
page . puts " title: \" #{ title } \" "
2011-07-19 20:09:42 +00:00
page . puts " date: #{ Time . now . strftime ( '%Y-%m-%d %H:%M' ) } "
page . puts " comments: true "
page . puts " sharing: true "
page . puts " footer: true "
page . puts " --- "
end
else
puts " Syntax error: #{ args . filename } contains unsupported characters "
end
end
2010-01-23 20:47:43 +00:00
# usage rake isolate[my-post]
desc " Move all other posts than the one currently being worked on to a temporary stash location (stash) so regenerating the site happens much quicker. "
task :isolate , :filename do | t , args |
2011-06-21 20:11:07 +00:00
stash_dir = " #{ source_dir } / #{ stash_dir } "
2010-01-23 20:47:43 +00:00
FileUtils . mkdir ( stash_dir ) unless File . exist? ( stash_dir )
2011-06-21 20:11:07 +00:00
Dir . glob ( " #{ source_dir } / #{ posts_dir } /*.* " ) do | post |
2010-01-23 20:47:43 +00:00
FileUtils . mv post , stash_dir unless post . include? ( args . filename )
end
end
desc " Move all stashed posts back into the posts directory, ready for site generation. "
task :integrate do
2011-06-21 20:11:07 +00:00
FileUtils . mv Dir . glob ( " #{ source_dir } / #{ stash_dir } /*.* " ) , " #{ source_dir } / #{ posts_dir } / "
2010-01-23 20:47:43 +00:00
end
2011-09-18 11:45:25 +00:00
desc " Clean out caches: .pygments-cache, .gist-cache, .sass-cache "
2011-06-18 02:24:48 +00:00
task :clean do
2011-09-18 11:45:25 +00:00
rm_rf [ " .pygments-cache/** " , " .gist-cache/** " , " .sass-cache/** " , " source/stylesheets/screen.css " ]
2011-06-18 02:24:48 +00:00
end
2011-07-20 02:18:34 +00:00
desc " Move sass to sass.old, install sass theme updates, replace sass/custom with sass.old/custom "
task :update_style , :theme do | t , args |
theme = args . theme || 'classic'
2011-07-27 22:22:57 +00:00
if File . directory? ( " sass.old " )
puts " removed existing sass.old directory "
2011-08-25 14:52:43 +00:00
rm_r " sass.old " , :secure = > true
2011-07-27 22:22:57 +00:00
end
2011-08-25 14:52:43 +00:00
mv " sass " , " sass.old "
2011-07-20 02:18:34 +00:00
puts " # # Moved styles into sass.old/ "
2011-08-25 14:52:43 +00:00
cp_r " #{ themes_dir } / " + theme + " /sass/ " , " sass "
2011-07-20 02:18:34 +00:00
cp_r " sass.old/custom/. " , " sass/custom "
puts " # # Updated Sass # # "
end
desc " Move source to source.old, install source theme updates, replace source/_includes/navigation.html with source.old's navigation "
task :update_source , :theme do | t , args |
theme = args . theme || 'classic'
2011-07-27 22:22:57 +00:00
if File . directory? ( " #{ source_dir } .old " )
2011-09-02 22:24:42 +00:00
puts " # # Removed existing #{ source_dir } .old directory "
2011-08-25 14:52:43 +00:00
rm_r " #{ source_dir } .old " , :secure = > true
2011-07-27 22:22:57 +00:00
end
2011-10-02 04:36:52 +00:00
mkdir " #{ source_dir } .old "
2011-09-02 22:24:42 +00:00
cp_r " #{ source_dir } /. " , " #{ source_dir } .old "
puts " # # Copied #{ source_dir } into #{ source_dir } .old/ "
cp_r " #{ themes_dir } / " + theme + " /source/. " , source_dir , :remove_destination = > true
cp_r " #{ source_dir } .old/_includes/custom/. " , " #{ source_dir } /_includes/custom/ " , :remove_destination = > true
2011-09-30 13:08:07 +00:00
cp " #{ source_dir } .old/favicon.png " , source_dir
2011-08-25 14:52:43 +00:00
mv " #{ source_dir } /index.html " , " #{ blog_index_dir } " , :force = > true if blog_index_dir != source_dir
2011-10-02 04:36:52 +00:00
cp " #{ source_dir } .old/index.html " , source_dir if blog_index_dir != source_dir && File . exists? ( " #{ source_dir } .old/index.html " )
2011-07-20 02:18:34 +00:00
puts " # # Updated #{ source_dir } # # "
end
2011-06-11 11:56:04 +00:00
##############
# Deploying #
##############
2011-06-29 18:01:06 +00:00
desc " Default deploy task "
2011-09-12 17:49:18 +00:00
task :deploy do
2011-11-29 14:13:50 +00:00
# Check if preview posts exist, which should not be published
if File . exists? ( " .preview-mode " )
puts " # # Found posts in preview mode, regenerating files ... "
File . delete ( " .preview-mode " )
Rake :: Task [ :generate ] . execute
end
2011-09-22 08:17:31 +00:00
Rake :: Task [ :copydot ] . invoke ( source_dir , public_dir )
Rake :: Task [ " #{ deploy_default } " ] . execute
2011-09-12 18:48:26 +00:00
end
desc " Generate website and deploy "
2011-09-22 08:17:31 +00:00
task :gen_deploy = > [ :integrate , :generate , :deploy ] do
2011-08-25 14:52:43 +00:00
end
desc " copy dot files for deployment "
2011-09-22 08:17:31 +00:00
task :copydot , :source , :dest do | t , args |
2011-12-10 13:42:31 +00:00
FileList [ " #{ args . source } /**/.* " ] . exclude ( " **/. " , " **/.. " , " **/.DS_Store " , " **/._* " ) . each do | file |
cp_r file , file . gsub ( / #{ args . source } / , " #{ args . dest } " ) unless File . directory? ( file )
2011-08-25 14:52:43 +00:00
end
2011-06-29 18:01:06 +00:00
end
2011-06-11 11:56:04 +00:00
desc " Deploy website via rsync "
2011-06-29 18:01:06 +00:00
task :rsync do
2011-06-07 14:45:01 +00:00
puts " # # Deploying website via Rsync "
2011-09-25 21:16:15 +00:00
ok_failed system ( " rsync -avze 'ssh -p #{ ssh_port } ' --delete #{ public_dir } / #{ ssh_user } : #{ document_root } " )
2009-10-19 00:07:36 +00:00
end
2011-06-21 20:11:07 +00:00
desc " deploy public directory to github pages "
2011-08-25 14:52:43 +00:00
multitask :push do
2011-06-21 20:11:07 +00:00
puts " # # Deploying branch to Github Pages "
( Dir [ " #{ deploy_dir } /* " ] ) . each { | f | rm_rf ( f ) }
2011-09-22 08:17:31 +00:00
Rake :: Task [ :copydot ] . invoke ( public_dir , deploy_dir )
puts " \n # # copying #{ public_dir } to #{ deploy_dir } "
2011-10-17 06:18:41 +00:00
cp_r " #{ public_dir } /. " , deploy_dir
2011-06-21 20:11:07 +00:00
cd " #{ deploy_dir } " do
system " git add . "
system " git add -u "
puts " \n # # Commiting: Site updated at #{ Time . now . utc } "
message = " Site updated at #{ Time . now . utc } "
2011-09-18 12:07:43 +00:00
system " git commit -m \" #{ message } \" "
2011-06-21 20:11:07 +00:00
puts " \n # # Pushing generated #{ deploy_dir } website "
2011-09-22 21:16:54 +00:00
system " git push origin #{ deploy_branch } --force "
2011-06-21 20:11:07 +00:00
puts " \n # # Github Pages deploy complete "
end
2009-11-24 22:40:47 +00:00
end
2011-07-16 18:52:50 +00:00
desc " Update configurations to support publishing to root or sub directory "
task :set_root_dir , :dir do | t , args |
puts " >>> !! Please provide a directory, eg. rake config_dir[publishing/subdirectory] " unless args . dir
if args . dir
if args . dir == " / "
dir = " "
else
dir = " / " + args . dir . sub ( / ( \/ *)(.+) / , " \\ 2 " ) . sub ( / \/ $ / , '' ) ;
end
rakefile = IO . read ( __FILE__ )
rakefile . sub! ( / public_dir( \ s*)=( \ s*)(["'])[ \ w \ - \/ ]*["'] / , " public_dir \\ 1= \\ 2 \\ 3public #{ dir } \\ 3 " )
File . open ( __FILE__ , 'w' ) do | f |
f . write rakefile
end
compass_config = IO . read ( 'config.rb' )
compass_config . sub! ( / http_path( \ s*)=( \ s*)(["'])[ \ w \ - \/ ]*["'] / , " http_path \\ 1= \\ 2 \\ 3 #{ dir } / \\ 3 " )
compass_config . sub! ( / http_images_path( \ s*)=( \ s*)(["'])[ \ w \ - \/ ]*["'] / , " http_images_path \\ 1= \\ 2 \\ 3 #{ dir } /images \\ 3 " )
compass_config . sub! ( / http_fonts_path( \ s*)=( \ s*)(["'])[ \ w \ - \/ ]*["'] / , " http_fonts_path \\ 1= \\ 2 \\ 3 #{ dir } /fonts \\ 3 " )
compass_config . sub! ( / css_dir( \ s*)=( \ s*)(["'])[ \ w \ - \/ ]*["'] / , " css_dir \\ 1= \\ 2 \\ 3public #{ dir } /stylesheets \\ 3 " )
File . open ( 'config.rb' , 'w' ) do | f |
f . write compass_config
end
jekyll_config = IO . read ( '_config.yml' )
jekyll_config . sub! ( / ^destination:.+$ / , " destination: public #{ dir } " )
2011-07-22 04:03:11 +00:00
jekyll_config . sub! ( / ^subscribe_rss: \ s* \/ .+$ / , " subscribe_rss: #{ dir } /atom.xml " )
jekyll_config . sub! ( / ^root:.*$ / , " root: / #{ dir . sub ( / ^ \/ / , '' ) } " )
2011-07-16 18:52:50 +00:00
File . open ( '_config.yml' , 'w' ) do | f |
f . write jekyll_config
end
2011-07-22 04:03:11 +00:00
rm_rf public_dir
mkdir_p " #{ public_dir } #{ dir } "
puts " # # Site's root directory is now '/ #{ dir . sub ( / ^ \/ / , '' ) } ' # # "
2011-07-16 18:52:50 +00:00
end
end
2011-09-22 09:41:40 +00:00
desc " Set up _deploy folder and deploy branch for Github Pages deployment "
2011-09-22 09:45:44 +00:00
task :setup_github_pages do
2011-09-22 09:41:40 +00:00
repo_url = get_stdin ( " Enter the read/write url for your repository: " )
user = repo_url . match ( / :([^ \/ ]+) / ) [ 1 ]
2011-10-11 12:20:52 +00:00
branch = ( repo_url . match ( / \/ [ \ w-]+.github.com / ) . nil? ) ? 'gh-pages' : 'master'
2011-09-22 09:41:40 +00:00
project = ( branch == 'gh-pages' ) ? repo_url . match ( / \/ ([^ \ .]+) / ) [ 1 ] : ''
unless ` git remote -v ` . match ( / origin.+?octopress.git / ) . nil?
# If octopress is still the origin remote (from cloning) rename it to octopress
system " git remote rename origin octopress "
if branch == 'master'
# If this is a user/organization pages repository, add the correct origin remote
# and checkout the source branch for committing changes to the blog source.
system " git remote add origin #{ repo_url } "
puts " Added remote #{ repo_url } as origin "
system " git config branch.master.remote origin "
puts " Set origin as default remote "
system " git branch -m master source "
puts " Master branch renamed to 'source' for committing your blog source files "
else
unless ! public_dir . match ( " #{ project } " ) . nil?
system " rake set_root_dir[ #{ project } ] "
end
end
end
url = " http:// #{ user } .github.com "
url += " / #{ project } " unless project == ''
jekyll_config = IO . read ( '_config.yml' )
jekyll_config . sub! ( / ^url:.*$ / , " url: #{ url } " )
File . open ( '_config.yml' , 'w' ) do | f |
f . write jekyll_config
end
rm_rf deploy_dir
mkdir deploy_dir
2011-06-27 22:17:15 +00:00
cd " #{ deploy_dir } " do
2011-09-22 09:41:40 +00:00
system " git init "
2011-06-28 02:47:40 +00:00
system " echo 'My Octopress Page is coming soon …' > index.html "
2011-06-23 03:44:02 +00:00
system " git add . "
2011-09-18 12:07:43 +00:00
system " git commit -m \" Octopress init \" "
2011-09-22 09:41:40 +00:00
system " git branch -m gh-pages " unless branch == 'master'
system " git remote add origin #{ repo_url } "
2011-06-29 18:01:06 +00:00
rakefile = IO . read ( __FILE__ )
2011-09-22 09:41:40 +00:00
rakefile . sub! ( / deploy_branch( \ s*)=( \ s*)(["'])[ \ w-]*["'] / , " deploy_branch \\ 1= \\ 2 \\ 3 #{ branch } \\ 3 " )
2011-06-29 18:01:06 +00:00
rakefile . sub! ( / deploy_default( \ s*)=( \ s*)(["'])[ \ w-]*["'] / , " deploy_default \\ 1= \\ 2 \\ 3push \\ 3 " )
File . open ( __FILE__ , 'w' ) do | f |
f . write rakefile
end
2011-06-23 03:44:02 +00:00
end
2011-09-22 09:41:40 +00:00
puts " \n --- \n # # Now you can deploy to #{ url } with `rake deploy` # # "
2011-06-23 03:44:02 +00:00
end
2009-10-19 00:07:36 +00:00
2011-06-23 03:44:02 +00:00
def ok_failed ( condition )
if ( condition )
puts " OK "
else
puts " FAILED "
end
end
2009-10-19 00:07:36 +00:00
2011-09-04 12:25:04 +00:00
def get_stdin ( message )
print message
STDIN . gets . chomp
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
2011-06-11 11:56:04 +00:00
desc " list tasks "
task :list do
2011-08-11 12:13:30 +00:00
puts " Tasks: #{ ( Rake :: Task . tasks - [ Rake :: Task [ :list ] ] ) . join ( ', ' ) } "
2011-06-11 11:56:04 +00:00
puts " (type rake -T for more detail) \n \n "
2010-08-03 05:10:59 +00:00
end