创建和管理投票

[Discourse]

本指南说明如何在 Discourse 中创建投票，以便就任何主题收集用户投票。

所需用户级别：所有用户

默认情况下，Discourse 中启用了投票，信任等级 1 或更高用户可以创建投票。站点管理员可以通过站点设置 poll create allowed groups 调整谁可以创建投票，并通过站点设置 poll enabled 禁用投票。

从工具栏创建投票

创建投票的最简单方法是使用投票构建器。可以通过编辑器中 ⊕ 选项菜单访问投票构建器，它允许您创建投票而无需知道确切的语法。

要显示高级选项，请按 图标。这将显示不同的投票选项，例如投票是否自动关闭、允许投票的组、选择条形图还是饼图等。

投票选项

投票类型：

• 单选：默认投票类型。用户可以从投票中选择一个选项。
• 多选：用户可以从投票中选择多个选项。
  • 投票创建者还必须定义用户可以选择的选项的最小数量和最大数量。默认情况下，最小值为 1，最大值为投票选项的数量。
• 数字评分：用户可以选择一个数字。
  • 投票创建者还必须定义数字评分的最小值、最大值和步长。例如，如果最小值为 2，最大值为 10，步长为 2，则选项将是 2、4、6、8 和 10。
• 排序选择：用户按偏好顺序对所有选项进行排名。赢家使用即时决选投票（Instant Run-off Voting）确定——在每轮中，得票最少的首选选项被淘汰，其选票重新分配，直到一个候选人获得多数票或出现平局。

结果：

• 始终可见：默认的投票结果。无论用户是否投票，他们都可以随时查看投票结果。
• 投票后可见：用户必须先投票才能查看投票结果。
• 投票关闭时：只有在投票关闭后才会显示投票结果。
• 仅限工作人员：只有站点工作人员可以看到投票结果。

允许的组：

允许投票创建者限制哪些组可以参与投票。不在列出组中的用户可以查看投票，但不能投票。默认情况下，所有用户都可以参与，没有组限制。

图表类型：

对于单选或多选投票，选择是显示条形图还是饼图。数字评分或排序选择投票不可用。

显示谁投票了：

默认启用，这允许可以看到投票结果的人同时查看每个投票用户的具体选择。（仅限条形图类型）

自动关闭投票：

允许投票创建者设置一个日期/时间让投票自动关闭。与手动关闭的投票不同，自动关闭的投票无法重新打开。

发布后允许添加或删除选项（动态）：

启用后，即使编辑窗口过期，也可以添加或删除投票选项，而不会清除未更改选项上的投票。这必须在首次创建投票时设置——现有投票创建后无法转换为动态。

包含图片

投票甚至可以包含图片！使用投票构建器插入投票后，可以将图片上传到帖子中并手动添加到投票中。上传的图片应较小，或调整为以较低的百分比显示：

[poll type=regular]
* ![image|690x458,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* ![image|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* ![image|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]

• 
• 
• 

[poll type=regular]
* Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
![image|690x458,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
![image|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
![image|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]

• Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
  
  
• Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
  
  
• Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
  
  

包含相对日期

投票也可以包含相对日期！与添加图片类似，使用投票构建器插入投票后，您可以通过“插入日期/时间”编辑器按钮在投票选项中插入日期：

[poll type=regular]
* [date=2019-10-13 timezone="Europe/Paris"]
* [date=2019-10-12 timezone="Europe/Paris"]
* [date=2019-10-11 timezone="Europe/Paris"]
[/poll]

• 2019-10-12T22:00:00Z
• 2019-10-11T22:00:00Z
• 2019-10-10T22:00:00Z

在一篇文章中包含多个投票

如果在单个帖子中使用多个投票（像这个！），每个投票都需要一个唯一的名称，否则它们将无法工作。使用投票构建器时，每个额外的投票都会被连续编号，但您也可以通过添加 name="poll_name" 作为参数手动完成：

[poll name="poll_1"]
1. option one
2. option two
3. option three
[/poll]

[poll name="poll_3" type=multiple min=2 max=3]
- option one
- option two
- option three
- option four
[/poll]

[poll name="dave" type=number min=2 max=10 step=2]
[/poll]

手动创建投票

虽然投票构建器是最简单的方法，但也可以在编辑器中手动创建和编辑投票。

要创建简单的投票，请用 [poll] 和 [/poll] 包围一个 markdown 列表：

[poll]
* option one
* option two
* option three
[/poll]

任何 markdown 列表都可以工作，包括使用连字符 - 或数字而不是星号 *。

这将产生以下结果：

1. option one
2. option two
3. option three

要手动创建更复杂的投票，可以在投票标签中添加附加参数。例如：

[poll type=multiple results=on_vote min=1 max=2 public=true chartType=pie groups=trust_level_1 close=3024-12-31T00:00:00.000Z]
# Do you like polls?
* Yes
* No
* Maybe
[/poll]

Do you like polls?

• Yes
• No
• Maybe

（尽管并非所有选项都适用于所有投票 ）

其他可用的投票类型包括 type=ranked_choice 用于即时决选投票，可以添加 dynamic=true 参数以允许在发布后修改选项。

使用投票构建器是了解这些附加参数格式以供将来使用的绝佳方式。

常见问题

任何人都可以投票吗？

即使投票本身没有组投票限制，用户也必须能够回复创建投票的主题才能参与。只有“查看”权限的用户将无法投票。

投票可以编辑吗？

编辑投票时会清除所有选票，以确保投票创建者无法更改用户投票的选择。因此，默认情况下，投票只能在创建后的 5 分钟宽限期内编辑。

一旦编辑了投票并清除了选票，就无法恢复选票

动态投票（dynamic=true）是一个例外，它允许在编辑窗口后添加或删除选项，同时保留现有选项上的选票。

我可以导出投票数据以供进一步分析吗？

工作人员可以使用 Discourse Data Explorer 以 csv 格式导出投票数据，可以将其导入他们选择的数据分析程序中。