Open mileOfSunshine opened 3 years ago
初出茅庐之时,看到他人的博客,总会产生一丝新鲜感,好奇之心让你不知不觉跟随着他人的脚步,在写作平台开始展露拳脚。
发布了两三篇文章后,又发现有些人并非在写作平台写作,而是在拥有自己域名的博客平台发布。就像小时候看到邻居小孩吃糖,不知甜不甜就想着自己也能吃一块。然后就开始折腾了,购买域名空间,独立搭建博客。
从写文章到搭建博客这思路是对的,但不乏带有点跟风之意。博客,技术圈的个人名片。特别是在招聘面试时,部分面试官会特别关注面试者是否有个人博客,一来从博客上能看出面试者的表达能力和涉猎,二来能看到个人的代码水平和编码习惯。
此外,博客的书写对个人也是一种技能锻炼。资料的整理,特别是技术问题的整理,有助于自己下一次遇到类似的问题时能否更好的回忆细节和复用相关代码。
但如何能又快又好的搭建,这是讲究方法的。
笔者在开发博客前,简单做了调研,了解到当下最受欢迎的搭建模式就是借助GitHub Page和静态博客框架。接下来向大家介绍整个博客的搭建流程。
qwebfe.github.io
根据笔者调研,网上讨论最多的博客框架当属 Jekyll 和 Hexo。有人说,Jekyll 就是为了写博客打造的。Github Pages 中提供的 Jekyll 主题似乎也验证了这点。早期组内的博客也是基于 Jekyll 搭建的,其原因我想大概是 GitHub 自带 Jekyll 引擎,无需部署静态页面,只放项目源码即可。后因开发环境依赖问题不便维护,便弃 Jekyll 从 Hexo。据说 Hexo 的出现是因为 Jekyll 比较慢,大概是早期 Hexo 还不够成熟,还不支持自动化部署,也给使用者带来了不便,但那个时候已经过去了。接下来向大家具体介绍 Jekyll 和 Hexo。
gem install bundler jekyll jekyll new my-awesome-site cd my-awesome-site bundle exec jekyll serve # => Now browse to http://localhost:4000
通过以上几个命令可以看出,Jekyll 是基于 Ruby 实现的,安装 Jekyll 需要搭建 Ruby 环境,但在 Windows 搭建 Ruby 环境并不被推荐。若你是 Windows 用户,那可能一开始就跌倒在安装 Jekyll 的起跑线上。
我们组的早期博客基于 Jekyll,运行了小一年时间,但用户体验不是很好。受环境搭建影响,多数成员无法启动本地服务器,都是盲写文章,推送上线后,发现问题再修复。有一次把文章日期提前了一天,上线后新文章一直未被构建。无法本地预览,一定程度上影响排查效率。后面求助了同事,也没找到原因,但在第二天早上被告知文章构建成功了。笔者一时蒙蔽,后查阅了各手资源,才得知以下这个答案:
Jekyll 是不会构建未来日期的文章的!
在主题方面,有想法的你可自行选择Jekyll主题。按照安装提示,或基于gem,或只取远程主题,或直接直接拷贝至项目中,然后配置 _config.yml 文件即可。
_config.yml
theme: minimal-mistakes-jekyll
厌倦了 Jekyll 的那段爱恨情仇,最终投向了 Hexo 的怀抱。
A fast, simple & powerful blog framework 快速、简洁且高效的博客框架
Hexo 是基于 NodeJs 实现,在 Windows 上安装 NodeJs 开发环境可谓是相当简单。何其美哉!乐哉!
Hexo 默认的主题是 landscape,接触过博客园的童鞋可能觉得该主题有它的味道。萝卜青菜各有所爱,你可自行选择主题。关于 Hexo 的主题,笔者想说是我喜欢的调调😉,本组博客应用的主题是NexT
landscape
Hexo
啥也不说了,搬砖吧。
npm install -g hexo-cli
hexo init <folder> cd <folder> npm install npm server
M:咦? 这一套指令好像在哪见过👀。 H:🙊 vue ? M:嗷呜...
项目初始化完成后,指定文件夹的目录如下:
. ├── _config.yml # 网站的 配置 信息 ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
项目创建完成后,我们就可以开始写作了。关于写作,Hexo cli 也提供了相关指令,可快速创建一篇新文章或者新的页面。
hexo new [layout] <title>
scaffolds/*
new_post_name: :year-:month-:day-:title.md
执行指令时只需输入文件名,创建成功会自动带上当天日期,文件内容也会按照模板格式显示。
hexo new test # ==> source/_posts/2020-12-01-test.md
若你想了解更多使用方法,可前往hexo官网。
Hexo 官方介绍了三种部署方式。由于我们代码托管在了 Github 上,那笔者就部署到 GitHub Pages 展开介绍。
GitHub Pages
1、将你本地的 Hexo 站点文件夹推送到 repository(<你的 GitHub 用户名>.github.io) 中。默认情况下 public 目录将不会被推送到 repository 中,你应该检查 .gitignore 文件中是否包含 public 一行,如果没有请加上。 2、将 Travis CI 添加到你的 GitHub 账户中。
<你的 GitHub 用户名>.github.io
.gitignore
3、前往 GitHub 的 Applications settings,配置 Travis CI 权限,使其能够访问你的 repository。若你在第2步忘记了设置 Travis CI 的仓库权限,也可在此重新配置。
Travis CI
4、保存设置后你应该会被重定向到 Travis CI 的页面。如果没有,请 手动前往。 5、在浏览器新建一个标签页,前往 GitHub 新建 Personal Access Token,只勾选 repo 的权限并生成一个新的 Token。Token 生成后请复制并保存好。 6、回到 Travis CI,前往你的 repository 的设置页面,在 Environment Variables 下新建一个环境变量,Name 为 GH_TOKEN ,Value 为刚才你在 GitHub 生成的 Token。确保 DISPLAY VALUE IN BUILD LOG 保持 不被勾选 避免你的 Token 泄漏。点击 Add 保存。 7、在你的 Hexo 站点文件夹中新建一个 .travis.yml 文件:
repo
GH_TOKEN
sudo: false language: node_js node_js: - 10 # use nodejs v10 LTS cache: npm branches: only: - master # build master branch only script: - hexo generate # generate static files deploy: provider: pages skip-cleanup: true github-token: $GH_TOKEN keep-history: true on: branch: master local-dir: public
8、将 .travis.yml 推送到 repository 中。Travis CI 应该会自动开始运行,并将生成的文件推送到同一 repository 下的 gh-pages 分支下. 9、在 GitHub 中前往你的 repository 的设置页面,修改 GitHub Pages 的部署分支为 gh-pages。 10、前往 https://<你的 GitHub 用户名>.github.io 查看你的站点是否可以访问。这可能需要一些时间。
.travis.yml
gh-pages
https://<你的 GitHub 用户名>.github.io
或许你觉得这种基于 Travis CI 的部署方式配置繁琐,但你要知道一旦配置走通,后期部署都走自动化,对于团队博客而言能在一定程度上减轻心智负担。你要是真不想配置,推荐使用官方的一键部署,但这种部署方式每次都要人工执行操作。
还是那句话,萝卜青菜个有所爱。从 Jekyll 到 Hexo,这趟旅行虽说不易,但旅途中的风景也是令人难忘。若你还有更好用的博客框架,可留言推荐给笔者和大家。
初出茅庐之时,看到他人的博客,总会产生一丝新鲜感,好奇之心让你不知不觉跟随着他人的脚步,在写作平台开始展露拳脚。
发布了两三篇文章后,又发现有些人并非在写作平台写作,而是在拥有自己域名的博客平台发布。就像小时候看到邻居小孩吃糖,不知甜不甜就想着自己也能吃一块。然后就开始折腾了,购买域名空间,独立搭建博客。
从写文章到搭建博客这思路是对的,但不乏带有点跟风之意。博客,技术圈的个人名片。特别是在招聘面试时,部分面试官会特别关注面试者是否有个人博客,一来从博客上能看出面试者的表达能力和涉猎,二来能看到个人的代码水平和编码习惯。
此外,博客的书写对个人也是一种技能锻炼。资料的整理,特别是技术问题的整理,有助于自己下一次遇到类似的问题时能否更好的回忆细节和复用相关代码。
但如何能又快又好的搭建,这是讲究方法的。
笔者在开发博客前,简单做了调研,了解到当下最受欢迎的搭建模式就是借助GitHub Page和静态博客框架。接下来向大家介绍整个博客的搭建流程。
Github Pages 入门
qwebfe.github.io
。静态博客框架
根据笔者调研,网上讨论最多的博客框架当属 Jekyll 和 Hexo。有人说,Jekyll 就是为了写博客打造的。Github Pages 中提供的 Jekyll 主题似乎也验证了这点。早期组内的博客也是基于 Jekyll 搭建的,其原因我想大概是 GitHub 自带 Jekyll 引擎,无需部署静态页面,只放项目源码即可。后因开发环境依赖问题不便维护,便弃 Jekyll 从 Hexo。据说 Hexo 的出现是因为 Jekyll 比较慢,大概是早期 Hexo 还不够成熟,还不支持自动化部署,也给使用者带来了不便,但那个时候已经过去了。接下来向大家具体介绍 Jekyll 和 Hexo。
Jekyll
通过以上几个命令可以看出,Jekyll 是基于 Ruby 实现的,安装 Jekyll 需要搭建 Ruby 环境,但在 Windows 搭建 Ruby 环境并不被推荐。若你是 Windows 用户,那可能一开始就跌倒在安装 Jekyll 的起跑线上。
我们组的早期博客基于 Jekyll,运行了小一年时间,但用户体验不是很好。受环境搭建影响,多数成员无法启动本地服务器,都是盲写文章,推送上线后,发现问题再修复。有一次把文章日期提前了一天,上线后新文章一直未被构建。无法本地预览,一定程度上影响排查效率。后面求助了同事,也没找到原因,但在第二天早上被告知文章构建成功了。笔者一时蒙蔽,后查阅了各手资源,才得知以下这个答案:
在主题方面,有想法的你可自行选择Jekyll主题。按照安装提示,或基于gem,或只取远程主题,或直接直接拷贝至项目中,然后配置
_config.yml
文件即可。厌倦了 Jekyll 的那段爱恨情仇,最终投向了 Hexo 的怀抱。
Hexo
Hexo 是基于 NodeJs 实现,在 Windows 上安装 NodeJs 开发环境可谓是相当简单。何其美哉!乐哉!
Hexo 默认的主题是
landscape
,接触过博客园的童鞋可能觉得该主题有它的味道。萝卜青菜各有所爱,你可自行选择主题。关于Hexo
的主题,笔者想说是我喜欢的调调😉,本组博客应用的主题是NexT建站
啥也不说了,搬砖吧。
安装
初始化
项目初始化完成后,指定文件夹的目录如下:
landscape
写作
项目创建完成后,我们就可以开始写作了。关于写作,Hexo cli 也提供了相关指令,可快速创建一篇新文章或者新的页面。
scaffolds/*
下的模板文件,保证新页面的规范性。执行指令时只需输入文件名,创建成功会自动带上当天日期,文件内容也会按照模板格式显示。
若你想了解更多使用方法,可前往hexo官网。
部署
Hexo 官方介绍了三种部署方式。由于我们代码托管在了 Github 上,那笔者就部署到
GitHub Pages
展开介绍。1、将你本地的 Hexo 站点文件夹推送到 repository(
![授予项目访问权限](https://p0.ssl.qhimg.com/t0177f583632427bf95.png)
<你的 GitHub 用户名>.github.io
) 中。默认情况下 public 目录将不会被推送到 repository 中,你应该检查.gitignore
文件中是否包含 public 一行,如果没有请加上。 2、将 Travis CI 添加到你的 GitHub 账户中。3、前往 GitHub 的 Applications settings,配置 Travis CI 权限,使其能够访问你的 repository。若你在第2步忘记了设置
Travis CI
的仓库权限,也可在此重新配置。4、保存设置后你应该会被重定向到 Travis CI 的页面。如果没有,请 手动前往。 5、在浏览器新建一个标签页,前往 GitHub 新建 Personal Access Token,只勾选
6、回到 Travis CI,前往你的 repository 的设置页面,在 Environment Variables 下新建一个环境变量,Name 为
7、在你的 Hexo 站点文件夹中新建一个 .travis.yml 文件:
repo
的权限并生成一个新的 Token。Token 生成后请复制并保存好。GH_TOKEN
,Value 为刚才你在 GitHub 生成的 Token。确保 DISPLAY VALUE IN BUILD LOG 保持 不被勾选 避免你的 Token 泄漏。点击 Add 保存。8、将
10、前往
.travis.yml
推送到 repository 中。Travis CI 应该会自动开始运行,并将生成的文件推送到同一 repository 下的gh-pages
分支下. 9、在 GitHub 中前往你的 repository 的设置页面,修改GitHub Pages
的部署分支为gh-pages
。https://<你的 GitHub 用户名>.github.io
查看你的站点是否可以访问。这可能需要一些时间。或许你觉得这种基于 Travis CI 的部署方式配置繁琐,但你要知道一旦配置走通,后期部署都走自动化,对于团队博客而言能在一定程度上减轻心智负担。你要是真不想配置,推荐使用官方的一键部署,但这种部署方式每次都要人工执行操作。
后记
还是那句话,萝卜青菜个有所爱。从 Jekyll 到 Hexo,这趟旅行虽说不易,但旅途中的风景也是令人难忘。若你还有更好用的博客框架,可留言推荐给笔者和大家。