此文章使用 windows
系统介绍。
你需要:
- Git
- Nodejs(建议使用12.0及以上版本,推荐12.22.12版本)
- 没了
如何安装
Nodejs
打开这个链接,点击 node-v12.22.12-x64.msi
就可以下载 Nodejs
了。
Git
打开这个链接,点击右侧电脑,就可以下载 Git
了。
安装hexo
打开 Git Bash
,输入
npm install hexo
就可以安装 hexo
。
建站
安装 hexo
后,新建一个文件夹用于建站,进入文件夹,右键并点击 Git Bash Here
,输入
hexo init
npm install
hexo
就会在这个文件夹里新建需要的文件。
新建完成后,指定文件夹的目录如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
_config.yml
网站的配置信息,在本教程中这个会用到。
package.json
应用程序的信息。EJS
,Stylus
和 Markdown
渲染引擎已默认安装,您可以自由移除。
package.json
{
"name": "hexo-site",
"version": "0.0.0",
"private": true,
"hexo": {
"version": ""
},
"dependencies": {
"hexo": "^3.8.0",
"hexo-generator-archive": "^0.1.5",
"hexo-generator-category": "^0.1.3",
"hexo-generator-index": "^0.2.1",
"hexo-generator-tag": "^0.2.0",
"hexo-renderer-ejs": "^0.3.1",
"hexo-renderer-stylus": "^0.3.3",
"hexo-renderer-marked": "^0.3.2",
"hexo-server": "^0.3.3"
}
}
在本教程中这个屁用没有。
scaffolds
模版文件夹。当您新建文章时,Hexo
会根据 scaffold
来创建文件。
Hexo
的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改 scaffold/post.md
中的 Front-matter
内容,那么每次新建一篇文章时都会包含这个修改。
在本教程中这个屁用没有。
source
资源文件夹是存放用户资源的地方。除 _posts
文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown
和 HTML
文件会被解析并放到 public
文件夹,而其他文件会被拷贝过去。
在本教程中这个屁用没有。
themes
主题文件夹。Hexo 会根据主题来生成静态页面。
访问
你可以输入以下命令来访问你的博客。
hexo g
hexo s
然后打开网址为 http://localhost:4000/
的网站来访问,Git Bash
输入 Ctrl+C
关闭。
配置
打开 _config.yml
,有这些主要东西:
参数 | 描述 |
---|---|
titie |
网站标题 |
subtitle |
网站副标题 |
description |
网站描述 |
keywords |
网站的关键词。支持多个关键词 |
author |
你的名字 |
language |
网站使用的语言,本教程需要改成 zh-CN |
timezone |
网站时区。本教程需要改成 Asia/Shanghai |
其中,description
主要用于 SEO
,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author
参数用于主题显示文章的作者。
迁移
创建仓库
打开 Github->Settings->Repositories
,更改 main
为 master
,点击 Update
。
新建一个仓库,名为 你的用户名.github.io
。
生成 SSH
打开 git bash
,输入
git config --global user.name "你的Github用户名"
git config --global user.email "你的Github注册用的邮箱"
然后输入
ssh-keygen -t rsa -C "你的Github注册用的邮箱"
一直回车(注意有一个地方需要输入 y
),找到 .ssh
文件夹,用 txt
打开 id_rsa.pub
,复制里面的东西,然后回到 Github->Settings->SSH and GPG keys
,新建一个 SSH
,名字随便,把复制的内容粘贴进去。
Git Bash
输入
ssh -T git@github.com
查看是否成功。
部署到Github
打开 _config.yml
,把最后几行改成这样子:
deploy:
type: git
repo: git@github.com:GitHub用户名/Github用户名.github.io.git
branch: master
之后保存,Git Bash
输入
hexo clean
hexo g
hexo d
(注:以后一旦博客有改动都用这个命令更新)
部署到 Github
,等待一会,就可以用 Github用户名.github.io
这个网址访问你的博客了,如 https://zhuangjihong.github.io/
主题
hexo
默认的主题不好看,所以我们可以换一个,我用的是 fluid
。
安装
下载fluid最新版本,解压到 themes
目录,并将解压出的文件夹重命名为 fluid
。进入 fluid
文件夹,打开这个文件夹中的 _config.yml
文件,复制里面的内容,再在你用于部署博客的文件夹(也就是有 source
文件夹的文件夹)里新建一个 _config.fluid.yml
文件,打开,粘贴复制的内容,可以自定义一些比如说标题、背景图等参数,详见fluid配置指南。保存后运行前面提到过由于更新的命令,就可以看到效果了。