- 1 -

为什么需要版本管理

当一个团队进行协同创作内容时，有以下需要：

在对文档做新版本的修订时，希望获得老版本的内容做修改并发布
当对内容做修改后，想回到修改前的状态
当团队成员共同修改内容时，希望避免彼此覆盖对方的修改
需要获得同一个文件的两个版本，对比查看有什么改动
防止内容因磁盘损坏等原因而丢失

版本管理软件就是为解决以上问题而设计。

Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。它最初是为管理软件代码而设计，现在很多的文档采用DITA、Markdown等纯文本格式来编写，Git也适合用于对文档进行版本管理。

- 2 -

版本修订过程

下边是文档团队使用Git来做内容编辑和发布的过程。我们用Gitee和Github desktop来说明。

注：这里描述的不是唯一的方法，它是一种相对简单的做法。

1. 创建仓库

在浏览器中注册用户并登录www.gitee.com，可以通过以下步骤创建内容仓库：

2. 增加内容

首先，使用Git客户端软件（Github Desktop）在个人电脑上将Gitee上的内容仓库克隆(Clone）到本地，这个操作只需要做一次。

上图的Repository URL填写Gitee上创建的仓库URL，从下图处获取：

内容放在本地磁盘的C:\dev\dyson目录，目前目录中无内容。

然后，我们添加内容。

比如：在C:\dev\dyson目录中创建topics和graphics子目录，然后将手册的图放到graphics目录中，将DITA Topic文件放到topics目录中，ditamap文件则直接放在C:\dev\dyson目录。这些内容是使用Oxygen XML Editor、Windows画图等工具创建的。

最后，我们对内容进行提交并推送到Gitee服务器。

请在Description输入栏中输入这次做了什么变动，以后我们通过看Description知道每次提交做了哪些修改。