教程分享均是笔者亲身学习经验总结,涉及到的知识点均亲身试验,但有时为了知识完整性,可能并未亲自确认,对于这部分内容会明确指出,到时由读者确认试验.
如果读者实际运行效果和教程演示效果有出入,很可能是版本问题,系统环境等原因,希望能及时反馈,避免更多人踩坑,谢谢!
国内用户推荐访问 snowdreams1006.tech ,速度非常快并且和 snowdreams1006.github.io 保持同步更新.
- 面向初学者,适合零基础入门;
- 面向常用操作,技能实用性强;
- 情景教学,理清事情来龙去脉;
- 章节重点知识小结,精华集锦;
- 保持哲学三问,是什么,为什么,怎么样?希望最终能有你自己的答案;
- 好记性不如烂笔头,亲自动手操作一遍,你会发现你的理解更上一层楼;
- 授人以鱼不如授人以渔,希望带给你不仅仅是知识更多的是学习的方法;
- 知识重在分享才有价值,鼓励知识传播与分享,创造收益更有价值;
- 因本人能力有限,如有出入,敬请指正,请联系我 snowdreams1006
{% aimg audiocontrols=""%} /assets/image/play.png,/assets/audio/snowdreams.mp3 {% endaimg %}
名称 :
雪之梦技术驿站,微信号 :snowdreams1006
关注理由:
开源的不开源的都会发布到微信公众号,不再局限于系列教程而是随性而为,展示真实的技术人生.
名称 :
雪之梦技术驿站,微信号 :snowdreams1109
适用场景:
如果三言两语很难阐释你遇到的问题,如果你是人见人爱的妹子,那么欢迎加我私人微信一起畅谈人生.
Github 作为远程项目服务器时下载速度感人,而国内用户使用 Gitee 进行下载时速度明显提升,因此下载项目时推荐使用 Gitee 作为远程项目仓库.
核心思路
如果以 Github 作为远程仓库,全量下载项目代码时切换到 Gitee 远程仓库地址进行下载,增量更新时切换回 Github 远程仓库地址进行更新,以此保持最新代码状态.
- 全量下载 Gitee
# 使用 https 方式下载 Gitee 源码
git clone https://gitee.com/snowdreams1006/snowdreams1006.git
# 切换回 Github 远程仓库地址
git remote set-url origin https://github.com/snowdreams1006/snowdreams1006.github.io.git- 增量更新 Github
# 切换远程仓库地址为 Gitee 地址
git remote set-url origin https://gitee.com/snowdreams1006/snowdreams1006.git
# 更新项目源码
git Pull
# 切换回 Github 远程仓库地址
git remote set-url origin https://github.com/snowdreams1006/snowdreams1006.github.io.git如果以 Gitee 作为远程仓库,无论下载还是更新均无需切换远程项目地址,正常下载更新即可.
- 全量下载 Gitee
# 使用 https 方式下载 Gitee 源码
git clone https://gitee.com/snowdreams1006/snowdreams1006.git- 增量更新 Gitee
# 更新项目源码
git Pull不论是直接下载 zip 压缩包还是命令行克隆项目,接下来需要使用 gitbook 相关命令进行启动本地服务,正常情况下运行效果和线上环境相差无二.
gitbook环境需要本机安装nodejs环境,个别插件可能还需要额外环境依赖,具体情况请参考 gitbook入门教程
# 安装项目插件
gitbook install
# 运行本地服务
gitbook serve一般情况下,服务启动后会在本机 4000 端口开启服务,可以打开浏览器访问 localhost:4000 或者 127.0.0.1:4000 进行访问.
本地服务确认无误后,可使用 gitbook build 生成静态网站,然后将其上传到服务器直接部署即可,例如可以将 _book/ 文件夹下的静态网站全部上传到 Github 网站,上传成功后即可访问在线网站: https://snowdreams1006.github.io/
# 生成静态网站,生成完毕后全部网站文件位于_book文件夹中.
gitbook build
# 将静态网站文件夹_book全部复制到当前目录,保证首页存在index.html文件
cp -rf ./_book/* ./
# 添加到版本库等待上传 Github
git add .
# 添加更新说明
git commit -m "regenerate website"
# 推送到远程仓库,推送成功后等待一段时间后在线服务即可开启.
git push推送到远程仓库要求用户对该仓库具有写权限,因此建议 fork 本项目到个人空间,这样就可以体验完整的个人博客搭建流程.
如果远程仓库只有Github 一种,发生意外情况的话将直接影响到网站运行,所以可以考虑将网站进行多处备份,目前本项目已经备份到 Gitee 和 Gitlab 网站.
- 一个 pull + 多个 push
本项目以 Github 为主,Gitee 和 Gitlab 为辅,具体表现为: 当本地环境需要更新项目时,拉取自 Github 仓库源码,推送项目时,一次性同时推送到多个仓库.
# 添加 Gitee 推送地址
git remote set-url --add [email protected]:snowdreams1006/snowdreams1006.git
# 添加 Gitlab 推送地址
git remote set-url --add [email protected]:snowdreams1006/snowdreams1006.gitlab.io.git设置完成后,以后使用 git push 进行推送就会一次性同步到多个远程仓库,当然需要先确保已将该项目导入到相应的仓库并且能正常通讯.
- 多套 pull + push
如果希望拉取地址和推送地址是对应的,可以使用下面这种方式建立多套远程仓库地址.
# 添加 Gitee 远程仓库地址,拉取或推送时需要指定仓库名称,例如: git push gitee master
git remote add gitee [email protected]:snowdreams1006/snowdreams1006.git
# 添加 Gitlab 远程仓库地址,拉取或推送时需要指定仓库名称,例如: git push gitlab master
git remote add gitlab [email protected]:snowdreams1006/snowdreams1006.gitlab.io.git上述两种方式并不冲突,如果愿意的话也可以两者同时设置,好处是一般情况下拉取源码时从 Github 下载,推送源码时自动同步到多个远程仓库.
如果遇到特殊情况也可以单独指定远程仓库,例如长时间没更新项目再次更新下载速度比较慢,也可以指定远程仓库 Gitee 等等.
最后,运行 git remote -v 命令可查看远程项目关联情况,实现一份代码多处备份.
$ git remote -v
gitee [email protected]:snowdreams1006/snowdreams1006.git (fetch)
gitee [email protected]:snowdreams1006/snowdreams1006.git (push)
gitlab [email protected]:snowdreams1006/snowdreams1006.gitlab.io.git (fetch)
gitlab [email protected]:snowdreams1006/snowdreams1006.gitlab.io.git (push)
origin [email protected]:snowdreams1006/snowdreams1006.github.io.git (fetch)
origin [email protected]:snowdreams1006/snowdreams1006.github.io.git (push)
origin [email protected]:snowdreams1006/snowdreams1006.git (push)
origin [email protected]:snowdreams1006/snowdreams1006.gitlab.io.git (push)本教程源码托管在 snowdreams1006.github.io ,在线阅读请访问 snowdreams1006.github.io.
如果你觉得本教程对你有所帮助,请不吝 Star.
如果你想贡献一份力量,欢迎提交 Pull Request.