引用标注

:information_source: 摘要 添加 Obsidian 风格的提示框(Callouts),作为 Markdown 引用的一种替代方案。
:eyeglasses: 预览 Theme Creator
:hammer_and_wrench: 仓库 GitHub - Arkshine/discourse-quote-callouts · GitHub
:question: 安装指南 如何安装主题或主题组件
:open_book: Discourse 主题新手? Discourse 主题使用入门指南

安装此主题组件

此主题组件在 Discourse 中支持 Obsidian 风格的提示框,作为 Markdown 引语的替代方案。

提示框是突出显示内容、添加备注、警告或其他特殊消息的绝佳方式。


使用方法

创建提示框有多种方式。

Markdown 语法

在引用的第一行添加 [!type],其中 type 是类型标识符。类型标识符决定了提示框的外观和风格。查看所有可用类型,请参阅“支持的类型”部分。

:information_source: 类型标识符不区分大小写。

> [!tip] 
> **提示**:使用 `代码片段` 可提高可读性。它们提供清晰度和精确度。

预览

您可以通过点击图标来更改类型:

![chrome_atmmLf0v3c|690x209](upload://hZYzuK1MCwo7vsMEV9uYEZZOqjn.jpeg) 

富文本编辑器

现已完全支持,请参阅“富文本编辑器支持”部分。

键盘快捷键

  • Ctrl + q — 插入空提示框

工具栏

聊天

工具栏中提供了一个按钮,用于插入默认提示框。

自定义标题

默认情况下,提示框的标题是其类型标识符(首字母大写)。您可以在类型标识符后添加文本来更改它:

> [!question] 自定义标签 🤗
> 提示框的标签可以自定义。

> [!abstract] [date=2032-12-22 timezone="Europe/Paris"]
> 它们还可以包含特殊的内联格式,如动态日期。

您还可以创建仅标题的提示框:

> [!success] 已解决。

chrome_z53bS1GCew

可折叠提示框

您可以通过在类型标识符后直接添加加号 + 或减号 - 来使提示框可折叠。

  • + 默认展开提示框
  • - 默认折叠提示框
> [!todo]- 我的待办事项列表
>
> - [x] 编写文档
> - [ ] 添加测试
> - [ ] 审查代码

> [!todo]+ 我的展开待办事项列表
>
> - [x] 创建仓库
> - [ ] 设置 CI/CD
> - [ ] 部署到生产环境

![图片显示了一个展开的待办事项列表,包含“创建仓库”、“设置 CI/CD

54 个赞

太好了!\n\n我认为这可以用于此目的?:\n\nAdditional Post "Colour" coding

6 个赞

这似乎是一个有效的用法!

8 个赞

太棒了!你真厉害

4 个赞

这是一个很棒的补充。比基础讨论似乎包含的要多得多(尽管我还没有使用过 Obsidian)。

2 个赞

这看起来太棒了。电子邮件中的标注也会被正确样式化吗?

2 个赞

将此组件添加到我的网站时,我收到一条错误消息,内容为:

:warning: 您的网站可能无法正常工作,因为某个主题/组件存在错误。
由“引用标注”引起。单击此处进行更新、重新配置或禁用。

1 个赞

您运行的是哪个版本的 Discourse?

我使用的是 Tests-passed(3.5 beta),看起来没问题。

如果您使用的是 Stable 版本,您可能仍然是 3.4 或更早的版本,因为 3.4 刚刚发布到 Stable 版本。

1 个赞

我最近没有升级,因为有PostgreSQL 的问题。我升级后会向你汇报!

2 个赞

不确定是不是这种情况……但这是一个可能的嫌疑,因为许多更改已经推出,并且 TC 等……结构已经改变。例如,迁移到 Glimmer 组件。

1 个赞

恐怕不会。这需要一个插件。

您当前的 Discourse 版本是多少?

2 个赞

我已经更新到最新版本,现在可以正常工作了。

不幸的是,缺乏电子邮件支持使得它在我们的情况下无法使用。我们的大多数成员都订阅了群组和类别,因此通过电子邮件阅读消息。真遗憾!

3 个赞

我稍后可能会尝试制作一个插件版本!

7 个赞

这是 Discourse 的一个绝佳补充!:heart: :heart: :heart:

这正是 Discourse 核心所缺少的,至少是四种最常见的 callout 类型,如 info、danger、warning 和 success。我们已经使用 blockquote + emoji 格式一段时间了,我们一定会尝试这个 :slight_smile:

5 个赞

很喜欢你在这里所做的!

6 个赞

太好了,谢谢!

2 个赞

您好,只有一件事,引用代码块出现在我主页的摘录中,最好不要出现:

3 个赞

@patrickemin 你能测试一下最新版本吗?它现在应该可以清理主题摘录了。

4 个赞

是的,它奏效了,谢谢!

2 个赞

感谢您提供的这个主题组件,我非常喜欢!

但不幸的是,我不得不暂时禁用它,因为它在我的网站上造成了视觉问题,并且我在控制台中看到了以下内容,我能够追溯到您的 callouts.gjs

2 个赞