Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Modified as per style guide

This article explains how to resolve the issue of Latex Math anchor/numbering not working in Confluence Server 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 may 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 app must be updated to resolve the problem.

Instructions

  1. Log in to Jira, click the Cogwheelicon in the top right corner, and select "Manage Apps" from the dropdown menu.

  2. Search or scroll down until you see "Latex Math," and click on select it. Select "Click Latex Math Configuration".

  3. Scroll down until you see "Math Block velocity template" and "Math Block Reference velocity template", as shown below.

    Image RemovedTo edit each of the blocks, click Image Added
  4. Click anywhere within the block to edit a block. This will open opens the corresponding velocity template, which you can compare with the templates available 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:

Code Block
#*
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:

Code Block
#*
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 Refresh the Confluence page containing the Latex math LaTex Math macros to see if anchors and numbers display correctly.

...