更改 discourse-setup 的措辞

安装
1

您好
我最近进行了几次全新安装。
我注意到在检查 Docker 是否已安装的过程中，第一条响应的措辞是：

“未能找到 Docker… 等等”

在大多数安装中，将“未能”作为第一条响应，对于不熟悉命令行的人来说并不是很好的反馈。

您复制粘贴

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse

除非 Docker 已安装，否则会导致失败，而在大多数情况下，这几乎是不可能的。

能否将措辞更改为不那么负面的内容？

  • “未找到 Docker…”

  • “[如预期]… Docker 未安装…”

  • “下一步是安装 Docker，因为它目前未安装…”

  • “成功了！- 下一步是安装 Docker，因为它目前未安装…”

@pfaffman 我知道您进行了很多安装，有什么想法吗？

3 个赞
2

回复我自己……一个事后的想法。

安装 Docker 是出于礼貌才征求许可吗？
这个安装过程中的停止步骤真的有必要吗？

难道不能直接说明如果尚未安装 Docker，则会安装它吗？

2 个赞
3

请注意，此措辞不在说明中，而是来自 discourse-setup 脚本。

2 个赞
4

是的，
我说的是命令行响应——echo

“Failed”这个词可以去掉并换成其他说法吗？
或者最好是安装直接继续，而不是在这里停止等待响应？

如果你在进行任何安装，你最不想看到的就是“Failed”这个词
尤其是在你刚刚（正确地）从安装说明中复制粘贴之后。

3 个赞
5

这是一个很好的观点。还有很多 grep 命令也会输出令人困惑且看起来像错误的内容。我以前曾考虑过清理这些。这可能需要一两个小时，而且我不太愿意在自己的时间里做这件事，因为大多数人都能忍受那些可怕的消息。

不过，下次我进行更改时（也许在下个月，以便更容易关闭新的 ember-cli 内容），我会看看如何让这种语言不那么吓人。

4 个赞
6

罗马非一日建成 :slight_smile:

所以清理工作可以分阶段进行 :+1:

3 个赞
7

嗨 Jay，
是的，我经历过几次安装，随着经验的积累，恐慌确实会消退。

所使用的语言反映了第 131 行 if 语句的负面结果。
从编码角度来看，这是正确的，但实际上，找不到 Docker 是预期行为，因为大多数人刚刚进行了全新安装。

我一直认为，我粘贴到命令行中的这段代码应该/能够安装 Docker，而无需进行对话？

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
2 个赞
8

我写那段话时，显然是为程序员写的，而不是为普通人写的！

4 个赞
9

这里展示的内容可以通过替换消息为语言字符串来轻松避免。实现这一目标的两种可能方法：

  • 实现 API 调用（读取）并使用 Weblate，
  • 将所有语言字符串存储在本地（在 Discourse 安装中）并用占位符替换所有消息。

上述两种方法都需要对 Discourse 核心进行大量修改。

1 个赞
10

我想到，与其修复我认为所有有问题的地方，不如你请求的更改只需要几行代码，所以我提交了这个：

3 个赞
11

老实说，新的措辞听起来像是 Docker 存在，但不在路径中。

3 个赞
12

哎呀，糟糕。是的。

文字太难了。

所以也许

在你的 PATH 中找不到 docker 或 docker.io。

我想这说得通，因为

你的 PATH 中既没有 docker 也没有 docker.io。

应该是

未找到 Docker。

而看到这个的人

“按 Enter 从 https://get.docker.com/ 安装 Docker 或按 Ctrl+C 退出”

会知道是按回车还是不按。

5 个赞
13

嗨 Jay，感谢您抽出宝贵时间完成这项工作，我知道您很忙，还要打理您自己的网站，顺便说一句，您的网站看起来很棒。祝您一切顺利。

未找到 Docker。

太棒了。

1 个赞
14

我认为在消息中提及 PATH 是一个重要的指标，表明 docker/docker.io 可能已安装或未安装，即问题可能是 PATH 不包含安装它的位置。

如果目标只是避免使用强烈的否定词，我认为只需将“Failed to”替换为“Could not”即可。

Could not find docker or docker.io on your PATH.
15

回到负面……
我只是不需要知道这个……我只想在我粘贴时安装 Docker……

为什么停止安装来报告您正在安装的东西之前没有安装过？
继续安装 Docker。
如果在 PATH 中找到 Docker - 太棒了 - 安装 Discourse
完全删除这两行？

16

Jay, Simon

最好不要在这上面花任何时间。
关于“复制”的多种意见很难在不惹恼某人的情况下解决。

当我下次进行全新安装时……我可以笑着谈论这个话题，然后进入我的“好地方”，正如我被告知的那样，Docker 在我的全新安装中“未找到”，当我按下“Y”安装 Docker 时，我可以做到不咬牙切齿地咒骂，“我以为我一直在他妈地做这件事——赶紧的”。

1 个赞
17

我认为这是因为您没有安装 docker。在出现该消息时，您正在运行 Discourse 设置，该设置依赖于 docker 的可用性——如果找不到 docker，它会帮助您安装它，但它会询问，因为它不了解您的系统。

也许它找不到，因为它没有安装，在这种情况下，安装显然是正确的答案。也许它找不到，因为您出于某种原因故意将 docker 安装在其他地方，而它不在系统的默认 PATH 中，在这种情况下，安装是错误的答案。（一个正确的答案是中止设置并使用 PATH=/where/docker/is:$PATH ./discourse-setup 再次运行它）

您是否有可能将存储库名称 discourse_docker 误解为 docker？它不是，它是 Discourse 的外层，是需要与 docker 交互的组件，例如设置脚本、启动脚本等。

1 个赞