开源项目翻译正确姿势
日常开发中,我们经常会在Github上发现一些好用的新框架, 如何对这些项目文档进行翻译, 其实这个问题困扰了我很久. 这里,我总结了一些不同情况下所谓的最佳实践, 供大家参考:
独立文档项目
举例: https://github.com/graphql/gr...
GraphQL文档的网站, 是一个独立的项目, source分支是源码目录, master分支(可以理解为gh-pages分支)是静态站点.
1. 初始化翻译项目
直接Fork
该项目, 示例: https://github.com/willin/gra...
Fork之后可以给该项目改名, 如我换到了 graphql.js.cool
域名, 并以该域名进行命名.
然后, 将项目Clone
至本地.
git clone git@github.com:willin/graphql.js.cool.git
cd graphql.js.cool
# 默认源码的分支是source, 可以新建一个分支用于翻译
git checkout -b cn
git push -u origin cn
至此, 可以开始翻译工作了.
2. 从源站更新内容
# 一次性添加
git remote add remote git@github.com:graphql/graphql.github.io.git
# 每次更新源站最新代码
git pull remote source
.git/config
文件参考:
[core]repositoryformatversion = 0filemode = truebare = falselogallrefupdates = trueignorecase = trueprecomposeunicode = true
[remote "origin"]url = git@github.com:willin/graphql.js.cool.gitfetch = +refs/heads/*:refs/remotes/origin/*
[branch "cn"]remote = originmerge = refs/heads/cn
[travis]slug = willin/graphql.js.cool
[remote "remote"]url = git@github.com:graphql/graphql.github.io.gitfetch = +refs/heads/*:refs/remotes/remote/*
文档包含在项目中
可能是一个一个单独的分支, 或者只是某个分支的一个目录.
以vue-router
项目为例, 文档位于dev
分支的docs
目录: https://github.com/vuejs/vue-...
1. 初始化翻译项目
git init
git remote add origin xxx # 你的项目路径
git remote add remote git@github.com:vuejs/vue-router.git
# 拉取源站代码
git pull remote dev
2. 从源站更新内容
# 每次更新源站最新代码
git pull remote dev
注意事项
CNAME
等配置文件需要替换pull
后可能会有冲突. 解决后再提交代码.
p.s.
优秀的中文翻译项目及推荐的未翻译项目汇总: Awesome-CN
开源项目翻译正确姿势相关推荐
- 使用开源项目的正确姿势,都是血和泪的总结!
阿里妹导读:开源精神是技术发展的源动力之一,受到工程师们的热烈欢迎.但是开源项目如此之多,哪一个最适合自己?如何更好利用开源项目,甚至做二次开发?今天,阿里资深无线开发专家李运华,总结多年与开源项目打 ...
- 如何成为一名合格的Apache项目Committer,参与Apache开源贡献的正确姿势
近日,孙金城老师在 "Open Source Promotion Plan - Summer 2020" 开源软件供应链点亮计划做了<如何成为一名合格的Apache项目Com ...
- 暑期2020“大咖说开源”之 孙金城:参与 ASF 开源贡献的正确姿势
| 主办方: 中科院软件所.openEuler 社区.开源社 | 编辑:王皓月 | 设计:朱亿钦 活动介绍 Overview 开源供应链点亮计划 - 暑期 2020 (https://isrc.isc ...
- 这才是介绍项目的正确姿势,终于不用害怕面试了
在面试时,经过简单寒暄后,面试官一般先从让候选人自我介绍开始,紧接着就是问候选人简历中所列的项目,让介绍下项目经验.常见的问法是,说下你最近的(或感觉不错的)一个项目.面试中很多人忽视对这一个环节的准 ...
- ssm架构 开源项目_如何为您的开源项目选择正确的品牌架构
ssm架构 开源项目 启动开源软件项目的大多数人并不是在等人与他们讨论品牌架构模型,而是很多人确实为他们的项目制定了长期目标,包括最终使其成为付费产品甚至是基础产品.一家为项目代码提供服务和支持的公司 ...
- AI:人工智能领域有影响力的开源社区/科技巨头研究机构/全球顶尖学府实验室的简介、课程学习(正确姿势薅羊毛)之详细攻略
AI:人工智能领域有影响力的开源社区/科技巨头研究机构/全球顶尖学府实验室的简介.课程学习(正确姿势薅羊毛)之详细攻略 目录 全球顶尖学府的人工智能实验室 国外篇 CSAIL(MIT计算科学与人工智能 ...
- 开源运维管理软件排名_云上自动化部署和运维的正确姿势
导读:今天起,"凌云时刻"特别推出"阿里云玩转 ECS"系列课程,每周二.周四固定更新,欢迎关注.本期为系列第 1 讲,由阿里云资深技术专家吴君印介绍上云最正确 ...
- Nuxt 项目引入外部Js的正确姿势 ,问题描述:打包构建之后引入的外部 js失效,构建之后的 .nuxt 文件夹下的js文件中,引入 js 的script标签凭空消失!
首先先说我遇到的问题描述: 我是用vue + nuxt项目,项目中使用了阿里播放器,于是我在vue页面中直接引入了阿里播放器的 css和js文件,然后运行没有任何问题:如下图所示: 但是! ...
- 有一说一!这才是RabbitMQ实现分布式事务的正确姿势(项目实战)
分布式事务 随着互联网快速发展,微服务,SOA 等服务架构模式正在被大规模的使用,现在分布式系统一般由多个独立的子系统组成,多个子系统通过网络通信互相协作配合完成各个功能. 有很多用例会跨多个子系统才 ...
最新文章
- php yat grpc,Laravel 5 使用 Grpc 构建的微服务
- 上帝造题的七分钟(ybtoj-树状数组)
- kendo-ui学习笔记——题记
- 7纳米!华为鲲鹏920芯片问世,最强性能面向智能计算
- 为初学者介绍10个最常被问到的Javascript问题
- spring data for mongo
- 【演化(进化)算法】遗传算法原理及python实现
- 完美解决“运行引擎需要DX11特性等级10.0”
- 基于E4A的手机蓝牙串口助手app制作
- MATLAB 中如何使用 help
- 华为vlan间路由:利用路由器实现不同vlan间的通信
- 【数据结构】单链表的实现
- python苹果支付(服务端)自动订阅版
- dell电脑如何安装ubuntu系统_Dell Win10系统安装成Ubuntu16.04
- html下拉框设置默认值_html下拉框怎么设置默认值
- CentOS 6.5挂载windows NTFS硬盘
- 荔枝FM、喜马拉雅FM、蜻蜓FM竞品分析
- Redis在多线程高并发下出现数据错乱问题
- 高可用性GRE+IPSEC中心—分支
- 小甲鱼python课后题百度云盘_【小甲鱼python课后题.doc】下载 - 面包树