publish: use +stdlib/html per matlab defaults

Author: scivision

.github/workflows/publish.yml

@@ -59,9 +59,9 @@ jobs:
 # "Error using publish Only MATLAB code can be published"
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
-          path: 'docs/'
+          path: '+stdlib/html/'
 
       - name: Deploy to GitHub Pages
         id: deployment

.gitignore

@@ -10,14 +10,14 @@ release/
 resources/
 .buildtool/
 *.asv
-docs/
++stdlib/html/
 
 *.mex*
-*.oct
+*.exe
 
-test/printenv.exe
-test/stdout_stderr_c.exe
-test/stdout_stderr_fortran.exe
-test/stdin_cpp.exe
-test/stdin_fortran.exe
-test/sleep.exe
+test/printenv
+test/stdout_stderr_c
+test/stdout_stderr_fortran
+test/stdin_cpp
+test/stdin_fortran
+test/sleep

buildfile.m

@@ -107,13 +107,19 @@
 
 function publishTask(context)
 % publish HTML inline documentation strings to individual HTML files
-outdir = fullfile(context.Plan.RootFolder, 'docs');
+%
+% References:
+% https://www.mathworks.com/help/matlab/matlab_prog/display-custom-documentation.html
+% https://www.mathworks.com/help/matlab/matlab_prog/create-a-help-summary-contents-m.html
+
+pkg_root = fullfile(context.Plan.RootFolder, '+stdlib');
+html_dir = fullfile(pkg_root, 'html');
 styleFile = fullfile(context.Plan.RootFolder, "private/style.css");
 
 readme = publish_gen_index_html("stdlib", ...
   "A standard library of functions for Matlab.", ...
   "https://github.com/geospace-code/matlab-stdlib", ...
-  outdir, styleFile);
+  html_dir, styleFile);
 
 fprintf("\nweb('file:///%s') to view docs\n\n", readme);
 end