欢迎参与 Flask 文档中文翻译

Posted 李辉greyli

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了欢迎参与 Flask 文档中文翻译相关的知识,希望对你有一定的参考价值。

我在上周开始策划 Flask 文档翻译的事,制定了大致的翻译流程,创建了翻译协调仓库和翻译模板仓库。中文翻译作为这个流程的试水项目,在上周末正式(静悄悄)启动。

启动中文翻译项目的第一步是把 logo 里的标语「web development, one drop at a time」翻译成中文,这让我想起来一个也许冷也许不冷的冷知识。很多人知道 Flask 的名字是对 Bottle 的双关语——另一个容器/另一个 Python Web 框架。那为什么 Python Web 框架爱用容器做名字?其实是因为这些 Python Web 框架都是基于 WSGI 规范实现的,而 WSGI 不知从哪天起流行被读作 Whiskey(威士忌),所以这两个 Python Web 框架才叫做 Bottle 和 Flask,所以才有「Web 开发,一次一滴」。


回到正题。如果你对 Flask 足够熟悉,并且擅长翻译,欢迎参与进来!翻译通过 GitHub 进行协作(github.com/greyli/flask-docs-zh)。除了翻译文档,我们也需要有丰富翻译经验的朋友来审阅提交的翻译,欢迎在 GitHub 上关注(点 Watch 按钮)这个项目以接收新增翻译提醒。 


下面是参与翻译之前要了解的三件事:


  1. 请务必完整阅读 GitHub 仓库 README 中的 Contributing Guide 了解翻译流程,然后阅读置顶 issue 了解翻译要求,在置顶 discussion 中投票选出你认为合适的翻译词汇,并在另外两个置顶 discussion 中投票选出你喜欢的 logo 标语翻译和字体。

  2. 需要强调的是,完成一章的翻译要提交两个 PR:第一个 PR 在 README 中对应的章节条目后添加自己的用户名以认领章节;第二个 PR 翻译对应的 .po 文件并勾选完成的章节条目。先认领,再翻译,一次只认领一章。

  3. 不要改动任何 ReStructuredText 标记、变量/类/函数/方法名称、URL 等。


如果有其他问题和相关想法,请在 GitHub 仓库创建 discussion 发起讨论;如果对翻译流程和项目设置有改进建议,或是发现了翻译错误和笔误,请创建 issue 反馈。


这个项目在后期会转移到 FlaskCWG 组织,并在翻译完成后链接到 Flask 官方文档。


相关链接:


  • 翻译项目:github.com/greyli/flask-docs-zh

  • 文档预览:flask-zh.rtfd.io


以上是关于欢迎参与 Flask 文档中文翻译的主要内容,如果未能解决你的问题,请参考以下文章

Flask-Babel 使用简介(翻译文档)

Hyperledger Fabric 社区中文文档

epub.js|翻译|原创开源中间件epub.js的使用及其中文文档

Weex中文文档

UNITY文档中文翻译邀请

[翻译] flask-SocketIO