《C标准库函数新编手册》开源项目上手指南

作为一个新手，这个文档将会介绍如何参与到这个项目中(以gitee代码托管网站为例)

第0步：环境准备

• Linux环境，可以使用VMware虚拟机跑Ubuntu
• 在Windows或Linux下已经安装Git工具
• 熟练使用Git、vim、Markdown、Linux基本命令
• 参加开源活动的同学通过赠送的激活码学习《Linux三剑客》相关章节
• 《零基础玩转Linux+Ubuntu》
• 《Git零基础实战》
• 《vim从入门到精通》

第1步：首先在gitee上注册一个个人账号

然后在本地Linux下使用下面命令创建一对SSH密钥

# ssh-keygen -t rsa -C "litao.wang@qq.com"

创建成功后，会在~/.ssh目录下生产一对密钥：id_rsa 和 id_rsa.pub

将公钥id_rsa.pub文件的内容添加你刚注册的账号里

这样你的这台电脑就有了提交(push)权限，可以将你本地的修改提交到你的远程仓库了。

第2步：fork项目的仓库到自己刚注册的账号

打开开源项目主页：https://gitee.com/zhaixuebuluo/glibc_man_cn.git

点击右上角的fork按钮，这样你就把这个开源项目拷贝到自己的空间了

进入你的个人主页，你会看到你的个人主页上已经有了一个拷贝的项目仓库了

第3步：将远程仓库clone到本次电脑

使用Git clone命令将自己的远程仓库下载到本地

# git clone git@gitee.com:wanglitao_repo/glibc_man_cn.git

第4步：在本地修改、添加文件、提交，并push到自己的远程仓库

比如你在本地添加了一个文件：puts.md

# vi puts.md

# git add puts.md

# git commit -m "add puts.md"

# git push

这样你本地的修改(添加了一个puts.md文件)就提交到了你的远程仓库

第5步：将自己远程仓库的修改添加到宅学部落官方原始仓库

进入到你个人主页的远程仓库项目，点击新建Pull Request 按钮

就可以将你远程仓库上的修改合并到宅学部落原始仓库中

第6步：宅学部落负责人会把你的提交合并到原始仓库中

系统会给你一个提示：你的提交合并成功！

整个提交流程结束。

后续问题1：如何使自己的远程仓库与官方仓库同步

可能存在这样一种情况，你通过fork按钮将官方原始仓库拷贝到自己个人主页

但是随着时间推移，官方仓库一直在更新，那如何保持同步呢？

方法很多，简单的一个操作就是：

先将官方原始仓库pull到本地，然后再push到自己的远程仓库上

具体操作：

# git remote -v 查看自己本地仓库的远程仓库信息(比如我刚创建的个人账号)

origin git@gitee.com:wanglitao_repo/glibc_man_cn.git (fetch)

origin git@gitee.com:wanglitao_repo/glibc_man_cn.git (push)

# git remote add upstream https://gitee.com/zhaixuebuluo/glibc_man_cn.git

# git remote -v

origin git@gitee.com:wanglitao_repo/glibc_man_cn.git (fetch)

origin git@gitee.com:wanglitao_repo/glibc_man_cn.git (push)

upstream https://gitee.com/zhaixuebuluo/glibc_man_cn.git(fetch)

upstream https://gitee.com/zhaixuebuluo/glibc_man_cn.git(push)

# git pull upstream master 将原始仓库先跟自己本地仓库同步

# git push 再提交到自己的远程仓库，这样自己的远程仓库就跟原始官方仓库同步了

后续问题1：提交冲突问题

具体解决方法，可参考《Linux三剑客》中的《Git零基础实战》中的Git冲突解决操作流程