| 摘要 | 未格式化代码检测器 会检测未格式化的代码,并在发布前发出警告。 | |
| 预览 | 在 Discourse 主题创建器中预览 | |
| 仓库链接 | https://github.com/discourse/unformatted-code-detector | |
| 初次接触 Discourse 主题? | Discourse 主题使用入门指南 |
安装此主题组件
功能
发布未格式化代码的用户将看到一条警告消息,指导他们如何正确格式化代码。
灵敏度和是否检测 HTML 可通过主题设置进行配置。
设置
| 名称 | 描述 |
|---|---|
| emoji icon | 在未格式化警告模态框标题旁边显示的 emoji 图标。 |
| 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 获得将用户信息附加到主题的功能,该问题将被修复。
由我们托管? 主题组件可在我们的标准版、商业版和企业版计划中使用。
