publish: add project URL

Author: scivision

+stdlib/is_url.m

@@ -1,3 +1,6 @@
+%% IS_URL is true if the string is a URL.
+% e.g. https://example.invalid is true
+
 function y = is_url(s)
 arguments
   s (1,1) string

Readme.md

@@ -21,6 +21,8 @@ Self-tests can be run from that matlab-stdlib/ directory:
 buildtool
 ```
 
+URLs (e.g. https://, s3:// and similar) are treated as not existing.
+
 [API Documentation](https://geospace-code.github.io/matlab-stdlib)
 
 Most Matlab-stdlib filesystem functions work without the

buildfile.m

@@ -30,5 +30,6 @@ function publishTask(~)
 
   publish_gen_index_html("stdlib", ...
     "A standard library of functions for Matlab.", ...
+    "https://github.com/geospace-code/matlab-stdlib", ...
     outdir)
 end

private/publish_gen_index_html.m

@@ -7,7 +7,13 @@
 % * https://www.mathworks.com/help/matlab/matlab_prog/marking-up-matlab-comments-for-publishing.html
 %
 % for package code -- assumes no classes and depth == 1
-function publish_gen_index_html(pkg_name, tagline, outdir)
+function publish_gen_index_html(pkg_name, tagline, project_url, outdir)
+arguments
+  pkg_name (1,1) string
+  tagline (1,1) string
+  project_url (1,1) string
+  outdir (1,1) string
+end
 
 pkg = what("+" + pkg_name);
 % "+" avoids picking up cwd of same name
@@ -28,6 +34,7 @@ function publish_gen_index_html(pkg_name, tagline, outdir)
      "<h1>" + pkg_name + " API</h1>", ...
      "<p>" + tagline + "</p>", ...
      "<p>" + git_txt + "</p>", ...
+     "<p>Project URL: <a href=" + project_url + ">" + project_url + "</a></p>", ...
      "<h2>API Reference</h2>"];
 fid = fopen(readme, 'w');
 fprintf(fid, join(txt, "\n"));
@@ -39,15 +46,13 @@ function publish_gen_index_html(pkg_name, tagline, outdir)
 doc_fn = publish(pkg_name + "." + name, evalCode=false, outputDir=outdir);
 disp(doc_fn)
 
-% inject summary into Readme.md
+% inject summary for each function into Readme.md
 summary = split(string(help(pkg_name + "." + name)), newline);
 words = split(strip(summary(1)), " ");
 
-% purposefully this will error if no docstring
+% error if no docstring
 fname = words(1);
-if(lower(fname) ~= lower(name))
-  error("fname %s does not match name %s", fname, name)
-end
+assert(lower(fname) == lower(name), "fname %s does not match name %s \nis there a docstring at the top of the .m file?", fname, name)
 
 line = "<a href=" + name + ".html>" + fname + "</a> ";
 if(length(words) > 1)