forked from tiangolo/fastapi
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
🌐 Update Chinese translation for
docs/help-fastapi.md (tiangolo#3847)
- Loading branch information
1 parent
0fdfe8a
commit caaaa58
Showing
1 changed file
with
103 additions
and
61 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,107 +1,149 @@ | ||
| # 帮助 FastAPI - 获取帮助 | ||
| # 帮助 FastAPI 与求助 | ||
|
|
||
| 你喜欢 **FastAPI** 吗？ | ||
| 您喜欢 **FastAPI** 吗？ | ||
|
|
||
| 您愿意去帮助 FastAPI，帮助其他用户以及作者吗？ | ||
| 想帮助 FastAPI？其它用户？还有项目作者？ | ||
|
|
||
| 或者你想要获得有关 **FastAPI** 的帮助？ | ||
| 或要求助怎么使用 **FastAPI**？ | ||
|
|
||
| 下面是一些非常简单的方式去提供帮助（有些只需单击一两次链接）。 | ||
| 以下几种帮助的方式都非常简单（有些只需要点击一两下鼠标）。 | ||
|
|
||
| 以及几种获取帮助的途径。 | ||
| 求助的渠道也很多。 | ||
|
|
||
| ## 在 GitHub 上 Star **FastAPI** | ||
| ## 订阅新闻邮件 | ||
|
|
||
| 你可以在 GitHub 上 "star" FastAPI（点击右上角的 star 按钮）：<a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>。 | ||
| 您可以订阅 [**FastAPI 和它的小伙伴** 新闻邮件](/newsletter/){.internal-link target=_blank}（不会经常收到） | ||
|
|
||
| 通过添加 star，其他用户将会更容易发现 FastAPI，并了解已经有许多人认为它有用。 | ||
| * FastAPI 及其小伙伴的新闻 🚀 | ||
| * 指南 📝 | ||
| * 功能 ✨ | ||
| * 破坏性更改 🚨 | ||
| * 开发技巧 ✅ | ||
|
|
||
| ## Watch GitHub 仓库的版本发布 | ||
| ## 在推特上关注 FastAPI | ||
|
|
||
| 你可以在 GitHub 上 "watch" FastAPI（点击右上角的 watch 按钮）：<a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>。 | ||
| <a href="https://twitter.com/fastapi" class="external-link" target="_blank">在 **Twitter** 上关注 @fastapi</a> 获取 **FastAPI** 的最新消息。🐦 | ||
|
|
||
| 这时你可以选择 "Releases only" 选项。 | ||
| ## 在 GitHub 上为 **FastAPI** 加星 | ||
|
|
||
| 之后，只要有 **FastAPI** 的新版本（包含缺陷修复和新功能）发布，你都会（通过电子邮件）收到通知。 | ||
| 您可以在 GitHub 上 **Star** FastAPI（只要点击右上角的星星就可以了）： <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi。</a>⭐️ | ||
|
|
||
| ## 加入聊天室 | ||
| **Star** 以后，其它用户就能更容易找到 FastAPI，并了解到已经有其他用户在使用它了。 | ||
|
|
||
| 加入 Gitter 上的聊天室：<a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">https://gitter.im/tiangolo/fastapi</a>。 | ||
| ## 关注 GitHub 资源库的版本发布 | ||
|
|
||
| 在这里你可以快速提问、帮助他人、分享想法等。 | ||
| 您还可以在 GitHub 上 **Watch** FastAPI，（点击右上角的 **Watch** 按钮）<a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi。</a>👀 | ||
|
|
||
| ## 与作者联系 | ||
| 您可以选择只关注发布（**Releases only**）。 | ||
|
|
||
| 你可以联系 <a href="https://tiangolo.com" class="external-link" target="_blank">我 (Sebastián Ramírez / `tiangolo`)</a> - FastAPI 的作者。 | ||
| 这样，您就可以（在电子邮件里）接收到 **FastAPI** 新版发布的通知，及时了解 bug 修复与新功能。 | ||
|
|
||
| 你可以： | ||
| ## 联系作者 | ||
|
|
||
| * <a href="https://github.com/tiangolo" class="external-link" target="_blank">在 **GitHub** 上关注我</a>。 | ||
| * 查看我创建的其他的可能对你有帮助的开源项目。 | ||
| * 关注我以了解我创建的新开源项目。 | ||
| * <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">在 **Twitter** 上关注我</a>。 | ||
| * 告诉我你是如何使用 FastAPI 的（我很乐意听到）。 | ||
| * 提出问题。 | ||
| * <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">在 **Linkedin** 上联系我</a>。 | ||
| * 与我交流。 | ||
| * 认可我的技能或推荐我 :) | ||
| * <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">在 **Medium** 上阅读我写的文章（或关注我）</a>。 | ||
| * 阅读我创建的其他想法，文章和工具。 | ||
| * 关注我以了解我发布的新内容。 | ||
| 您可以联系项目作者，就是<a href="https://tiangolo.com" class="external-link" target="_blank">我（Sebastián Ramírez / `tiangolo`</a>）。 | ||
|
|
||
| ## 发布和 **FastAPI** 有关的推特 | ||
| 您可以： | ||
|
|
||
| <a href="https://twitter.com/compose/tweet?text=I'm loving FastAPI because... https://github.com/tiangolo/fastapi cc @tiangolo" class="external-link" target="_blank"> 发布和 **FastAPI** 有关的推特</a> 让我和其他人知道你为什么喜欢它。 | ||
| * <a href="https://github.com/tiangolo" class="external-link" target="_blank">在 **GitHub** 上关注我</a> | ||
| * 了解其它我创建的开源项目，或许对您会有帮助 | ||
| * 关注我什么时候创建新的开源项目 | ||
| * <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">在 **Twitter** 上关注我</a> | ||
| * 告诉我您使用 FastAPI（我非常乐意听到这种消息） | ||
| * 接收我发布公告或新工具的消息 | ||
| * 您还可以关注<a href="https://twitter.com/fastapi" class="external-link" target="_blank">@fastapi on Twitter</a>，这是个独立的账号 | ||
| * <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">在**领英**上联系我</a> | ||
| * 接收我发布公告或新工具的消息（虽然我用 Twitter 比较多） | ||
| * 阅读我在 <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> 或 <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a> 上的文章，或关注我 | ||
| * 阅读我的其它想法、文章，了解我创建的工具 | ||
| * 关注我，这样就可以随时看到我发布的新文章 | ||
|
|
||
| ## 告诉我你正在如何使用 **FastAPI** | ||
| ## Tweet about **FastAPI** | ||
|
|
||
| 我很乐意听到有关 **FastAPI** 被如何使用、你喜欢它的哪一点、被投入使用的项目/公司等等信息。 | ||
| <a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/tiangolo/fastapi" class="external-link" target="_blank">Tweet about **FastAPI**</a> 让我和大家知道您为什么喜欢 FastAPI。🎉 | ||
|
|
||
| 你可以通过以下平台让我知道： | ||
|
|
||
| * <a href="https://twitter.com/compose/tweet?text=Hey @tiangolo, I'm using FastAPI at..." class="external-link" target="_blank">**Twitter**</a>。 | ||
| * <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">**Linkedin**</a>。 | ||
| * <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>。 | ||
| 知道有人使用 **FastAPI**，我会很开心，我也想知道您为什么喜欢 FastAPI，以及您在什么项目/哪些公司使用 FastAPI，等等。 | ||
|
|
||
| ## 为 FastAPI 投票 | ||
|
|
||
| * <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">在 Slant 上为 **FastAPI** 投票</a>。 | ||
| * <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">在 Slant 上为 **FastAPI** 投票</a> | ||
| * <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">在 AlternativeTo 上为 **FastAPI** 投票</a> | ||
|
|
||
| ## 在 GitHub 上帮助其他人解决问题 | ||
|
|
||
| 您可以查看<a href="https://github.com/tiangolo/fastapi/issues" class="external-link" target="_blank">现有 issues</a>，并尝试帮助其他人解决问题，说不定您能解决这些问题呢。🤓 | ||
|
|
||
| 如果帮助很多人解决了问题，您就有可能成为 [FastAPI 的官方专家](fastapi-people.md#experts){.internal-link target=_blank}。🎉 | ||
|
|
||
| ## 监听 GitHub 资源库 | ||
|
|
||
| 您可以在 GitHub 上「监听」FastAPI（点击右上角的 "watch" 按钮）： <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀 | ||
|
|
||
| 如果您选择 "Watching" 而不是 "Releases only"，有人创建新 Issue 时，您会接收到通知。 | ||
|
|
||
| 然后您就可以尝试并帮助他们解决问题。 | ||
|
|
||
| ## 创建 Issue | ||
|
|
||
| 您可以在 GitHub 资源库中<a href="https://github.com/tiangolo/fastapi/issues/new/choose" class="external-link" target="_blank">创建 Issue</a>，例如： | ||
|
|
||
| ## 帮助他人解决 GitHub 的 issues | ||
| * 提出**问题**或**意见** | ||
| * 提出新**特性**建议 | ||
|
|
||
| 你可以查看 <a href="https://github.com/tiangolo/fastapi/issues" class="external-link" target="_blank">已有的 issues</a> 并尝试帮助其他人。 | ||
| **注意**：如果您创建 Issue，我会要求您也要帮助别的用户。😉 | ||
|
|
||
| ## Watch GitHub 仓库 | ||
| ## 创建 PR | ||
|
|
||
| 你可以在 GitHub 上 "watch" FastAPI（点击右上角的 "watch" 按钮）：<a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>。 | ||
| 您可以创建 PR 为源代码做[贡献](contributing.md){.internal-link target=_blank}，例如： | ||
|
|
||
| 如果你选择的是 "Watching" 而不是 "Releases only" 选项，你会在其他人创建了新的 issue 时收到通知。 | ||
| * 修改文档错别字 | ||
| * <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">编辑这个文件</a>，分享 FastAPI 的文章、视频、博客，不论是您自己的，还是您看到的都成 | ||
| * 注意，添加的链接要放在对应区块的开头 | ||
| * [翻译文档](contributing.md#translations){.internal-link target=_blank} | ||
| * 审阅别人翻译的文档 | ||
| * 添加新的文档内容 | ||
| * 修复现有问题/Bug | ||
| * 添加新功能 | ||
|
|
||
| 然后你可以尝试帮助他们解决这些 issue。 | ||
| ## 加入聊天 | ||
|
|
||
| ## 创建 issue | ||
| 快加入 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">Discord 聊天服务器</a> 👥 和 FastAPI 社区里的小伙伴一起哈皮吧。 | ||
|
|
||
| 你可以在 GitHub 仓库中 <a href="https://github.com/tiangolo/fastapi/issues/new/choose" class="external-link" target="_blank">创建一个新 issue</a> 用来： | ||
| !!! tip "提示" | ||
|
|
||
| * 报告 bug 或问题。 | ||
| * 提议新的特性。 | ||
| * 提问。 | ||
| 如有问题，请在 <a href="https://github.com/tiangolo/fastapi/issues/new/choose" class="external-link" target="_blank">GitHub Issues</a> 里提问，在这里更容易得到 [FastAPI 专家](fastapi-people.md#experts){.internal-link target=_blank}的帮助。 | ||
| 聊天室仅供闲聊。 | ||
|
|
||
| ## 创建 Pull Request | ||
| 我们之前还使用过 <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">Gitter chat</a>，但它不支持频道等高级功能，聊天也比较麻烦，所以现在推荐使用 Discord。 | ||
|
|
||
| 你可以 <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">创建一个 Pull Request</a> 用来： | ||
| ### 别在聊天室里提问 | ||
|
|
||
| * 纠正你在文档中发现的错别字。 | ||
| * 添加新的文档内容。 | ||
| * 修复已有的 bug 或问题。 | ||
| * 添加新的特性。 | ||
| 注意，聊天室更倾向于“闲聊”，经常有人会提出一些笼统得让人难以回答的问题，所以在这里提问一般没人回答。 | ||
|
|
||
| GitHub Issues 里提供了模板，指引您提出正确的问题，有利于获得优质的回答，甚至可能解决您还没有想到的问题。而且就算答疑解惑要耗费不少时间，我还是会尽量在 GitHub 里回答问题。但在聊天室里，我就没功夫这么做了。😅 | ||
|
|
||
| 聊天室里的聊天内容也不如 GitHub 里好搜索，聊天里的问答很容易就找不到了。只有在 GitHub Issues 里的问答才能帮助您成为 [FastAPI 专家](fastapi-people.md#experts){.internal-link target=_blank}，在 GitHub Issues 中为您带来更多关注。 | ||
|
|
||
| 另一方面，聊天室里有成千上万的用户，在这里，您有很大可能遇到聊得来的人。😄 | ||
|
|
||
| ## 赞助作者 | ||
|
|
||
| 你还可以通过 <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a> 在经济上支持作者（我）。 | ||
| 您还可以通过 <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub 赞助商</a>资助本项目的作者（就是我）。 | ||
|
|
||
| 给我买杯咖啡 ☕️ 以示感谢 😄 | ||
|
|
||
| 当然您也可以成为 FastAPI 的金牌或银牌赞助商。🏅🎉 | ||
|
|
||
| 这样你可以给我买杯咖啡☕️以示谢意😄。 | ||
| ## 赞助 FastAPI 使用的工具 | ||
|
|
||
| 如您在本文档中所见，FastAPI 站在巨人的肩膀上，它们分别是 Starlette 和 Pydantic。 | ||
|
|
||
| 您还可以赞助： | ||
|
|
||
| * <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin （Pydantic）</a> | ||
| * <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode （Starlette, Uvicorn）</a> | ||
|
|
||
| --- | ||
|
|
||
| 感谢！ | ||
| 谢谢！🚀 | ||
|
|