《C标准库函数新编手册》开源项目上手指南
作为一个新手，这个文档将会介绍如何参与到这个项目中(以gitee代码托管网站为例)
第0步：环境准备
- Linux环境，可以使用VMware虚拟机跑Ubuntu
- 在Windows或Linux下已经安装Git工具
- 熟练使用Git、vim、Markdown、Linux基本命令
- 参加开源活动的同学通过赠送的**码学习《Linux三剑客》相关章节
- 《零基础玩转Linux+Ubuntu》
- 《Git零基础实战》
- 《vim从入门到精通》
第1步：首先在gitee上注册一个个人账号
然后在本地Linux下使用下面命令创建一对SSH**
# ssh-****** -t rsa -C "[email protected]"
创建成功后，会在~/.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 [email protected]:wanglitao_repo/glibc_man_cn.git
第4步：在本地修改、添加文件、提交，并push到自己的远程仓库
# 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 [email protected]:wanglitao_repo/glibc_man_cn.git (fetch)
origin [email protected]:wanglitao_repo/glibc_man_cn.git (push)
# git remote add upstream https://gitee.com/zhaixuebuluo/glibc_man_cn.git
# git remote -v
origin [email protected]:wanglitao_repo/glibc_man_cn.git (fetch)
origin [email protected]: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冲突解决操作流程