看板

[Discourse]

	摘要	看板 (Kanban Board) 允许您使用看板界面来显示和组织主题。
	预览	在 Discourse 主题创建器中预览
	仓库链接	https://github.com/discourse/discourse-kanban-theme
	Discourse 主题新手？	使用 Discourse 主题的初学者指南

安装此主题组件

由于这是由 Discourse 团队维护的 official 主题组件，您可以在此处的相应类别中提出 #support、#contribute:bug、Contribute > UX 和 Contribute > Feature 请求，并加上相应的主题组件标签。点击下方的链接即可开始。

 支持  Bug  UX  功能

看板现已作为核心 Discourse 插件发布，参见 Try out the new Boards feature for roadmaps and collaboration 。此功能可供我们商业版和企业版计划的客户使用。

由我们托管？ 主题组件可在我们的 Pro、Business 和 Enterprise 计划中使用。

摘要

Kanban Board 主题组件改变了您组织和可视化论坛主题的方式。它提供了一个拖放界面，允许您在代表类别、标签或用户分配的不同列之间移动主题，非常适合项目管理、工作流程可视化和内容组织。

功能

多种组织模式

Kanban Board 提供三种不同的模式来组织您的主题：

1. 类别模式：根据分配的类别组织主题
2. 标签模式：根据分配的标签组织主题
3. 分配模式：根据主题分配的用户进行组织

您可以将主题拖放到不同的列表中，以自动更改相应的属性：

性能优化

列表是“懒加载”的，这意味着组件仅在需要时加载内容。这确保了即使处理大量类别或主题时，也能保持合理的性能。

设置和配置

默认看板模式选择

默认看板模式将使用以下标准自动确定：

• 如果这是顶级页面，则使用类别模式
• 如果这是一个类别，并且存在子类别，则使用类别模式
• 否则，使用标签模式。（列表由“热门标签”列表构建）

更改看板模式

您可以使用左侧的筛选按钮更改看板模式，配置更改将反映在 URL 中。用户可以在浏览器中收藏他们喜欢的配置。

设置

站点管理员可以通过主题设置自定义主题组件的默认设置：

摘要

设置	描述
显示类别	应显示“看板”按钮的类别列表。如果留空，将在所有地方显示。对于子类别，不要包含父级 slug。使用 @ 表示顶级视图。
默认模式	覆盖每个类别的默认看板模式。使用语法 category:mode:params。例如，support:assigned:david,sam,joffrey。使用 @ 代替 category 来表示顶级视图（例如 @:tags:todo,done）。使用 @untagged 来显示未标记列。
默认视图	“看板”作为默认视图的类别列表。（注意：尚不支持顶级默认视图）
需要确认	在更改主题的标签/类别之前显示确认模态框
显示标签	在主题卡片上显示标签
卡片样式	确定主题卡片的视觉样式（目前可用“详细”）
显示主题缩略图	在卡片底部显示主题缩略图
显示活动指示器	显示卡片的活动指示器。如果主题在 7 天前或 20 天前被顶起，将应用不同的样式

每个设置的默认值如下所示：

文本自定义

管理员可以自定义文本标签 ，这些标签用于整个 Kanban 看板界面。以下文本元素可以自定义：

摘要

翻译	默认值	描述
no_topics	no topics	当列中没有主题时显示
confirm_change_tags	Remove ‘#%{remove}’ and add ‘#%{add}’ to ‘%{title}’?	更改标签时的确认消息
confirm_close	Close topic ‘%{title}’?	关闭主题时的确认
confirm_open	Reopen topic ‘%{title}’?	重新打开主题时的确认
confirm_change_category	Move topic ‘%{title}’?	更改主题类别时的确认
menu_label	Board	看板导航菜单项的文本
copy_link	Copy link to clipboard	复制链接的提示文本
configure	Configure kanban board	配置按钮的文本
fullscreen	Toggle fullscreen	全屏切换按钮的文本
no_lists	No Kanban lists configured…	当没有配置列表时显示
controls	Kanban Board Controls	控制部分标题
last_post_by	Last post by	最后发帖人信息的标签
modal.title	Configure Kanban	配置模态框的标题
modal.tags_placeholder	Tags to display…	标签输入字段的占位符
modal.categories_placeholder	Categories to display…	类别输入字段的占位符
modal.usernames_placeholder	Users to display…	用户输入字段的占位符
modal.apply	Apply	应用按钮的文本
modal.mode	Board Mode	看板模式选择器的标签
modal.lists	Lists	列表配置部分的标签

有效使用技巧

设置标签列

要在标签模式下实现最直观的设置，请在一个启用了“仅从此组中选择一个标签”的标签组中组织您的标签。这确保主题只能有一个状态标签，使看板像传统的工作流板一样工作。

控制标签模式下的列顺序

您可以使用 default modes 设置指定列的确切顺序。例如，指定 roadmap:tags:discovery,design,build,testing 将按照该特定顺序显示列：

赋能您的用户

由于在 Kanban 列之间移动主题的机制是更改标签，您必须确保您的目标用户实际上可以执行此操作。选项：

1. 确保您的目标用户是 @staff、@trust_level_4 或类别版主
2. 修改 post edit time 站点设置（这允许用户在更长的时间内更改自己主题的标题/标签）
3. 将所有主题设为 Wiki（不过他们需要编辑 Wiki 才能更改标签，这并不理想）

常见问题解答

我可以在移动设备上使用看板吗？

拖放功能目前不支持移动设备，因为它们不支持 HTML5 拖放。您仍然可以在移动设备上查看看板，但无法在列之间移动卡片。

为什么设置后看板标签页会消失？

如果初始配置后看板标签页消失，您可能需要确保已在主题设置中正确输入类别名称。请务必使用确切的类别 slug（如果适用，使用下划线而不是连字符），并分别配置父类别和子类别。

我如何限制全站显示的标签？

您可以使用 default modes 设置配置在标签模式下显示哪些标签。准确指定应作为列显示的标签，以防止显示所有标签。

我如何更改卡片外观？

您可以使用几个设置来自定义卡片的外观：

• 使用“卡片样式”设置选择显示格式
• 使用“显示标签”选项启用或禁用卡片上的标签
• 使用“显示主题缩略图”设置在卡片上添加缩略图
• 使用“显示活动指示器”设置添加视觉活动指示器

pr-welcome 功能：

• 使列表更具可配置性。例如，允许管理员在一个视图中定义分配、标签和类别的组合

• 添加对移动设备上拖动卡片的支持。不幸的是，它们不支持 html 拖放

[satonotdead]

这个插件得到了很大的改进，感谢核心团队的投入！

我建议添加一个选项，以便始终将一个特定的置顶主题显示在看板表的顶部。

这将有助于确保重要的信息 (如何使用 'support') 对所有用户保持可见，即使在使用看板视图时也是如此。

[ChrisBeach (Chris)]

您能澄清一下，如果我在看板上使用标签（而不是分类）时，“默认模式”设置应该是什么吗？

这来自文档，但不是很清楚：

@Discourse

覆盖每个分类的默认看板模式。使用语法 category:mode:params。例如 support:assigned:david,sam,joffrey。使用 @ 表示顶层视图。使用 @untagged 显示一个未标记的列。

基本上，我有两个标签（todo 和 done），并希望看板显示来自任何分类中带有这些标签的帖子。

[Moin]

我认为 @:tags:todo,done 应该可以满足你的要求

[ChrisBeach (Chris)]

有效了！感谢 @Moin

编辑：我已经更新了原帖中的文档，使其更清晰

[ShizukuYae]

您好，

感谢您在插件上所做的出色工作。

目前在标签模式的配置中，是否有任何方法可以只显示分类下的卡片，而不显示子分类的卡片？

[Lew_Grothe]

开始考虑迁移到 Horizon 主题——请问 Kanban 主题组件是否兼容？该组件不在列表中，我大致推测它可能不兼容，因为 Horizon 的设计非常具有倾向性，以合理的方式处理新 UI 可能会很困难。

如果不兼容，是否有办法将 Kanban 组件分叉修改为能够与 Horizon 配合使用的版本？

[mcwumbly (Dave McClure)]

它在 Horizon 上应该能运行得相当不错。

[Lew_Grothe]

刚在我的开发机器上启动了 Horizon，但看板完全无法使用——之前使用默认主题（几个版本之前）时是正常的。可能只是某个管理设置问题，但还是想问一下……

我会进一步调查……

[Arkshine]

我试了一下，在我这边可以正常工作。
你可以检查以下几点：

• 组件是否已附加到主题？
• 浏览器控制台是否有报错？

[nathank (Nathan Kershaw)]

@mcwumbly

它在 Horizon 上应该能很好地工作。

我一直很愉快地在 Horizon 上使用它。

我记得为了让看板有更宽的视图，我稍微调整了一下它，因为 Horizon 在中间部分的水平空间有点局促。这是我使用的 CSS：

// 允许看板视图占据主容器的整个宽度，并控制列宽
@media (min-width: 40rem) {
    body.kanban-active:not(.has-full-page-chat,.wizard) #main-outlet-wrapper #main-outlet>*:not(.experimental-screen,.activate-account) {
        max-width: none;
    }
}
.discourse-kanban-container .discourse-kanban-list {
    width: 350px;
}