请更好地记录 Discourse Calendar 插件

继续关于 Discourse Calendar 的讨论 — 因为我在那里的帖子将在一个月后被自动删除。

描述此插件的置顶帖需要一些修改。它确实令人困惑。具体来说:

事件混淆

似乎有三个不同的东西都称为“事件”:

  1. 最基础的:一个带有 [date] 的回复,它会显示在主题置顶帖的日历中。
  2. 主题中的置顶帖,包含 [event],由可选的“alpha state”功能使用 在此单独描述
  3. 一个名称相似的完全独立插件:Events instead of Event

这……令人困惑。

基础单主题事件的语法不明确

  1. 如何设置事件的名称?插件描述显示了带有事件的文本,但没有说明实际是如何设置的。
  2. 如何创建重复事件?
  3. 节假日日历显示了颜色。常规日历也可以有颜色吗?如果有,如何设置?
  4. 单独的“events”功能似乎可以生成 ical 提要。那么“basic”日历可以吗?

更多关于节假日日历的问题

它使用的是与每个主题日历相同的语法,还是“event”的语法?它是否仅限于“员工假期”,还是任何可以回复给定主题的人都可以使用?颜色从何而来? :desert_island: “Holiday flair”表情符号是否可以更改?是否可以将其显示给任何人,或某个任意群组,而不仅仅是员工?

等等……

其中一些我已经自己弄清楚了,或者通过寻求支持解决了。但它确实需要在插件文档主题中进行记录。

也许也应该详细说明一些限制 — 周开始日期不遵循您的区域设置且不可配置,整个东西在时区方面很混乱……如果有一个路线图或计划来解决其中一些问题或添加新功能(或者没有!),也请说明一下。

谢谢!这是一个很棒的小 Discourse 功能,对很多人来说都非常有用,但它也相当令人困惑。

7 个赞

该帖子是一个维基——所以你可以轻松地对其做出自己的贡献。这对大家都会非常有帮助。

6 个赞

我可以,尽管有些事情只能是猜测!

2 个赞

我在刷新日历和事件主题时在“相关主题”中发现了这个(“相关主题”的又一次胜利 :slight_smile: :medal_sports:

我刚刚重新调整了它们,使这两个功能现在都作为一个插件主题正确显示,这应该能消除一些困惑:

我还将许多“操作方法”的详细信息分成了几个指南,让它们有更多的空间:

主要重点是给它们更一致的结构(尽管我也为了好玩而进行了一些快速更新)。打磨它们有点棘手,但我认为它们比以前要好。经过一夜的思考,我认为还有一些事情我想做,所以我现在还不会 :rocket::slight_smile:

但希望我们正朝着正确的方向前进。 :crossed_fingers: :slight_smile:

7 个赞