This article explains how to resolve the issue of Latex Math anchor/numbering not working in Confluence Server after an upgrade.
When you encounter Latex Math issues in Confluence Server after updating to a new version, such as anchors not working or numbers not displaying, you might have an issue with the velocity templates. The velocity templates (Math Block velocity template and Math Block Reference velocity template) for the Latex Math add-on need to be updated to resolve the problem.
Instructions
Log in to Jira, click the Cogwheel icon in the top right corner, and select "Manage Apps" from the dropdown menu.
Search or scroll down until you see "Latex Math," and click on it. Select "Latex Math Configuration".
Scroll down until you see "Math Block velocity template" and "Math Block Reference velocity template", as shown below.
To edit each of the blocks, click anywhere within the block. This will open the corresponding velocity template, which you can compare with the templates below. If you notice any differences, replace the existing template with the new one. Ensure to take the back up of the existing codes.
Math Block velocity template:
#* Copyright (c) 2022 Appfire Technologies, LLC. All rights reserved. This software is licensed under the provisions of the "Appfire EULA" (https://appfire.com/eula/) as well as under the provisions of the "Standard EULA" from the "Atlassian Marketplace Terms of Use" as a "Marketplace Product" (http://www.atlassian.com/licensing/marketplace/termsofuse). See the LICENSE file for more details. *# #htmlSafe() ## Put parenthesis around equation number: #if ($!captionHtml && ($!captionHtml.length()>0)) #set ($captionHtml = "($captionHtml)") #end ## ## Write block equation: <table border=0 cellspacing=0 cellpadding=0 width=100% align="center" class="latexmath-mathblock" style="width: 100% !important;"> <tbody><tr> <td nowrap class="latexmath-numbering">$!captionHtml</td> <td nowrap class="latexmath-$halign">$!latexHtml</td> </tr></tbody> </table>
Math Block Reference velocity template:
#*
Copyright (c) 2022 Appfire Technologies, LLC.
All rights reserved.
This software is licensed under the provisions of the "Appfire EULA"
(https://appfire.com/eula/) as well as under the provisions of
the "Standard EULA" from the "Atlassian Marketplace Terms of Use" as a "Marketplace Product"
(http://www.atlassian.com/licensing/marketplace/termsofuse).
See the LICENSE file for more details.
*#
#htmlSafe()
#macro(doNothing)#end
## Add colon to page name:
#if ($pageNameHtml && ($pageNameHtml.length()>0))
#set ($pageNameHtml = $pageNameHtml+'<span class="latexmath-refpagejoiner">:</span>')
#end
##
<a href="$!{anchorURLHtml}" class="latexmath-mathblock-ref"$!{dataParamsHtml}>($!{pageNameHtml}$!{captionHtml})</a>#doNothing()
5. Make sure to save your changes after replacing the templates.
6. Try refreshing the Confluence page containing the Latex math macros to see if anchors and numbers display correctly.
Perform the above steps in a staging environment before implementing them in production.
Ensure to have appropriate permissions to change this setting.