首页 Paddle框架 帖子详情
如何使用Pull Request 提交翻译稿
收藏
快速回复
Paddle框架 问答深度学习模型训练 4012 4
如何使用Pull Request 提交翻译稿
收藏
快速回复
Paddle框架 问答深度学习模型训练 4012 4

为了方便翻译稿的统一管理,也方便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中,完成即可。

2
收藏
回复
全部评论(4)
时间顺序
上官一疯
#2 回复于2018-04

这个说的好详细啊!

0
回复
桃子小同志
#3 回复于2018-04

超赞的耶~我可以转载你的文章吗?

0
回复
如何世代为天子
#4 回复于2018-07

源码怎么用啊

 

0
回复
s
shanyi_17
#5 回复于2018-07
超赞的耶~我可以转载你的文章吗?

当然可以滴~

0
回复
需求/bug反馈?一键提issue告诉我们
发现bug?如果您知道修复办法,欢迎提pr直接参与建设飞桨~
在@后输入用户全名并按空格结束,可艾特全站任一用户