[ARVADOS] updated: 385b439532e90ccd2429941574d8b44029a6ea54

git at public.curoverse.com git at public.curoverse.com
Thu Apr 3 14:29:37 EDT 2014


Summary of changes:
 .gitignore         |    3 +--
 doc/.gitignore     |    1 -
 doc/README.textile |   14 +++++++-------
 doc/Rakefile       |   45 ++++++++++++++++++++-------------------------
 4 files changed, 28 insertions(+), 35 deletions(-)
 delete mode 100644 doc/.gitignore

       via  385b439532e90ccd2429941574d8b44029a6ea54 (commit)
      from  3acd32f8a766269e0d7841000eb58e6d8364fcc9 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.


commit 385b439532e90ccd2429941574d8b44029a6ea54
Author: Ward Vandewege <ward at curoverse.com>
Date:   Thu Apr 3 14:27:16 2014 -0400

    * README: remove numbers in headings
    
    * linkchecker: only check file:// links
    
    * epydoc: run against the local source tree, not against whatever
      version of the python 'arvados' package is installed
    
    * generate: re-run epydoc on every generation
    
    * generate: do not fail to include the epydoc output files if they are
      generated in the current run (which they now always are)

diff --git a/.gitignore b/.gitignore
index 4d6cc39..4fe6ac8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,6 +2,5 @@
 *.pyc
 docker/*/generated/*
 docker/config.yml
-doc/_site/*
 doc/.site/*
-doc/sdk/python/arvados
\ No newline at end of file
+doc/sdk/python/arvados
diff --git a/doc/.gitignore b/doc/.gitignore
deleted file mode 100644
index ca35be0..0000000
--- a/doc/.gitignore
+++ /dev/null
@@ -1 +0,0 @@
-_site
diff --git a/doc/README.textile b/doc/README.textile
index 38a53cf..9d58dfe 100644
--- a/doc/README.textile
+++ b/doc/README.textile
@@ -6,13 +6,13 @@ Here's how to build the HTML pages locally so you can preview your updates befor
 
 Additional information is available on the "'Documentation' page on the Arvados wiki":https://arvados.org/projects/arvados/wiki/Documentation.
 
-h2. 0. Install dependencies
+h2. Install dependencies
 
 <pre>
 arvados/doc$ bundle install
 </pre>
 
-h2. 1. Generate HTML pages
+h2. Generate HTML pages
 
 <pre>
 arvados/doc$ rake
@@ -24,18 +24,18 @@ Alternately, to make the documentation browsable on the local filesystem:
 arvados/doc$ rake generate baseurl=$PWD/.site
 </pre>
 
-h2. 2. Run linkchecker
+h2. Run linkchecker
 
 If you have "Linkchecker":http://wummel.github.io/linkchecker/ installed on
 your system, you can run it against the documentation:
 
 <pre>
-arvados/doc$ rake linkchecker baseurl=$PWD/.site
+arvados/doc$ rake linkchecker baseurl=file://$PWD/.site
 </pre>
 
 Please note that this will regenerate your $PWD/.site directory.
 
-h2. 2. Preview HTML pages
+h2. Preview HTML pages
 
 <pre>
 arvados/doc$ rake run
@@ -46,7 +46,7 @@ arvados/doc$ rake run
 
 Preview the rendered pages at "http://localhost:8000":http://localhost:8000.
 
-h2. 3. Publish HTML pages inside Workbench
+h2. Publish HTML pages inside Workbench
 
 (or some other web site)
 
@@ -62,7 +62,7 @@ Make the docs appear at {workbench_host}/doc by creating a symbolic link in Work
 arvados/doc$ ln -sn ../../../doc/.site ../apps/workbench/public/doc
 </pre>
 
-h2. 4. Delete generated files
+h2. Delete generated files
 
 <pre>
 arvados/doc$ rake realclean
diff --git a/doc/Rakefile b/doc/Rakefile
index dbef7b9..6d7f4e1 100644
--- a/doc/Rakefile
+++ b/doc/Rakefile
@@ -3,7 +3,7 @@
 require "rubygems"
 require "colorize"
 
-task :generate do
+task :generate => [ :realclean, 'sdk/python/arvados/index.html' ] do
   vars = ['baseurl', 'arvados_api_host', 'arvados_workbench_host']
   vars.each do |v|
     if ENV[v]
@@ -12,39 +12,34 @@ task :generate do
   end
 end
 
-task :linkchecker => [:realclean, :generate]
-
-task :linkchecker do
-  Dir.chdir(".site")
-  `which linkchecker`
+file "sdk/python/arvados/index.html" do |t|
+  `which epydoc`
   if $? == 0
-    ignore_urls = ['', 'javascript', 'mailto',
-                   'oftc.net', 'putty.org','google.com', 'fsf.org',
-                   'arvadosapi.com', 'arvados.org', 'sourceforge.net',
-                   'chiark.greenend.org.uk', 'github.io' ]
-    system "linkchecker index.html " + ignore_urls.join(' --ignore-url=')
+    `epydoc --html --parse-only -o sdk/python/arvados ../sdk/python/arvados/`
   else
-    puts "Warning: linkchecker not found, skipping".colorize(:light_red)
+    puts "Warning: epydoc not found, Python documentation will not be generated".colorize(:light_red)
   end
 end
 
-require "zenweb/tasks"
-load "zenweb-textile.rb"
-load "zenweb-liquid.rb"
-
-file "sdk/python/arvados/index.html" do |t|
-  `which epydoc`
-  if $? == 0
-    `epydoc --html -o sdk/python/arvados arvados`
-    Dir["sdk/python/arvados/*"].each do |f|
-      puts f
-      $website.pages[f] = Zenweb::Page.new($website, f)
+task :linkchecker => [ :generate ] do
+  Dir.chdir(".site") do
+    `which linkchecker`
+    if $? == 0
+      system "linkchecker index.html --ignore-url='!file://'"
+    else
+      puts "Warning: linkchecker not found, skipping run".colorize(:light_red)
     end
-  else
-    puts "Warning: epydoc not found, Python documentation will not be generated".colorize(:light_red)
   end
 end
 
+task :clean do
+  rm_rf "sdk/python/arvados"
+end
+
+require "zenweb/tasks"
+load "zenweb-textile.rb"
+load "zenweb-liquid.rb"
+
 task :extra_wirings do
   $website.pages["sdk/python/python.html.textile.liquid"].depends_on("sdk/python/arvados/index.html")
 end

-----------------------------------------------------------------------


hooks/post-receive
-- 




More information about the arvados-commits mailing list