hexo 小白搭建自己个人博客
本文最后更新于:20 天前
通过hexo 可以搭建属于的免费博客,不需要敲代码,不需要花钱,并且还很好看,但是需要稍稍花上一点时间,当然只要按照文档,一步一步操作,就可以收获属于自己的博客啦
需要的工具介绍
nodejs
: 包含俩个命令 node
npm
hexo
: 快速、简洁且高效的博客框架,支持markdown 插件和扩展性很好
git
:需要安装git 通过git 命令来操作github
github
账号:申请注册一个github账号,github提供了一个github pages功能可以支持站点
软件版本:
nodejs
: v12.20.0 建立使用这个版本,最新版本使用hexo的时候,可能会有bug
开始搭建并部署博客
nodejs 操作
windows 用户 安装nodejs
windows用户这里需要安装git来操作
Git的官方下载地址:https://git-scm.com/download/win
下载完成之后点击安装,然后通过打开Git Bash 这个软件来敲下面的命令
临时更换npm 源 (为了后面快速下载安装hexo,更换为国内的源)
npm config set registry https://registry.npm.taobao.org
npm config get registry
看看终端显示信息,如果看到这行信息,说明配置成功: https://registry.npm.taobao.org/
mac 用户 打开终端 安装nodejs
下载安装 然后通过命令检测下安装版本
下载地址: https://npm.taobao.org/mirrors/node/v12.20.0/
$ node -v
v12.20.0
(base)
$ npm -v
6.14.8
临时更换npm 源 (为了后面快速下载安装hexo,更换为国内的源)
$ npm config set registry https://registry.npm.taobao.org
$ npm config get registry
https://registry.npm.taobao.org/
hexo 操作
windows用户 安装初始化hexo
通过npm来安装hexo,下面前俩个命令安装需要一点时间,blog目录就是博客目录,根据自己情况选择目录
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server
然后会看到这样的信息
INFO Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
本地访问http://localhost:4000 就可以看到博客网站了
mac 用户 打开终端 安装初始化hexo
通过npm来安装hexo(mac用户加上sudo),下面前俩个命令安装需要一点时间,blog目录就是博客目录,根据自己情况选择目录
sudo npm install hexo-cli -g #安装需要一点时间
hexo init blog #hexo 初始化安装 需要一点时间 这个blog以后就是自己的博客目录啦 文章都会放在这里面
cd blog #进入博客目录
npm install #npm 安装一些插件
hexo server #启动hexo服务
INFO Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
本地访问http://localhost:4000 就可以看到博客网站了
注意: 后面不在区分windows和 mac 用户,只要是敲命令的操作,命令都是通用的,命令不要敲错就OK。
至此,你本地的博客就已经搭建成功,接下来就是部署到 Github Page 了
github 操作
github 申请账号注册
github 注册地址: https://github.com/join?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F&source=header-home
github 登录 新建仓库
github 只能是托管同名代码下 一个静态站点
这里要注意: 我们要更改下默认仓库分支名字 由 main 改为master
然后打开仓库创建一个 index.html 文件,并随意先写点内容,比如: 你能看到我 说明部署成功~
这个时候打开 http://你的用户名.github.io 就可以看到你的站点啦,是不是很简单!index.html 内容只是暂时的预览效果,后面把 Hexo 的文件部署上去就可以在 http://你的用户名.github.io 看到你自己的博客啦! 比如我的就是 http://budongshu.github.io 了。
![image-20201126115126800](https://gitee.com/budongshu/blogimg/raw/master/img/image-20201126115126800.png
配置 SSH key
首先windows用户打开Git-Bash工具 mac 用户打开终端 操作命令都是一样的
执行以下命令全局配置一下本地账户
git config --global user.name "用户名"
git config --global user.email "邮箱地址"
生成一对密钥 SSH key
ssh-keygen -t rsa
首次使用还需要确认并添加主机到本机ssh 信任列表 下面可以看到success 返回成功
ssh -T git@github.com
查看刚刚生成公钥 最后要把这个公钥复制粘贴到github上去
cat ~/.ssh/id_rsa.pub
然后登录github 在github 上添加刚刚生成的ssh key 把公钥复制粘贴上去
创建一个新的 SSH key, 标题随便,key 就填刚才生成那个,确认创建,搞定!!这样在你的 SSH keys 列表里就会看到你刚刚添加的密钥
部署到github 仓库
这个时候我们把本地hexo 和github pages部署已经完成了,接下来我们要把本地的hexo静态站点部署到github pages中,然后通过github pages 我们就可以在互联网上浏览到博客了。
部署之前需要更改hexo 配置 和安装部署插件
第一: 进入blog 目录,打开仓库_config.yml 配置文件,拉到文件末尾,填上如下配置(也可同时部署到多个仓库,比如也可以支持gitee ):
# 注意: 这个文件是有格式的,不同层级按照缩进俩个空格,比如: 下面github 根据上面repo 就是俩个空格
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
branch: main
repo:
github: https://github.com/budongshu/budongshu.github.io.git #仓库名字改成自己的
第二: 要安装一个部署插件 hexo-deployer-git
npm install hexo-deployer-git --save
第三: 最后执行以下命令就可以部署上传啦,以下 g 是 generate 缩写,d 是 deploy 缩写:
hexo g -d
稍等一会,在浏览器访问网址: https://你的用户名.github.io 就会看到你的博客
hexo 命令
命令 | 功能 |
---|---|
hexo clean | 清除所有生成的页面文件 |
hexo g | 生成页面 |
hexo deploy | 推送部署到远程服务器 |
hexo n xxx | 新建一篇名为xxx的文章 |
写一遍博客 发布到网上
hexo new '第一遍文章'
执行完成后可以在 /source/_posts 下看到一个“第一遍文章.md
” 的文章文件 .md 就是 Markdown 格式的文件
具体用法可以在网上找一下,语法还是比较简单的。
然后按照markdown语法 编辑第一遍文章.md
,推荐markdown 工具: Typora
进行编辑
编辑完成保存,然后进行发布,注意: 一定要在blog目录下执行命令
cd ~/blog
hexo clean && hexo g -d
更换主题fluid
cd ~/blog
git clone https://github.com/fluid-dev/hexo-theme-fluid.git themes/fluid
在_config.yml 配置文件中,替换theme 参数,我们 把原来的注释掉加#,然后新增一行theme: fluid
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
#theme: landscape
theme: fluid
配置主题fluid
新建about 关于页面
hexo new page about
随便编写介绍自己的about 页面内容
---
title: about
date: 2020-11-26 16:47:37
layout: about
---
`email`: bdstravel@126.com
本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!