 |
摘要 | 未格式化代码检测器 会在发布前检测未格式化的代码并发出警告。 |
 |
预览 | 在 Discourse 主题创建器中预览 |
 |
仓库链接 | https://github.com/discourse/unformatted-code-detector |
 |
初次接触 Discourse 主题？ | Discourse 主题使用入门指南 |
安装此主题组件
功能特性
发布未格式化代码的用户将看到一条警告消息，指导其如何正确格式化代码。
检测的敏感度以及是否检测 HTML 可通过主题设置进行配置。
设置
| 名称 | 描述 |
|---|---|
| emoji icon | 在未格式化警告弹窗标题旁显示的表情图标。 |
| disable at trust level | 对信任等级为 N 或更高的用户禁用警告。-1 = 对所有用户启用。 |
| sensitivity | 检测算法的敏感度。0 = 插件禁用；1 = 对任何看起来略微像代码的内容发出警告。 |
| min post length to check | 要检查的帖子最小长度（字符数） |
| max post length to check | 要检查的帖子最大长度（字符数）。-1 = 无上限。 |
| include html | 除其他类型的代码外，还检查 HTML 标签。如果用户经常需要在帖子中渲染自定义 HTML，建议禁用此项。 |
| 翻译键 | 默认值 |
|---|---|
| warning_modal.title | 您正在发布代码吗？ |
| warning_modal.content | 您的帖子似乎包含代码或日志。为保持帖子可读性，请记得使用工具栏中的 预格式化文本 按钮 </> 或键盘上的反引号键 ` 来格式化您的代码，示例如下：[examples] |
| warning_modal.do_not_show_again | 不再显示此消息 |
| warning_modal.fix_post | 编辑帖子 |
| warning_modal.ignore_and_post_anyway | 仍要发布 |
调试
如果您收到针对不包含任何文本的帖子的警告，可以通过打开浏览器 JS 控制台并输入 debugUnformattedCodeDetector() Enter 来打印调试信息。这将输出哪些行被视为“代码”以及当前的敏感度设置等信息。
“不再显示此消息”仅对当前设备生效，而非针对用户。这是一个已知问题，待 Discourse 获得从主题中附加用户信息的功能后将会修复。
由我们托管？ 主题组件可在我们的标准版、商业版和企业版计划中使用。