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

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

第0步&＃xff1a;环境准备

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

第1步&＃xff1a;首先在gitee上注册一个个人账号

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

# ssh-keygen -t rsa -C "litao.wang&＃64;qq.com"

创建成功后&＃xff0c;会在~/.ssh目录下生产一对密钥&＃xff1a;id_rsa 和 id_rsa.pub

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

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

第2步&＃xff1a;fork项目的仓库到自己刚注册的账号

打开开源项目主页&＃xff1a;https://gitee.com/zhaixuebuluo/glibc_man_cn.git

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

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

第3步&＃xff1a;将远程仓库clone到本次电脑

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

# git clone git&＃64;gitee.com:wanglitao_repo/glibc_man_cn.git

第4步&＃xff1a;在本地修改、添加文件、提交&＃xff0c;并push到自己的远程仓库

比如你在本地添加了一个文件&＃xff1a;puts.md

# vi puts.md

# git add puts.md

# git commit -m "add puts.md"

# git push

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

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

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

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

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

系统会给你一个提示&＃xff1a;你的提交合并成功&＃xff01;

整个提交流程结束。

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

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

但是随着时间推移&＃xff0c;官方仓库一直在更新&＃xff0c;那如何保持同步呢&＃xff1f;

方法很多&＃xff0c;简单的一个操作就是&＃xff1a;

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

具体操作&＃xff1a;

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

origin git&＃64;gitee.com:wanglitao_repo/glibc_man_cn.git (fetch)

origin git&＃64;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&＃64;gitee.com:wanglitao_repo/glibc_man_cn.git (fetch)

origin git&＃64;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 再提交到自己的远程仓库&＃xff0c;这样自己的远程仓库就跟原始官方仓库同步了

后续问题1&＃xff1a;提交冲突问题

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