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:

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/4J1qHxqAFvZe0q911q4f4N0MvkId.xml

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

resources/project/Ku6LayYHevJ-5It_EcVLrF2mc2Y/4J1qHxqAFvZe0q911q4f4N0MvkIp.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Info location="tex-mml-chtml.js.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

tbx/docmaker/DocMakerTask.m

@@ -0,0 +1,116 @@
+classdef DocMakerTask < matlab.buildtool.Task
+    %DOCMAKERTASK Generate toolbox documentation using DocMaker.
+    %
+    % See also docconvert, docrun, docindex
+
+    properties
+        % Documentation theme.
+        Theme(1, 1) string {mustBeMember( Theme, ...
+            ["light", "dark", "auto"] )} = "auto"
+        % Stylesheets to include.
+        Stylesheets(1, :) string {mustBeFile}
+        % Scripts to include.
+        Scripts(1, :) string {mustBeFile}
+        % Root folder for publishing.
+        Root(1, :) string {mustBeFolder, mustBeScalarOrEmpty}
+        % LaTeX interpreter.
+        Interpreter(1, 1) string {mustBeMember( Interpreter, ...
+            ["latex", "none"] )} = "none"        
+        % Batching level.
+        Level(1, 1) double {mustBeInteger, ...
+            mustBeInRange( Level, 0, 7 )} = 0
+        % Figure theme.
+        FigureTheme {docmaker.mustBeTheme( FigureTheme )} = "none"
+        % Figure size.
+        FigureSize(1, 2) double {mustBePositive, mustBeReal} = ...
+            docmaker.getDefaultFigureSize()
+    end % properties
+
+    properties ( TaskInput )
+        % Documentation files in Markdown format.
+        MarkdownFiles(1, :) cell
+    end % properties ( TaskInput )
+
+    methods
+
+        function task = DocMakerTask( markdownFiles, namedArgs )
+            %DOCMAKERTASK Construct the DocMaker build task.
+
+            arguments ( Input, Repeating )
+                markdownFiles
+            end % arguments ( Input, Repeating )
+
+            arguments ( Input )
+                namedArgs.?DocMakerTask
+            end % arguments ( Input )
+
+            % Assign the markdown files.
+            task.MarkdownFiles = markdownFiles;
+
+            % Add the task metadata.
+            task.Description = ...
+                "Generate toolbox documentation using DocMaker";
+
+            % Assign any user-specified properties.
+            props = string( fieldnames( namedArgs ).' );
+            for prop = props
+                task.(prop) = namedArgs.(prop);
+            end % for
+
+        end % constructor
+
+    end % methods
+
+    methods ( TaskAction )
+
+        function buildDoc( task, ~ )
+            %BUILDDOC Build the toolbox documentation.
+            %
+            % * Convert Markdown documents to HTML
+            % * Run MATLAB code in HTML documents and insert output
+            % * Create info.xml and helptoc.xml from helptoc.md
+
+            % Prepare docconvert argument list.
+            convertArgs = {};
+            if ~isempty( task.Stylesheets )
+                convertArgs = {"Stylesheets", task.Stylesheets};
+            end % if
+
+            if ~isempty( task.Scripts )
+                convertArgs = [convertArgs, {"Scripts", task.Scripts}];
+            end % if
+
+            if ~isempty( task.Root )
+                convertArgs = [convertArgs, {"Root", task.Root}];
+            end % if
+
+            % Convert Markdown to HTML.
+            html = docconvert( task.MarkdownFiles{:}, ...
+                "Theme", task.Theme, ...
+                "Interpreter", task.Interpreter, ...
+                convertArgs{:} );
+            fprintf( 1, "** Converted Markdown doc to HTML\n" )
+
+            % Execute MATLAB code and insert output into the HTML.
+            docrun( html, ...
+                "Level", task.Level, ...
+                "Theme", task.FigureTheme, ...
+                "FigureSize", task.FigureSize )
+            fprintf( 1, "** Inserted MATLAB output into doc\n" )
+
+            % Build the documentation search index.
+            if ~isempty( task.Root )            
+                docindex( task.Root )
+            else
+                sMd = docmaker.dir( task.MarkdownFiles{:} );
+                pMd = reshape( {sMd.folder}, size( sMd ) );
+                pRoot = docmaker.superfolder( pMd{:} );
+                docindex( pRoot )
+            end % if
+            fprintf( 1, "** Indexed doc\n" )
+
+        end % buildDoc
+
+    end % methods ( TaskAction )
+
+end % classdef