Merge branch '17165-vscode-training-doc' refs #17165

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <peter.amstutz@curii.com>

diff --combined doc/Rakefile
index 3717f9f5f1d429568b748ff7e0ca1e558585a00e,c13cea3c1abf9e720730218f9828c215ca6b3fa6..ee87062f7ec275716f454c298db96eb9239e0e0a
--- 1/doc/Rakefile
--- 2/doc/Rakefile
+++ b/doc/Rakefile
@@@ -20,15 -20,6 +20,15 @@@ en
  
  task :generate => [ :realclean, 'sdk/python/arvados/index.html', 'sdk/R/arvados/index.html', 'sdk/java-v2/javadoc/index.html' ] do
    vars = ['baseurl', 'arvados_cluster_uuid', 'arvados_api_host', 'arvados_workbench_host']
 +  if ! ENV.key?('baseurl') || ENV['baseurl'] == ""
 +    if !ENV.key?('WORKSPACE') || ENV['WORKSPACE'] == ""
 +      puts "The `baseurl` variable was not specified and the `WORKSPACE` environment variable is not set. Defaulting `baseurl` to file://#{pwd}/.site"
 +      ENV['baseurl'] = "file://#{pwd}/.site/"
 +    else
 +      puts "The `baseurl` variable was not specified, defaulting to a value derived from the `WORKSPACE` environment variable"
 +      ENV['baseurl'] = "file://#{ENV['WORKSPACE']}/doc/.site/"
 +    end
 +  end
    vars.each do |v|
      if ENV[v]
        website.config.h[v] = ENV[v]
@@@ -157,6 -148,37 +157,37 @@@ task :linkchecker => [ :generate ] d
    end
  end
  
+ task :import_vscode_training do
+   Dir.chdir("user") do
+   rm_rf "arvados-vscode-cwl-training"
+   `git clone https://github.com/arvados/arvados-vscode-cwl-training`
+   githash = `git --git-dir arvados-vscode-cwl-training/.git log -n1 --format=%H HEAD`
+   File.open("cwl/arvados-vscode-training.html.md.liquid", "w") do |fn|
+     File.open("arvados-vscode-cwl-training/README.md", "r") do |rd|
+       fn.write(<<-EOF
+ ---
+ layout: default
+ navsection: userguide
+ title: "Developing CWL Workflows with VSCode"
+ ...
+ {% comment %}
+ Copyright (C) The Arvados Authors. All rights reserved.
+ 
+ SPDX-License-Identifier: CC-BY-SA-3.0
+ 
+ Imported from https://github.com/arvados/arvados-vscode-cwl-training
+ git hash: #{githash}
+ {% endcomment %}
+ 
+ EOF
+               )
+                fn.write(rd.read())
+     end
+   end
+   rm_rf "arvados-vscode-cwl-training"
+   end
+ end
+ 
  task :clean do
    rm_rf "sdk/python/arvados"
    rm_rf "sdk/R"