||||\n-|-|-|\n:discourse2: | 摘要 | Discourse Math 使用 MathJax(默认)或 KaTeX 来渲染您的 Discourse 论坛中的数学公式。\n:open_book: | 安装指南 | 此插件已与 Discourse 核心捆绑。无需单独安装插件。\n\n\n[quote]\n\n:discourse2: 由于这是由 Discourse 团队维护的 official 插件,#support、#bug、UX 和 Feature 请求可以在 Meta 上的相应版块中提出,并使用适当的插件标签进行标记。点击下面的链接即可开始。
\n\n\u003ckbd\u003e [
\u0026nbsp;支持](Discourse Meta "询问有关配置和使用 Discourse Math 的支持") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;Bug](Discourse Meta " Bug 报告意味着某些东西坏了,阻止了插件的正常/典型使用") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;用户体验](Discourse Meta "关于 Discourse Math 的用户界面,以及功能如何呈现(包括语言和 UI 元素)的讨论") \u003c/kbd\u003e \u003ckbd\u003e [
\u0026nbsp;功能](Discourse Meta "讨论如何改进或增强现有的 Discourse Math 功能,以及提议的新功能如何运作")\u003c/kbd\u003e\n\n[/quote]\n\n### 启用数学公式\n\n可以通过其设置启用 Math 插件,这些设置可在您的 admin/plugins 页面访问:\n\n
\n\n\n### 功能\n\n启用后,您可以通过用单个 $ 包裹来渲染行内数学公式,如下所示:$E=mc^2$。\n\nYou can render blocks of math by wrapping with $$\n\n\n$$\n\\sqrt{(-1)} \\; 2^3 \\; \\sum \\; \\pi\n$$\n\n\n
\\(...\\) - 示例:\\(E=mc^2\\)\n- 块级: \\[...\\] - 示例:\n \n \\[\n \\frac{1}{2}\n \\]\n \n\n#### AsciiMath (仅限 MathJax)\n\n使用 MathJax 时,您可以启用 asciimath 处理,它使用 % 作为分隔符:%E=mc^2%\n\n### 编辑器集成\n\n编辑器工具栏中包含一个 插入数学公式 按钮,快捷键为 \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e。这会打开一个模态框,您可以在其中进行以下操作:\n\n- 在行内和块级模式之间切换\n- 编写您的 LaTeX 表达式\n- 预览并插入到您的帖子中\n\n在富文本编辑器中,数学表达式显示为带有编辑按钮的可编辑节点,用于修改表达式。\n\n### 聊天支持\n\n数学表达式也会在 Discourse Chat 消息中渲染,使用相同的设置和渲染引擎。\n\n### 渲染引擎\n\n#### MathJax (默认)\n\n- 版本: 4.1\n- 输出格式: HTML(默认)或 SVG\n- 功能:\n - 上下文菜单(右键单击数学公式)\n - 屏幕阅读器的辅助功能增强\n - Alt 键单击时缩放(175% 缩放)\n - AsciiMath 支持\n\n#### KaTeX (替代方案)\n\n- 功能:\n - 快速渲染\n - 用于化学方程式的 Mhchem 扩展\n - CopyTex 扩展 - 点击数学公式可将 LaTeX 源代码复制到剪贴板\n - 支持使用 \\label、\\ref 和 \\eqref 宏的交叉引用\n\n### 站点设置\n\n在您的管理设置中搜索“math”,即可查看所有相关的站点设置。\n\n| 名称 | 描述 |\n|-|-|\n| discourse math enabled | 启用 Discourse Math 插件(对 $ 和 $$ 块添加特殊处理) |\n| discourse math provider | 数学渲染提供商:mathjax(默认)或 katex |\n| discourse math enable latex delimiters | 启用 LaTeX 风格的分隔符:行内数学公式使用 \\(...\\),块级数学公式使用 \\[...\\] |\n| discourse math mathjax output | MathJax 输出格式:html(默认)或 svg(仅限 MathJax) |\n| discourse math enable menu | 为数学表达式启用上下文菜单(仅限 MathJax) |\n| discourse math enable accessibility | 启用辅助功能,例如文本增强(仅限带菜单的 MathJax) |\n| discourse math zoom on click | Alt 键单击交互时缩放 175%(仅限带菜单的 MathJax) |\n| discourse math enable asciimath | 使用 % 分隔符启用 asciimath 处理(仅限 MathJax) |\n\n\n\u003e 