「这是我参与2022首次更文挑战的第14天,活动详情查看:2022首次更文挑战」。
前言:
前段时间研究了个人博客搭建,完成了一些的基础步骤,后面有其他的事就给忙忘了,这两天想起来就顺手撸了一个技术博客。在Github有一个框架比较简便,通过静态页面就可以搭建好你个人的博客了,先在这里分享给大家这个框架「 Hexo-简洁且高效的博客框架 」,搭建过程可能会有一些报错,我也是踩了一些坑,所以在这里跟大家分享一下。如果你也想搭建一个技术博客,那么请跟我一起来看看吧。
搭建流程
这篇搭建博客的做法是采用Github仓库 + Hexo框架,简单说下做法,我们需要使用到Github来管理我们项目,然后使用 Hexo框架来搭建博客网站,然后找一个喜欢的主题,最后完成个性化的配置后就可以使用个人的博客了。 下面我们来看看哪些流程:
Github 篇
- 创建
Github账号;(有跳过) - 创建
GithubPage,创建了一个repository,名称使用*username*.github.io; (有跳过) - 检查
git是否安装,没有的话去这里安装(有跳过) - 检查本机ssh密钥是否在Github仓库SSH设置中,没有则去生成一个,然后保存到Github仓库SSH设置中;(不知道ssh怎么生成的,
点这里)
Hexo 篇
安装 Node.js
如果本地有,最好更新一下,我在搭建过程中因为版本问题浪费了一些时间,所以最好都更新的最稳定的版本;
安装方式:
-
安装包: 官网直接下载
-
利用Homebrew安装:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" //如果没有权限, 添加sudo在最前面 使用admin权限 brew install node // 安装成功后 node -v: // 查看node版本 npm -v: //查看npm版本
安装 Hexo
创建一个目录用于你的博客,然后在命令行中 cd到你创建的目录中,然后执行Hexo安装命令;查看Hexo官网看这里。
// 这是我创建的目录,
cd Desktop/WorkSpace/Blog
// 安装 hexo
npm install -g hexo-cli
准备工作一般都会比较顺利。前面的这些都是一些准备工作,把每一步都检查仔细了后面会事半功倍,接下来我们将开始创建一个博客的模版了。
这里有 hexo 相关的一些命令,仅供大家参考,如果想了解的更加详细的请看官方文档:
init新建一个网站,如果没有设置folder,Hexo 默认在目前的文件夹建立网站。
hexo init [folder]
new新建一篇文章
hexo new "hello world"
generate生成静态文件
hexo g
server启动服务器
hexo server
deploy部署网站
hexo d
clean清除缓存文件
hexo clean
创建 Blog
在创建目录下执行以下操作;
// hexo init <项目名称>
hexo init blog
执行成功之后,会在当前的目录下生成一个新的文件夹,这个文件夹的名称就是你前面初始化的项目名称;
项目中的结构如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
初始化完成后,我们可以在本地查看效果; cd 到 这个新建的项目下;然后执行hexo s命令
// 到你新建的blog项目下执行 hexo s 命令
cd blog
hexo s
执行完成后,命令行中会提示你成功或者失败,成功会有以下的提示:
~/Desktop/WorkSpace/Blog/blog(master*) » hexo s
INFO Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.
^CINFO Farewell
本地服务已经打开了,你可以通过复制http://localhost:4000/ 这个路径到浏览器中预览。
到这里整个框架的搭建就算完成,但是,当你打开之后你会发现,这个默认的模版肯定不是你想要的吧。所以你还需要设置自己喜欢的主题,以及修改一些基础的配置。
下面我们讲讲怎么修改这些配置。
修改配置
在创建的根目录下找到_config.yml文件,打开之后,会发现有很多可以配置的地方。例如:
# Site
title: 新生代农民工的博客
subtitle: '喜欢黑科技'
description: '记录成长'
keywords: Objective-C,swift
author: 新生代农民工
language: zh-CN
timezone: 'Asia/ShangHai'
按照你自己的改完了之后,清理下缓存, 然后重新运行下看看效果吧。
这里有详细的_config.yml文件设置
以上只是小试牛刀,让你体验下这些配置的作用,关键的设置是这个theme,对吧,我们要更换一套自己喜欢的主题,这个才是重点的地方。
主题修改
在_config.yml中,我们可以看到theme有一个默认的主题,但这个不是我们想要的,hexo官方提供了主题集共我们选择,这些主题来自于很多人的贡献,吃水不忘挖井人,在这里先感谢他们🙏。
到了选主题的时候了,在这个themes 中找一个你喜欢的吧;
我选择的主题是archer,那么接下来在_config.yml文件中将theme对应的换成自己的主题就好了.
theme: archer
这个时候再去运行看看效果吧,是不是炫酷多了。那么后面使用到的具体配置,要在你使用的主题中去配置了,你可以在主题对应的官方链接中去查看教程。
接下来,就到了部署的环节,大家在本地调试了这么久,还没有用自己的链接打开过吧,在完成接下来的流程之后,我们就可以通过自己的链接打开博客了,该不该鼓励下自己呢?
部署博客到Github
同样,我们要修改_config.yml文件中的deploy,把repo的地址换成前面 Github 创建的那个项目地址,以下这种格式。具体的路径可以去 Github 中复制。
deploy:
type: 'git'
repo: git@github.com:yourname/yourname.github.io.git
branch: main
接下来,我们在创建的项目根目录下初始化git
git init
我们还需要安装一些工具来部署 hexo-deployer-git
npm install hexo-deployer-git --save
为了保险起见,先清理下缓存,然后生成静态文件,最后发布,如果不记得常用的指令可以在上面找找。
// 清除缓存
hexo clean
// 生成静态文件
hexo g
// 部署
hexo d
恭喜你处理完这些后,你就可以用自己的链接看到部署完成后的博客了。 接下来就是你自由发挥的时间啦。有帮助到你的话,那就点个赞👍再走吧!