1. 雪之梦
你在互联网的路上匆匆而来,雪之梦助你满载而去.
喜欢这个项目?请考虑捐赠来帮助它完善!
1.1. 简介
教程分享均是笔者亲身学习经验总结,涉及到的知识点均亲身试验,但有时为了知识完整性,可能并未亲自确认,对于这部分内容会明确指出,到时由读者确认试验.
如果读者实际运行效果和教程演示效果有出入,很可能是版本问题,系统环境等原因,希望能及时反馈,避免更多人踩坑,谢谢!
国内用户推荐访问 blog.snowdreams1006.cn ,速度非常快并且和 snowdreams1006.github.io 保持同步更新.
1.2. 教程特点
- 面向初学者,适合零基础入门;
- 面向常用操作,技能实用性强;
- 情景教学,理清事情来龙去脉;
- 章节重点知识小结,精华集锦;
1.3. 学习要求
- 保持哲学三问,是什么,为什么,怎么样?希望最终能有你自己的答案;
- 好记性不如烂笔头,亲自动手操作一遍,你会发现你的理解更上一层楼;
- 授人以鱼不如授人以渔,希望带给你不仅仅是知识更多的是学习的方法;
- 知识重在分享才有价值,鼓励知识传播与分享,创造收益更有价值;
- 因本人能力有限,如有出入,敬请指正,请联系我 snowdreams1006
1.4. 怎么联系
1.4.1. 第三方平台
1.4.2. 微信公众号
名称 :
雪之梦
,微信号 :snowdreams1006
关注理由:
开源的不开源的都会发布到微信公众号,不再局限于系列教程而是随性而为,展示真实的技术人生.
1.4.3. 个人微信号
名称 :
雪之梦
,微信号 :snowdreams1109
适用场景:
如果三言两语很难阐释你遇到的问题,如果你是人见人爱的妹子,那么欢迎加我私人微信一起畅谈人生.
1.5. 克隆网站
1.5.1. 下载项目
Github
作为远程项目服务器时下载速度感人,而国内用户使用 Gitee
进行下载时速度明显提升,因此下载项目时推荐使用 Gitee
作为远程项目仓库.
核心思路
静态网站托管:
.nojekyll
如果以 Github
作为主要远程仓库,全量下载项目代码时首先切换到 Gitee
远程仓库地址进行下载,然后增量更新时再切换回 Github
远程仓库地址进行更新,以此保持最新代码状态.
# 使用 https 方式下载 Gitee 源码
git clone https://gitee.com/snowdreams1006/snowdreams1006.git
# 重命名
mv snowdreams1006/ snowdreams1006.github.io/
# 切换到项目
cd snowdreams1006.github.io
# 切换回 Github 远程仓库地址
git remote set-url origin git@github.com:snowdreams1006/snowdreams1006.github.io.git
# 更新项目源码
git pull
如果以 Gitee
作为远程仓库,无论下载还是更新均无需切换远程项目地址,正常下载更新即可.
# 使用 https 方式下载 Gitee 源码
git clone https://gitee.com/snowdreams1006/snowdreams1006.git
# 切换到项目
cd snowdreams1006
1.5.2. 部署项目
不论是直接下载 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 本项目到个人空间,这样就可以体验完整的个人博客搭建流程.
1.5.3. 多处备份
如果远程仓库只有Github
一种,发生意外情况的话将直接影响到网站运行,所以可以考虑将网站进行多处备份,目前本项目已经备份到 Gitee
和 Gitlab
网站.
- 一个 pull + 多个 push
本项目以 Github
为主,Gitee
和 Gitlab
为辅,具体表现为: 当本地环境需要更新项目时,拉取自 Github
仓库源码,推送项目时,一次性同时推送到多个仓库.
# 添加 Gitee 推送地址
git remote set-url --add origin git@gitee.com:snowdreams1006/snowdreams1006.git
# 添加 Gitlab 推送地址
git remote set-url --add origin git@gitlab.com:snowdreams1006/snowdreams1006.gitlab.io.git
设置完成后,以后使用 git push
进行推送就会一次性同步到多个远程仓库,当然需要先确保已将该项目导入到相应的仓库并且能正常通讯.
- 多套 pull + push
如果希望拉取地址和推送地址是对应的,可以使用下面这种方式建立多套远程仓库地址.
# 添加 Github 远程仓库地址,拉取或推送时需要指定仓库名称,例如: git push github master
git remote add github git@github.com:snowdreams1006/snowdreams1006.github.io.git
# 添加 Gitee 远程仓库地址,拉取或推送时需要指定仓库名称,例如: git push gitee master
git remote add gitee git@gitee.com:snowdreams1006/snowdreams1006.git
# 添加 Gitlab 远程仓库地址,拉取或推送时需要指定仓库名称,例如: git push gitlab master
git remote add gitlab git@gitlab.com:snowdreams1006/snowdreams1006.gitlab.io.git
上述两种方式并不冲突,如果愿意的话也可以两者同时设置,好处是一般情况下拉取源码时从 Github
下载,推送源码时自动同步到多个远程仓库.
如果遇到特殊情况也可以单独指定远程仓库,例如长时间没更新项目再次更新下载速度比较慢,也可以指定远程仓库 Gitee
等等.
最后,运行 git remote -v
命令可查看远程项目关联情况,实现一份代码多处备份.
$ git remote -v
gitee git@gitee.com:snowdreams1006/snowdreams1006.git (fetch)
gitee git@gitee.com:snowdreams1006/snowdreams1006.git (push)
github git@github.com:snowdreams1006/snowdreams1006.github.io.git (fetch)
github git@github.com:snowdreams1006/snowdreams1006.github.io.git (push)
gitlab git@gitlab.com:snowdreams1006/snowdreams1006.gitlab.io.git (fetch)
gitlab git@gitlab.com:snowdreams1006/snowdreams1006.gitlab.io.git (push)
origin git@github.com:snowdreams1006/snowdreams1006.github.io.git (fetch)
origin git@github.com:snowdreams1006/snowdreams1006.github.io.git (push)
origin git@gitee.com:snowdreams1006/snowdreams1006.git (push)
origin git@gitlab.com:snowdreams1006/snowdreams1006.gitlab.io.git (push)
1.6. 相关说明
本教程源码托管在 snowdreams1006.github.io ,在线阅读请访问 snowdreams1006.github.io.
感谢支持
如果你觉得本教程对你有所帮助,请不吝 Star
.
如果你想贡献一份力量,欢迎提交 Pull Request
.
赞赏捐助
赞赏不赞赏无所谓,有则喝茶,无则喝水.安得广厦千万间,大庇天下寒士俱欢颜!
作者: 雪之梦技术驿站
来源: 雪之梦技术驿站
本文原创发布于「雪之梦技术驿站」,转载请注明出处,谢谢合作!