Add gh-pages docs publish task

Adapted from
https://github.com/ruby-grape/grape/blob/864568d903e283d91da46fdebceb2605236ab55e/Rakefile

Author: bf4

Rakefile

@@ -12,11 +12,7 @@ Bundler::GemHelper.install_tasks
 
 require 'yard'
 
-namespace :yard do
-  YARD::Rake::YardocTask.new(:doc) do |t|
-    t.stats_options = ['--list-undoc']
-  end
-
+namespace :doc do
   desc 'start a gem server'
   task :server do
     sh 'bundle exec yard server --gems'
@@ -28,6 +24,73 @@ namespace :yard do
     sh "bundle exec yard graph --protected --full --dependencies > #{output_file}"
     puts 'open doc/erd.dot if you have graphviz installed'
   end
+
+  # #files => Array<String>
+  # The Ruby source files (and any extra documentation files separated by '-') to process.
+  DOC_FILES = ['lib/**/*.rb', '-', 'README.md']
+  DOC_FILES.concat `git ls-files -z docs *.md`.split("\x0")
+  DOC_FILES.freeze
+  DOC_REF = `git log --pretty=format:'%h' -1 | less -F -X`.chomp
+  DOC_VERSION = ActiveModel::Serializer::VERSION
+  DOC_REMOTE = "[email protected]:rails-api/active_model_serializers.git"
+  DOC_REMOTE_NAME = 'origin'
+  DOC_ROOT = Rails.root.to_s
+  DOC_PATH = File.join('..', 'ams.doc')
+  DOC_DIR  = File.join(DOC_ROOT, DOC_PATH)
+
+  YARD::Rake::YardocTask.new(:doc) do |t|
+    t.stats_options = ['--list-undoc']
+    t.files = DOC_FILES
+  end
+
+  YARD::Rake::YardocTask.new(:pages) do |t|
+    t.files   = DOC_FILES
+    t.options = ['-o', DOC_PATH]
+  end
+
+  namespace :pages do
+    task :clean do
+      Dir.chdir(DOC_DIR) do
+        next unless File.directory?('.git')
+        sh 'git rm -rf .' if system("git diff HEAD^..HEAD &>/dev/null | cat")
+      end
+    end
+
+    desc 'Check out gh-pages.'
+    task :checkout do
+      unless Dir.exist?(DOC_DIR)
+        Dir.mkdir(DOC_DIR)
+        Dir.chdir(DOC_DIR) do
+          sh 'git init'
+          sh "git remote add #{DOC_REMOTE_NAME} #{DOC_REMOTE}"
+          sh "git fetch #{DOC_REMOTE_NAME}"
+          if system('git branch -r gh-pages')
+            sh 'git checkout gh-pages'
+          else
+            sh 'git checkout --orphan gh-pages'
+            sh 'git rm -rf . || echo $?'
+            sh 'echo "Page" > index.html'
+            sh 'git add index.html'
+            sh 'git commit -a -m "First pages commit"'
+            sh "git push #{DOC_REMOTE_NAME} gh-pages --force-with-lease"
+          end
+        end
+      end
+    end
+
+    desc 'Generate and publish YARD docs to GitHub pages.'
+    task publish: ['doc:pages:checkout', 'doc:pages:clean', 'doc:pages'] do
+      Dir.chdir(DOC_DIR) do
+        sh "cat .git/HEAD | grep -q 'gh-pages' || git checkout gh-pages || echo $?"
+        sh 'git add .'
+        sh 'git add -u'
+        sh 'git diff --stat | cat'
+        sh 'git diff --stat --staged | cat'
+        sh 'git remote -v'
+        sh "git commit -m 'Generating docs for version #{DOC_VERSION} at ref #{DOC_REF}.' && git push #{DOC_REMOTE_NAME} gh-pages --force-with-lease || echo $!"
+      end
+    end
+  end
 end
 
 begin