From: Peter Amstutz <pamstutz@veritasgenetics.com>
Date: Fri, 9 Feb 2018 14:14:51 +0000 (-0500)
Subject: 11876: Build R SDK reference pages for doc site
X-Git-Tag: 1.1.4~89^2~4
X-Git-Url: https://git.arvados.org/arvados.git/commitdiff_plain/4fca56d2393f754a0f8ff21225fd975ca4b1f782

11876: Build R SDK reference pages for doc site

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <pamstutz@veritasgenetics.com>
---

diff --git a/.gitignore b/.gitignore
index d41eaeea5f..cc4f17e9ab 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,6 +12,7 @@ docker/*/generated
 docker/config.yml
 doc/.site
 doc/sdk/python/arvados
+doc/sdk/R/arvados
 sdk/perl/MYMETA.*
 sdk/perl/Makefile
 sdk/perl/blib
diff --git a/build/run-tests.sh b/build/run-tests.sh
index 4ebaf07c13..ec3c463770 100755
--- a/build/run-tests.sh
+++ b/build/run-tests.sh
@@ -249,6 +249,8 @@ sanity_checks() {
     R -q -e "library('testthat')" || fatal "No testthat. Try: apt-get install r-cran-testthat"
     # needed for roxygen2, needed for devtools, needed for R sdk
     pkg-config --exists libxml-2.0 || fatal "No libxml2. Try: apt-get install libxml2-dev"
+    # needed for pkgdown, builds R SDK doc pages
+    which pandoc || fatal "No pandoc. Try: apt-get install pandoc"
 }
 
 rotate_logfile() {
@@ -786,6 +788,9 @@ if (!requireNamespace("devtools")) {
 if (!requireNamespace("roxygen2")) {
   install.packages("roxygen2")
 }
+if (!requireNamespace("pkgdown")) {
+  devtools::install_github("hadley/pkgdown")
+}
 devtools::install_dev_deps()
 EOF
 }
diff --git a/doc/Rakefile b/doc/Rakefile
index f68a96471d..10bb8b9616 100644
--- a/doc/Rakefile
+++ b/doc/Rakefile
@@ -6,7 +6,7 @@
 require "rubygems"
 require "colorize"
 
-task :generate => [ :realclean, 'sdk/python/arvados/index.html' ] do
+task :generate => [ :realclean, 'sdk/python/arvados/index.html', 'sdk/R/arvados/index.html' ] do
   vars = ['baseurl', 'arvados_api_host', 'arvados_workbench_host']
   vars.each do |v|
     if ENV[v]
@@ -25,6 +25,17 @@ file "sdk/python/arvados/index.html" do |t|
   end
 end
 
+file "sdk/R/arvados/index.html" do |t|
+  `which R`
+  if $? == 0
+    STDERR.puts `R --quiet --vanilla -e 'pkgdown::build_site(pkg="../sdk/R/")' 2>&1`
+    raise if $? != 0
+    cp_r("../sdk/R/docs", "sdk/R/arvados")
+  else
+    puts "Warning: R not found, R documentation will not be generated".colorize(:light_red)
+  end
+end
+
 task :linkchecker => [ :generate ] do
   Dir.chdir(".site") do
     `which linkchecker`
@@ -38,6 +49,7 @@ end
 
 task :clean do
   rm_rf "sdk/python/arvados"
+  rm_rf "sdk/R/arvados"
 end
 
 require "zenweb/tasks"
diff --git a/doc/_config.yml b/doc/_config.yml
index 08b581c0d7..680f940f26 100644
--- a/doc/_config.yml
+++ b/doc/_config.yml
@@ -103,6 +103,8 @@ navbar:
     - Go:
       - sdk/go/index.html.textile.liquid
       - sdk/go/example.html.textile.liquid
+    - R:
+      - sdk/R/R.html.textile.liquid
     - Perl:
       - sdk/perl/index.html.textile.liquid
       - sdk/perl/example.html.textile.liquid
diff --git a/doc/sdk/R/R.html.textile.liquid b/doc/sdk/R/R.html.textile.liquid
new file mode 100644
index 0000000000..7b788a16a5
--- /dev/null
+++ b/doc/sdk/R/R.html.textile.liquid
@@ -0,0 +1,15 @@
+---
+layout: default
+navsection: sdk
+navmenu: R
+title: "R Reference"
+
+no_nav_left: true
+...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
+
+notextile. <iframe src="arvados/" style="width:100%; height:100%; border:none" />
diff --git a/doc/sdk/index.html.textile.liquid b/doc/sdk/index.html.textile.liquid
index e2b6eba899..fbc5ca11b6 100644
--- a/doc/sdk/index.html.textile.liquid
+++ b/doc/sdk/index.html.textile.liquid
@@ -14,6 +14,7 @@ This section documents language bindings for the "Arvados API":{{site.baseurl}}/
 * "Python SDK":{{site.baseurl}}/sdk/python/sdk-python.html
 * "Command line SDK":{{site.baseurl}}/sdk/cli/install.html ("arv")
 * "Go SDK":{{site.baseurl}}/sdk/go/index.html
+* "R SDK":{{site.baseurl}}/sdk/go/index.html
 * "Perl SDK":{{site.baseurl}}/sdk/perl/index.html
 * "Ruby SDK":{{site.baseurl}}/sdk/ruby/index.html
 * "Java SDK":{{site.baseurl}}/sdk/java/index.html
diff --git a/sdk/R/.Rbuildignore b/sdk/R/.Rbuildignore
index 91114bf2f2..4952b99da1 100644
--- a/sdk/R/.Rbuildignore
+++ b/sdk/R/.Rbuildignore
@@ -1,2 +1,3 @@
 ^.*\.Rproj$
 ^\.Rproj\.user$
+^docs$
diff --git a/sdk/R/DESCRIPTION b/sdk/R/DESCRIPTION
index 73738e17bc..19cf8fbabb 100644
--- a/sdk/R/DESCRIPTION
+++ b/sdk/R/DESCRIPTION
@@ -2,7 +2,7 @@ Package: ArvadosR
 Type: Package
 Title: Arvados R SDK
 Version: 0.0.2
-Author: Fuad Muhic
+Authors@R: person("Fuad", "Muhic", role = c("aut", "cre"), email = "fmuhic@capeannenterprises.com")
 Maintainer: Ward Vandewege <wvandewege@veritasgenetics.com>
 Description: This is the Arvados R SDK
 URL: http://doc.arvados.org