常见问题:获取帮助¶
如何为X制作动画?为什么我会得到错误Y?有人能帮我吗?¶
在向社区提问之前,请确保您遇到的问题尚未在我们的FAQ部分中得到充分讨论,以便您可以自行解决问题。您也可以尝试使用您喜欢的搜索引擎,如果幸运的话,您可能会找到一篇博客文章、StackOverflow上的一个问题,或者r/manim subreddit中的一篇帖子。
如果不是这种情况,请花点时间适当地准备你的问题: 你越能解释清楚你正在努力解决的问题, 人们就越能有效地帮助你。无论你在下一步选择哪个平台, StackOverflow 都有一个关于如何提出好问题的好指南。
一旦你明确了想要询问的内容,请选择以下沟通渠道之一:
社区在我们的Discord服务器上最为活跃。 点击链接加入,然后在侧边栏中选择一个
#manim-help频道, 并在那里发布你的问题。如果你熟悉使用Discord,尝试使用我们服务器的搜索功能搜索你的问题;也许之前已经有人讨论过这个问题!我们也在监控StackOverflow上标记有
manim的问题。许多人也在我们的r/manim subreddit中活跃,如果你是狂热的Reddit用户,欢迎在那里发帖——但请注意,Discord或StackOverflow可能是更好的选择。
最后,如果您不喜欢其他所有选项,您也可以在GitHub上发起新的讨论。
在所有这些渠道中,请确保遵守Manim的行为准则——简而言之,彼此要优秀:友好、耐心、体贴和尊重。
如果没有人回答我的问题,我该怎么办?¶
尝试看看你的问题是否可以改进:你是否包含了所有相关信息(在出现错误的情况下:完整的堆栈跟踪、你正在渲染的代码,以及你用来运行Manim的命令?)。如果你使用了一个非常长的例子,是否可以构建一个更简洁的版本,具有相同的(错误)行为?
如果您在我们的Discord帮助频道中发布了问题,但您的问题被埋没了,
您可以ping @Manim Helper 角色,以引起愿意查看的志愿者的注意。
请在第一次提问时避免立即ping该角色,这被认为是不礼貌的。
如果您觉得最初选择的渠道没有取得任何成功,您也可以尝试将您的问题发布到不同的渠道——但请不要在我们所有的沟通渠道中滥发您的问题(特别是对于Discord:请不要同时使用多个帮助渠道)。
最后,就像大多数开源项目一样:我们的社区成员都是志愿者。如果你没有快速得到问题的答案,可能是因为没有人知道答案,或者因为你的问题不够清晰,也可能是因为所有能帮助你解决问题的人都在忙于其他事情。
库的行为与文档不符,或者在新版本中出现了问题。我该怎么办?¶
听起来你发现了一个bug。为Manim的开发做出贡献的最佳方式之一就是报告它!
查看我们已知问题和功能请求的列表 在我们的GitHub仓库中。如果 你发现的问题尚未列出(使用搜索功能;同时检查 是否有相应的已关闭问题,有可能你的问题 已经解决并将在下一个版本中修复),请考虑 以下步骤来提交一个新问题。
注意
如果你不确定是否应该为你发现的某些奇怪行为提交一个新问题,请随时向社区开发者询问,最好是在我们的Discord中的#manim-dev频道之一。
请确保您正在运行最新发布的Manim版本,您的问题可能已经在更新的版本中得到修复。请查看更新日志以获取Manim版本之间所有更改的完整列表。
在创建新问题时,请为您的报告选择正确的类别。我们有专门的错误报告、功能请求和安装问题的问题模板。如果您的报告属于这些类别之一,请仔细阅读问题模板!文本字段的
部分中给出了说明。如果您想在没有具体实现细节的情况下建议新功能,请参阅此答案中给出的说明。对于错误报告:准备一个可以用来说明问题的最小示例。包含数百行代码的示例非常低效且调试起来很繁琐。您的问题需要能够被其他人复现,因此请确保准备一个合适的示例。
这在错误报告模板中也有提到,但非常重要: 如果你报告某些代码引发了错误,请确保包含完整的终端输出,从你用来运行库的命令开始,直到并包括带有错误信息的最后一行。仔细阅读:如果信息提到还有另一个相关的日志文件,请一并包含这个文件!