码云（Gitee.com）帮助文档

### 1、什么是码云（Gitee.com）
----------
码云（Gitee.com）是专为开发者提供的稳定、高效、安全的云端软件开发协作平台。
无论是个人、团队、或是企业，都能够用码云实现代码托管、项目管理、协作开发。

码云于2013年正式推出，由开源中国基于 Gitlab 所开发，我们在 Gitlab 的基础上做了大量的改进和定制开发，致力于为国内开发者提供优质稳定的托管服务。目前已成为国内最大的代码托管系统。

### 2、码云主要功能
----------

码云除了提供最基础的 Git 代码托管之外，还提供代码在线查看、历史版本查看、Fork、Pull Request、打包下载任意版本、Issue、Wiki 、保护分支、代码质量检测、PaaS 项目演示等方便管理、开发、协作、共享的功能。

### 3、码云协作模式
----------

对于一个开源项目，从开发角度讲大体上分为两类人群，一类称为核心开发团队，他们可以向保存源代码的版本库提交，即对源代码的修改具有最终的决定权。另外一类称为贡献者，他们不属于核心开发团队，虽然也能看到源代码，但无权向版本库提交修改。

采用传统的集中式版本控制系统（如 SVN ）的开源项目，这两个群体的用户体验都不是太好。如图1-1所示，项目的贡献者（非核心成员）很不“高兴”，因为他们即便有修改源代码的能力和渴望，也不能直接向版本库提交，要想成为提交者需要一个很长的建立信任的过程。然而即便是核心开发团队的成员，体验也不是太好，因为凡是涉及到版本库的操作（检入、检出、查看日志等）都需要在联网的状态下进行，网络带宽对用户体验影响相当大。

![cvcs-model](https://static.oschina.net/uploads/img/201705/18181722_ePPY.jpg "cvcs-model")
图1-1：使用集中式版本控制系统

Git 等分布式版本控制系统的出现，彻底颠覆了原有代码管理的组织模式。使用 Git，不再依赖唯一的、集中式的版本库，而是每个开发者本地都拥有一份完整的版本库。Git 并不排斥集中式的使用模式，但更倾向于将集中式版本库称为共享版本库。核心开发团队的成员和贡献者（非核心成员）都可以从共享版本库克隆一份本地版本库，但只有核心团队成员才可以将自己本地版本库的提交推送到共享版本库上。如图1-2所示。

![dvcs-model](https://static.oschina.net/uploads/img/201705/18181743_LKNF.jpg "dvcs-model")
图1-2：使用分布式版本控制系统

使用 Git 做版本控制（如图1-2所示），核心开发团队非常“高兴”，因为他们和共享版本库之间不必一直保持连接状态，诸如查看日志、提交、创建分支等几乎全部操作都（脱离网络）在本地的版本库中完成。项目贡献者（非核心成员）也不再那么沮丧，因为版本库人人皆可更改（当然是对本地版本库而言）。稍微让贡献者感到困难的就是如何将自己对项目的改进被核心开发团队所了解并接纳。Git 提供了多种途径，一个方法是先用 git format-patch 命令将本地提交转换为补丁文件或补丁文件序列，再通过邮件发送给核心开发团队。另外一个办法就是搭建一个自己专有的共享版本库，通过邮件创建一个拉拽请求（Pull Request），让核心团队的开发者到自己的版本库来抓取（Pull）。

![git@osc-model](https://static.oschina.net/uploads/img/201705/18181806_8HN7.jpg "git@osc-model")
图1-3：码云的协同模式

使用码云，无论是项目的核心开发团队，还是普通的项目贡献者都工作得非常“愉快”。创建项目变得非常轻松，创建者只需在码云上点击一下鼠标即可创建一个新版本库，通过简单的 Web 操作即可完成项目授权进而组建项目核心团队。在码云中，非核心团队成员参与项目也很容易。先找到自己希望参与的项目，然后只需在 Web 上点击一下鼠标即可在自己的托管空间下创建一个派生（fork）的项目，并对派生项目的版本库具有读写的完全权限，就好像这个项目原本就是由自己创立的那样。当贡献者完成开发并向自己派生的版本库推送后，可以通过码云的 Web 界面向项目的核心开发团队发送一个 Pull Request，请求审核。项目的核心团队收到 Pull Request 后审核代码，审核通过后可以直接通过 Web 界面执行合并操作接纳贡献者的提交。

#1. 插件安装

**注意：码云 IDEA 插件已由　`gitosc` 更名为 `gitee`。**
**新版插件 gitee 菜单已经和 git 菜单合并**

## 方法一

1. 启动 idea
2. 选择 `Configure` - `Plugins`
3. 选择 `Browse repositories...`
4. 搜索 `gitee`，安装插件
5. 重启 idea 即可

![输入图片说明](https://static.oschina.net/uploads/img/201712/01141617_wXCn.gif "在这里输入图片标题")

## 方法二

1. 选择 `File` - `Settings`
2. 选择 `Plugins`
3. 选择 `Browse repositories...`
4. 搜索 `gitee`，安装插件
5. 重启 idea 即可

![输入图片说明](https://static.oschina.net/uploads/img/201712/01141922_Njrt.gif "在这里输入图片标题")

## 方法三

插件地址为：https://plugins.jetbrains.com/plugin/8383-gitee　直接下载，手动安装。

#2. 登陆并拉取项目

## 方法一

**1. 启动 idea，选择 `Check out from Version Control` - `码云`**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02120258_WPKq.png "在这里输入图片标题")

最新版本发生了变更，gitee 选项和 git 已经合并：

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175436_HJry.png "在这里输入图片标题")

**2. 输入用户名和密码，登陆**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02120306_MS8H.png "在这里输入图片标题")

**3. 点击选框中的向下箭头，会显示当前用户在码云上的所有项目**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02120321_H6TO.png "在这里输入图片标题")

**4. 可选择任意项目进行 clone**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02120334_8SUv.png "在这里输入图片标题")

## 方法二

### 登陆

**1. 选择 `File` - `settings`**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02123545_hTwI.png "在这里输入图片标题")

**2. 选择 Version Control - 码云**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02122846_XuM9.png "在这里输入图片标题")

如果配置了公钥，可选择 ssh 方式拉取项目。

Test 按钮可测试用户名和密码是否正确。

### 拉取项目代码

**1. 选择 `VCS` - `Checkout from Version Control` - `码云`**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02123042_mnaF.png "在这里输入图片标题")

最新版 gitee 选项已经和 git 合并：

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175937_Ooer.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201806/26180112_a0yC.png "在这里输入图片标题")

**2. 其他步骤同上**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02123754_WLFj.png "在这里输入图片标题")

#3. push 代码

**1. 添加文件**

右键点击需要添加的文件、文件夹

![输入图片说明](https://static.oschina.net/uploads/img/201606/02125128_1yZy.png "在这里输入图片标题")

**2. 选择commit**

右键点击文件、文件夹

![输入图片说明](https://static.oschina.net/uploads/img/201606/02125200_Mylj.png "在这里输入图片标题")

**3. 填写 commit 信息**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02125215_mCBO.png "在这里输入图片标题")

**4. 选择 push**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02125233_YqtF.png "在这里输入图片标题")

**5. 将代码 push 到线上**

![输入图片说明](https://static.oschina.net/uploads/img/201606/02125248_3yo9.png "在这里输入图片标题")

#4. 托管本地项目到码云

本地项目可以直接托管到码云，不需要在 web 上创建项目。

**1. 选择 `VCS` - `Import into Version Control` - `托管项目到码云`**

![将本地项目托管到码云](https://static.oschina.net/uploads/img/201606/02121544_480H.png "在这里输入图片标题")

**2. 填写项目信息，可选择公有或私有**

![将本地项目托管到码云](https://static.oschina.net/uploads/img/201606/02121603_Od6p.png "在这里输入图片标题")

** 3. 选择文件，填写 commit 信息。点击`OK`即可**

![将本地项目托管到码云](https://static.oschina.net/uploads/img/201606/02121631_xmdK.png "在这里输入图片标题")

#5. Tasks 关联码云 Issue

通过插件，可将 IDEA Tasks 与码云 Issue 进行关联。

**Tasks 关联仓库的步骤如下**

1. 选择 `Tools` -> `Tasks && Contexts` -> `Configure Servers...` 
2. 点击 `+` 后选择 `GitOSC`，输入用户名和仓库名称，这两个名称需要与仓库 url 中的名称一致。
3. 点击`Create API Token`，输入邮箱和密码，点击 `Login`，此时会生成 Token。
4. 最后确定即可。

![输入图片说明](https://static.oschina.net/uploads/img/201711/24153109_HM6o.gif "在这里输入图片标题")

**打开 Tasks 步骤如下**

1. 选择 `Tools` -> `Tasks && Contexts` -> `Open Task...` 
1. 列表中会显示项目的 Issue，双击。
1. 设置仓库分支等，最后确定即可。

![输入图片说明](https://static.oschina.net/uploads/img/201711/24153121_DwTZ.gif "在这里输入图片标题")

**操作 Issue**
1. `Open Task...` Task 与 Issue 建立关联。
1. `Close Active Task` 可以更新 Issue 状态。
1. `Show '***' Description` 可显示 Issue 的描述信息。
1. `Open '***' In Browser` 可在浏览器中打开 Issue 页面。
![输入图片说明](https://static.oschina.net/uploads/img/201711/24153134_BaRU.png "在这里输入图片标题")

#6. 创建代码片段

打开源码文件，在文件窗口点击右键，选择`创建代码片段...`即可。

![输入图片说明](https://static.oschina.net/uploads/img/201711/24155948_eotH.png "在这里输入图片标题")

注册码云账号，只要点击导航条中的“注册”，或者点击首页中那个大大的“加入码云”按钮，即可进入注册页面。

收费吗？目前除企业版外均为免费。开源软件托管是码云的基础，对于开源项目的版本库（无论是公有版本库，还是私有版本库）的托管，码云都是免费的。在码云首页中，就有针对于个人用户的免费托管方案，如图2-1所示。

![免费方案](https://static.oschina.net/uploads/img/201704/18155757_fiOb.jpg "免费方案")
图2-1：针对个人用户的免费方案

进入码云的注册界面，依次填入各项，需注意的是：邮箱最好填写国内的邮箱，以免因为众所周知的原因无法接收激活邮件，**个性地址一经选定,无法修改，请慎重填写。**

![注册界面](https://static.oschina.net/uploads/img/201806/27181105_kWqQ.png "在这里输入图片标题")
图2-2：注册界面

我们会向您的邮箱发送一份激活邮件，请点击其中的链接激活账号，账号激活后，注册流程就算完成了。注册完毕即以新注册的账号登录，登录后即进入用户的控制面板页面。如果图2-3所示。

![控制面板](https://static.oschina.net/uploads/img/201704/18172802_RGrN.jpg "控制面板")
图2-3：登录后的码云首页

控制面板页面是用户最重要的页面，因为在这个页面中不仅可以看到组织成员的动态，还可以看到自己的项目信息，代码片段，PR，Issues，以及加入的企业信息，非常方便。

在页面右上方显示当前登录用户的名称和头像。图2-3中显示登录用户为 “不要404”。在页面右上方还有两个图标，从左至右分别是：通知和创建。点击头像图标进入【修改资料】对账号进行进一步设置，如图2-4所示。

![账户设置](https://static.oschina.net/uploads/img/201704/18190232_7R3K.jpg "账户设置")
图2-4：账户设置页

点击菜单中的【修改账户】，可以更改私人令牌、更换登陆密码、以及修改注册邮箱，如图2-5所示。

![修改账户](https://static.oschina.net/uploads/img/201704/18181420_ix0Y.jpg "修改账户")
图2-5：账户管理

其中私人令牌是和用户密码相关的密钥，当用户密码更改时私人令牌也随之更改。码云的某些应用会使用私人令牌进行身份认证，从而避免直接使用用户密码造成泄露的风险。私人令牌若泄露的危害要远远小于密码泄露，这因为私人令牌不能用于登录码云网站等，而且一旦私人令牌泄露可以很容易通过更改密码的方式更换私人令牌。

码云只允许为一个账号绑定对应一个邮件地址，以便能够将 Git 版本库中的提交正确对应到码云账户。

码云为用户提供可个性化配置的信息通知方式，如图2-6所以。

![通知方式](https://static.oschina.net/uploads/img/201806/27181317_OkNd.png "在这里输入图片标题")
图2-6：通知方式

码云为托管的 Git 版本库提供 SSH 协议支持，即用户可以用公钥认证的方式连接到码云的 SSH 服务器。点击 [生成并部署SSH key](http://git.mydoc.io/?t=154712) 了解具体实现步骤。

码云作为一个优秀程序员的聚集地，期待着你的加入！！

###1、创建项目

----------

点击右上角的![输入图片说明](https://static.oschina.net/uploads/img/201704/01152036_vITZ.jpg "在这里输入图片标题")或者![输入图片说明](https://static.oschina.net/uploads/img/201704/01152303_3MMo.jpg "在这里输入图片标题")，跳转至项目创建页面：

![输入图片说明](https://static.oschina.net/uploads/img/201704/01152603_Zb3l.jpg "在这里输入图片标题")

依次填写各项信息然后点击创建就可以了，这样我们一个项目就创建好了如果没有意外，你将看到这个页面:

![输入图片说明](https://static.oschina.net/uploads/img/201704/01152726_Wux6.jpg "在这里输入图片标题")

这样，我们在码云平台就创建好了一个项目

###2、本地初始化一个项目

----------

首先，你需要执行下面两条命令，作为 git 的基础配置，作用是告诉 git 你是谁，你输入的信息将出现在你创建的提交中。

```
git config --global user.name "你的名字或昵称"
git config --global user.email "你的邮箱"
```

然后在你的需要初始化版本库的文件夹中执行：

```
git init 
git remote add origin <你的项目地址> //注:项目地址形式为:https://gitee.com/xxx/xxx.git或者 git@gitee.com:xxx/xxx.git
```

这样就完成了一次版本你的初始化。

如果你想克隆一个项目，只需要执行：

```
git clone <项目地址>
```

###3、完成第一次提交

----------

进入你已经初始化好的或者克隆项目的目录,然后执行：

```
git pull origin master
<这里需要修改/添加文件，否则与原文件相比就没有变动>
git add .
git commit -m "第一次提交"
git push origin master
```

然后如果需要账号密码的话就输入账号密码，这样就完成了一次提交。

此时，你可以在你的个人面板、项目主页查看到你的提交记录，例如：https://gitee.com/oschina/git-osc/commit/f3dd1c5bae48fa4244e2595a39e750e5606dd9be](https://gitee.com/oschina/git-osc/commit/f3dd1c5bae48fa4244e2595a39e750e5606dd9be

按照本文档新建的项目时，在码云平台仓库上已经存在 readme 文件，故在提交时可能会存在冲突，这时您需要选择的是保留线上的文件或者舍弃线上的文件，如果您舍弃线上的文件，则在推送时选择强制推送，强制推送需要执行下面的命令：

```
git push origin master -f
```

如果您选择保留线上的 readme 文件,则需要先执行：

```
git pull origin master
```

然后才可以推送,如果发生冲突，则需要先解决冲突,关于如何处理冲突，请参阅[如何处理代码冲突](http://git.mydoc.io?v=16912&t=66902)这一小节。

开发者向码云版本库写入最常用到的协议是 SSH 协议，因为 SSH 协议使用公钥认证，可以实现无口令访问，而若使用 HTTPS 协议每次身份认证时都需要提供口令。使用 SSH 公钥认证，就涉及到公钥的管理。

### 1.如何生成ssh公钥

----------

你可以按如下命令来生成sshkey:

```sh
ssh-keygen -t rsa -C "xxxxx@xxxxx.com"

# Generating public/private rsa key pair...
# 三次回车即可生成 ssh key
```

查看你的 public key，并把他添加到码云（Gitee.com） [SSH key添加地址](http://git.oschina.net/profile/sshkeys)

```
cat ~/.ssh/id_rsa.pub
# ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc....
```

添加后，在终端（Terminal）中输入

```
ssh -T git@gitee.com
```

若返回

```
Welcome to Gitee.com, yourname! 
```

则证明添加成功。
* * *

### 2.怎么添加用户ssh key?

----------

1. 点击右上角的![输入图片说明](https://static.oschina.net/uploads/img/201604/14154017_ogkd.png "在这里输入图片标题")标志,进入个人中心,然后点击左侧的ssh公钥后在下图位置填写你的ssh公钥。

2. 点击确定,然后验证密码(即你的注册账号密码)就完成了ssh公钥添加。

![输入图片说明](https://static.oschina.net/uploads/img/201610/18115822_miTO.png "在这里输入图片标题")

### 3.项目的 ssh key 和用户的 ssh key 两处地方有什么不同?

----------

> 项目的 ssh key 只针对项目,且我们仅对项目提供了部署公钥,即`项目下的公钥仅能拉取项目`,这通常用于生产服务器拉取仓库的代码。
而用户的 key 则是针对用户的,用户添加了 key 就对用户名下的项目和用户参加了的项目具有权限,一般而言,用户的 key 具有推送和拉取的权限,而项目的 key 则只具有拉取权限

很多开源项目托管平台都支持为托管的项目建立主页，但主页的维护方式都没有码云这么酷。大多数托管平台无非是开放一个FTP或类似服务，用户把制作好的网页或脚本上传了事，而在码云用户通过创建特殊名称的 Git 版本库或在 Git 库中建立特别的分支实现对主页的维护。

### 码云 `Pages` 是一个免费的静态网页托管服务，您可以使用 码云 `Pages` 托管博客、项目官网等静态网页。如果您使用过 `Github Pages` 那么您会很快上手使用码云的 `Pages`服务。

>Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown （或者 Textile） 以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 码云 Pages 上，也就是说，你可以使用码云的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

Jekyll 使用文档：http://jekyll.bootcss.com/docs/home/

### 1. 使用前须知

1、项目必须有 index.html 才可以正常访问

2、静态网页的样式可以自己写，也可以拿一些静态模版来修改，`Pages`服务本身不提供任何形式的模版，但我们后续会陆续增加例子，供大家参考使用。

3、如果你想以根目录的形式访问自己的静态网站，只需要建立一个与自己个性地址同名的项目即可，如 https://gitee.com/ipvb 这个用户，想要创建一个自己的站点，但不想以子目录的方式访问，想以`ipvb.oschina.io`直接访问，那么他就可以创建一个名字为`ipvb`的项目 https://gitee.com/ipvb/ipvb 部署完成后，就可以以 http://ipvb.oschina.io 进行访问了。

### 2. 一个小白的 Pages 搭建之旅

#### **A.新建项目 test_pages**

![输入图片说明](https://static.oschina.net/uploads/img/201606/01172928_Wv13.png "在这里输入图片标题")

点击创建完成项目的创建

#### **B.添加文件 index.html (注意名称是index.html哦！)**

点击新建文件

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173033_nL18.png "在这里输入图片标题")

文件名输入 `index.html`，内容就是简单的 `html`

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173322_qoin.png "在这里输入图片标题")

点击提交，将文件提交到仓库

#### **C.选择 pages 服务**

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173449_hHY1.png "在这里输入图片标题")

#### **D.选择需要部署的分支，这里选择 Master 启动服务。**

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173541_QDTs.png "在这里输入图片标题")

#### **E.访问生成的网站地址，即可以查看你部署的静态页面啦！**

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173617_VOe9.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201606/01173639_s4t6.png "在这里输入图片标题")

### 3. 已经有Pages项目如何部署到码云的Pages
以`jQuery-File-Upload`项目为例，项目地址：https://github.com/blueimp/jQuery-File-Upload

它在Github上的Pages地址是：https://blueimp.github.io/jQuery-File-Upload/

如果想把它转移到码云`Pages`，只需要登录你的码云账户，点击右上角的 `+` 号，选择新建项目

![输入图片说明](https://static.oschina.net/uploads/img/201606/01170937_93rs.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201606/01170914_Vb4Q.png "在这里输入图片标题")

然后点击创建，项目会在后台自动导入，导入成功后，点击菜单栏的 `Pages`

![输入图片说明](https://static.oschina.net/uploads/img/201606/01171047_x3BN.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201606/01171113_lM7g.png "在这里输入图片标题")

这里我们默认的`Pages`服务分支是`osc-pages`，但是你也已选择自己静态页面所在的分支，这里`jQuery-File-Upload`项目的静态页面分支是`gh-pages`，选择`gh-pages`并点击启动服务。

![输入图片说明](https://static.oschina.net/uploads/img/201606/01171334_7QAP.png "在这里输入图片标题")

至此，静态网页已经部署成功，访问提供的地址：http://silentboy.oschina.io/jQuery-File-Upload/ 即可查看到`jQuery-File-Upload`项目的静态官网。

![输入图片说明](https://static.oschina.net/uploads/img/201606/01171535_B1u8.png "在这里输入图片标题")

### 4. Pages 进阶，使用 Jekyll 生成自己的静态网页

Jekyll 究竟是什么？

Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown （或者 Textile） 以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 码云Pages上，也就是说，你可以使用码云的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

Jekyll 使用文档：http://jekyll.bootcss.com/docs/home/

### 其他帮助:

如何自定义404？

答：在项目根目录新建 404.html 文件即可。

参与码云中的项目开发，最常用和推荐的首选方式是“Fork + Pull”模式。在“Fork + Pull”模式下，项目参与者不必向项目创建者申请提交权限，而是在自己的托管空间下建立项目的派生（Fork）。至于在派生项目中创建的提交，可以非常方便地利用码云的 Pull Request 工具向原始项目的维护者发送 Pull Request。

### 1、什么是 Pull Request？

Pull Request 是两个仓库提交变更的一种方式，通常用于 fork 项目与被 fork 项目的差异提交，同时也是一种非常好的团队协作方式，下面，就来讲解如何在码云平台提交 Pull Request：

PS：码云平台限制 Pull Request 源项目与目标项目需存在 fork 与被 fork 关系，故如果你要提交 Pull Request，必须先 fork 一个项目，然后才能对该项目提交 Pull Request，同时，以该项目为父项目的所有项目，您也均可以提交 Pull Request。

### 2、如何 fork 项目

fork 项目时非常简单的，进到项目页面，然后找到右上角的 fork 按钮，点击后再次点击确定，等待系统在后台完成仓库克隆操作，你就完成了 fork 操作，如图：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11170038_5Rzf.png "在这里输入图片标题")

### 3、如何提交 Pull Request

首先，您的项目与目标项目必须存在差异，这样才能提交,比如这样：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11164020_j8To.png "在这里输入图片标题")

如果不存在差异，或者目标分支比你提Pull Request的分支还要新，则会得到这样的提示：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11164209_LfgW.png "在这里输入图片标题")

然后，填入Pull Request的说明，点击提交Pull Request，就可以提交一个Pull Request了，就想下图所示的那样：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11171413_x7Jh.png "在这里输入图片标题")

### 4、如何对已经存在的 Pull Request 的进行管理

首先，对于一个已经存在的 Pull Request，如果只是观察者，报告者等权限，那么访问将会受到限制，具体权限限制请参考码云平台关于角色权限的内容，下文涉及的部分，仅针对管理员权限，如果您发现不太一样的地方，请检查您的权限是不是管理员或该 Pull Request 的创建者。

### 5、如何修改一个已经存在的 Pull Request

点击 Pull Request 的详情界面右上角的编辑按钮，就会弹出编辑框，在编辑框中修改你需要修改的信息，然后点击保存即可修改该 Pull Request，如下图所示：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11182105_veIB.png "在这里输入图片标题")

请注意，在该界面，可以对 Pull Request 进行指派负责人，指派测试者等等操作，每一个操作均会通知对应的人员

### 6、对 Pull Request 的 bug 修改如何提交到该 Pull Request 中

对于 Pull Request 中的 bug 修复或者任何更新动作，均不必要提交新的 Pull Request，仅仅只需要推送到您提交 Pull Request 的分支上，稍后我们后台会自动更新这些提交，将其加入到这个 Pull Request 中去

### 7、Pull Request 不能自动合并该如何处理

在提交完 Pull Request 的后，在这个 Pull Request 处理期间，由原本的能自动合并变成不能自动合并，这是一件非常正常的事情，那么，这时，我们有两种选择，一种，继续合并到目标，然后手动处理冲突部分，另一种则是先处理冲突，使得该 Pull Request 处于可以自动合并状态，然后采用自动合并，一般来讲，我们官方推荐第二种，即先处理冲突，然后再合并。具体操作为：

先在本地切换到提交 Pull Request 的分支，然后拉取目标分支到本地，这时，会发生冲突，参考[如何处理代码冲突](http://git.mydoc.io?v=16912&t=83148) 这一小节将冲突处理完毕，然后提交到 Pull Request 所在的分支，等待系统后台完成Pull Request的更新后，Pull Request 就变成了可自动合并状态

### 8、Pull Request 不小心合并了，可否回退

对于错误合并的 Pull Request，我们提供了回退功能，该功能会产生一个回退 XXX 的 Pull Request，接受该 Pull Request 即可完成回退动作，注意，回退本质上是提交一个完全相反的 Pull Request，所以，你仍然需要进行测试来保证完整性，另，为了不破坏其他 Pull Request，建议只有需回退的 Pull Request 处于最后一次合并操作且往上再无提交时执行回退动作，否则请手动处理。

之前码云的解析器基于用户的反馈做了很多定制化的修改，但是随着使用码云的用户越来越多，以及越来越多的 Github 用户往码云上迁移，我们收到了很多用户反馈，在 Github 正常解析渲染的 Readme 在码云上渲染出来的结果却有所出入，讨论再三，我们决定将码云的 Markdown 解析器更换为 CommonMark。

更改后的差异如下：

### 标题#后面需要有空格才会正确渲染标题

![标题](https://static.oschina.net/uploads/img/201709/14162417_MBeF.png "标题")

### 正确解析形如 Map<String, Collection<Object.toString>> 的文本

![文本](https://static.oschina.net/uploads/img/201709/14163530_K0X4.png "文本")

### 解决代码块标签前后没有空行导致不换行显示

![标签](https://static.oschina.net/uploads/img/201709/14164246_FtbX.png "标签")

### 解决Readme中注释显示的问题

![注释](https://static.oschina.net/uploads/img/201709/14164312_L8Sr.png "在这里输入图片标题")

### 解决 Html colspan、rowspan 标签无效的问题

![标签无效的问题](https://static.oschina.net/uploads/img/201709/14164520_lKEK.png "标签无效的问题")

### 解决标题中不支持 Code 块的问题

![Code 块](https://static.oschina.net/uploads/img/201709/14164603_kibi.png "Code 块")

### 解决内容中不留空格无法加粗的问题

![解决内容中不留空格无法加粗的问题](https://static.oschina.net/uploads/img/201709/14164625_suY2.png "解决内容中不留空格无法加粗的问题")

### 支持--构建表格

![构建表格](https://static.oschina.net/uploads/img/201709/14164657_LPI3.png "构建表格")

### 不再支持[TOC]

标准的 Markdown 是不支持 [TOC] 标签的，可以通过 a 标签的方式自行创建目录

![自行创建目录](https://static.oschina.net/uploads/img/201709/14164719_Bri7.png "自行创建目录")

### 码云上 Readme 后缀说明

码云为了适应不同种类的开源项目的 Readme 显示，有不同的优先显示规则，如下：

- 如一个项目有 Readme.osc.md 也有 Readme.md，那么在码云上则优先显示 Readme.osc.md。  
 
再比如一个项目有 Readme.zh-CN.md 又有 Readme.en.md 如果浏览器是英文，则显示 Readme.en.md，如果浏览器是中文，则显示 Readme.zh-CN.md。

具体规则如下：

- 有 osc 标示优先 如Readme.osc.md；
- 其次对应语言优先 简体中文[zh CH cn zh-cn zh_cn] 繁体中文 [zh-hk zh-tw zh-yue zh_hk zh_tw zh_yue] 英文 [en] 如 Readme.zh.md；
- 没有以上规则以后缀优先 [mdown md mkdn mdwn markdown textile rdoc creole mediawiki rst rest adoc asciidoc pod org txt html htm] 如readme.mdown。

如果您在使用中遇到问题，欢迎反馈 https://gitee.com/oschina/git-osc/issues/new。

附 CommonMark 语法文档 http://commonmark.org/help/。

现在 **码云** 目前支持使用 Subversion 对仓库进行操作，以下是使用指南和注意事项。

## 使用前注意

1. 仓库体积超过 `300 MB` 不建议使用 Subversion 操作仓库，存储库容量达到 400 MB，或者 300 MB 并且存储大量非文本数据时，我们将关闭仓库的 Subversion 支持。
  
2. 由于 GIT 不支持空目录的提交，在存储机器上，无论是普通仓库还是开启 Subversion 接入的仓库存储时都是 GIT 仓库，Subversion 的 commit 是提交到 git 仓库上的，所以码云的 Subversion `不支持空目录的提交`。

3. 第一次开启 Subversion， 操作一个仓库，如果仓库体积较大或者提交次数较多，由于缓存的缘故，响应时间会比较长。

4. 不支持 Subversion 的 Hook 机制，请使用 WebHook 替代。

5. Subversion 属性不完全支持。

6. 客户端需要开启 SASL 支持，不支持的客户端无法访问。

7. 部分 svn 命令不支持。可以查看 **Subversion 客户端的兼容性。**

8. 版本号的映射，目前 Subversion 的版本号计算依据为本分支所有的commit 数目减一 不包括 merge ，如果使用了在 git 中强制回退等操作，请重新检出。

*WARNING:*  
 
>由于 git 在设计上就没有考虑空文件 [Kernel.org: Git FAQ](https://git.wiki.kernel.org/index.php/GitFaq#Can_I_add_empty_directories.3F)

>我们设计的原则就是不破坏，不主动修改用户的仓库，我们的后端存储的完全是一个 git 仓库，如果我们添加了，一次提交内容也不会一致了，建议你在添加目录的时候添加 .keep 之类的占位文件，空文件即可。

>Git 与 SVN 混用时尽量不要使用 Git 强制推送。[Git 与 SVN 混用注意事项](https://git.mydoc.io/?t=122635)

## 关于改版

Subversion 功能的最终解释权归 OSChina.NET 所有。Subversion 接入的规则可能在下一次改版中发生改变。

## 开启方式

1. 在项目的设置界面开启

![设置开启 svn ](https://static.oschina.net/uploads/img/201701/17151858_hFcd.png "在这里输入图片标题")

2. 如果是空仓库：

![输入图片说明](https://static.oschina.net/uploads/img/201701/17152124_TZe7.png "在这里输入图片标题")

## 使用指南

码云 支持的是 svn 协议。  对于 svn 而言，获取一个仓库的代码通常是 checkout，在项目主页我们通常可以获得 URL：   
 
![svn-url](http://static.oschina.net/uploads/space/2015/0318/152207_DRMJ_139664.png)

这个仓库地址为：

```sh 
svn://git.oschina.net/svnserver/newos
```

### 1.获取仓库代码：   
 
```sh
svn checkout svn://git.oschina.net/svnserver/newos newos
```

**注意信息** 码云的 SVN 接入后端是通过 git 存储库实现，URL 规则为 svn://域名/用户名/项目名 .

使用上述命令，我们将得到项目`默认分支的代码`。并将本地的工作目录命名为 *newos*

如果最后不带 newos，svn 默认把本地工作目录命名为 项目名  
 
```sh
svn checkout svn://git.oschina.net/svnserver/newos
```

如果要`获得任意分支代码`，例如获取 newos 的 dev 分支，请输入近似如下的命令：

- 此时地址为： ` svn://域名/用户名/项目名/branches/分支名 `.

```sh
svn checkout svn://git.oschina.net/svnserver/newos/branches/dev
```

特别的说明，获取主干分支，也就是 master 分支可以使用下面的分支格式   
 
```sh
svn checkout svn://git.oschina.net/svnserver/newos/trunk newos
```

svn trunk 分支对应 master 分支 用户应当尽量不使用下面格式     
  
```sh
svn checkout svn://git.oschina.net/svnserver/newos 
```

## 操作说明

如果部分检出仓库，并且仓库根目录下包含 branches/tags/trunk 这样的目录，请使用完整的路径 layout，如下：

```sh
svn://git.oschina.net/username/example/trunk/tags/hello
svn://git.oschina.net/username/example/branches/dev/trunk
svn://git.oschina.net/username/example/branches/dev/branches 
```

如果没有 master 分支，也就没有 trunk 分支，检出的 URL 不能省略分支名。比如只有一个 dev 分支,必须使用下列格式，否则会提示仓库不存在。

```sh
svn co svn://git.oschina.net/svnserver/newos/branches/dev  svnserver_dev  
```

打开终端,输入上述命令，出现以下下面提示。其中第一个认证领域是用户的密码，这个可以留空。而用户名是用户在 码云（Gitee.com）登陆时使用`邮箱地址`。密码则是用户登陆 码云 所使用的密码。

一般而言，svn 会加密缓存用户的用户名密码，所以，对仓库的操作只需要第一次输入用户邮箱和密码。

清除密码缓存，用户目录下的 `.subversion/auth/svn.simple` 文件夹下的文件。

![image](http://static.oschina.net/uploads/space/2015/0318/153828_ptt4_139664.png)

下图则是成功的拉取了项目代码。

![输入图片说明](https://static.oschina.net/uploads/img/201701/17152908_GJy9.png "在这里输入图片标题")

查看本地工作目录信息：

```sh
svn info
```

![输入图片说明](https://static.oschina.net/uploads/img/201701/17153454_IO8A.png "在这里输入图片标题")

```
cd helloworld
echo "test" > SVNReadMe.md
#svn add SVNReadMe.md
#svn add * --force类似于git add -A
svn add * --force
svn update .
svn commit -m "first svn commit"
```
Subversion 在提交前建议先使用 svn update 更新工作拷贝。也就相当于 git pull 后再 git push。

Subversion 的提交是在线的，如果机器已经离线，那么提交会失败，这个过程用git的方式理解就是 git commit+git push。

用户使用 svn 提交代码同样会有动态显示。

列出版本库中的目录内容:

```sh
svn list svn://git.net/svnserver/newos/trunk
```

导出仓库指定分支的所有文件，不含版本控制信息：

```sh
svn export svn://git.net/svnserver/newos/trunk newos
```

## 备注

### 安装 Subversion 客户端

在 Apache 基金会的 Subversion 官网：  
 
[http://subversion.apache.org](http://subversion.apache.org)

二进制下载提示页面：

[http://subversion.apache.org/packages.html](http://subversion.apache.org/packages.html)

#### Windows 系统：

与资源管理起集成的 SVN 客户端：[TortoiseSVN](http://tortoisesvn.net/downloads.html),通常被叫做"海龟"，为 msi 安装包。可以使用 [ExtractMSI](http://pan.baidu.com/s/1szHIn) 解压缩。

很诡异的是，在 Apache 上并没有推荐 TortoiseSVN。

另外还有 SlikSVN，下载地址：[https://sliksvn.com/download/](https://sliksvn.com/download/)

其他的也就不一一介绍了。

#### Linux 系统

一般而言 Linux 系统自带的包控制软件能够安装 Subversion，如果版本低于1.8，就建议用户下载预编译的二进制或者自己动手编译 Subversion。这里不做过多说明。

#### OS X

XCode 自带的 Subversion 版本为1.7.x，太老，而 码云（Gitee.com）只支持1.8以上的 SVN 客户端。

如果安装了 Homebrew

```sh
brew install subversion
```

或者使用 WANdisco 的预编译版本

[http://www.wandisco.com/subversion/download#osx](http://www.wandisco.com/subversion/download#osx)

### Subversion 客户端的兼容性

我们支持 Apache Subversion 1.8 或者更高的版本，当你安装一个 Subversion 客户端时，如果错误提示是“无法协商验证验证方式” 请确保你的客户端支持 SASL 验证，比如在 Ubuntu 上，你可以安装 libsasl2-dev 然后编译 Subversion, 这样的话客户端是支持 SASL 验证的。
 
>sudo apt-get install libsasl2-dev
                                                                            
当你使用 svnkit 或者 SubversionJavaHl 这类 IDE 集成客户端，请确保支持 SASL 验证。

### 关于 GIT 与 SVN 的转换

如果用户存在一个基于 Subversion 托管的项目，要迁移到 码云（Gitee.com），可以使用 git-svn 将项目转变为基于 git 的仓库，然后推送到码云（Gitee.com），这样你依然能够使用SVN对项目进行操作。请记得先在码云（Gitee.com）上新建一个项目

```
 git svn clone http://myhost/repo -T trunk -b branches -t tags 
 git remote add oscgit https://git.oschina.net/user/repo
 git push -u oscgit --all
```

通常来说，如果本地存在 SVN 仓库，则可以：

```
git svn clone file:///tmp/svn-repo -T trunk -b branches -t tags 
git remote add oscgit https://git.oschina.net/user/repo
git push -u oscgit  --all
```

将项目转移到 GIT@OSC 上以后，使用 svn 命令 checkout 即可对项目进行操作。

高级指南：

[http://git-scm.com/book/zh/ch8-2.html](http://git-scm.com/book/zh/ch8-2.html)

### 安装 git，git-svn

#### Windows

msysgit 官网 [http://msysgit.github.io/](http://msysgit.github.io/),版本比较低。   
      
Github for Windows 提供的 git 工具和 msysgit 一致。

MSYS2 git 下载地址: [http://sourceforge.net/projects/msys2](http://sourceforge.net/projects/msys2)，然后启动终端,安装 git，目前版本为2.4.3。

```
pacman -S git
```
Cygwin git 下载地址: [http://www.cygwin.com/](http://www.cygwin.com/),然后使用包管理软件或者直接下载 git 源码编译 git。
```sh
make configure
./configure --prefix=/usr/local
make 
make install 
```
#### Linux

有包管理器的直接用包管理器安装。

如 Ubuntu

```sh
sudo apt-get install git git-svn
```
也可以手动编译。

#### Mac OSX

下载地址：[http://git-scm.com/download/mac](http://git-scm.com/download/mac)

码云 WebHook 功能是帮助用户 push 代码后，自动回调一个您设定的 http 地址。 这是一个通用的解决方案，用户可以自己根据不同的需求，来编写自己的脚本程序(比如发邮件，自动部署等)。

### 添加 WebHook

#### 设置页面

项目主页 > 管理页面 > WebHooks

![输入图片说明](https://static.oschina.net/uploads/img/201806/06224100_WX2H.png "在这里输入图片标题")

#### 参数说明

- URL(*): 接收 WebHook 数据的 http 地址。码云将发送 Post 请求到这个地址

- 密码: 为了保证安全以及识别数据来源，建议设置一个密码。码云将会在 Post 数据中携带这个密码。注意， **密码是明文**

- 钩子: 用户在码云上可触发的 WebHook，支持添加多个钩子

#### 钩子类型

目前, 码云支持以下 5 种钩子：

- Push: 项目推送代码、推送 / 删除分支

- Tag Push: 新建 / 删除 tag

- Issue: 新建任务、变更任务状态、更改任务指派人

- Pull Request: 新建、更新pr代码、合并 Pull Request

- 评论: 评论项目、任务、Pull Request、Commit

#### 测试 WebHook

在添加 WebHook 后，可测试 WebHook 是否可正常使用。码云将发送测试数据到指定的 URL

![输入图片说明](https://static.oschina.net/uploads/img/201806/06230805_P7P4.png "在这里输入图片标题")

### 支持第三方应用

我们为了方便用户在第三方平台接收到码云的推送，已通过 WebHook 支持以下第三方应用

- 钉钉机器人: 设置 WebHook URL 为钉钉机器人地址。 具体请查看 [码云的 WebHook 增加对钉钉的支持](http://git.mydoc.io/?t=223424)

- Slack 机器人: 设置 WebHook URL 为 Slack 机器人地址

### WebHook 推送数据

#### Request Headers

WebHook request headers 包含以下一些关键数据

```
Content-Type: application/json    # 默认为 application/json , 若是旧版钩子(已不维护)为 application/x-www-form-urlencoded

User-Agent: git-oschina-hook 　　 # 固定为 git-oschina-hook，可用于标识为来自 gitee 的请求

X-Gitee-Token: webhook password　 # 用户新建 WebHook 时提供的密码

X-Gitee-Event: Merge Request Hook # 标识触发的钩子类型
```

#### Request Payload

Webhook request payload 根据不同钩子，分为 4 种类型 payload， 以下是各钩子推送的示范数据（仅供参考，请以实际收到的数据为准）

##### Push / Tag Push 钩子

以下是一次推送代码触发的钩子数据

```json
{
  "hook_name": "push_hooks", 
  "password": "pwd"，
  "ref": "refs/heads/change_commitlint_config",
  "before": "0000000000000000000000000000000000000000",
  "after": "1cdcd819599cbb4099289dbbec762452f006cb40",
  "created": true,
  "deleted": false,
  "compare": "https://gitee.com/oschina/gitee/compare/0000000000000000000000000000000000000000...1cdcd819599cbb4099289dbbec762452f006cb40",
  "commits": [
    {
      "id": "1cdcd819599cbb4099289dbbec762452f006cb40",
      "tree_id": "db78f3594ec0683f5d857ef731df0d860f14f2b2",
      "distinct": true,
      "message": "Update README.md",
      "timestamp": "2018-02-05T23:46:46+08:00",
      "url": "https://gitee.com/oschina/gitee/commit/1cdcd819599cbb4099289dbbec762452f006cb40",
      "author": {
        "time": "2018-02-05T23:46:46+08:00",
        "name": "robot",
        "email": "robot@gitee.com",
        "username": "robot",
        "user_name": "robot",
        "url": "https://gitee.com/robot"
      },
      "committer": {
        "name": "robot",
        "email": "robot@gitee.com",
        "username": "robot",
        "user_name": "robot",
        "url": "https://gitee.com/robot"
      },
      "added": null,
      "removed": null,
      "modified": [
        "README.md"
      ]
    }
  ],
  "head_commit": {
    "id": "1cdcd819599cbb4099289dbbec762452f006cb40",
    "tree_id": "db78f3594ec0683f5d857ef731df0d860f14f2b2",
    "distinct": true,
    "message": "Update README.md",
    "timestamp": "2018-02-05T23:46:46+08:00",
    "url": "https://gitee.com/oschina/gitee/commit/1cdcd819599cbb4099289dbbec762452f006cb40",
    "author": {
      "time": "2018-02-05T23:46:46+08:00",
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "committer": {
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "added": null,
    "removed": null,
    "modified": [
      "README.md"
    ]
  },
  "total_commits_count": 0,
  "commits_more_than_ten": false,
  "repository": {
    "id": 120249025,
    "name": "Gitee",
    "path": "gitee",
    "full_name": "开源中国/Gitee",
    "owner": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "private": false,
    "html_url": "https://gitee.com/oschina/gitee",
    "url": "https://gitee.com/oschina/gitee",
    "description": "",
    "fork": false,
    "created_at": "2018-02-05T23:46:46+08:00",
    "updated_at": "2018-02-05T23:46:46+08:00",
    "pushed_at": "2018-02-05T23:46:46+08:00",
    "git_url": "git://gitee.com:oschina/gitee.git",
    "ssh_url": "git@gitee.com:oschina/gitee.git",
    "clone_url": "https://gitee.com/oschina/gitee.git",
    "svn_url": "svn://gitee.com/oschina/gitee",
    "git_http_url": "https://gitee.com/oschina/gitee.git",
    "git_ssh_url": "git@gitee.com:oschina/gitee.git",
    "git_svn_url": "svn://gitee.com/oschina/gitee",
    "homepage": null,
    "stargazers_count": 11,
    "watchers_count": 12,
    "forks_count": 0,
    "language": "ruby",
    "has_issues": true,
    "has_wiki": true,
    "has_pages": false,
    "license": null,
    "open_issues_count": 0,
    "default_branch": "master",
    "namespace": "oschina",
    "name_with_namespace": "开源中国/Gitee",
    "path_with_namespace": "oschina/gitee"
  },
  "sender": {
    "id": 1,
    "login": "robot",
    "avatar_url": "https://gitee.com/assets/favicon.ico",
    "html_url": "https://gitee.com/robot",
    "type": "User",
    "site_admin": false,
    "name": "robot",
    "email": "robot@gitee.com",
    "username": "robot",
    "user_name": "robot",
    "url": "https://gitee.com/robot"
  },
  "enterprise": {
    "name": "开源中国",
    "url": "https://gitee.com/oschina"
  }
}
```

##### Issue 钩子

以下是一次新建任务操作触发的钩子数据

```json
{
  "hook_name": "issue_hooks", 
  "password": "pwd"，
  "issue": {
    "html_url": "https://gitee.com/oschina/gitee/issues/IG6E9",
    "id": 295024870,
    "number": "IG6E9",
    "title": "IE浏览器，js报错",
    "body": "新建任务js报错",
    "state": "open",
    "comments": 0,
    "created_at": "2018-02-07T23:46:46+08:00",
    "updated_at": "2018-02-07T23:46:46+08:00",
    "user": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "labels": [
      {
        "id": 827033694,
        "name": "bug",
        "color": "d73a4a"
      }
    ],
    "assignee": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "milestone": {
      "html_url": "https://gitee.com/oschina/gitee/milestones/1",
      "id": 3096855,
      "number": 1,
      "title": "问题反馈",
      "description": null,
      "open_issues": 13,
      "started_issues": 6,
      "closed_issues": 31,
      "approved_issues": 42,
      "state": "open",
      "created_at": "2018-02-01T23:46:46+08:00",
      "updated_at": "2018-02-02T23:46:46+08:00",
      "due_on": null
    }
  },
  "repository": {
    "id": 120249025,
    "name": "Gitee",
    "path": "gitee",
    "full_name": "开源中国/Gitee",
    "owner": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "private": false,
    "html_url": "https://gitee.com/oschina/gitee",
    "url": "https://gitee.com/oschina/gitee",
    "description": "",
    "fork": false,
    "created_at": "2018-02-05T23:46:46+08:00",
    "updated_at": "2018-02-05T23:46:46+08:00",
    "pushed_at": "2018-02-05T23:46:46+08:00",
    "git_url": "git://gitee.com:oschina/gitee.git",
    "ssh_url": "git@gitee.com:oschina/gitee.git",
    "clone_url": "https://gitee.com/oschina/gitee.git",
    "svn_url": "svn://gitee.com/oschina/gitee",
    "git_http_url": "https://gitee.com/oschina/gitee.git",
    "git_ssh_url": "git@gitee.com:oschina/gitee.git",
    "git_svn_url": "svn://gitee.com/oschina/gitee",
    "homepage": null,
    "stargazers_count": 11,
    "watchers_count": 12,
    "forks_count": 0,
    "language": "ruby",
    "has_issues": true,
    "has_wiki": true,
    "has_pages": false,
    "license": null,
    "open_issues_count": 0,
    "default_branch": "master",
    "namespace": "oschina",
    "name_with_namespace": "开源中国/Gitee",
    "path_with_namespace": "oschina/gitee"
  },
  "sender": {
    "id": 1,
    "login": "robot",
    "avatar_url": "https://gitee.com/assets/favicon.ico",
    "html_url": "https://gitee.com/robot",
    "type": "User",
    "site_admin": false,
    "name": "robot",
    "email": "robot@gitee.com",
    "username": "robot",
    "user_name": "robot",
    "url": "https://gitee.com/robot"
  },
  "enterprise": {
    "name": "开源中国",
    "url": "https://gitee.com/oschina"
  }
}
```

##### Pull Request 钩子

以下是一次提交 Pull Request 触发的钩子数据

```json
{
  "hook_name": "merge_request_hooks", 
  "password": "pwd"，
  "pull_request": {
    "id": 167750879,
    "number": 1,
    "state": "open",
    "html_url": "https://gitee.com/oschina/giteeb/pulls/1",
    "diff_url": "https://gitee.com/oschina/giteeb/pulls/1.diff",
    "patch_url": "https://gitee.com/oschina/giteeb/pulls/1.patch",
    "title": "三方登陆的账号无密码问题",
    "body": null,
    "created_at": "2018-02-07T23:46:46+08:00",
    "updated_at": "2018-02-07T23:46:46+08:00",
    "closed_at": null,
    "merged_at": null,
    "merge_commit_sha": "5ccc31cda7aad7ddc59a6bdbb8a8bd61959dc71c",
    "user": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "assignee": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "tester": null,
    "milestone": {
      "html_url": "https://gitee.com/oschina/gitee/milestones/1",
      "id": 3096855,
      "number": 1,
      "title": "问题反馈",
      "description": null,
      "open_issues": 13,
      "started_issues": 6,
      "closed_issues": 31,
      "approved_issues": 42,
      "state": "open",
      "created_at": "2018-02-01T23:46:46+08:00",
      "updated_at": "2018-02-02T23:46:46+08:00",
      "due_on": null
    },
    "head": {
      "label": "gitee:login_should_complete_info",
      "ref": "login_should_complete_info",
      "sha": "5ccc31cda7aad7ddc59a6bdbb8a8bd61959dc71c",
      "user": {
        "id": 1,
        "login": "robot",
        "avatar_url": "https://gitee.com/assets/favicon.ico",
        "html_url": "https://gitee.com/robot",
        "type": "User",
        "site_admin": false,
        "name": "robot",
        "email": "robot@gitee.com",
        "username": "robot",
        "user_name": "robot",
        "url": "https://gitee.com/robot"
      },
      "repo": {
        "id": 120249025,
        "name": "Gitee",
        "path": "gitee",
        "full_name": "开源中国/Gitee",
        "owner": {
          "id": 1,
          "login": "robot",
          "avatar_url": "https://gitee.com/assets/favicon.ico",
          "html_url": "https://gitee.com/robot",
          "type": "User",
          "site_admin": false,
          "name": "robot",
          "email": "robot@gitee.com",
          "username": "robot",
          "user_name": "robot",
          "url": "https://gitee.com/robot"
        },
        "private": false,
        "html_url": "https://gitee.com/oschina/gitee",
        "url": "https://gitee.com/oschina/gitee",
        "description": "",
        "fork": false,
        "created_at": "2018-02-05T23:46:46+08:00",
        "updated_at": "2018-02-05T23:46:46+08:00",
        "pushed_at": "2018-02-05T23:46:46+08:00",
        "git_url": "git://gitee.com:oschina/gitee.git",
        "ssh_url": "git@gitee.com:oschina/gitee.git",
        "clone_url": "https://gitee.com/oschina/gitee.git",
        "svn_url": "svn://gitee.com/oschina/gitee",
        "git_http_url": "https://gitee.com/oschina/gitee.git",
        "git_ssh_url": "git@gitee.com:oschina/gitee.git",
        "git_svn_url": "svn://gitee.com/oschina/gitee",
        "homepage": null,
        "stargazers_count": 11,
        "watchers_count": 12,
        "forks_count": 0,
        "language": "ruby",
        "has_issues": true,
        "has_wiki": true,
        "has_pages": false,
        "license": null,
        "open_issues_count": 0,
        "default_branch": "master",
        "namespace": "oschina",
        "name_with_namespace": "开源中国/Gitee",
        "path_with_namespace": "oschina/gitee"
      }
    },
    "base": {
      "label": "gitee:master",
      "ref": "master",
      "sha": "7324ba0e3f19236bf4ddc6003168fbddf8f723a5",
      "user": {
        "id": 1,
        "login": "robot",
        "avatar_url": "https://gitee.com/assets/favicon.ico",
        "html_url": "https://gitee.com/robot",
        "type": "User",
        "site_admin": false,
        "name": "robot",
        "email": "robot@gitee.com",
        "username": "robot",
        "user_name": "robot",
        "url": "https://gitee.com/robot"
      },
      "repo": {
        "id": 120249025,
        "name": "Gitee",
        "path": "gitee",
        "full_name": "开源中国/Gitee",
        "owner": {
          "id": 1,
          "login": "robot",
          "avatar_url": "https://gitee.com/assets/favicon.ico",
          "html_url": "https://gitee.com/robot",
          "type": "User",
          "site_admin": false,
          "name": "robot",
          "email": "robot@gitee.com",
          "username": "robot",
          "user_name": "robot",
          "url": "https://gitee.com/robot"
        },
        "private": false,
        "html_url": "https://gitee.com/oschina/gitee",
        "url": "https://gitee.com/oschina/gitee",
        "description": "",
        "fork": false,
        "created_at": "2018-02-05T23:46:46+08:00",
        "updated_at": "2018-02-05T23:46:46+08:00",
        "pushed_at": "2018-02-05T23:46:46+08:00",
        "git_url": "git://gitee.com:oschina/gitee.git",
        "ssh_url": "git@gitee.com:oschina/gitee.git",
        "clone_url": "https://gitee.com/oschina/gitee.git",
        "svn_url": "svn://gitee.com/oschina/gitee",
        "git_http_url": "https://gitee.com/oschina/gitee.git",
        "git_ssh_url": "git@gitee.com:oschina/gitee.git",
        "git_svn_url": "svn://gitee.com/oschina/gitee",
        "homepage": null,
        "stargazers_count": 11,
        "watchers_count": 12,
        "forks_count": 0,
        "language": "ruby",
        "has_issues": true,
        "has_wiki": true,
        "has_pages": false,
        "license": null,
        "open_issues_count": 0,
        "default_branch": "master",
        "namespace": "oschina",
        "name_with_namespace": "开源中国/Gitee",
        "path_with_namespace": "oschina/gitee"
      }
    },
    "merged": false,
    "mergeable": null,
    "comments": 0,
    "commits": 1,
    "additions": 7,
    "deletions": 0,
    "changed_files": 1
  },
  "author": {
    "id": 1,
    "login": "robot",
    "avatar_url": "https://gitee.com/assets/favicon.ico",
    "html_url": "https://gitee.com/robot",
    "type": "User",
    "site_admin": false,
    "name": "robot",
    "email": "robot@gitee.com",
    "username": "robot",
    "user_name": "robot",
    "url": "https://gitee.com/robot"
  },
  "sender": {
    "id": 1,
    "login": "robot",
    "avatar_url": "https://gitee.com/assets/favicon.ico",
    "html_url": "https://gitee.com/robot",
    "type": "User",
    "site_admin": false,
    "name": "robot",
    "email": "robot@gitee.com",
    "username": "robot",
    "user_name": "robot",
    "url": "https://gitee.com/robot"
  },
  "enterprise": {
    "name": "开源中国",
    "url": "https://gitee.com/oschina"
  }
}
```

##### 评论钩子

以下是一次评论任务操作触发的钩子数据，其中 `notable_type` 表示评论的不同类型： Comment(项目评论)、Commit、PullRequest、Issue

```json
{
  "hook_name": "note_hooks", 
  "password": "pwd"，
  "comment": {
    "html_url": "https://gitee.com/oschina/gitee/issues/IG6E9#note_1",
    "id": 1,
    "body": "Fixed",
    "user": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "created_at": "2018-02-08T23:46:46+08:00",
    "updated_at": "2018-02-08T23:46:46+08:00"
  },
  "noteable_type": "Issue", 
  "issue": {
    "html_url": "https://gitee.com/oschina/gitee/issues/IG6E9",
    "id": 295024870,
    "number": "IG6E9",
    "title": "IE浏览器，js报错",
    "user": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "labels": [
      {
        "id": 827033694,
        "name": "bug",
        "color": "d73a4a"
      }
    ],
    "state": "open",
    "assignee": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "milestone": {
      "html_url": "https://gitee.com/oschina/gitee/milestones/1",
      "id": 3096855,
      "number": 1,
      "title": "问题反馈",
      "description": null,
      "open_issues": 13,
      "started_issues": 6,
      "closed_issues": 31,
      "approved_issues": 42,
      "state": "open",
      "created_at": "2018-02-01T23:46:46+08:00",
      "updated_at": "2018-02-02T23:46:46+08:00",
      "due_on": null
    },
    "comments": 0,
    "created_at": "2018-02-07T23:46:46+08:00",
    "updated_at": "2018-02-07T23:46:46+08:00",
    "body": "新建任务js报错"
  },
  "repository": {
    "id": 120249025,
    "name": "Gitee",
    "path": "gitee",
    "full_name": "开源中国/Gitee",
    "owner": {
      "id": 1,
      "login": "robot",
      "avatar_url": "https://gitee.com/assets/favicon.ico",
      "html_url": "https://gitee.com/robot",
      "type": "User",
      "site_admin": false,
      "name": "robot",
      "email": "robot@gitee.com",
      "username": "robot",
      "user_name": "robot",
      "url": "https://gitee.com/robot"
    },
    "private": false,
    "html_url": "https://gitee.com/oschina/gitee",
    "url": "https://gitee.com/oschina/gitee",
    "description": "",
    "fork": false,
    "created_at": "2018-02-05T23:46:46+08:00",
    "updated_at": "2018-02-05T23:46:46+08:00",
    "pushed_at": "2018-02-05T23:46:46+08:00",
    "git_url": "git://gitee.com:oschina/gitee.git",
    "ssh_url": "git@gitee.com:oschina/gitee.git",
    "clone_url": "https://gitee.com/oschina/gitee.git",
    "svn_url": "svn://gitee.com/oschina/gitee",
    "git_http_url": "https://gitee.com/oschina/gitee.git",
    "git_ssh_url": "git@gitee.com:oschina/gitee.git",
    "git_svn_url": "svn://gitee.com/oschina/gitee",
    "homepage": null,
    "stargazers_count": 11,
    "watchers_count": 12,
    "forks_count": 0,
    "language": "ruby",
    "has_issues": true,
    "has_wiki": true,
    "has_pages": false,
    "license": null,
    "open_issues_count": 0,
    "default_branch": "master",
    "namespace": "oschina",
    "name_with_namespace": "开源中国/Gitee",
    "path_with_namespace": "oschina/gitee"
  },
  "sender": {
    "id": 1,
    "login": "robot",
    "avatar_url": "https://gitee.com/assets/favicon.ico",
    "html_url": "https://gitee.com/robot",
    "type": "User",
    "site_admin": false,
    "name": "robot",
    "email": "robot@gitee.com",
    "username": "robot",
    "user_name": "robot",
    "url": "https://gitee.com/robot"
  },
  "enterprise": {
    "name": "开源中国",
    "url": "https://gitee.com/oschina"
  }
}
```

#### 码云 `Pages` 是一个免费的静态网页托管服务，您可以使用 码云 `Pages` 托管博客、项目官网等静态网页。如果您使用过 `Github Pages` 那么您会很快上手使用码云的 `Pages`服务。目前码云 `Pages` 支持 Jekyll、Hugo、Hexo编译静态资源。

### Jekyll、Hugo、Hexo 编译判断依据
1. 编译 Hugo 依据：项目编译目录下存在`config.toml|json|yaml`文件和`content`目录的时候，会使用`hugo`生成静态文件。
2. 编译 Hexo 依据：项目编译目录下存在`package.json`，`_config.yml`文件和`scaffolds`目录的，会使用`hexo generate`生成静态文件，由于每次部署编译需要重新克隆编译并进行`npm install`，所以使用 Hexo 的时间相对 Hugo 和 Jekyll 会长一些。
3. 当不符合上述1和2条件的时候，就默认使用Jekyll编译。

### 常见问题
1. 如何创建一个首页访问地址不带二级目录的 pages，如ipvb.gitee.io？

答：如果你想你的 pages 首页访问地址不带二级目录，如ipvb.gitee.io，**你需要建立一个与自己个性地址同名的项目**，如 https://gitee.com/ipvb 这个用户，想要创建一个自己的站点，但不想以子目录的方式访问，想以`ipvb.oschina.io`直接访问，那么他就可以创建一个名字为`ipvb`的项目 https://gitee.com/ipvb/ipvb 部署完成后，就可以以 https://ipvb.gitee.io 进行访问了。

2. 当要部署的项目与自己的个性地址不一致时，部署完成后存在一些资源访问404？

答：当需要部署的项目和自己的个性地址不一致时，如：https://gitee.com/ipvb/blog ，生成的pages url 为 https://ipvb.gitee.io/blog ，而访问的资源404，如 https://ipvb.gitee.io/style.css 。这是因为相应配置文件的相对路径存在问题导致的，生成的资源 url 应该为 https://ipvb.gitee.io/blog/style.css 才对。对于不同的静态资源生成器，配置如下：
     - Hugo 配置文件`config.toml`的baseURL修改如下
       ```
       baseURL = "https://ipvb.gitee.io/blog"
       ```
     - Hexo 配置文件`_config.yml`的`url`和`root`修改如下：
       ```
       url: https://ipvb.gitee.io/blog
       root: /blog
       ```
     - Jekyll 配置文件`_config.yml`的 `baseurl`修改如下：
       ```
       baseurl: "/blog" # the subpath of your site, e.g. /blog
       ```

3. Jekyll 中带有下划线开头文件夹或者文件无法访问，例如：_layouts
   答：需要在项目目录下新建_config.yml，编写：include: [_layouts] 即可。

4. 如何自定义404？
   答：在项目根目录新建 404.html 文件即可。

### 1. 使用前须知

1、项目必须有 index.html 才可以正常访问

2、静态网页的样式可以自己写，也可以拿一些静态模版来修改，`Pages`服务本身不提供任何形式的模版，但我们后续会陆续增加例子，供大家参考使用。

### 2. 一个小白的Pages搭建之旅

#### **A.新建项目 test_pages**

![输入图片说明](https://static.oschina.net/uploads/img/201806/26173338_Pmcg.png "在这里输入图片标题")

点击创建完成项目的创建

#### **B.添加文件 index.html (注意名称是index.html哦！)**

点击新建文件

![输入图片说明](https://static.oschina.net/uploads/img/201806/26172523_5GI8.png "在这里输入图片标题")

文件名输入`index.html`，内容就是简单的`html`

![输入图片说明](https://static.oschina.net/uploads/img/201806/26173106_Jn2d.png "在这里输入图片标题")

点击提交，将文件提交到仓库

#### **C.选择 pages 服务**

![输入图片说明](https://static.oschina.net/uploads/img/201806/26173423_zzeF.png "在这里输入图片标题")

#### **D.选择需要部署的分支，这里选择 Master 启动服务。**

![输入图片说明](https://static.oschina.net/uploads/img/201806/26173508_e3TE.png "在这里输入图片标题")

#### **E.访问生成的网站地址，即可以查看你部署的静态页面啦！**

![输入图片说明](https://static.oschina.net/uploads/img/201806/26173825_h9D1.png "在这里输入图片标题")
![输入图片说明](https://static.oschina.net/uploads/img/201806/26173847_USPU.png "在这里输入图片标题")

### 3. 已经有 Pages 项目如何部署到码云的 Pages

以`jQuery-File-Upload`项目为例，项目地址：https://github.com/blueimp/jQuery-File-Upload

它在Github上的Pages地址是：https://blueimp.github.io/jQuery-File-Upload/

如果想把它转移到码云`Pages`，只需要登录你的码云账户，点击右上角的`+`号，选择新建项目

![输入图片说明](https://static.oschina.net/uploads/img/201806/26174500_j9HQ.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201806/26174556_lc6V.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201806/26174630_Kpri.png "在这里输入图片标题")

然后点击创建，项目会在后台自动导入，导入成功后，点击菜单栏的服务下拉`Gitee Pages`

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175015_PomW.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175207_KKZ0.png "在这里输入图片标题")

这里我们默认的`Pages`服务分支是项目的默认分支，但是你也已选择自己静态页面所在的分支，这里`jQuery-File-Upload`项目的静态页面分支是`gh-pages`，选择`gh-pages`并点击启动服务。

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175333_xxzm.png "在这里输入图片标题")
至此，静态网页已经部署成功，访问提供的地址：https://frech.gitee.io/jquery-file-upload/ 即可查看到`jQuery-File-Upload`项目的静态官网。

![输入图片说明](https://static.oschina.net/uploads/img/201806/26175421_ikZP.png "在这里输入图片标题")

### 4. Pages 进阶，使用 Jekyll、Hugo、Hexo 生成自己的静态网页

Jekyll、Hugo、Hexo 究竟是什么？

Jekyll、Hugo、Hexo 是简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown 以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll、Hugo、Hexo 也可以运行在 码云（Gitee.com） Pages 上，也就是说，你可以使用码云的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

Jekyll 使用文档：https://www.jekyll.com.cn/docs/home/
Hugo 使用文档：https://gohugo.io/documentation/
Hexo 使用文档：https://hexo.io/docs/

> 注意码云新的方案已经不采用issue的id标识issue，而是使用ident。[具体说明查看这里](https://gitee.com/oschina/git-osc/issues/IE5CI)，为了避免手动输入issueident错误的情况，建议直接复制#issueident）

- 说明：
1. 本地推送时，请确保本地配置的邮箱和码云账号的注册邮箱保持一致，才能正确的关联issue
2. 个人版和企业版的区别： 个人项目的commit只能关联该项目的任务；企业项目的commit可以关联企业的所有任务。

- 下面中的issue_ident和issue_url指的是
![输入图片说明](https://static.oschina.net/uploads/img/201806/26162847_Dhiz.png "在这里输入图片标题")

### 1. commit message关联任务
- 关键字： link, linked, linking, relate, related, relating
- 形式： commit message中输入 **link #issue_ident**，**link issue_ident**
- 效果如下
![输入图片说明](https://static.oschina.net/uploads/img/201806/26162010_bnON.png "在这里输入图片标题")

### 2. 通过 commit 关闭任务
- 关键字: close, closes, closing, closed, fixed, fix, resolved
- 形式: commit message中输入： **close #issue_ident**，**close issue_url** 就可以关闭 issue 了。
- 效果图如下
![输入图片说明](https://static.oschina.net/uploads/img/201806/26162643_Rlg2.png "在这里输入图片标题")

### 3. 通过 commit 评论任务
- 关键字： comment, reply
- 形式： commit message中输入： **comment #issueident**， **comment issue_url** ， 就可以评论 issue 了。
- 效果如下：
![输入图片说明](https://static.oschina.net/uploads/img/201806/26162619_VN49.png "在这里输入图片标题")

### 转移已有组织至企业账号

组织账号是为了满足大型开源团队的需要，不适合企业/团队管理其内部的私有项目，为了明确私有项目的归属权和保证私有项目的安全性，强烈建议企业团队使用码云企业版来管理内部私有项目。

登陆码云账号，在导航栏选择“我的码云”，进入到需要转移的组织主页。

![输入图片说明](https://static.oschina.net/uploads/img/201803/05174130_d19j.png "在这里输入图片标题")

进入组织的主页，点击右上角的“转移至企业”

![输入图片说明](https://static.oschina.net/uploads/img/201803/05174641_rEc3.png "在这里输入图片标题")

点击按钮后会出现如下所示内容，按照提示信息生成转移码。

![输入图片说明](https://static.oschina.net/uploads/img/201803/05174848_ztlp.png "在这里输入图片标题")

进入企业工作台界面，在左侧栏点击「项目」。

![输入图片说明](https://static.oschina.net/uploads/img/201807/09183113_LLFQ.png "在这里输入图片标题")

在右边出现的界面中，选择「添加项目」-「转移项目」。

![输入图片说明](https://static.oschina.net/uploads/img/201807/09183540_9tpx.png "在这里输入图片标题")

在弹出的窗口点击「生成转移码」-「复制」。

![输入图片说明](https://static.oschina.net/uploads/img/201807/09183738_Ezr2.png "在这里输入图片标题")

![输入图片说明](https://static.oschina.net/uploads/img/201807/09183912_lJjJ.png "在这里输入图片标题")

将生成的转移码填写完毕后，点击“下一步”，会出现被转移到的企业信息，这里需要勾选下图所示的对勾，然后点击“确认转移”。

![输入图片说明](https://static.oschina.net/uploads/img/201803/05175815_TBi2.png "在这里输入图片标题")

转移成功后，右上角会有提示信息。

![输入图片说明](https://static.oschina.net/uploads/img/201803/05180106_tERm.png "在这里输入图片标题")

如果您现在还没有企业账号，请先根据您的需求选择不同的升级为企业账号的方案。

- 全新的企业账号，与个人账号分隔：http://git.mydoc.io/?t=215159
- 已有组织账号升级为企业账号：http://git.mydoc.io/?t=265543
- 已有个人账号升级为企业账号：http://git.mydoc.io/?t=262490

如果您已有企业账号，想要升级为付费版本（企业标准版及其以上版本），请先登录账号，点击“我的码云”，选择需要升级的企业。

![输入图片说明](https://static.oschina.net/uploads/img/201803/12161806_YDYc.png "在这里输入图片标题")

在出现的企业个人工作台界面的左侧栏点击“功能”，进入企业管理后台。

![输入图片说明](https://static.oschina.net/uploads/img/201803/12161702_54Ga.png "在这里输入图片标题")

在企业管理界面中，点击“升级/续费”

![输入图片说明](https://static.oschina.net/uploads/img/201803/12162424_DAfq.png "在这里输入图片标题")

在升级/续费页面，选择您所需要的企业套餐类型，以及购买的年数，然后点击“购买”，跳转到支付页面。

![输入图片说明](https://static.oschina.net/uploads/img/201803/12162836_qpwD.png "在这里输入图片标题")

**注意：这里的优惠码仅限于码云新注册用户或码云线上优惠活动期间才可使用，数量有限。**

在支付页面中，根据您的实际支付情况来选择支付方式。

![输入图片说明](https://static.oschina.net/uploads/img/201803/12163204_1lNU.png "在这里输入图片标题")

#### 这里需要强调说明下“线下支付”的问题。

线下对公转账时，需按照下图所示的账户信息进行转账（以该网页上所显示的账户信息为准）。转账完毕后，敬请上传银行的电子回执单以便于工作人员及时给您核对。最后，关于对公转账开具发票的注意事项页面中也有说明，敬请知悉。

![输入图片说明](https://static.oschina.net/uploads/img/201803/12163402_mGuJ.png "在这里输入图片标题")

-------------------

### 企业账号发票开具流程：http://git.mydoc.io/?t=227873
### 查看发票快递信息：http://git.mydoc.io/?t=266896

##在码云平台注册以及创建第一个项目

###注册账号

首先是在码云平台注册，注册链接请点解[这里](https://git.oschina.net/signup)如下图：

![码云注册](https://static.oschina.net/uploads/img/201704/01151716_Q7lu.jpg "码云注册")

依次填入各项，需注意的是：邮箱最好填写国内的邮箱，以免因为众所周知的原因无法接收激活邮件，**个性地址一经选定，无法修改，请慎重填写。**

我们会向您的邮箱发送一份激活邮件，请点击其中的链接激活账号，账号激活后，注册流程就算完成了，接下来就是创建第一个项目了

###创建项目

点击右上角的![输入图片说明](https://static.oschina.net/uploads/img/201704/01152036_vITZ.jpg "在这里输入图片标题")或者![输入图片说明](https://static.oschina.net/uploads/img/201704/01152303_3MMo.jpg "在这里输入图片标题")，跳转至项目创建页面：

![输入图片说明](https://static.oschina.net/uploads/img/201704/01152603_Zb3l.jpg "在这里输入图片标题")

依次填写各项信息然后点击创建就可以了，这样我们一个项目就创建好了如果没有意外，你将看到这个页面:

![输入图片说明](https://static.oschina.net/uploads/img/201704/01152726_Wux6.jpg "在这里输入图片标题")

这样，我们在码云平台就创建好了一个项目

###本地初始化一个项目

首先，你需要执行下面两条命令，作为 git 的基础配置，作用是告诉 git 你是谁，你输入的信息将出现在你创建的提交中。

```
git config --global user.name "你的名字或昵称"
git config --global user.email "你的邮箱"
```

然后在你的需要初始化版本库的文件夹中执行：

```
git init 
git remote add origin <你的项目地址> //注:项目地址形式为:http://git.oschina.net/xxx/xxx.git或者 git@git.oschina.net:xxx/xxx.git
```

这样就完成了一次版本你的初始化。

如果你想克隆一个项目，只需要执行：

```
git clone <项目地址>
```

###完成第一次提交

进入你已经初始化好的或者克隆项目的目录，然后执行：

```
git pull origin master
<这里需要修改/添加文件，否则与原文件相比就没有变动>
git add .
git commit -m "第一次提交"
git push origin master
```

然后如果需要账号密码的话就输入账号密码，这样就完成了一次提交。

此时，你可以在你的个人面板、项目主页查看到你的提交记录，例如：http://git.oschina.net/oschina/git-osc/commit/f3dd1c5bae48fa4244e2595a39e750e5606dd9be](http://git.oschina.net/oschina/git-osc/commit/f3dd1c5bae48fa4244e2595a39e750e5606dd9be

按照本文档新建的项目时，在码云平台仓库上已经存在 readme 文件，故在提交时可能会存在冲突，这时您需要选择的是保留线上的文件或者舍弃线上的文件，如果您舍弃线上的文件，则在推送时选择强制推送，强制推送需要执行下面的命令：

```
git push origin master -f
```

如果您选择保留线上的 readme 文件，则需要先执行：

```
git pull origin master
```

然后才可以推送，如果发生冲突，则需要先解决冲突，关于如何处理冲突，请参阅[如何处理代码冲突](http://git.mydoc.io?v=16912&t=66902)这一小节。

Pull Request 是两个仓库提交变更的一种方式，通常用于 fork 项目与被 fork 项目的差异提交，同时也是一种非常好的团队协作方式，下面，就来讲解如何在码云平台提交 Pull Request：

PS：码云平台限制 Pull Request 源项目与目标项目需存在 fork 与被 fork 关系，故如果你要提交 Pull Request，必须先 fork 一个项目，然后才能对该项目提交 Pull Request，同时，以该项目为父项目的所有项目，您也均可以提交 Pull Request。

###如何 fork 项目

fork 项目时非常简单的，进到项目页面，然后找到右上角的 fork 按钮，点击后再次点击确定，等待系统在后台完成仓库克隆操作，你就完成了 fork 操作，如图：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11170038_5Rzf.png "在这里输入图片标题")

###如何提交 Pull Request：

首先，您的项目与目标项目必须存在差异，这样才能提交,比如这样：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11164020_j8To.png "在这里输入图片标题")

如果不存在差异，或者目标分支比你提 Pull Request 的分支还要新，则会得到这样的提示：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11164209_LfgW.png "在这里输入图片标题")

然后，填入 Pull Request 的说明，点击提交 Pull Request ，就可以提交一个 Pull Request 了，就想下图所示的那样：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11171413_x7Jh.png "在这里输入图片标题")

###如何对已经存在的 Pull Request 的进行管理

首先，对于一个已经存在的 Pull Request，如果只是观察者，报告者等权限，那么访问将会受到限制，具体权限限制请参考码云平台关于角色权限的内容，下文涉及的部分，仅针对管理员权限，如果您发现不太一样的地方，请检查您的权限是不是管理员或该 Pull Request 的创建者。

####如何修改一个已经存在的 Pull Request

点击 Pull Request 的详情界面右上角的编辑按钮，就会弹出编辑框，在编辑框中修改你需要修改的信息，然后点击保存即可修改该 Pull Request，如下图所示：

![输入图片说明](https://static.oschina.net/uploads/img/201607/11182105_veIB.png "在这里输入图片标题")

请注意，在该界面，可以对 Pull Request 进行指派负责人，指派测试者等等操作，每一个操作均会通知对应的人员

####对 Pull Request 的 bug 修改如何提交到该 Pull Request 中

对于 Pull Request 中的 bug 修复或者任何更新动作，均不必要提交新的 Pull Request，仅仅只需要推送到您提交 Pull Request 的分支上，稍后我们后台会自动更新这些提交，将其加入到这个 Pull Request 中去

####Pull Request 不能自动合并该如何处理

在提交完 Pull Request 的后，在这个 Pull Request 处理期间，由原本的能自动合并变成不能自动合并，这是一件非常正常的事情，那么，这时，我们有两种选择，一种，继续合并到目标，然后手动处理冲突部分，另一种则是先处理冲突，使得该 Pull Request 处于可以自动合并状态，然后采用自动合并，一般来讲，我们官方推荐第二种，即先处理冲突，然后再合并。具体操作为：

先在本地切换到提交 Pull Request 的分支，然后拉取目标分支到本地，这时，会发生冲突，参考[如何处理代码冲突](http://git.mydoc.io?v=16912&t=83148) 这一小节将冲突处理完毕，然后提交到 Pull Request 所在的分支，等待系统后台完成 Pull Request 的更新后，Pull Request 就变成了可自动合并状态。

####Pull Request 不小心合并了，可否回退

对于错误合并的 Pull Request，我们提供了回退功能，该功能会产生一个回退 XXX 的 Pull Request，接受该 Pull Request 即可完成回退动作，注意，回退本质上是提交一个完全相反的 Pull Request，所以，你仍然需要进行测试来保证完整性，另，为了不破坏其他 Pull Request，建议只有需回退的 Pull Request 处于最后一次合并操作且往上再无提交时执行回退动作，否则请手动处理。

> 码云平台提供了 WebHook 触发钩子，定义了5种触发方法，我们可以根据 WebHook 的回调来搭建自动化部署/测试平台，下面给出示例(注:以下给出的是伪代码，并不能实际运行，仅作参考):
首先，我们明确自己的需求:搭建一个自动化部署平台，其需求如下:
- 能做到自动拉取代码
- 自动编译
- 自动更新数据库表结构
- 只更新master分支

这是一个最简单的自动化部署平台需求，下面就来看看怎么实现，需要说明的是，因为是最简单的方案，故没有考虑分布式的架构。

我们来做功能拆分，拆分如下：

#### 代码同步模块
* 正常代码拉取
* 强制推送代码拉取
* 忽略其他分支的代码推送

#### 编译模块
* 正常编译
* 异常编译回滚

#### 部署模块
* 编译文件自动部署
* 重启服务端
* 重启代理工具

#### 日志模块
* 正常情况下日志输出
* 代码拉取失败日志输出
* 编译错误日志输出
* 服务端重启日志输出

现在功能需求定好了，开始进行代码编写，因为这是一个最简单的部署，所以数据量非常小，用文本文件足以，故这里不采用数据来增加系统复杂程度

首先，我们要写一个接口，以便于接收由 WebHook 发出的数据，由于 WebHook 的数据发送方式是 post，故需要一个接收 post 数据的地址。例如：
http://xxx.xxx.com/xxx/xxx/git/post.php 这样一个地址，当然，这个 php 文件具体怎么写就不知道了哈，他的作用只有一条：调用执行预定脚本： auto.sh 并将收到的参数传递给脚本。

然后我们剩下的工作就是写 auto.sh 这个脚本了，我们所有的工作都需要在 auto.sh 这个脚本上完成。

首先，我们来搞定自动拉取代码

```bash
git pull origin master
```

这是正常拉取代码的，但是这条命令需要拉取的分支不存在强制推送状态，故这条命令适用性不够广泛，所以我们要改造一下，改成下面的样子：

```bash
git reset --hard <commit id>
git pull origin master
puts "时间 拉取代码成功，分支为master" >> pull.txt
```

然后我们就搞定了代码拉取的问题，设定好 commit id 任你分支怎么变化怎么强推我都能正常拉取代码。为了正常判断状态，我们将这段代码新建个脚本，命名为 pull_code.sh 然后交给 auto.sh 调用，这样我们就可以在 auto 中写上判断条件来判断脚本执行成功还是失败，这样便于日志输出

实际上，这里只做到拉取 master 分支的代码，我们可以将这段代码改改，将分支名作为参数，然后加上 checkout 语句，就可以拉取任意分支了，比如这样：

```bash
git checkout 分支名（参数，外部传递）
git reset --hard <commit id>
git pull origin  分支名
```

至于 commit id 从配置文件中读出来就行了，然后就变成了可以部署其他分支的代码了。到这里，拉取代码的部分就算完成了。

接下来是自动编译部分，同样，基于扩展性需求，我们可以将它做成一个脚本，已编译 rails 应用为例，我们一般需要编译资源执行如下命令：

```bash
bundle exec rake assets:precompile RAILS_ENV=production
```

所以我们将这条命令写成脚本，命名为：compile.sh 同样，编译部分就完成了，其他语言按照其他语言格式将执行的命令写入到脚本中去，然后等待 auto.sh 的调用即可

部署模块同样的操作手法，将需要执行的命令一条一条写入脚本中，等待被调用

然后我们开始写最重要主文件，也就是 auto.sh 脚本（注：以下是伪代码，不具有执行能力，仅提供思路参考）

以下是伪代码：

```
开始接受参数：params

解析参数，需要：分支信息 commit信息

根据分支信息和 commit 信息判断是否需要更新，如果无需更新，结束

需要更新，开始切换用户，获取更新权限，写入参数到文本文件中，避免因切换参数导致参数丢失

从文本文件中读取参数，调用 pull_code.sh 脚本，同时传递分支参数

接收 pull_code.sh 脚本执行结果，开始根据执行结果打印日志，同时保存执行结果到变量 code

根据变量 code 的值判断代码拉取是否成功，判断是否需要编译资源，同时打印日志

调用部署脚本，开始执行部署操作

日志部分开始工作，对每次执行结果进行记录

汇总日志部分，开始分析是否可以重新启动服务（热启动或其他）

开始清理除日志之外的中间文件，清理工作目录

执行完成
```

以上就是一个最简单的利用 WebHook 进行自动化部署的案例，其原理是先用钩子触发回调，拿到更新信息，然后调用预先定义好的自动化部署脚本进行部署，最后完成操作

现在 **码云** 目前支持使用 Subversion 对仓库进行操作，以下是使用指南和注意事项。

## 使用前注意

1. 仓库体积超过 300 MB 不建议使用 Subversion 操作仓库，存储库容量达到 400 MB，或者 300 MB 并且存储大量非文本数据时，我们将关闭仓库的 Subversion 支持。  
2. 由于 GIT 不支持空目录的提交，在存储机器上，无论是普通仓库还是开启 Subversion 接入的仓库存储时都是 GIT 仓库，Subversion 的 commit 是提交到 git 仓库上的，所以码云的 Subversion 不支持空目录的提交。  
3. 第一次开启 Subversion， 操作一个仓库，如果仓库体积较大或者提交次数较多，由于缓存的缘故，响应时间会比较长。  
4. 不支持 Subversion 的 Hook 机制，请使用 WebHook 替代。
5. Subversion 属性不完全支持。  
6. 客户端需要开启 SASL 支持，不支持的客户端无法访问。  
7. 部分 svn 命令不支持。可以查看 **Subversion 客户端的兼容性**   
8. 版本号的映射，目前 Subversion 的版本号计算依据为本分支所有的 commit 数目减一 不包括 merge ，如果使用了在 git 中强制回退等操作，请重新检出。

*WARNING:*   
>由于 git 在设计上就没有考虑空文件 [Kernel.org: Git FAQ](https://git.wiki.kernel.org/index.php/GitFaq#Can_I_add_empty_directories.3F)

>我们设计的原则就是不破坏，不主动修改用户的仓库，我们的后端存储的完全是一个 git 仓库，如果我们添加了，一次提交内容也不会一致了，建议你在添加目录的时候添加 .keep 之类的占位文件，空文件即可。

>Git 与 SVN 混用时尽量不要使用 Git 强制推送。[Git 与 SVN 混用注意事项](https://git.mydoc.io/?t=122635)

## 关于改版 
Subversion 功能的最终解释权归 OSChina.NET 所有。Subversion 接入的规则可能在下一次改版中发生改变。

## 开启方式
在项目的设置界面开启

![undefined](http://git.oschina.net/uploads/images/2015/0324/182035_d23abb99_62561.png)

如果是空仓库：     
![emptyrepo](https://static.oschina.net/uploads/img/201506/16185355_IYvK.png "开启空仓库的支持")

## 使用指南    
码云 支持的是 svn 协议。  对于 svn 而言，获取一个仓库的代码通常是 checkout，在项目主页我们通常可以获得 URL：    
![svn-url](http://static.oschina.net/uploads/space/2015/0318/152207_DRMJ_139664.png)   
这个仓库地址为：

``` 
svn://git.net/svnserver/newos
```

### 1.获取仓库代码：   
 
```sh
svn checkout svn://git.net/svnserver/newos newos
```

**注意信息** 码云的 SVN 接入后端是通过 git 存储库实现，URL 规则为 svn://域名/用户名/项目名 .

使用上述命令，我们将得到项目默认分支的代码。并将本地的工作目录命名为 *newos*   
如果最后不带 newos，svn 默认把本地工作目录命名为 SVN-URL 的最后一个目录名，这里是 *newos*    
 
```
svn checkout svn://git.net/svnserver/newos
```

如果要获得任意分支代码，请输入近似如下的命令：
     
```sh
svn checkout svn://git.net/svnserver/newos/branches/update newosupdate
```

特别的说明，获取主干分支，也就是 master 分支可以使用下面的分支格式   
 
```sh
svn checkout svn://git.net/svnserver/newos/trunk newos
```

svn trunk 分支对应 master 分支 用户应当尽量不使用下面格式     
```sh
svn checkout svn://git.net/svnserver/newos 
```

## 操作说明

如果部分检出仓库，并且仓库根目录下包含 branches/tags/trunk 这样的目录，请使用完整的路径 layout，如下：

```
svn://git.net/example/example/trunk/tags/hello
svn://git.net/example/example/branches/dev/trunk
svn://git.net/example/example/branches/dev/branches 
```

如果没有 master 分支，也就没有 trunk 分支，检出的 URL 不能省略分支名。比如只有一个 dev 分支,必须使用下列格式，否则会提示仓库不存在。

```
svn co svn://git.net/svnserver/newos/branches/dev  svnserver_dev  
```

打开终端,输入上述命令，出现以下下面提示。其中第一个认证领域是用户的密码，这个可以留空。而用户名是用户在码云（Gitee.com）登陆时使用`邮箱地址`。密码则是用户登陆 码云 所使用的密码。

一般而言，svn 会加密缓存用户的用户名密码，所以，对仓库的操作只需要第一次输入用户邮箱和密码。

清除密码缓存，用户目录下的 .subversion/auth/svn.simple 文件夹下的文件。

![image](http://static.oschina.net/uploads/space/2015/0318/153828_ptt4_139664.png)

下图则是成功的拉取了项目代码。

![image](http://static.oschina.net/uploads/space/2015/0318/154033_aySS_139664.png)

查看本地工作目录信息：

```sh
svn info
```
![svninfo](http://static.oschina.net/uploads/img/201503/18161038_vF3E.png )
```
cd helloworld
echo "#SVN Options ReadMe.md">SVNReadMe.md
#svn add SVNReadMe.md
#svn add * --force类似于git add -A
svn add * --force
svn update .
svn commit -m "first svn commit"
```
Subversion 在提交前建议先使用 svn update 更新工作拷贝。也就相当于 git pull 后再 git push。
Subversion 的提交是在线的，如果机器已经离线，那么提交会失败，这个过程用git的方式理解就是 git commit+git push。
用户使用 svn 提交代码同样会有动态显示。

列出版本库中的目录内容:

```
svn list svn://git.net/svnserver/newos/trunk
```

导出仓库指定分支的所有文件，不含版本控制信息：

```
svn export svn://git.net/svnserver/newos/trunk newos
```

## 备注   
### 安装 Subversion 客户端

在 Apache 基金会的 Subversion 官网：

[http://subversion.apache.org](http://subversion.apache.org)

二进制下载提示页面：

[http://subversion.apache.org/packages.html](http://subversion.apache.org/packages.html)

#### Windows 系统：

与资源管理起集成的 SVN 客户端：[TortoiseSVN](http://tortoisesvn.net/downloads.html),通常被叫做"海龟"，为 msi 安装包。可以使用 [ExtractMSI](http://pan.baidu.com/s/1szHIn) 解压缩。

很诡异的是，在 Apache 上并没有推荐 TortoiseSVN。

另外还有 SlikSVN，下载地址：[https://sliksvn.com/download/](https://sliksvn.com/download/)

其他的也就不一一介绍了。

#### Linux 系统

一般而言 Linux 系统自带的包控制软件能够安装 Subversion，如果版本低于1.8，就建议用户下载预编译的二进制或者自己动手编译 Subversion。这里不做过多说明。

#### OS X

XCode 自带的 Subversion 版本为1.7.x，太老，而码云（Gitee.com）只支持1.8以上的 SVN 客户端。

如果安装了 Homebrew

```sh
brew install subversion
```

或者使用WANdisco的预编译版本

[http://www.wandisco.com/subversion/download#osx](http://www.wandisco.com/subversion/download#osx)

### Subversion 客户端的兼容性

我们支持 Apache Subversion 1.8 或者更高的版本，当你安装一个 Subversion 客户端时，如果错误提示是“无法协商验证验证方式” 请确保你的客户端支持 SASL 验证，比如在 Ubuntu 上，你可以安装 libsasl2-dev 然后编译 Subversion, 这样的话客户端是支持 SASL 验证的。
 
>sudo apt-get install libsasl2-dev
                                                                            
当你使用 svnkit 或者 SubversionJavaHl 这类 IDE 集成客户端，请确保支持 SASL 验证。

### 关于 GIT 与 SVN 的转换

如果用户存在一个基于 Subversion 托管的项目，要迁移到码云（Gitee.com），可以使用 git-svn 将项目转变为基于 git 的仓库，然后推送到码云（Gitee.com），这样你依然能够使用SVN对项目进行操作。请记得先在码云（Gitee.com）上新建一个项目

```
 git svn clone http://myhost/repo -T trunk -b branches -t tags 
 git remote add oscgit https://git.oschina.net/user/repo
 git push -u oscgit --all
```

通常来说，如果本地存在 SVN 仓库，则可以：

```
git svn clone file:///tmp/svn-repo -T trunk -b branches -t tags 
git remote add oscgit https://git.oschina.net/user/repo
git push -u oscgit  --all
```

将项目转移到 码云（Gitee.com）上以后，使用 svn 命令 checkout 即可对项目进行操作。

高级指南：
[http://git-scm.com/book/zh/ch8-2.html](http://git-scm.com/book/zh/ch8-2.html)

### 安装 git，git-svn
#### Windows
msysgit 官网 [http://msysgit.github.io/](http://msysgit.github.io/),版本比较低。     
    
Github for Windows 提供的 git 工具和 msysgit 一致。  
   
MSYS2 git 下载地址: [http://sourceforge.net/projects/msys2](http://sourceforge.net/projects/msys2)，然后启动终端,安装 git，目前版本为2.4.3。

```
pacman -S git
```

Cygwin git 下载地址: [http://www.cygwin.com/](http://www.cygwin.com/),然后使用包管理软件或者直接下载 git 源码编译 git。

```sh
make configure
./configure --prefix=/usr/local
make 
make install 
```
#### Linux

有包管理器的直接用包管理器安装。

如 Ubuntu

```sh
sudo apt-get install git git-svn
```
也可以手动编译。

#### Mac OSX

下载地址：[http://git-scm.com/download/mac](http://git-scm.com/download/mac)

###一、如何贡献于开源项目

[1、如何向开源软件贡献自己的力量 ](http://www.oschina.net/translate/contribute-to-opensource)

> “我想向开源社区贡献源码，但是该怎么做呢？”我经常看见很多很多学生在很多论坛里问这个问题。有很多种方式可以贡献源码，我列出了很多，希望能够对你们有多帮助。

[2、不用写代码，你也能为开源作出贡献](https://my.oschina.net/editorial-story/blog/837992)

> 开源项目在国外已经成为了一股热潮，已经开始影响到日常生活的方方面面，可是在中国，开源项目的使用者不少，贡献者却寥寥无几，但同时有很多人想要参加开源项目，却总是不得其门而入……无论你是久经沙场的编程老手还是初入门道的技术小白，或者压根就不是一个程序猿，都有不写代码而为开源项目作出贡献的方法。

[3、开源项目贡献者行为准则](https://my.oschina.net/ljzn/blog/732450)

> 作为该项目的贡献者和维护者，我们希望培养一个开放，友善的社区，我们承诺:尊敬任何通过报告提案，发布特性需求，更新文档，提交pull请求或补丁，以及其它任何活动来进行贡献的人.

###二、如何开启开源项目

[1、如何开始一个新的开源项目](https://www.oschina.net/translate/starting-open-source-project?lang=chs&page=1#)

> 这一段时间， 好像很多人写了一代代码加上一段开源软件协议， 再把它发布到GitHub， 然后就说: "我把它开源了". 创建一个开源项目并不仅仅是让你的代码可以自由的被访问获取。
> 如何开始呢？

[2、向开源社区贡献模块的经验分享](https://www.oschina.net/question/554557_120351)

> 2007年的时候，我曾经在CPAN上发布了几个Perl模块，至今我的名字一直是Perl模块作者中几十个中文名字的其中一个，在Google中搜索我的名字，CPAN上的页面也一直有较高的关联度。

> 向开源社区贡献模块是一个熟悉国外软件开发流程，完善代码规范的过程，对于把自己训练成更专业的软件开发者很有帮助。

[3、我如何在OSC上做开源项目](https://my.oschina.net/u/134395/blog/523214)

> - 在 OSC 上如何做开源项目和利用开源项目赚钱？
> - 如何做开源软件？
> - 大家都明白，所以重点是在如何利用开源软件赚钱。

[4、寻找 TODOs：向开源项目贡献的一些建议](https://www.oschina.net/news/26465/find-the-todos-in-opensource-project)

> TODO 和 Bug 不一样。Bug一般是由用户提交的，外部可见的一些问题。而TODO一般是开发者自己标记的，代码中可以改进的地方，由于时间关系没有来得及做。

###三、为开源项目寻找参与者

[1、吸引学生为你的开源项目贡献代码的九招秘诀](http://os.51cto.com/art/201509/491366.htm)

###四、建立开源欢迎社区

[1、如何建立开源社区](http://www.kaiyuanshe.cn/article/57.html)

> 社区就是有共同兴趣的一群人。开源项目和闭源项目都有用户社区，大部分用户不会积极地与社区其他成员互动。而另一方面，无论是开源社区还是闭源社区，都会有成员愿意更积极地参与，例如，报告 bug、帮助其他用户、撰写文档或进行推广。

###五、如何做好开源项目的维护者

[1、怎样维护成功的开源项目](http://www.csdn.net/article/2013-07-03/2816085-How-to-maintain-a-successful-open-source-project)

> 开源项目和普通产品一样，想要取得成功并非易事。流行的开源 Python 库 urllib3 的作者 Andrey Petrov 是总结了自己五年来的经验，写好介绍下文字、对待用户和贡献者的态度、合作和营销意识都至关重要。

[2、成为流行开源项目的维护者 你是如何一步步进“坑”的 ？](https://www.sdk.cn/news/4066)

> 我们都清楚，开源的价值越来越高。我谈到了作为一名开源维护人员，你将会经历的各种情绪，但是对于你的职业生涯来说，维护开源项目将会给你带来巨大的回报。

###六、如何领导和治理开源社区

[1、自由开源社群治理之道](https://linux.cn/article-7436-1.html)

注：以上内容为文章作者

# Git LFS 是什么

Git LFS 即 Git Large File Storage （大文件存储），即将存储库中体积较大修改不太频繁的文件转移到 LFS 服务器上存储。在 2015 年由 Github 推出。

关于 Git LFS 的技术原理，大家可以在网络搜索，或者去 https://github.com/git-lfs/git-lfs 查看。

# 如何在 Gitee 上 使用 LFS

由于 Git LFS 需要大量的带宽和存储需求，因此目前 LFS 仅开放给付费企业用户。因此，当您需要在码云上使用 Git LFS 时，需要确保您的项目是属于付费企业。

## 安装 Git LFS

如果您当前的操作系统是 Windows，要使用 Git LFS 非常简单，把您的 Git for Windows 客户端升级到最新版本即可。如果是 macOS 或者 Linux 用户，那麻烦您自己去 [https://github.com/git-lfs/git-lfs/releases](https://github.com/git-lfs/git-lfs/releases) 下载 git-lfs 程序. 当然，在这之前您得安装好 git。

Linux 用户：

```sh
wget https://github.com/git-lfs/git-lfs/releases/download/v2.5.1/git-lfs-linux-amd64-v2.5.1.tar.gz
tar -xvf git-lfs-linux-amd64-v2.5.1.tar.gz
cd git-lfs-linux-amd64-v2.5.1
sudo ./install.sh
git lfs version
```

macOS 用户或许可以使用 `brew` 安装。

## 在 Gitee 上创建项目

创建一个项目，选择项目的所有者为付费企业用户，或者是付费企业用户下的组织。

## Git LFS 操作

Git LFS 存储库和普通的 git 存储库是一致的，只有当您的项目中有文件被 Git LFS track 时，才会出现一些差异。

将文件纳入 Git LFS 管理。

已知一个图片设计文件路劲为为 `resources/logo.psd` 将其纳入 git lfs 管理

```sh
git lfs track resources/logo.psd
```
然后按照正常的 git 操作流程即可，在 运行 `git push` 的时候会被推送到远程 LFS 服务器，Pull 时会按需从 LFS 服务器下载。而 diff merge 等操作由 git lfs 管理。

## Git LFS lock

Git LFS 目前可以设置 lock 防止其他用户对特定路径的文件进行修改。

```sh
# 对路径上锁
git lfs lock resources/logo.psd

# 查看存储库的锁
git lfs locks

# 解除锁定
git lfs unlock resources/logo.psd
# 或者
git lfs unlock --id=lockid
```

## Git LFS 授权

在使用 Git LFS 的时候，如果没有设置凭据管理器保存密码，您可能需要多次输入密码，这是正常情况，因此不必担忧。

###仓库
在 Git 的概念中，仓库，就是你存在`.git`目录的那个文件夹内的所有文件，包括隐藏的文件，Git程序会在当前目录以及上级目录查找是否存在`.git`文件，如果存在，则会将`.git`目录存在的文件夹开始下的所有文件当成你需要管理的文件，所以，我们如果想将某个文件夹当做一个Git仓库，你可以在那个文件夹下通过终端(Window为Cmd或者PoewrShell或者Bash)来执行
```bash
git init
```
这样，你所期望的那个文件夹就成为了一个Git管理的仓库了

###版本
严格来讲，Git并不存在版本的概念，但人们也硬是发展出了这么个玩意，在Git中，计数基础是提交，即我们常说的Commit，我们每做一点更改便可以产生一次提交，当提交累计起来，可以作为产品定型时，就在当前的Commit上打上一个标记，将这个标记我们称之为版本多少多少，那么就算完成了一个版本，标记本身被称之为Tag，请注意，在Git中，版本仅仅只是某一个提交的标签，并没有其他意义，Git本身也仅有打标签的功能，并没有版本功能，版本功能是根据Tag来扩展的，Git本身并没有

###分支
这是Git中最重要的也是最常用的概念和功能之一，分支功能解决了正在开发的版本与上线版本稳定性冲突的问题在Git使用过程中，我们的默认分支一般是Master，当然，这是可以修改的，我们在Master完成一次开发，生成了一个稳定版本，那么当我们需要添加新功能或者做修改时，只需要新建一个分支，然后在该分支上开发，完成后合并到主分支即可

###提交
提交在Git中同样是非常重要的概念，Git对于版本的管理其实是对于提交的管理，在整个Git仓库中，代码存在的形式并不是一分一分的代码，而是一个一个的提交，Git使用四十个字节长度的16进制字符串来标识每一个提交，这基本保证了每一个提交的标识是唯一的，然后通过组织一个按照时间排序的提交列表，就组成了我们所说的分支，请注意，分支在本质上只是一个索引，所以，我们可以任意回退，修正，即使因为某些原因丢失了，也可以重建另外，关于Git的储存方式:Git是仅仅只储存有修改的部分，并不会储存整个文件，所以，请不要删除文件夹整个文件夹的内容，除非你确定你不再需要他，否则请勿删除

###同步
同步，也可以称之为拉取，在Git中是非常频繁的操作，和SVN不同，Git的所有仓库之间是平等的，所以，为了保证代码一致性，尽可能的在每次操作前进行一次同步操作，具体的为在工作目录下执行如下命令:
```bash
git pull origin master
```
其中`origin`代表的是你远程的仓库，可以通过命令 `git remote -v` 查看，`master`是分支名，如果你本地是其他分支，请换成其他分支的名字，另，因为远程仓库与你本地仓库可能存在冲突，故当存在冲突时，请参考进阶篇的如何处理冲突

###推送
和拉取一样，也是一个非常频繁的操作，当你代码有更新时，你需要更新到远程仓库，这个动作被称之为推送，执行的命令与拉取一样，只是将其中的`pull`这个单词改成`push`，同样，如果远程仓库存在你本地仓库没有的更新，则在推送前你需要先进行一次同步，如果你确定你不需要远程的更新，则在推送时加上 `-f` 选项，则可以强制推送，注:在协同开发中，我并不建议这么做，因为这样很可能覆盖别人的代码

推送代码示例:
```bash
git push origin master
```

强制推送代码示例:
```bash
git push origin master -f
```
###冲突
在使用Git开发时，如果只是一个人使用，那么基本不会产生冲突，但是在多人合作开发的情况下，产生冲突是很正常的一件事情，关于如何处理冲突，请参考进阶篇的[如何处理代码冲突](http://git.mydoc.io?v=16912&t=83148) 这一小节

###合并
合并这个命令通常情况下是用于两个分支的合并，一般用于本地分支，远程分支多用Pull命令，该命令的功能是将待合并分支与目标分支合并在一起，注意，这个命令只会合并当前版本之前的差异，两个分支的提交历史会根据提交时间重新组织索引，故只可能会产生一次冲突但是会生成一个提交，如果你不想生成这次提交，加上 `--base`参数即可

###暂存
这个既是一个概念也是一个命令，其含义就是字面上的，作用就是可以将你当前正在进行的工作暂时存起来，然后在此基础上干别的事情，等你别的事情干完后，再转回来继续，注意，暂存只是针对你最后一次改动而言，即针对当前所在的版本的所有改动都算具体执行命令为:
#####将当前改动暂存起来:
```bash
git stash
```
#####恢复最后一次暂存的改动
```bash
git stash pop
```
#####查看有多少暂存
```bash
git stash list
```

###撤销
撤销命令使用是非常频繁的，因为某些原因，我们不再需要我们的改动或者新的改动有点问题，我们需要回退到某个版本，这时就需要用到撤销命令，或者说这个应该翻译成重置更加恰当。具体命令如下:
#####撤销当前的修改:
```bash
git reset --hard
```
请注意:以上命令会完全重置你的修改，如果你想保留某些文件，请使用checkout +文件路径 命令来逐一撤销修改

#####如果你想重置到某一版本，可以将 `--hard` 改为具体的Commit的id如:
```bash
git reset 1d7f5d89346
```
请注意，这时你的修改仍然存在，只是你的最近一次提交的版本号变成了你要重置的版本，如果说你想完全丢弃修改，只需要加上 --hard参数就可以

#####这里解释的只是一些工作中经常用到的git的基本概念，名词，并不包含Git的所有名词，概念解释，故本文未提到之处请自行使用搜索引擎搜索;另:文档编撰者尽可能的寻找标准的解释，因结果来自于互联网，如果解释有错漏之处，烦请指出并给出正确的解释，谢谢
#####另，本文仅提到部分常使用的概念以及命令，但Git远远不止这些东西，所以，在本文找不到的内容请自行百度，这里推荐 Git的官方文档(中文和英文均有，由官方以及志愿者维护):<http://git-scm.com/book/zh/v2> ，廖雪峰博客:<http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000>

#####注:本节中内容来自 https://git-scm.com/book/zh/v2/Git-工具-重写历史 最终解释权归该页面编撰者所有,本页面仅引用以及对内容进行一定的排版,本文档编撰者对本页面内容无版权

许多时候，在使用 Git 时，可能会因为某些原因想要修正提交历史。 Git 很棒的一点是它允许你在最后时刻做决定。 你可以在将暂存区内容提交前决定哪些文件进入提交，可以通过 stash 命令来决定不与某些内容工作，也可以重写已经发生的提交就像它们以另一种方式发生的一样。 这可能涉及改变提交的顺序，改变提交中的信息或修改文件，将提交压缩或是拆分，或完全地移除提交 - 在将你的工作成果与他人共享之前。

在本节中，你可以学到如何完成这些非常有用的工作，这样在与他人分享你的工作成果时你的提交历史将如你所愿地展示出来。

###修改最后一次提交
修改你最近一次提交可能是所有修改历史提交的操作中最常见的一个。 对于你的最近一次提交，你往往想做两件事情：修改提交信息，或者修改你添加、修改和移除的文件的快照。

如果，你只是想修改最近一次提交的提交信息，那么很简单：
```
 git commit --amend
```
这会把你带入文本编辑器，里面包含了你最近一条提交信息，供你修改。 当保存并关闭编辑器后，编辑器将会用你输入的内容替换最近一条提交信息。

如果你已经完成提交，又因为之前提交时忘记添加一个新创建的文件，想通过添加或修改文件来更改提交的快照，也可以通过类似的操作来完成。 通过修改文件然后运行 git add 或 git rm 一个已追踪的文件，随后运行 git commit --amend 拿走当前的暂存区域并使其做为新提交的快照。

使用这个技巧的时候需要小心，因为修正会改变提交的 SHA-1 校验和。 它类似于一个小的变基 - 如果已经推送了最后一次提交就不要修正它。

###修改多个提交信息
为了修改在提交历史中较远的提交，必须使用更复杂的工具。 Git 没有一个改变历史工具，但是可以使用变基工具来变基一系列提交，基于它们原来的 HEAD 而不是将其移动到另一个新的上面。 通过交互式变基工具，可以在任何想要修改的提交后停止，然后修改信息、添加文件或做任何想做的事情。 可以通过给 git rebase 增加 -i 选项来交互式地运行变基。 必须指定想要重写多久远的历史，这可以通过告诉命令将要变基到的提交来做到。

例如，如果想要修改最近三次提交信息，或者那组提交中的任意一个提交信息，将想要修改的最近一次提交的父提交作为参数传递给 git rebase -i命令，即 HEAD~2^ 或 HEAD~3。 记住 ~3 可能比较容易，因为你正尝试修改最后三次提交；但是注意实际上指定了以前的四次提交，即想要修改提交的父提交：
```
 git rebase -i HEAD~3
```
再次记住这是一个变基命令 - 在 HEAD~3..HEAD 范围内的每一个提交都会被重写，无论你是否修改信息。 不要涉及任何已经推送到中央服务器的提交 - 这样做会产生一次变更的两个版本，因而使他人困惑。

运行这个命令会在文本编辑器上给你一个提交的列表，看起来像下面这样：
```
pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file

# Rebase 710f0f8..a5f4a0d onto 710f0f8
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out
```
需要重点注意的是相对于正常使用的 log 命令，这些提交显示的顺序是相反的。 运行一次 log 命令，会看到类似这样的东西：
```
git log --pretty=format:"%h %s" HEAD~3..HEAD
a5f4a0d added cat-file
310154e updated README formatting and added blame
f7f3f6d changed my name a bit
```
注意其中的反序显示。 交互式变基给你一个它将会运行的脚本。 它将会从你在命令行中指定的提交（HEAD~3）开始，从上到下的依次重演每一个提交引入的修改。 它将最旧的而不是最新的列在上面，因为那会是第一个将要重演的。

你需要修改脚本来让它停留在你想修改的变更上。 要达到这个目的，你只要将你想修改的每一次提交前面的 ‘pick’ 改为 ‘edit’。 例如，只想修改第三次提交信息，可以像下面这样修改文件：
```
edit f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file
```
当保存并退出编辑器时，Git 将你带回到列表中的最后一次提交，把你送回命令行并提示以下信息：
```
 git rebase -i HEAD~3
Stopped at f7f3f6d... changed my name a bit
You can amend the commit now, with

git commit --amend

Once you’re satisfied with your changes, run

git rebase --continue
```
这些指令准确地告诉你该做什么。 输入
```
 git commit --amend
```
修改提交信息，然后退出编辑器。 然后，运行

```
 git rebase --continue
```
这个命令将会自动地应用另外两个提交，然后就完成了。 如果需要将不止一处的 pick 改为 edit，需要在每一个修改为 edit 的提交上重复这些步骤。 每一次，Git 将会停止，让你修正提交，然后继续直到完成。

###重新排序提交
也可以使用交互式变基来重新排序或完全移除提交。 如果想要移除 “added cat-file” 提交然后修改另外两个提交引入的顺序，可以将变基脚本从这样：
```
pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file
```
改为这样：
```
pick 310154e updated README formatting and added blame
pick f7f3f6d changed my name a bit
```
当保存并退出编辑器时，Git 将你的分支带回这些提交的父提交，应用 310154e 然后应用 f7f3f6d，最后停止。 事实修改了那些提交的顺序并完全地移除了 “added cat-file” 提交。

###压缩提交
通过交互式变基工具，也可以将一连串提交压缩成一个单独的提交。 在变基信息中脚本给出了有用的指令：
```
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out
```
如果，指定 “squash” 而不是 “pick” 或 “edit”，Git 将应用两者的修改并合并提交信息在一起。 所以，如果想要这三次提交变为一个提交，可以这样修改脚本：
```
pick f7f3f6d changed my name a bit
squash 310154e updated README formatting and added blame
squash a5f4a0d added cat-file
```
当保存并退出编辑器时，Git 应用所有的三次修改然后将你放到编辑器中来合并三次提交信息：
```
# This is a combination of 3 commits.
# The first commit's message is:
changed my name a bit

# This is the 2nd commit message:

updated README formatting and added blame

# This is the 3rd commit message:

added cat-file
```
当你保存之后，你就拥有了一个包含前三次提交的全部变更的提交。

###拆分提交
拆分一个提交会撤消这个提交，然后多次地部分地暂存与提交直到完成你所需次数的提交。 例如，假设想要拆分三次提交的中间那次提交。 想要将它拆分为两次提交：第一个 “updated README formatting”，第二个 “added blame” 来代替原来的 “updated README formatting and added blame”。 可以通过修改 rebase -i 的脚本来做到这点，将要拆分的提交的指令修改为 “edit”：
```
pick f7f3f6d changed my name a bit
edit 310154e updated README formatting and added blame
pick a5f4a0d added cat-file
```
然后，当脚本将你进入到命令行时，重置那个提交，拿到被重置的修改，从中创建几次提交。 当保存并退出编辑器时，Git 带你到列表中第一个提交的父提交，应用第一个提交（f7f3f6d），应用第二个提交（310154e），然后让你进入命令行。 那里，可以通过 git reset HEAD^ 做一次针对那个提交的混合重置，实际上将会撤消那次提交并将修改的文件未暂存。 现在可以暂存并提交文件直到有几个提交，然后当完成时运行 git rebase --continue：
```
 git reset HEAD^
 git add README
 git commit -m 'updated README formatting'
 git add lib/simplegit.rb
 git commit -m 'added blame'
 git rebase --continue
```
Git 在脚本中应用最后一次提交（a5f4a0d），历史记录看起来像这样：
```
 git log -4 --pretty=format:"%h %s"

1c002dd added cat-file
9b29157 added blame
35cfb2b updated README formatting
f3cc40e changed my name a bit
```
再一次，这些改动了所有在列表中的提交的 SHA-1 校验和，所以要确保列表中的提交还没有推送到共享仓库中。

##核武器级选项：filter-branch
有另一个历史改写的选项，如果想要通过脚本的方式改写大量提交的话可以使用它 - 例如，全局修改你的邮箱地址或从每一个提交中移除一个文件。 这个命令是 filter-branch，它可以改写历史中大量的提交，除非你的项目还没有公开并且其他人没有基于要改写的工作的提交做的工作，你不应当使用它。 然而，它可以很有用。 你将会学习到几个常用的用途，这样就得到了它适合使用地方的想法。

###从每一个提交移除一个文件
这经常发生。 有人粗心地通过 git add . 提交了一个巨大的二进制文件，你想要从所有地方删除它。 可能偶然地提交了一个包括一个密码的文件，然而你想要开源项目。 filter-branch 是一个可能会用来擦洗整个提交历史的工具。 为了从整个提交历史中移除一个叫做 passwords.txt 的文件，可以使用 --tree-filter 选项给 filter-branch：
```
 git filter-branch --tree-filter 'rm -f passwords.txt' HEAD
Rewrite 6b9b3cf04e7c5686a9cb838c3f36a8cb6a0fc2bd (21/21)
Ref 'refs/heads/master' was rewritten
```
--tree-filter 选项在检出项目的每一个提交后运行指定的命令然后重新提交结果。 在本例中，你从每一个快照中移除了一个叫作 passwords.txt 的文件，无论它是否存在。 如果想要移除所有偶然提交的编辑器备份文件，可以运行类似 git filter-branch --tree-filter 'rm -f *~' HEAD 的命令。

最后将可以看到 Git 重写树与提交然后移动分支指针。 通常一个好的想法是在一个测试分支中做这件事，然后当你决定最终结果是真正想要的，可以硬重置 master 分支。 为了让 filter-branch 在所有分支上运行，可以给命令传递 --all 选项。

###使一个子目录做为新的根目录
假设已经从另一个源代码控制系统中导入，并且有几个没意义的子目录（trunk、tags 等等）。 如果想要让 trunk 子目录作为每一个提交的新的项目根目录，filter-branch 也可以帮助你那么做：
```
 git filter-branch --subdirectory-filter trunk HEAD
Rewrite 856f0bf61e41a27326cdae8f09fe708d679f596f (12/12)
Ref 'refs/heads/master' was rewritten
```
现在新项目根目录是 trunk 子目录了。 Git 会自动移除所有不影响子目录的提交。

###全局修改邮箱地址
另一个常见的情形是在你开始工作时忘记运行 git config 来设置你的名字与邮箱地址，或者你想要开源一个项目并且修改所有你的工作邮箱地址为你的个人邮箱地址。 任何情形下，你也可以通过 filter-branch 来一次性修改多个提交中的邮箱地址。 需要小心的是只修改你自己的邮箱地址，所以你使用 --commit-filter：
```
 git filter-branch --commit-filter '
        if [ "$GIT_AUTHOR_EMAIL" = "schacon@localhost" ];
        then
                GIT_AUTHOR_NAME="Scott Chacon";
                GIT_AUTHOR_EMAIL="schacon@example.com";
                git commit-tree "$@";
        else
                git commit-tree "$@";
        fi' HEAD
```
这会遍历并重写每一个提交来包含你的新邮箱地址。 因为提交包含了它们父提交的 SHA-1 校验和，这个命令会修改你的历史中的每一个提交的 SHA-1 校验和，而不仅仅只是那些匹配邮箱地址的提交。

####感谢您访问 git.oschina.net（以下简称“本网站”）。

本网站由深圳市奥思网络科技有限公司（以下简称“奥思网络”）运行维护。本网站向公众开放，提供基于 git 的代码托管和项目管理服务。 在使用本网站前，敬请您仔细阅读以下各项使用条款（以下简称“本使用条款”）。您对本网站的使用(包括但不限于对本网站的访问、登录，对本网站内容的浏览和使用)，将被视为您自愿承诺接受本声明的约束。如果您对本使用条款的内容不能接受，您应当立即停止使用本网站并迅速离开。

####本网站的使用

奥思网络有限许可您在您的计算机设备上浏览（使用）本网站展示的内容（由本使用条款第2条规定）。

####知识产权声明

本网站，包括(但不仅限于) 文字，内容，软件，录像，音乐，声音，图形，照片，图表，美术设计，图片，名称，标识，商标和/或服务标志（包括已注册和未注册的），以及其他资料（以下简称网站内容）都受到版权法，商标法和一切知识产权公约的保护。本网站内容包括奥思网络所有或控制下的内容和第三方所有或控制下，并授权奥思网络使用的内容。所有代码，文章，讨论等一切构成本网站的元素都可能是受版权保护的作品。您同意遵守所有适用本网站的版权保护法律法规，以及所有本网站包含的补充性的版权说明或限制。本网站的内容均由相应的机构/个人上传、维护。对于本站内容的任何使用请遵守内容所附带的授权协议。如不清楚相应的授权协议请询问上传该内容的机构/个人。

任何在 git.oschina.net 上注册的账号上传的内容的版权均归上传者所有，上传者承担所有被上传内容的版权责任。奥思网络有权在其拥有的网站上，展示上传者上传到本网站公共区域的内容。

####个人信息的保护

奥思网络尊重访问本网站的任何个人的隐私信息。当您访问本网站的时候可能被要求提供您个人的基本资料(如姓名、电子邮件、电话号码等)，您可以自行选择是否提供。对于您提供的个人信息，奥思网络将根据中华人民共和国相关法律进行保密并严格保管，不会将这些信息以任何方式提供或展示给任何第三方，但下述情况除外：

(一) 当司法机关或行政机关依照法定程序和法定职权要求本网站披露个人资料时，我们将依法提供相关资料。对于此情况下的任何披露，本网站均得免责；

(二) 对于任何由黑客攻击、计算机病毒侵入或发作、或政府管制而造成的暂时性关闭等影响网站正常运营的不可抗力事件所造成的个人资料的泄露、丢失、被盗用或被篡改等，本网站均得免责；

(三) 对于用户将个人密码告知他人或与他人共享注册帐号所导致的任何个人资料泄露，丢失、被盗用或被篡改等,本网站不负任何责任；

(四) 对于与本网站链接的任何其它网站的个人资料泄露，丢失、被盗用或被篡改等事件，本网站不负任何责任。

####网站的更新与变更

奥思网络提供的本网站上的内容仅为方便您获取信息，奥思网络有权单方面在任何时间，对本网站的内容进行变更或更新，此种变更或更新无需以通知您或任何第三方为前提。您承认并接受上述变更或更新。我们建议您定期访问本网站以尽快获知有关的更新或变更的信息。

####无担保声明

在法律允许的最大限度内，本网站及本网站的内容不包括任何明确或暗示的有关（但不限于）所有权，适销性，质量满意程度，特定用途的适用性，准确性、时效性和完整性，不侵犯知识产权和其它方权利的承诺。

奥思网络尽其合理的商业努力维护本网站的安全和功能，但不保证本网站上的所有功能正常运作，也不保证本网站连续性地或无故障运行或缺陷被及时更正。

奥思网络不保证本网站系统适合您的电脑操作系统性能，也不保证本网站或其服务器永不产生故障或没有病毒、木马程序和其他有害程序。奥思网络亦不承担您因上述问题而产生的任何电脑的损坏的责任。

奥思网络不为您所使用的访问本网站的网络线路和设备的可靠性以及连续性承担责任。

####禁止盗链

奥思网络禁止擅自利用本网站内容的网页构架系统的行为。奥思网络保留断开任何未经授权指向本网站的超文本链接或网页构架系统的权利。

####项目大小

奥思网络允许用户上传项目，规定每个项目的大小上限为1G，禁止大量的外链请求到本网站，并且不允许存放与代码无关的文件，如果代码实在有需要更大，请发邮件(git#oschina.cn)联系我们，说明使用场景和原因进行申请，我们邮件同意后方可上传更大的项目，如果未经允许私自上传大项目、与代码无关的文件或者大量的外链请求，奥思网络保留停止项目的使用以及通知作者备份并删除的权利。

####终止使用

如果您的账户违反当地相关法律法规或网站使用条款，在未经事先通知的情况下，奥思网络有权自行判断并立即终止您对本网站的使用，或者采取措施禁止您对本网站的再次访问。

####准据法和管辖权

本网站内容及本使用条款的解释和适用均适用中华人民共和国法律，由于使用本网站而产生的一切纠纷，除另有约定，均由中华人民共和国(奥思网络所在地)人民法院管辖。

####继续有效原则

如果本使用条款中的部分条款被有关机关认定为无效，则此无效部分并不影响本使用条款其他部分的效力，其他部分仍然有效。

你可以点击这里阅读权威的 git 书籍[ProGit](http://git.oschina.net/progit)

以下为收集的开源中国社区热心网友制作的码云（Gitee.com）跟各种 IDE，软件的集成办法，可以点击查看：

* [git官方中文文档](https://git-scm.com/book/zh/v2) 推荐阅读!

* [eclipse中egit插件使用-图文并茂-详细](http://my.oschina.net/songxinqiang/blog/194203)

* [Visual Studio 2012连接到osc@git](http://my.oschina.net/gal/blog/141442)

* [TortoiseGit配合msysGit在Git@OSC代码托管的傻瓜教程](http://my.oschina.net/icelily/blog/141342)

* [利用eclipse的git插件EGit与git@osc交互](http://my.oschina.net/kzhou/blog/132146)

* [Git初体验](http://my.oschina.net/dxqr/blog/134811)

* [在win7系统下使用TortoiseGit(乌龟git)简单操作Git@OSC](http://my.oschina.net/longxuu/blog/141699)

* [Xcode连接git @ osc](http://my.oschina.net/zxs/blog/142544)

* [git@osc(git)中team开发、fork和pull request的用法](http://my.oschina.net/kzhou/blog/150290)

* [eclipse的git插件整合Git@OSC](http://my.oschina.net/u/861562/blog/151975)

* [Eclipse使用EGit管理git@OSC项目](http://my.oschina.net/China2012/blog/174874)

* [如何导入外部Git仓库到中国源代码托管平台（Git@OSC）](http://www.oschina.net/question/82993_133520)

* [https 方式使用Git@OSC设置密码的方式](http://git.oschina.net/oschina/git-osc/issues/2586)

* [sourcetree使用git@osc教程](http://blog.csdn.net/riven_wn/article/details/45332713)

* [Netbeans使用git教程](https://netbeans.org/kb/docs/ide/git_zh_CN.html?print=yes)

码云（Gitee.com）帮助文档

码云使用手册

1、什么是码云

1.1、什么是码云（Gitee.com）

1.2、码云亮点

1.3、探索码云

1.4、码云平台IDEA系列的插件使用

1.5、常用工具及插件教程

1.6、码云使用容量说明

2、创建码云账号

2.1、创建码云账号

2.2、CSDN CODE 项目整体迁移到码云平台

3、代码托管

3.1、创建第一个项目

3.2、公钥认证管理

3.3、建立主页

4、协同工作

4.1、Fork + Pull 模式

4.2、组织和团队

4.3、文档协作

码云特性

码云SVN支持

克隆 Pull Request

WebHook

码云的 WebHook 增加对钉钉的支持

码云Pages

生成并部署SSH key

项目成员权限说明

Commit关联issue

Pull Request关联issue

在线重命名或删除文件

项目转移

issue和pr模板

为项目添加LICENSE

什么是 G 币？

码云企业版

企业版简介

创建企业 VS 升级为企业

转移组织至企业账号

设置企业信息

企业通知&告警设置

安全设置

添加企业成员

设置企业成员管理权限

导入企业项目

转移项目至企业账号

企业项目权限说明

企业项目成员权限说明

企业外包说明

企业账号付费说明

企业账号开具发票

查看发票快递信息

企业版仓库快照功能简介

服务问题

如果合同到期终止，代码资产怎么处理？

企业免费版会有赔付机制么？

码云企业版代码推拉方式设置功能介绍

FAQ

Git 操作管理

新手小白如何快速的在码云平台注册账号并完成第一次提交

http(s)方式如何自动记住密码

如何处理代码冲突

如何进行版本回退

git submodule

为什么在push的时候，出现了413错误，push失败

为什么pull request合并不了

如何对一个项目提交Pull Request

git clone git@osc项目出错 server aborted the ssl handshake

如何导入Github仓库到码云

用户账户

个性地址

为什么我收不到激活/通知/重置密码等邮件

怎么更改邮箱

为什么我的网络连接不上码云？

为什么我突然无发访问/登录码云？

QQ登录的如何修改密码？

代码仓库

项目被屏蔽后如何处理？

为什么大文件推不上去

push 代码的时候提示 fatal: Authentication failed 问题