Auto CMS is an efficient, customizable content management system dedicated to providing users with rich content display capabilities.In content creation, to support complex mathematical formulas and flowcharts and other advanced elements, Anqi CMS introduces integrated support for third-party libraries such as MathJax and Mermaid through its built-in Markdown editor.These libraries are usually loaded through content delivery networks (CDN) to ensure** performance and reliability.

According to the document guidance of AnQi CMS, if users want to correctly display mathematical formulas and flowcharts inserted through the Markdown editor on the front-end page, they need to do so in their template files (for example,base.html) of<head>Partially manually added specific CDN script links. For example, the CDN link provided for MathJax in the document ishttps://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js，clearly specified the third major version of MathJax. And the CDN link of Mermaidhttps://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjsalso clearly points to its tenth version.

This raises a key question: when these third-party libraries (MathJax and Mermaid) release new versions, do users of Safe CMS need to manually modify the script links in these templates?

According to the analysis of the documents provided by AnQi CMS, we can observe that the CDN links of MathJax and Mermaid provided in the documents are version-locked. Specifically, the link of MathJax contains@3，means locked in the third largest version of MathJax. The Mermaid link includes@10It indicates that the 10th version of Mermaid is being used.This version locking strategy means that as long as there are minor version updates within the MathJax 3.x series and Mermaid 10.x series (for example, from 3.0.0 to 3.1.0, or from 10.0.0 to 10.1.0), the CDN service will usually provide the latest minor version files for these version numbers automatically.In this case, the user does not need to manually modify the links in the template to enjoy bug fixes or minor feature improvements brought by minor version updates.

However, the situation is different when releasing the main version.If MathJax releases a new major version (such as MathJax 4), or if Mermaid releases its eleventh major version (Mermaid 11), and the user wants to take advantage of the functional improvements, performance optimizations, or major compatibility fixes brought by these new major versions, then they need to actively intervene.need to manually enter the template file of its CMS (such asbase.html），and update the main version number specified in the link——for example, update the main version number in the MathJax link@3Change to@4，or in the Mermaid link@10Change to@11.

In summary, for the CDN version updates of MathJax and Mermaid, the Anke CMS itself will not automatically modify the script links manually integrated by users in templates. If users want to upgrade to the latest major versions of these libraries to obtain new features or resolve compatibility issues, they need to manually edit according to the instructions in the documentation.base.htmlOr other template files that include these scripts, to update the main version number in the CDN link.This manual management method provides website stability while also requiring operation personnel to pay attention to the update dynamics of the third-party libraries they depend on.

Frequently Asked Questions

  • 问：为什么安企CMS不自动更新这些MathJax和Mermaid的CDN链接？答：The template design of Anqi CMS allows users to highly customize the website.To ensure the stability of the website and avoid compatibility issues that may be introduced by major version updates of external libraries, AnQi CMS will not automatically modify the third-party script links manually integrated into the template files by users.This approach gives control to the user, allowing them to decide whether to proceed with the version upgrade after sufficient testing and evaluation.

  • 问：如果我只想要MathJax或Mermaid的小版本更新（如bug修复），需要手动修改链接吗？答：通常不需要。CDN链接中的版本号通常锁定到库的主要版本（例如MathJax@3或 Mermaid@10EnglishThis means that small version updates within the same main version series (such as 3.0.1 to 3.0.2, or 10.1.0 to 10.2.0) will be automatically provided by the CDN service with the latest files, without the need for you to manually modify the links in the template.Only when you want to upgrade to a new major version of these libraries do you need to manually update the version number in the link.

  • 问：If MathJax or Mermaid releases a new version, how should I determine whether I need to update my safety CMS website?答：You should pay attention to the official release channels of MathJax and Mermaid to learn about the specific features, performance improvements, security fixes, or API changes brought by new versions.If these updates have a significant impact on your website functionality, user experience, or resolve the issues you are currently encountering, it is worth considering updating the CDN links manually.Before updating, it is strongly recommended that you verify in the test environment to ensure compatibility with your existing content and templates, to avoid potential issues affecting the production environment.