# 作曲家按钮盛宴

**URL:** <https://meta.discourse.org/t/composer-button-bonanza/352525>\
**Category:** Theme component\
**Tags:** composer\
**Created:** [2025年二月16日 05:07 UTC](https://meta.discourse.org/t/composer-button-bonanza/352525 "2025-02-16T05:07:12Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![mdoggydog](https://avatars.discourse-cdn.com/v4/letter/m/82dd89/32.png) [@mdoggydog](https://meta.discourse.org/u/mdoggydog)\
**Post date:** [2025年二月16日 05:07 UTC](https://meta.discourse.org/t/composer-button-bonanza/352525/1 "2025-02-16T05:07:12Z")

</div>

> ⚠ 富文本（单窗格，所见即所得）编辑器不完整，尚未充分支持此主题组件。

| | | |
| --- | --- | --- |
| ℹ | **摘要** | **Composer Button Bonanza** 允许站点管理员定义并将新的标记按钮添加到编辑器工具栏，并在其默认配置中提供大量新按钮。 |
| 🛠 | **仓库** | [centertap/DiscourseComposerButtonBonanza - Codeberg.org](https://codeberg.org/centertap/DiscourseComposerButtonBonanza.git) |
| 👀 | **自述文件** | [README.md](https://codeberg.org/centertap/DiscourseComposerButtonBonanza/src/branch/main/README.md) |
| 🗒 | **发布说明** | [RELEASE-NOTES.md](https://codeberg.org/centertap/DiscourseComposerButtonBonanza/src/branch/main/RELEASE-NOTES.md) |
| ❓ | **安装指南** | [如何安装主题或主题组件](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) |
| ❤ | **赞助** | **由以下机构为您带来…** [![CTAP](https://global.discourse-cdn.com/meta/original/4X/2/3/1/231262f126db7fbeb335bed672ccf6b49d3feee4.png)](https://www.centertap.org/how)  
此主题组件由 [Center for Transparent Analysis and Policy](https://www.centertap.org/)（一家 501(c)(3) 非营利组织）开发。如果此组件对您的站点有帮助，请考虑\*\*[向 CTAP 捐款以示支持](https://www.centertap.org/how)\*\*。 |

安装 Composer Button Bonanza

### _“您负担得起的编辑器新功能！”_

**Composer Button Bonanza** 是一个主题组件，它为编辑器提供了更多的标记按钮。

开箱即用，它提供了大量新按钮、一堆按钮、一个_按钮的盛宴_。默认配置在工具栏中添加了三个新按钮（_您能发现它们吗？_ 😄），并将其余的按钮隐藏在 ⚙ 弹出菜单中的一个切换按钮后面：

 ![Default layout, showing toggle in popup](https://global.discourse-cdn.com/meta/original/4X/0/3/a/03aed5fd89a011b4e40bbe28bf031044f9b2c8f8.png)

单击切换按钮后，其余按钮将可见：

 ![Default layout, all buttons revealed](https://global.discourse-cdn.com/meta/original/4X/a/4/0/a40f152639fabb901abfcaa58818b4e80e35c3af.png)

通过主题组件的配置设置，您可以：

- 添加新的按钮定义（和/或删除提供的定义）；
- 选择要显示哪些按钮以及何时显示它们；
- 更改按钮的顺序，并将按钮放置在工具栏或工具栏的 ⚙ 弹出菜单中；
- 为按钮提供翻译/本地化。

此组件 **不** 定义任何标记或样式——它只是添加了方便的按钮（可发现性/易用性！）来输入将调用现有样式的现有标记。它的主要目的是帮助用户发现和使用编辑器功能。例如，经常使用脚注的用户可能会直接在键盘上敲击 `^[` 和 `]`；但我们其他人会很高兴有一个 *️⃣ 按钮来提醒我们该怎么做。

这种方法的一个好处是，如果您决定删除此主题组件，您不会破坏任何现有帖子的样式。此组件不负责进行任何样式设置；它只是提供对编辑器中已存在的功能，和/或由其他插件或主题组件提供的功能快捷方式。

### 默认配置

默认配置提供了大多数（所有？）在默认 Discourse 安装（启用所有内置插件，未安装任何额外插件）上可用的额外标记的定义：

- 文本样式：
  - 下划线， ~~删除线~~
  - 上标 和 下标
  - 大文本，小文本
  - 键盘式

- 格式化
  - **一级标题** ， **二级标题** ， **三级标题**
  - 注脚\[1\]
  - Ruby text(ルビー テキスト)
  - 通过外部 URL 的图像 (`<img>`)
  - 待办事项列表
  - 高亮，插入的， ~~删除的~~ 文本

- 符号
  - 版权 ©，注册 ®，商标 ™
  - 欧元 €，日元 ¥
  - “耸肩”颜文字（因为，为什么不呢？ ¯\_(ツ)\_/¯ ）

- 还有一个切换按钮，用于显示/隐藏上述大部分按钮

如上所述，这些仅仅是默认设置。所有这些按钮都可以重新排列或删除，也可以添加新按钮。

* * *

1. …例如这个脚注。

---

_[View the full topic](https://meta.discourse.org/t/composer-button-bonanza/352525)._
