完美避坑:hexo+githubpages搭建博客

完美避坑:hexo+githubpages搭建博客~
#准备工作
1:git
2:nodejsv12+
3任意hexo主题,可以在这下载https://hexo.io/themes/
#正式开始
先去片尾看看吧!
#1.1 安装git

下载地址:https://registry.npmmirror.com/binary.html?path=git-for-windows/
注意!地址随时可能失效
建议尽快下载!
安装过程除了安装全选以外,其他全部下一步
#1.2 安装nodejs
对于官网那捉急的下载速度,我更推荐你去中文网,相较于git,nodejs的安装就很自动化
https://nodejs.cn/
安装完成后可能会有一个安装插件的过程,直接安装就行
tips:Windows Sever 2012 R2或Windows 8.1系统才能运行nodejsv14+,Windows 7只能运行nodejsv13-
#1.3 初始化:使用CMD&Git Bush进行准备工作(gitbush需要在命令串前加上”$”)
按下win+R
在弹出的窗口输入CMD

可以输入下面两行代码中的任意一行

[title] [url] [link text]
1
2
npm install hexo-cli -g #完整包
npm install hexo #局部包

完成操作后,现在,输入以下代码

[title] [url] [link text]
1
2
3
hexo init blog
cd blog
npm install

此时,你应该可以在C:\用户<你的用户名>中找到blog文件夹
#1.3.2 初始化:使用CMD&Git bush进行下一步工作
文件夹里应该有这些文件:

[title] [url] [link text]
1
2
3
4
5
6
7
8
.
├── _config.yml/_config.landscape.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

使用记事本或代码软件(如:notepad++)打开_config
你可以更改里面的参数
这是官方文档,转载于https://hexo.io/zh-cn/docs/configuration
参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
keywords 网站的关键词。支持多个关键词。
author 您的名字
language 网站使用的语言。对于简体中文用户来说,使用不同的主题可能需要设置成不同的值,请参考你的主题的文档自行设置,常见的有 zh-Hans和 zh-CN。
timezone 网站时区。Hexo 默认使用您电脑的时区。请参考 时区列表 进行设置,如 America/New_York, Japan, 和 UTC 。一般的,对于中国大陆地区可以使用 Asia/Shanghai。
输入以下代码

[title] [url] [link text]
1
2
hexo g
hexo s

在浏览器输入https://localhost:4000 查看预览
输入以下代码来添加自述文件

[title] [url] [link text]
1
hexo new page --path about/me "About me"

至此,基本步骤已经完成
#1.3.X 主题
我们可以通过主题来美化我们的博客
比如我这个就是Fluid主题
主题地址已在”#准备工作”栏标出
你可以去下载
下载完成后把它放入themes文件夹
并修改_config.yml文件
如 Fluid 就改为

[title] [url] [link text]
1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-fluid-1.9.5


记住!要全选复制到_config.landscape.yml
因为_config.landscape.yml是有优先级的,否则会报错
#2 部署
首先,需要一个Github账号
创建名为.github.io的储存库
打开git,输入以下代码

[title] [url] [link text]
1
2
3
4
$ git config --global user.name "示例用户名"
$ git config --global user.email "示例注册邮箱"
$ ssh-keygen -t rsa -C "示例注册邮箱" #要按3次enter
$ cat ~/.ssh/id_rsa.pub

把最后输出的那串字符复制到github上填写ssh密钥的地方,选择“只为一个库使用”
将_config.yml最后一串代码改为以下代码(不然要报错)

[title] [url] [link text]
1
2
3
4
deploy:
type: git
repo: git@github.com:<urse>/<urse>.github.io.git #urse是用户名
branch: gh-pages

最后输入以下代码:

[title] [url] [link text]
1
2
3
4
hexo clean #清理缓存
hexo g #生成网页
hexo d #部署
打开<urse>.github.io即可访问了

#3 写作
输入以下代码,写作时可以用HTML

[title] [url] [link text]
1
hexo new [layout] <title>

至此教程结束,Thank your watch!


完美避坑:hexo+githubpages搭建博客
https://scsdw.github.io/2023/07/27/完美避坑:hexo-githubpages搭建博客/
作者
GPUA
发布于
July 27, 2023
更新于
July 27, 2023
许可协议