Added LaTeX support via MathJax

.github/workflows/docmaker-ci.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       matrix:
         platform: [ubuntu-latest, windows-latest]
-        matlab-version: [R2022b, R2023b, R2024b, R2025b]
+        matlab-version: [R2022b, R2023b, R2024b, R2025b, R2026a]
     runs-on: ${{ matrix.platform }}    
     continue-on-error: false
     steps:

buildfile.m

@@ -14,26 +14,26 @@
 test = fullfile( prj, "tests" );
 
 % Clean task
-plan( "clean" ) = matlab.buildtool.tasks.CleanTask;
+plan("clean") = matlab.buildtool.tasks.CleanTask;
 
 % Check task
-plan( "check" ).Inputs = api;
+plan("check").Inputs = api;
 
 % Test task
-plan( "test" ) = matlab.buildtool.tasks.TestTask( test, ...
+plan("test") = matlab.buildtool.tasks.TestTask( test, ...
     "SourceFiles", tbx, "Strict", true );
-plan( "test" ).Inputs = [api test];
-plan( "test" ).Dependencies = "check";
+plan("test").Inputs = [api test];
+plan("test").Dependencies = "check";
 
 % Documentation task
-plan( "doc" ).Inputs = doc;
-plan( "doc" ).Outputs = [ ...
-    fullfile( doc, "**", "*.html" ), fullfile( doc, "*.xml" ), ...
-    fullfile( doc, "resources" ), fullfile( doc, "helpsearch-v*" )];
+plan("doc") = DocMakerTask( fullfile( doc, "**", "*.md" ), ...
+    "Theme", "light", ...
+    "FigureSize", [600, 400], ...
+    "FigureTheme", "light" );
 
 % Package task
-plan( "package" ).Inputs = tbx;
-plan( "package" ).Dependencies = ["test", "doc"];
+plan("package").Inputs = tbx;
+plan("package").Dependencies = ["test", "doc"];
 
 % Default task
 plan.DefaultTasks = "package";
@@ -72,27 +72,6 @@ function checkTask( c )
 
 end % checkTask
 
-function docTask( c )
-% Generate documentation
-
-% Documentation folder
-doc = c.Task.Inputs.Path;
-
-% Convert Markdown to HTML
-md = fullfile( doc, "**", "*.md" );
-html = docconvert( md, "Theme", "light" );
-fprintf( 1, "** Converted Markdown doc to HTML\n" )
-
-% Run code and insert output
-docrun( html, "Theme", "light", "FigureSize", [600 400] )
-fprintf( 1, "** Inserted MATLAB output into doc\n" )
-
-% Index documentation
-docindex( doc )
-fprintf( 1, "** Indexed doc\n" )
-
-end % docTask
-
 function packageTask( ~ )
 % Package toolbox
 

resources/project/4aFGfi4onqzWZHB5IvAEijU17mg/lopAaLOgBVi7xx_fr3uvxM8_E88d.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info/>

resources/project/4aFGfi4onqzWZHB5IvAEijU17mg/lopAaLOgBVi7xx_fr3uvxM8_E88p.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="DocMakerTask.md" type="File"/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/3vQSseMBROmLGazWdi5cLJvhWsgd.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/3vQSseMBROmLGazWdi5cLJvhWsgp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="tex-mml-chtml.rights" type="File"/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/DLDN-UvQd-QE2HBGqcPyADJ08D4d.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/DLDN-UvQd-QE2HBGqcPyADJ08D4p.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="tex-mml-chtml.js" type="File"/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/tSszSVdKmEHxNTuxxokkVBK4nu4d.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info/>

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/tSszSVdKmEHxNTuxxokkVBK4nu4p.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="mathjax-config.js" type="File"/>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/CptS6RPf-mdxP3OCPbhz6pVfFugd.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="design"/>
+    </Category>
+</Info>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/CptS6RPf-mdxP3OCPbhz6pVfFugp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="mustBeTheme.m" type="File"/>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/YFLRJ5f1k3unGOo2LdlE5qdJrVUd.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="design"/>
+    </Category>
+</Info>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/YFLRJ5f1k3unGOo2LdlE5qdJrVUp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="superfolder.m" type="File"/>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/xSrPVEHhWJ_-24ZQrCFK7aG8Q6Ad.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="design"/>
+    </Category>
+</Info>

resources/project/UMvhTnfaEKsbCRaOOLl1x86F4Is/xSrPVEHhWJ_-24ZQrCFK7aG8Q6Ap.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="getDefaultFigureSize.m" type="File"/>

resources/project/W7civUV8nZd65rl1QJN6xmVMVQI/-QZV9Nuy1zv83bU-kSqXt0VltGMd.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="design"/>
+    </Category>
+</Info>

resources/project/W7civUV8nZd65rl1QJN6xmVMVQI/-QZV9Nuy1zv83bU-kSqXt0VltGMp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="docmakerroot.m" type="File"/>

resources/project/W7civUV8nZd65rl1QJN6xmVMVQI/yuhCpIfVpbHV0GQ9EbmmIRF4rx8d.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="design"/>
+    </Category>
+</Info>

resources/project/W7civUV8nZd65rl1QJN6xmVMVQI/yuhCpIfVpbHV0GQ9EbmmIRF4rx8p.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="DocMakerTask.m" type="File"/>

resources/project/hLMKfvmMZYFbdoE4Xco7ryXas6s/bnU76PmKGhSmgMLZkuqWkWsd3scd.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info>
+    <Category UUID="FileClassCategory">
+        <Label UUID="test"/>
+    </Category>
+</Info>

resources/project/hLMKfvmMZYFbdoE4Xco7ryXas6s/bnU76PmKGhSmgMLZkuqWkWsd3scp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="tDocMakerTask.m" type="File"/>

resources/project/hLMKfvmMZYFbdoE4Xco7ryXas6s/npjRSxgAYS8N6yXOWyjOCzAHnKkd.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info/>

resources/project/hLMKfvmMZYFbdoE4Xco7ryXas6s/npjRSxgAYS8N6yXOWyjOCzAHnKkp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="LaTeXExample.md" type="File"/>

tbx/docmaker/+docmaker/getDefaultFigureSize.m

@@ -0,0 +1,7 @@
+function s = getDefaultFigureSize()
+%getDefaultFigureSize  Default figure size
+
+p = get( 0, "DefaultFigurePosition" ); % [x y w h]
+s = p(3:4); % [w h]
+
+end % getDefaultFigureSize

tbx/docmaker/+docmaker/mustBeTheme.m

@@ -0,0 +1,10 @@
+function mustBeTheme( theme )
+%mustBeTheme  Validation function for optional named argument Theme
+
+themes = ["none","light","dark","auto"];
+assert( ( ischar( theme ) && ismember( theme, themes ) ) || ...
+    ( isstring( theme ) && isscalar( theme ) && ismember( theme, themes ) ) || ...
+    ( isa( theme, "matlab.graphics.theme.GraphicsTheme" ) && isscalar( theme ) ), ...
+    "Theme must be ""none"", ""light"", ""dark"", ""auto"", or a GraphicsTheme." )
+
+end % mustBeTheme

tbx/docmaker/+docmaker/superfolder.m

@@ -0,0 +1,44 @@
+function s = superfolder( varargin )
+%superfolder  Common ancestor folder
+%
+%   s = superfolder(p1,p2,...) returns the common ancestor of the folders
+%   p1, p2, ...  The folders must exist.  If there is no common ancestor
+%   then superfolder returns [].
+
+%   Copyright 2024-2026 The MathWorks, Inc.
+
+% Check inputs
+narginchk( 1, Inf )
+dd = string( varargin );
+
+% Canonicalize using dir
+for ii = 1:numel( dd )
+    d = dd(ii);
+    assert( isfolder( d ), "docmaker:NotFound", "Folder ""%s"" not found.", d )
+    sd = dir( d );
+    dd(ii) = sd(1).folder; % first entry is "."
+end
+
+% Loop, split, compare
+s = dd(1); % initialize
+for ii = 2:numel( dd )
+    d = dd(ii);
+    ts = split( s, filesep ); % split
+    td = split( d, filesep ); % split
+    n = min( numel( ts ), numel( td ) ); % comparable length
+    tf = ts(1:n) == td(1:n); % compare
+    i = find( tf == false, 1, "first" ); % first non-match
+    if i == 1 % immediate non-match
+        s = [];
+        return
+    elseif isempty( i ) % full match
+        s = join( ts(1:n), filesep );
+    else % partial match
+        s = join( ts(1:i-1), filesep );
+    end
+end
+
+% Return matching datatype
+if iscellstr( varargin ), s = char( s ); end %#ok<ISCLSTR>
+
+end % superfolder

tbx/docmaker/Contents.m

@@ -1,5 +1,5 @@
 % MATLAB DocMaker
-% Version 0.7 (R2025b) 07-Feb-2026
+% Version 0.8 (R2026a) 28-May-2026
 %
 % docconvert - convert Markdown documents to HTML
 % docrun     - run MATLAB code in HTML documents and insert output