Replace rails guides source to v5.0.1

Author: chloerei

BASE_PATH.example

@@ -0,0 +1,50 @@
+## Rails 5.0.1 (December 21, 2016) ##
+
+*   No changes.
+
+
+## Rails 5.0.1.rc2 (December 10, 2016) ##
+
+*   No changes.
+
+
+## Rails 5.0.1.rc1 (December 01, 2016) ##
+
+*   No changes.
+
+
+## Rails 5.0.0 (June 30, 2016) ##
+
+*   Update example of passing a proc to `:message` option for validating records.
+
+    This behavior was recently changed in [Pull Request #24199](https://github.com/rails/rails/pull/24119) to
+    pass the object being validated as first argument to the `:message` proc,
+    instead of the key of the field being validated.
+
+    *Prathamesh Sonpatki*
+
+*   Added new guide: Action Cable Overview.
+
+    *David Kuhta*
+
+*   Add code of conduct to contributing guide.
+
+    *Jon Moss*
+
+*   New section in Configuring: Configuring Active Job.
+
+    *Eliot Sykes*
+
+*   New section in Active Record Association Basics: Single Table Inheritance.
+
+    *Andrey Nering*
+
+*   New section in Active Record Querying: Understanding The Method Chaining.
+
+    *Andrey Nering*
+
+*   New section in Configuring: Search Engines Indexing.
+
+    *Andrey Nering*
+
+Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/guides/CHANGELOG.md) for previous changes.

CC-BY-SA.png

@@ -1,95 +1,46 @@
-require 'pathname'
-
-BASE_PATH = Pathname(IO.readlines('./BASE_PATH').first.chomp)
-
-RAILS_PATH  = BASE_PATH + 'rails'
-GUIDES_PATH = BASE_PATH + 'guides'
-PAGES_PATH  = BASE_PATH + 'ruby-china.github.io'
-
-RAILS_GUIDE_SOURCE_PATH = RAILS_PATH + 'guides/source/'
-
-def update_rails_repo!
-  FileUtils.cd(RAILS_PATH.expand_path) { `git pull origin master` }
-end
-
-def get_rails_latest_sha1
-  sha1 = nil
-  FileUtils.cd(RAILS_PATH.expand_path) { sha1 = `git rev-parse HEAD` }
-  sha1[0, 7]
-end
-
-task :sanity_checks do
-  abort("Abort. please clone the rails/rails repo under #{BASE_PATH}") if !File.exist? RAILS_PATH.expand_path
-  abort("Abort. please clone the ruby-china/guides repo under #{BASE_PATH}") if !File.exist? GUIDES_PATH.expand_path
-end
-
 namespace :guides do
+
   desc 'Generate guides (for authors), use ONLY=foo to process just "foo.md"'
   task :generate => 'generate:html'
 
-  desc 'Deploy generated guides to github pages repository'
-  task :deploy => :sanity_checks do
-    ENV['RAILS_VERSION'] = get_rails_latest_sha1
-    ENV['ALL']  = '1'
-    ENV['GUIDES_LANGUAGE'] = 'zh-CN'
-    Rake::Task['guides:generate:html'].invoke
-
-    # the dot will copy contents under a folder, instead of copy the folder.
-    FileUtils.cp_r("#{GUIDES_PATH.expand_path}/output/zh-CN/.", PAGES_PATH.expand_path)
+  namespace :generate do
 
-    Dir.chdir(PAGES_PATH.expand_path) do
-      `git add -A .`
-      `git commit -m '#{%Q[Site updated @ #{Time.now.strftime("%a %b %-d %H:%M:%S %Z %Y")}]}'`
-      `git push origin master`
+    desc "Generate HTML guides"
+    task :html do
+      ENV["WARNINGS"] = "1" # authors can't disable this
+      ruby "rails_guides.rb"
     end
 
-    puts 'Deploy Complete. : )'
-  end
-
-  desc 'Update a given English guide'
-  task :update_guide => :sanity_checks do
-    update_rails_repo!
-
-    guide_to_be_updated = ARGV.last
-    guide_path = (RAILS_GUIDE_SOURCE_PATH + guide_to_be_updated).expand_path
-
-    if File.exist? guide_path
-      FileUtils.cp(guide_path, "#{GUIDES_PATH.expand_path}/source/")
-      puts "Update: #{guide_path} Complete. : )"
-    else
-      `ls #{guide_path}`
+    desc "Generate .mobi file. The kindlegen executable must be in your PATH. You can get it for free from http://www.amazon.com/gp/feature.html?docId=1000765211"
+    task :kindle do
+      unless `kindlerb -v 2> /dev/null` =~ /kindlerb 0.1.1/
+        abort "Please `gem install kindlerb` and make sure you have `kindlegen` in your PATH"
+      end
+      unless `convert` =~ /convert/  
+        abort "Please install ImageMagick`"
+      end
+      ENV['KINDLE'] = '1'
+      Rake::Task['guides:generate:html'].invoke
     end
-
-    # trick rake that ARGV.last is a task :P
-    task guide_to_be_updated.to_sym do; end
-  end
-
-  desc 'Update all English guides'
-  task :update_guides => :sanity_checks do
-    update_rails_repo!
-
-    FileUtils.cp_r(Pathname.glob("#{RAILS_GUIDE_SOURCE_PATH.expand_path}/*.md"), "#{GUIDES_PATH.expand_path}/source")
-
-    puts 'Update all English Guides. : D'
   end
 
-  namespace :generate do
-    desc "Generate HTML guides"
-    task :html do
-      ENV["WARN_BROKEN_LINKS"] = "1" # authors can't disable this
-      ruby "rails_guides.rb"
-    end
+  # Validate guides -------------------------------------------------------------------------
+  desc 'Validate guides, use ONLY=foo to process just "foo.html"'
+  task :validate do
+    ruby "w3c_validator.rb"
   end
 
   desc "Show help"
   task :help do
     puts <<-help
 
-Guides are taken from the source directory, and the resulting HTML goes into the
+Guides are taken from the source directory, and the result goes into the
 output directory. Assets are stored under files, and copied to output/files as
 part of the generation process.
 
-All this process is handled via rake tasks, here's a full list of them:
+You can generate HTML, Kindle or both formats using the `guides:generate` task.
+
+All of these processes are handled via rake tasks, here's a full list of them:
 
 #{%x[rake -T]}
 Some arguments may be passed via environment variables:
@@ -125,6 +76,4 @@ Examples:
   end
 end
 
-task :default do
-  Rake::Task['guides:generate'].invoke
-end
+task :default => 'guides:help'

CHANGELOG.md

@@ -51,9 +51,3 @@ var guidesIndex = {
     window.location = url;
   }
 };
-
-// Disable autolink inside example code blocks of guides.
-$(document).ready(function() {
-  SyntaxHighlighter.defaults['auto-links'] = false;
-  SyntaxHighlighter.all();
-});