hexo搭建个人博客网站

[TOC]

1. Hexo搭建步骤

1.1 安装Git

Windows下载:Git for Windows

Linux下载:sudo apt-get install git

1.2 安装Node.js

Windows下载:Download | Node.js (nodejs.org)

Linux下载:

1
2
sudo apt-get install nodejs
sudo apt-get install npm

1.3 安装Hexo

  • 新建文件夹命名blog。

  • 运行git bash,cd到blog文件夹下。输入

    1
    2
    3
    4
    5
    npm install -g hexo-cli		# 安装hexo
    hexo -v # 检查是否安装成功
    hexo init mstifiyblog # 初始化hexo,"mstifiyblog"为生成的hexo文件夹名,可自定义
    cd mstifiyblog # 进入这个mstifiyblog文件夹
    npm install

    mstifiyblog文件夹目录内容:

    • node_modules:依赖包
    • public:存放生成的页面
    • scaffolds:生成文章的一些模板
    • source:用来存放你的文章
    • themes:主题
    • ** _config.yml: 博客的配置文件**

    本地查看博客网页

    开启hexo服务:

    1
    2
    hexo g
    hexo server

    浏览器输入localhost:4000

1.4 GitHub创建个人仓库

创建public仓库<github用户名>.github.io

1.5 生成SSH添加到GitHub

1
2
3
4
5
6
7
8
# 配置git
git config --global user.name "yourname"
git config --global user.email "youremail"
# 验证配置
git config user.name
git config user.email
# 创建SSH
ssh-keygen -t rsa -C "youremail"

生成id_rsa(私人秘钥),id_rsa.pub(公共秘钥)。

GitHub->setting->SSH keys->New SSH key,把id_rsa.pub里面的信息复制进去。

1
ssh -T git@github.com	# 验证SSH

1.6 将hexo部署到GitHub

_config.yml,文件末尾修改:

1
2
3
4
deploy:
type: git
repo: https://github.com/<github账户名>/<github账户名>.github.io.git
branch: master
1
2
3
4
npm install hexo-deployer-git --save	# 安装deploy-git
hexo clean # 清除原数据
hexo generate # 生成静态文章,命令缩写:hexo g
hexo deploy # 部署文章,命令缩写:hexo d

配置成功后,通过浏览器输入:http://<github账户名>.github.io即可查看博客了。

1.7 设置个人域名

目前没有个人域名的需求,暂不记录。

1.8 发布文章

1
hexo new newpapername

source/_post中打开markdown文件编辑,写完后再:

1
2
3
hexo clean
hexo g
hexo d

更新成功。

2. 拓展部分

2.1 hexo基本配置

参考hexo官方文档:文档 | Hexo

2.2 更换主题

将主题源码从github上下载下来,放到theme文件夹下。然后在_config.yml配置文件中把theme换成目标主题文件夹的名字,它就会自动在theme文件夹中搜索配置的主题。

在目标主题文件夹下,也有一个配置文件_config.xml。这个配置文件是修改整个主题的配置文件。

menu(菜单栏)

新建自定义菜单栏选项:

1
hexo new page yourdiy		# yourdir为菜单栏名

然后在主题配置文件的menu菜单栏添加一个 Yourdiy : /yourdiy,注意冒号后面要有空格,以及前面的空格要和menu中默认的保持整齐。然后在languages文件夹中,找到zh-CN.yml,在index中添加yourdiy: '中文意思'就可以显示中文了。

fluid主题

配置指南 | Hexo Fluid 用户手册 (fluid-dev.com)

2.3 git分支进行多终端工作

2.4 其他拓展

参考文章:hexo史上最全搭建教程