为了方便翻译稿的统一管理,也方便PaddlePaddle的RD为大家审阅翻译稿,并大大提高后期反馈、修改的效率,推荐大家使用Github Pull Request(PR)的方法来上传您的翻译稿。
本教程教大家如何在网页上提交pr
首先,您需要确保注册一个Github账号
https://github.com/join?source=header-home
Fork PaddlePaddle的repo
翻译V2的用户请访问:https://github.com/PaddlePaddle/Paddle
翻译models的用户请访问:https://github.com/PaddlePaddle/models
下面以v2为例,models同理
请点击页面上的fork按钮
填写翻译稿
从您认领的任务对应的issue中找到翻译所在的目录
这里以V2的第16个任务Get Started为例,任务的issue为https://github.com/PaddlePaddle/Paddle/issues/8956
在“任务描述”中找到对应文档所在的目录
请注意!务必来到paddlepaddle的主分支,而不是您fork到自己的repo!
比如Get Started是汉译英,那么我点开“英文Github地址”,来到这里:
屏幕右侧有一个笔标志的按钮,点这里可以编辑,请点击
参考上图输入文档的名字和格式,一般有.rst和.md两种格式,参考对应的中/英文名字、格式来写即可
请将您的翻译稿写在Edit file这里,写的时候请注意.md/.rst的语法,若不清楚。
请参考以下解决方案:
(1) 请参考已有的对应的中/英文文档,找到这些文档,同样点右上角的“编辑”按钮。
这里我举一个例子
我找到了对应的中文文档,点击
同样点这里笔的按钮
(2) 如上图所示,我选中了文档的全部内容,然后复制。
没有文档经验的小伙伴,请务必,选中全部内容,并且务必,务必,不要删掉或修改最后一行的空行,在翻译过程中请务必不要在每一行的行末打多余的空格。
然后我们回到提交翻译稿的这个页面
把刚才复制的东西粘贴过来,然后在这个基础上翻译
代码、超链接等一般不用动(超链接的名字可能需要汉译英/英译汉),您无需改变语法,只要参照对应中文版、英文版的.md/.rst语法写就可以
您可以通过Preview changes选项卡预览您的文档
提交commit
翻译稿全部写好后,请拉到页面最下方
请按照上图填写commit的名字、描述等等,然后点绿色按钮,然后来到了如下图所示页面
提交pull request
确认没问题,可以点create pull request了,这样就建立了一个pr,然后按照下图步骤填写相关信息
这样就提交成功,请您将pr的链接传回到群里。
后续如果有review意见,您将会通过在github里留的邮箱得到反馈,请根据review意见及时提交您的修改稿哦~
修改翻译的方式如下:
在您提交翻译稿之前,请先确保在paddlepaddle的官方repo下,然后点击file changed
再点击右上角编辑按钮,即可在之前翻译的基础上修改。再commit即可
如果您需要上传2个及两个以上的文档,该如何操作呢?
首先,请您将其中一个文件,按照上述的方式上传,并提交pr。
在pr中,将页面下拉,找到红框这里,这里是您刚才提交commit的名字(是您本地repo 下的一个branch)
点击后,请确认下图红框中的两处:在您的repo下,分支正确
确认无误后,您可以点击 右上角 新建文件,上传文件
若您需要删除某个文件,请您打开对应的文件,在右上角找到删除标志
完成后,拉到页面下方,提交commit到刚才的pr中,完成即可。
这个说的好详细啊!
超赞的耶~我可以转载你的文章吗?
源码怎么用啊
当然可以滴~