网站开发怎样搭建,垂直网站做排名,中企动力邮箱登录端口,中国建设银行官方网站e路航下载Docs #xff08;docs.microsoft.com#xff09;是微软新版的文档网站#xff0c;重新规划了各项技术栈的文档结构#xff0c;看起来比 MSDN 可读性更好。虽然 Docs 提供了各种语言的版本#xff0c;但大多是机器翻译#xff0c;某些中文文档基本读不下去。因此微软鼓励社… Docs docs.microsoft.com是微软新版的文档网站重新规划了各项技术栈的文档结构看起来比 MSDN 可读性更好。虽然 Docs 提供了各种语言的版本但大多是机器翻译某些中文文档基本读不下去。因此微软鼓励社区参与者提交本地化内容。对于微软 MVP 来说参与 Docs 的本地化也是一种重要的贡献方式。除了 Docs 的本地化微软还有一个本地化社区可以对微软的多个软件程序进行本地化Microsoft Localization Community。接下来给大家介绍一下如何向这两个项目提交贡献。排行榜及积分规则微软发布了一个排行榜可以看到全球贡献者的分数排名Microsoft Cloud AI International Community Leaderboardhttps://microsoftl10n.github.io/计分规则是这样的对于 Docs 来说每项建议得15分如果微软审核后接受建议则可以得到60分。也就是说一项建议最多得75分。1. Docs 本地化得分 建议数 * 15 接受建议数 * 602. 一个建议 15分3. 一个通过审核的建议 60分对于软件程序来说如果审核并修改一个包含10个单词的的句子可以得20分。如果该翻译被微软批准则可以得到80分。也就是说翻译10个单词的句子最多得100分。同时如果审核其他人的翻译并投票可以得2分。1. 软件本地化得分 建议单词数 * 2 投票数 * 2 接受翻译单词数 * 82. 一个建议的单词 2分3. 一个通过审核的单词 8分4. 对其他人的翻译投票 每个投票2分当然我想强调的是我们并不是为了得分才去做贡献提交 PR 是一件很有成就感的事情你的贡献能够帮助到他人同时对自己也是一个提高这才是 Contribution 的意义所在。向 Docs 提交 PR下面详细介绍如何对 Docs 提交 PR(Pull Request)。直接在页面上修改第一种方式是直接在页面上修改适合修改单个词语、句子或文章。以该页面为例https://docs.microsoft.com/zh-cn/dotnet/standard/design-guidelines/choosing-between-class-and-struct“每个框架设计器的人脸的基本设计决策之一……” 这什么乱七八糟的。Bing 翻译的质量还需提高啊。首先点页面右上角的 登陆按钮,这里需要使用 GitHub 账户没有的话先注册一个。然后可以看到页面上方有几个链接可以点击 反馈 按钮来提交你的反馈意见相当于发布评论会显示在页面下方。如果想编辑翻译的话就点击 编辑 按钮这样会直接链接到该页面在 GitHub 上的地址要编辑的话就点击那个笔形的编辑按钮然后就可以直接编辑了注意页面上方的说明使用这种方式会自动在你的仓库中创建一个分支。点击下面的 Propose file change 按钮这样会自动生成一个页面对比所做的修改点击绿色的 Create pull requet 按钮就可以创建一个 PR 了创建 PR可以看到这种方式实际上是创建了一个名为patch-1的分支等 PR 被批准并合并之后会提示你将该分支删除因为该分支已经没用了。按提示操作就可以了。Fork 项目到自己的仓库直接在页面上修改的方式虽然简单但只能在线操作如果遇到断网或系统崩溃可能会丢数据。此外只改几个单词就提交一个 PR显得比较零散。因此建议 fork 项目到自己的仓库在本地修改后再提交 PR 。本地编辑使用 VS Code 或其他编辑器也不会丢失数据VS Code 会自动暂存修改。Fork 相当于一个仓库的副本。将源项目 fork 到自己的仓库可以让你随意修改代码而不会影响到源项目。并且你还可以将你的修改提交到源项目。一般流程是这样的Fork源项目到自己的仓库修改向源项目提交 Pull Request如果原项目作者同意了你的修改会将其合并到源项目中。Fork 项目首先打开官方项目的主页面将其 fork 到自己的仓库这样会在自己的账户内生成一个新的项目并显示是从源项目 fork 过来的使用 VS Code将项目 Clone 到本地。没有 VS Code 的话就装一个吧前端神器集成 Git用来写 markdown 也是极好的。Docs 的文档都是markdown 格式所以 VS Code 很适合干这个。点击 Clone or download 的按钮再点击路径旁边的按钮将项目路径复制下来因为 VS Code 已经集成了 Git所以 VS Code 中也有两种不同的使用 Git 的方式按 F1调出命令输入框输入 Git即可看到支持的各种 Git 命令按 Ctrl,也可以在 Terminal 窗口中直接输入 Git 命令选择自己喜欢的方式即可。如果使用第一种方式就选择 Git: Clone 命令然后输入项目路径回车会弹出一个选择文件夹位置的对话框选择后确定即可将项目 Clone 到该文件夹中。如果使用第二种方式首先要定位到你要存放该仓库的文件夹然后输入git clone https://github.com/YOUR-USERNAME/dotnet.docs.zh-cn.git设置与源项目同步Clone项目后还需要设置一下将本地的项目与源项目upstream关联起来这样就可以进行同步了。使用Terminal导航到项目所在目录输入以下命令git remote -v输出如下c:\Source\dotnet.docs.zh-cngit remote -v
origin https://github.com/YOUR-USERNAME/dotnet.docs.zh-cn.git (fetch)
origin https://github.com/YOUR-USERNAME/dotnet.docs.zh-cn.git (push)接下来输入以下命令设置本地目录的 upstream:git remote add upstream https://github.com/dotnet/docs.zh-cn.git再输入之前的命令查看显示已设置成功c:\Source\dotnet.docs.zh-cngit remote add upstream https://github.com/dotnet/docs.zh-cn.gitc:\Source\dotnet.docs.zh-cngit remote -v
origin https://github.com/YOUR-USERNAME/dotnet.docs.zh-cn.git (fetch)
origin https://github.com/YOUR-USERNAME/dotnet.docs.zh-cn.git (push)
upstream https://github.com/dotnet/docs.zh-cn.git (fetch)
upstream https://github.com/dotnet/docs.zh-cn.git (push)创建分支回到自己的项目页面不是官方源项目的页面点击 Branch 那个下拉列表框输入一个新的 branch 名称注意选择的时候要注意是以哪个分支为基础默认是 live 分支你也可以选择以其他的分支为基础创建自己的分支。创建分支后就可以在本地切换到该分支进行修改了。我还是更倾向使用 VS Code 集成的命令不易出错。使用 VS Code 打开刚才 Clone 的项目目录按 F1 调出命令输入框输入Git即可看到支持的 Git 命令选择 Git: Checkout to...选择刚才创建的分支这样本地的分支就切换为刚创建的分支了在 VS Code 左下角可以看出来当前分支是哪个点击左下角这个地方也可以方便的切换分支。如果使用命令行的方式可以输入以下命令git checkout xy-test输出如下C:\Source\dotnet.docs.zh-cngit checkout xy-test
Switched to branch xy-testYour branch is up to date with origin/xy-test.现在可以大胆修改了。修改这次我们来修改另一篇文档。打开 member.md即https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/member页面的源文件。对照英文原文进行翻译。为了查看 markdown 的效果可以安装一个插件。点击 VS Code 侧栏的第五个按钮打开插件管理器输入 markdown 搜索安装前面两个即可这两个插件能够有效提升你写 markdown 文档的效率还可以在右侧预览效果。具体的功能可查看插件的说明。修改完后保存。点击 VS Code 侧栏的第三个图标可以看到已经有一个修改输入 comment然后点击对号提交。这样修改只是提交到本地仓库还需要 Push 到远程仓库。点击右侧的三个点的按钮选择 Push如果选择 Push to... 的话还可以选择直接 Push 到上游分支也就是官方的项目但这样是没有权限的所以只能先提交到自己的项目再向官方项目提PR。返回到自己的仓库页面可以看到 GitHub 已经检测出来已经提交了一个更新这时候就可以点击右侧按钮创建 Pull Request了也可以点击 tab 栏的 Pull Request也会有一个 New pull request 的按钮。这样会出现一个页面对修改后的文件和源文件进行比较一定要注意上面的分支选择是从我们自己的分支提交到源项目的分支不要选错了。建议输入详细的 comment 便于官方人员检查。最后点击 Crete Pull Request 的按钮就成功创建 PR 了等微软工作人员审核后即可以被合并到主项目分支了。期间微软可能会做出一些修改。删除本地分支往往本地创建的分支都是针对一个 issue 做的修改或者修复某个bug或增加一个新 feature。当修改并成功被合并后该分支就没用了。可以点击分支后面的删除按钮删除注意一旦删除就无法恢复了因此一定要确认分支的内容都已成功被合并后再删除。与源项目进行同步时间一长我们本地的项目可能已经大大落后源项目的更新了。因此如果本地分支不是做出很大的破坏性变更的话建议保持与源项目的同步。首先点击自己仓库项目的 Pull Request 栏点击 New pull request 按钮。此时要注意默认是将自己项目的更改提交到源项目我们要反过来将源项目的更改提交到自己的项目。所以先选择左侧的下拉列表框选择自己的仓库这样两边都是自己的项目了再点击 compare across forks 链接右侧的下拉列表框选择源项目可以看到源项目已经更新很多了点击 Create pull request 按钮即可创建一个 PR。因为是自己的项目所以可以直接将 PR 合并合并后自己的项目就更新到源项目的进度了。然后要把更新的内容 Pull 到本地。在 VS Code 中按 F1打开命令行窗口输入 git pull或者点侧栏第三个按钮右上角的三个点按钮选择 Pull这样本地的项目也是最新的了。现在大家应该对如何向 Docs 贡献翻译有一个大概了解了。我并没有全部使用 Git 命令使用 VS Code 可以很方便的代替命令行做一些操作还是比较方便的。向应用程序提交贡献这个就比较简单了将这个网址加入收藏夹https://envelope-community.azurewebsites.net/首先选择语言然后可以点击右侧的按钮对当前已存在的翻译进行投票或在下面的输入框中输入自己的翻译这个页面支持手机浏览所以没事等车的时候也可以刷几个翻译。结语Docs 是很好的学习资料文章质量也都比较高。参与翻译 Docs 也是提高英语水平的一个方法。每天努力看一点时间久了就会发现英语阅读能力会有很大提高顺便为社区做点贡献何乐而不为呢希望能有更多同学加入到贡献者的队伍中来帮助他人的同时也提高自己。
