启用数学公式显示功能需要修改安企CMS的哪些模板文件？
作为一名资深的安企CMS网站运营人员，我深知内容质量对用户体验和网站成长的核心作用。随着内容形式的不断丰富，在技术类或教育类网站中，数学公式和复杂的流程图已成为提升内容专业度和可读性的重要元素。安企CMS为了满足这一需求，提供了通过集成第三方库来实现数学公式和流程图显示的方案。
要启用安企CMS网站上的数学公式显示功能，主要需要对一个核心模板文件进行修改，即 base.html。这个文件通常承载着网站的通用头部（<head>）和尾部（<footer>）结构，以及页面所需的全局样式和脚本。通过在此文件中引入特定的JavaScript库，我们可以让浏览器正确解析并渲染出美观的数学公式。
启用数学公式显示的前提条件是，您需要在安企CMS后台的“全局设置”中找到“内容设置”选项，并在此处确保已经启用了Markdown编辑器。这是因为数学公式通常以LaTeX或类似Markdown的语法编写，Markdown编辑器能够将这些特殊语法标记为需要进行额外处理的内容区域。
在确认Markdown编辑器已启用后，您需要打开当前正在使用的模板目录下的 base.html 文件。根据模板设计的约定，这个文件通常位于 /template/{你的模板目录}/ 路径下。在 base.html 文件的 <head> 区域，您需要添加一行专门用于数学公式渲染的JavaScript代码。具体而言，这行代码将引入 MathJax 库，该库负责在客户端解析并显示数学公式：
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
这条脚本建议放置在 <head> 标签内的底部，但要确保它在任何尝试渲染公式内容的JavaScript代码之前加载。async 属性会使脚本异步加载，而不会阻塞页面的其他内容的解析和渲染，从而优化页面加载性能。
虽然问题主要关注数学公式，但值得一提的是，如果您同时希望显示Markdown中的流程图，也需要在同一个 base.html 文件中进行类似的修改。流程图通常通过 Mermaid 库来渲染。您可以在 MathJax 脚本之后，同样在 <head> 区域，添加以下脚本代码：
<script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
mermaid.initialize({ startOnLoad: true });
</script>
这段代码会导入并初始化 Mermaid 库，使其能够在页面加载时自动寻找并渲染Markdown中定义的流程图。
此外，为了让Markdown内容在网页上有更统一和美观的默认样式，文档中也提到了引入 github-markdown-css 样式表。虽然这不是显示数学公式的必需步骤，但作为网站内容呈现的一部分，您可以在 base.html 的 <head> 区域，在引入 MathJax 脚本之前，添加以下 CSS 链接：
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.2.0/github-markdown.min.css" crossorigin="anonymous" referrerpolicy="no-referrer" />
完成这些修改并保存 base.html 文件后，刷新您的网站页面。此时，Markdown编辑器中包含的数学公式（如使用 $$...$$ 或 $...$ 语法）和流程图（如使用 mermaid 代码块）将能够被正确地解析和显示。
常见问题
Q1: 我是否需要为每个包含数学公式的页面单独修改模板文件？
您不需要为每个页面单独修改。对 base.html 文件的修改是全局性的。由于 base.html 是大多数页面（如文章详情页、单页面等）的基础模板，通过在此文件中引入 MathJax 和 Mermaid 等库，这些功能将自动应用于所有继承该基础模板的页面，无需针对每个内容页面进行重复操作。
Q2: 如果我的 MathJax 公式没有正确显示，我应该如何排查问题？
首先，请确保您已在安企CMS后台的“全局设置”->“内容设置”中启用了Markdown编辑器。其次，检查 base.html 文件中 MathJax 脚本的引入路径是否正确无误，以及脚本标签是否完整且未被其他HTML注释意外包裹。同时，确认您的Markdown内容中数学公式的语法（如LaTeX）是否符合标准，MathJax 默认支持许多常见的LaTeX语法。最后，检查浏览器开发者工具的控制台是否有报错信息，这通常能提供问题发生的具体线索。
Q3: 我可以不使用CDN服务来引入这些JavaScript和CSS库吗？
是的，您可以选择不使用CDN服务。如果您希望将 MathJax、Mermaid 等库的文件托管在自己的服务器上，可以从官方渠道下载这些库的最新版本，然后将文件放置在您网站的 /public/static/ 目录下（例如，创建一个 mathjax 或 mermaid 子目录），然后修改 base.html 中 <script> 和 <link> 标签的 src 或 href 属性，指向您本地托管的文件路径即可。这样做的好处是减少对第三方CDN的依赖，但需要您自行管理这些库的更新。