如何获得帮助

获得帮助的最佳位置是上的帮助频道 the Discord server 。它们位于频道列表中从顶部开始的第三类中：

要获得帮助，请从选择非活动的帮助频道开始。Inactive表示最后一条消息是在一天或更长时间之前发送的。如果所有帮助频道在该时间内都处于活动状态，请选择最后一条消息最早的频道。

一旦您选择了一个频道，请尽最大努力提供以下信息：

1. 对你想要做的事情做一个非常简短的解释

2. 你遇到的问题，有没有 error output formatted properly

3. 您的代码，带有 proper formatting

4. 哪一个 version of arcade 您正在使用它以及如何安装它

以下是一系列不和谐信息的示例(单击或点击放大)：

这一页的其余部分将解释如何像上面的例子那样格式化您的消息。

共享和格式化您的代码

其他人需要能够看到您的代码来帮助您。有两种首选的方式向他们展示它：

1. Pasting into Discord 对于少量的代码

2. Using a code hosting service 对于1个或多个文件

不和谐和Github问题的格式设置

在发布代码和终端输出时，格式化代码和终端输出非常重要。设置格式有助于其他人理解您粘贴的内容。

不和谐和GitHub问题都使用下面相同的3个步骤。

第一步：找到你的退格键

下面的字符不是单引号或撇号。它们被称为反划线。

在标准的美国键盘上，反记号键与输入Tilda时使用的键相同 (~ )。你可以在1键的左边找到它。

有关其他键盘布局，请 see this StackExchange answer 。

步骤2：格式化和粘贴

设置Python代码的格式与设置终端输出的格式几乎相同。

格式化代码

找到反记号密钥后，可以按如下方式格式化代码：

```python
# paste your code between the top and bottom lines!
print("Do stuff!")
```

如果您不能在键盘上键入反号，您可以将上面的示例复制到剪贴板上。为方便起见，单击示例框右上角的图标将为您复制它。您可以粘贴到不一致的消息框中，如下图所示：

格式化端子输出

终端输出(如回溯错误)可以采用几乎相同的方式进行格式化。不同的是，你不打字 python 在第一行的三个反号之后：

```
Traceback (most recent call last):
  File "/home/user/src/arcade/helpexample.py", line 34, in <module>
    main()
  File "/home/user/src/arcade/helpexample.py", line 29, in main
    window.setup()
  File "/home/user/src/arcade/helpexample.py", line 17, in setup
    self.player_sprite = arcade.Sprite(img, 1.0)
  File "/home/user/src/arcade/arcade/sprite.py", line 243, in __init__
    self._texture = load_texture(
  File "/home/user/src/arcade/arcade/texture.py", line 543, in load_texture
    file_name = resolve(file_name)
  File "/home/user/src/arcade/arcade/resources/__init__.py", line 40, in resolve
    raise FileNotFoundError(f"Cannot locate resource : {path}")
FileNotFoundError: Cannot locate resource : my_player_image.png
```

第三步：张贴！

在不一致时，您现在可以按Enter键发送消息，就像发送任何其他格式化文本一样。

对于GitHub上的错误报告，相同的一般格式原则也适用，但有一些不同。

您还必须单击提交新问题，而不是按Enter键。有关报告错误、GitHub问题及其支持的标记语法的详细信息，请参阅以下链接：

• How to Report Bugs Effectively

• GitHub issue creation documentation

• GitHub general markdown guide

• GitHub's code formatting documentation

代码托管

代码托管服务提供代码的格式化Web视图，您可以通过链接共享该视图。

要在没有注册的情况下共享代码片段或单个文件，您可以使用 the code pasting service 由 Python Discord 。如果你愿意注册一些东西，也有 GitHub Gists 。之后，您可以在不一致或其他聊天应用程序中粘贴链接。

共享代码的一种更高级的方式是使用git托管服务。学习如何使用git需要付出努力，但它有很多好处。其中一些包括：

• 轻松备份和撤消

• 更轻松地与他人协作

• 允许他人查看整个项目的源代码，以便更好地帮助您

流行的Git托管选项包括：

• GitHub

• GitLab

Arcade版本和基本环境信息

本节假定您已拥有 installed arcade 并激活了你的虚拟环境。

要获取有关当前Arcade版本和环境的基本信息，请在您的开发环境中运行以下命令：

arcade

该命令是跨平台的，这意味着无论你是在Mac、Linux还是Windows上，它都应该以相同的方式工作。

输出应如下所示：

Arcade 2.7.0
------------
vendor: Intel
renderer: Mesa Intel(R) UHD Graphics 620 (KBL GT2)
version: (4, 6)
python: 3.9.2 (default, Feb 28 2021, 17:03:44)
[GCC 10.2.1 20210110]
platform: linux

如果输出看起来与上面的示例不同，也没问题。每行的后半部分可能会发生变化，以反映您的街机版本、硬件和操作系统。

可以使用将输出复制并粘贴到Discorde或GitHub中 markdown formatting for terminal output 如前所述。

如下例所示的输出表示出了问题：

bash: arcade: command not found

你还是应该 include the output 作为请求帮助的一部分。

如果您想在获得帮助之前尝试自己解决问题，对上述错误消息最有可能的解释是：

• 忘记激活您的虚拟环境

• 不 installing arcade 成功