Set alt attribute when publishing a figure

Question

1 投票

I am using Publish to write some documentation that will be included in a larger website. I would like to be able to properly caption my figures:

function testAlt
figure(1);
x=0:.1:2*pi;
y=sin(x);
plot(x,y);
set(gcf,'Tag','Sine wave');

Produces:

What I want is:

<figure>
<img vspace="5" hspace="5" src="testAlt_01.png" alt=""> 
<figcaption>Sine wave</figcaption>
</figure>

Which would render as:

Looking at toolbox/matlab/codetools/private/mxdom2simplehtml.xsl, the <img> template contains:

<xsl:attribute name="alt"><xsl:value-of select="@alt"/></xsl:attribute>

I can modify this file to include:

<figure>
...
<figcaption><xsl:value-of select="@alt"/></figcaption>
</figure>

and I'll get my caption. Only problem is that there doesn't seem to be a way to propogate any property of gcf into the XML. @alt seems like the natural choice, and since someone wrote the code to consume it, perhaps someone could write the code to produce it.

My other suggestion on this is that embedding the css style sheet in an xsl file in a folder named "private" is painful. Why not provide a configuration parameter "cssfile" that would import the specified file into the document's head?

        <link rel="stylesheet" type="text/css"><xsl:attribute name="href">u<xsl:value-of select="@cssfile"/></xsl:attribute></link>

Where I can put:

figure {
    display: inline-block;
    margin: 20px;
}
figure img {
    vertical-align: top;
}
figure figcaption {
	caption-side: bottom;
	padding: 10px;
	font-weight: bold;
	font-size: 110%;
    text-align: center;
}

1 件のコメント
-1 件の古いコメントを表示 -1 件の古いコメントを非表示

Jeff Mandel 2025 年 2 月 21 日

編集済み: Jeff Mandel 2025 年 2 月 22 日

MATLAB Online で開く

A bit of a kludge, but until @alt is available, change the xsl to:

<figcaption>Figure <xsl:value-of select="substring(@src,string-length($title)+2,2)"/></figcaption>

This takes the name of the image file (myfunction-xx.png) and pulls out the xx, so the first figure will be "Figure 01". Yes, I could probably figure out how to suppress the leading zero.

What would be a nice feature would be the ability to define an XML variable in the script, so you could cross reference to the figure, something like:

setXMLtag('fignum', 1);
setXMLtag('caption', 'Money as a function of time');
%%
% As can be seen in Figure @fignum, time is money
plot(time,money)

サインインしてコメントする。

サインインしてこの質問に回答する。

Follow Question

Answer 1

Jeff Mandel 2026 年 3 月 2 日

MATLAB Online で開く

0 投票

OK, I came back to this a year later, and here's the solution. Not pretty, but it works. Several steps:

1) For every figure, create the figure with a name:

figure('Name', 'Money as a function of time');

2) Make a copy of the file $MATLABROOT/toolbox/matlab/codetools/private/mxdom2simplehtml.xsl

3) Add this line to the <HEAD> section:

    <link rel="stylesheet" type="text/css"><xsl:attribute name="href">user.css</xsl:attribute></link>

4) Create the file user.css in the directory that your html file will be written and add some css:

figure {
    display: inline-block;
    margin: 20px;
}
figure img {
    vertical-align: top;
}
figure figcaption {
	caption-side: bottom;
	padding: 10px;
	font-weight: bold;
	font-size: 18pt;
    text-align: center;
}

5) In mxdom2simplehtml.xsl, search for the line

<xsl:template match="img">

Change this to

<xsl:template match="img">
  <figure>

6) Change

</img>

To

</img>
<figcaption><xsl:value-of select="@alt"/></figcaption>
</figure>

7) Create this script:

function domNode = publishWithXML(fname)
% Usage:
%    fname - the name of the command (no file extension)
%    domNode - the DOM structure that was used to generate the HTML
    % An empty cell array that holds the captions
    figdata = {};
    % The DefaultFigureCreateFcn that populates the cell array 
    set(groot,'DefaultFigureCreateFcn',@myCreateCallback);
    % Call publish and get the xml without applying an XSLT
    thexmlfile= publish(sprintf("%s.m",fname),"format","xml","showCode",false,"codeToEvaluate",fname);
    close all;
    % Read the XML into a domNode
    domNode=xmlread(thexmlfile);
    % Get all the img nodes
    allimg = domNode.getElementsByTagName("img");
    for i=0:allimg.getLength-1
        % Get the src attribute of the img tag, scan for the figure
        % number, and find the row of figdata that contains the caption
        imgsrc = string(allimg.item(i).getAttribute("src"));
        fignum = sscanf(imgsrc,sprintf("%s_%%d",fname));
        [row,~] = find(cellfun(@(x) isequal(fignum,x),figdata));
        % Create the string for the alt tag and add this to the img node
        alttext = sprintf("Figure %d - %s", fignum, string(figdata(row,2)));
        allimg.item(i).setAttribute("alt", alttext);
    end
    
    % Transform the domNode to html using our modified xsl file. The
    % original is in $MATLABROOT/toolbox/matlab/codetools/private/mxdom2simplehtml.xsl
    xslt(domNode,"mxdom2simplehtml.xsl",sprintf("html/%s.html",fname),"-web");
    function myCreateCallback(src,~)
        % Add the properties of the figure handle to the cell array
        if ~isempty(src.Number)
            figdata(src.Number,:) = {[src.Number], src.Name};
        end
    end
end

Calling publishWithXML("myscript") will create a <figcaption> within the <figure> that contains your <img>, sequentially numbering them.

Now MathWorks could modify $MATLABROOT/toolbox/matlab/codetools/+internal/+matlab/+publish/PublishFigures.m to write the alt tag from the Number and Name of the figure, but isn't this way more fun?

5 件のコメント
3 件の古いコメントを表示 3 件の古いコメントを非表示

Michael 2026 年 3 月 4 日

Thank you for the additional feedback. The enhancement request has been forwarded to the relevant development team for consideration for a future update or release of MATLAB.

Jeff Mandel 2026 年 4 月 11 日

MATLAB Online で開く

As I dig further into this, I discovered that when publish exports an equation, it appends class="equation" to the img tag. I'd suggest that when exporting a regular figure, appending class="figure". This would assist an xsl transform in dealing with figures and equations differently. Also, adding a tag id="Figure_num", where num is the Number attribute of the figure. This would allow the xsl to output:

<figure id="Figure_1">
  <img alt="The relationship between time and money" src="myapp_01.png" />
  <figcaption>The relationship between time and money</figcaption>
</figure>

and a link to #Figure_1 to bring you to that figure.

サインインしてコメントする。

Set alt attribute when publishing a figure

1 件のコメント
-1 件の古いコメントを表示 -1 件の古いコメントを非表示

採用された回答

5 件のコメント
3 件の古いコメントを表示 3 件の古いコメントを非表示

その他の回答 (0 件)

カテゴリ

製品

リリース

タグ

Community Treasure Hunt

Set alt attribute when publishing a figure

1 件のコメント -1 件の古いコメントを表示 -1 件の古いコメントを非表示

採用された回答

5 件のコメント 3 件の古いコメントを表示 3 件の古いコメントを非表示

その他の回答 (0 件)

カテゴリ

製品

リリース

タグ

参考

Community Treasure Hunt

1 件のコメント
-1 件の古いコメントを表示 -1 件の古いコメントを非表示

5 件のコメント
3 件の古いコメントを表示 3 件の古いコメントを非表示