||||
-|-|
| 摘要 | Discourse Math 使用 MathJax（默认）或 KaTeX 在您的 Discourse 论坛中渲染数学公式。
| 安装指南 | 此插件已捆绑在 Discourse 核心代码中。无需单独安装该插件。
启用数学公式
可以通过其设置启用数学公式插件，访问路径为您的 admin/plugins 页面：
功能
启用后，您可以使用单个 $ 包裹来渲染行内数学公式，例如：$E=mc^2$。
您可以使用 $$ 包裹来渲染块级数学公式：
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
Discourse Math 使用启发式算法来确保诸如 “I spent 20$ and another 100$” 这样的句子不会被转换。
LaTeX 定界符
通过站点设置启用后，您还可以使用标准的 LaTeX 定界符：
- 行内：
\(...\)- 示例：\(E=mc^2\) - 块级：
\[...\]- 示例：\[ \frac{1}{2} \]
AsciiMath（仅限 MathJax）
使用 MathJax 时，您可以启用 asciimath 处理，它使用 % 作为定界符：%E=mc^2%
编辑器集成
编辑器工具栏中包含一个 插入数学公式 按钮，快捷键为 Shift+M。这将打开一个模态窗口，您可以在其中：
- 在行内模式和块级模式之间切换
- 编写您的 LaTeX 表达式
- 预览并插入到您的帖子中
在富文本编辑器中，数学公式显示为可编辑节点，并带有编辑按钮以修改表达式。
聊天支持
数学公式也会在 Discourse Chat 消息中使用相同的设置和渲染引擎进行渲染。
渲染引擎
MathJax（默认）
- 版本： 4.1
- 输出格式： HTML（默认）或 SVG
- 功能：
- 上下文菜单（右键点击数学公式）
- 屏幕阅读器的无障碍增强
- 按住 Alt 点击缩放（175% 缩放）
- 支持 AsciiMath
KaTeX（替代方案）
- 功能：
- 快速渲染
- 用于化学方程式的 Mhchem 扩展
- CopyTex 扩展 - 点击数学公式可将 LaTeX 源代码复制到剪贴板
- 支持使用
\label、\ref和\eqref宏进行交叉引用
站点设置
通过在管理员设置中搜索 “math” 查看所有相关站点设置。
| 名称 | 描述 |
|-|
| discourse math enabled | 启用 Discourse Math 插件（为 $ 和 $$ 块添加特殊处理） |
| discourse math provider | 数学渲染提供程序：mathjax（默认）或 katex |
| discourse math enable latex delimiters | 启用 LaTeX 风格定界符：行内数学使用 \(...\)，块级数学使用 \[...\] |
| discourse math mathjax output | MathJax 输出格式：html（默认）或 svg（仅限 MathJax） |
| discourse math enable menu | 启用数学公式的上下文菜单（仅限 MathJax） |
| discourse math enable accessibility | 启用无障碍功能，如文本增强（仅限 MathJax 且启用菜单时） |
| discourse math zoom on click | 按住 Alt 点击时缩放 175%（仅限 MathJax 且启用菜单时） |
| discourse math enable asciimath | 启用 asciimath 处理，使用 % 定界符（仅限 MathJax） |
由我们托管？此插件在我们所有的托管套餐中均可用 Math | Discourse - Civilized Discussion