 |
摘要 | 看板 (Kanban Board) 允许您使用看板界面来显示和组织主题。 |
 |
预览 | 在 Discourse 主题创建器中预览 |
 |
仓库链接 | https://github.com/discourse/discourse-kanban-theme |
 |
Discourse 主题新手？ | 使用 Discourse 主题的初学者指南 |
安装此主题组件
看板现已作为核心 Discourse 插件发布，参见 Try out the new Boards feature for roadmaps and collaboration 。此功能可供我们商业版和企业版计划的客户使用。
摘要
Kanban Board 主题组件改变了您组织和可视化论坛主题的方式。它提供了一个拖放界面，允许您在代表类别、标签或用户分配的不同列之间移动主题，非常适合项目管理、工作流程可视化和内容组织。
功能
多种组织模式
Kanban Board 提供三种不同的模式来组织您的主题：
- 类别模式：根据分配的类别组织主题
- 标签模式：根据分配的标签组织主题
- 分配模式：根据主题分配的用户进行组织
您可以将主题拖放到不同的列表中，以自动更改相应的属性：
性能优化
列表是“懒加载”的，这意味着组件仅在需要时加载内容。这确保了即使处理大量类别或主题时，也能保持合理的性能。
设置和配置
默认看板模式选择
默认看板模式将使用以下标准自动确定：
- 如果这是顶级页面，则使用类别模式
- 如果这是一个类别，并且存在子类别，则使用类别模式
- 否则，使用标签模式。（列表由“热门标签”列表构建）
更改看板模式
您可以使用左侧的筛选按钮更改看板模式，配置更改将反映在 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 列之间移动主题的机制是更改标签，您必须确保您的目标用户实际上可以执行此操作。选项：
- 确保您的目标用户是 @staff、@trust_level_4 或类别版主
- 修改
post edit time站点设置（这允许用户在更长的时间内更改自己主题的标题/标签） - 将所有主题设为 Wiki（不过他们需要编辑 Wiki 才能更改标签，这并不理想）
常见问题解答
我可以在移动设备上使用看板吗？
拖放功能目前不支持移动设备，因为它们不支持 HTML5 拖放。您仍然可以在移动设备上查看看板，但无法在列之间移动卡片。
为什么设置后看板标签页会消失？
如果初始配置后看板标签页消失，您可能需要确保已在主题设置中正确输入类别名称。请务必使用确切的类别 slug（如果适用，使用下划线而不是连字符），并分别配置父类别和子类别。
我如何限制全站显示的标签？
您可以使用 default modes 设置配置在标签模式下显示哪些标签。准确指定应作为列显示的标签，以防止显示所有标签。
我如何更改卡片外观？
您可以使用几个设置来自定义卡片的外观：
- 使用“卡片样式”设置选择显示格式
- 使用“显示标签”选项启用或禁用卡片上的标签
- 使用“显示主题缩略图”设置在卡片上添加缩略图
- 使用“显示活动指示器”设置添加视觉活动指示器
pr-welcome 功能：
-
使列表更具可配置性。例如，允许管理员在一个视图中定义分配、标签和类别的组合
-
添加对移动设备上拖动卡片的支持。不幸的是，它们不支持 html 拖放