hexo博客部署到github

Introduce how to deploy hexo blog to github.

环境准备

安装Git

Git

安装nodejs

可以直接上https://nodejs.org/zh-cn/download/prebuilt-installer

有多版本需求的也可以用nvm管理多个版本的nodejs

nvm管理多版本nodejs环境

安装hexo

1
npm install hexo-cli -g

安装好后执行hexo -version

本地部署

初始化

找一个喜欢的目录用于存放博客

然后在当前目录下执行命令，这里hexo初始化一个默认模板

1
2
3
hexo init [blog_name]
cd [blog_name]
npm install

预览

1
2
3
hexo clean # 清除缓存文件，建议写完文章后执行一次
hexo g		# 生成 public 文件夹，写完文章执行
hexo s		# 启动 hexo 服务

然后访问http://localhost:4000/即可

看到这个说明就部署成功了

更换主题

Themes

这是官网的主题链接，目前有400+的主题，选择一个自己喜欢的主题

以 https://github.com/Ares-X/hexo-theme-freemind.bithack 这个主题为例

在 Readme 文档中往往写有如何使用的教程

主要是几个步骤

将主题下载到themes目录

安装环境运行的额外依赖包

然后修改配置文件，启用该主题

复制主题的_config.yml到博客根目录下，改名为_config.[theme_name].yml

然后给hexo根目录下的_config.yml文件中 theme 选项改为要换成的主题

然后根据主题修改配置文件_config.[theme_name].yml的内容进行个性化配置

https://hexo.io/docs/configuration.html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# 对照看着一下改就好:
# Hexo Configuration
## Docs: http://zespia.tw/hexo/docs/configure.html
## Source: https://github.com/tommy351/hexo/

# Site 
title: My Blog #博客名
subtitle: to be continued... #副标题
description: My blog #给搜索引擎看的，对网站的描述，可以自定义
author: Yourname #作者，在博客底部可以看到
email: yourname@yourmail.com #你的联系邮箱
language: zh-CN #中文。如果不填则默认英文

# URL #这项暂不配置，绑定域名后，欲创建sitemap.xml需要配置该项
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com
root: /
permalink: :year/:month/:day/:title/
tag_dir: tags
archive_dir: archives
category_dir: categories

# Writing 文章布局、写作格式的定义，不修改
new_post_name: :title.md # File name of new posts
default_layout: post
auto_spacing: false # Add spaces between asian characters and western characters
titlecase: false # Transform title into titlecase
max_open_file: 100
filename_case: 0
highlight:
  enable: true
  backtick_code_block: true
  line_number: true
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Archives 默认值为2，这里都修改为1，相应页面就只会列出标题，而非全文
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 1
category: 1
tag: 1

# Server 不修改
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
logger: false
logger_format:

# Date / Time format 日期格式，可以修改成自己喜欢的格式
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-M-D
time_format: H:mm:ss

# Pagination 每页显示文章数，可以自定义，贴主设置的是10
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Disqus Disqus插件，我们会替换成“多说”，不修改
disqus_shortname:

# Extensions 这里配置站点所用主题和插件，暂时默认
## Plugins: https://github.com/tommy351/hexo/wiki/Plugins
## Themes: https://github.com/tommy351/hexo/wiki/Themes
theme: landscape
exclude_generator:
plugins:
- hexo-generator-feed
- hexo-generator-sitemap

# Deployment 站点部署到github要配置(重点！！！)
## Docs: http://zespia.tw/hexo/docs/deploy.html
deploy:
  type: git
  repository: //这里是需要填的，下面会讲
  branch: master

按需修改完后一套小连招即可重新部署

1
2
3
hexo clean # 清除缓存文件，建议写完文章后执行一次
hexo g		# 生成 public 文件夹，写完文章执行
hexo s		# 启动 hexo 服务

部署到github托管

没有github账号的先注册一个账号

设置git的全局变量

1
2
git config --global user.name "user_name" # user_name填入GitHub用户名
git config --global user.email "user_email" # user_email填入GitHub注册的邮箱

新建一个 Repository，Repository name一定要是你的用户名.github.io，记得设为public，公开可见

然后在github配置ssh-key

访问C:\Users\你的用户名\.ssh目录，如果存在 id_rsa.pub 文件则复制其文件内容，如果不存在则生成一个

1
ssh-keygen -t rsa -C "user.email" # user.email为GitHub上注册的邮箱

然后直接三个回车即可，默认不需要设置密码，没太大必要

复制内容后，这就是你的公钥，访问 https://github.com/settings/keys 添加到github

然后我们在Git Bash中验证是否连接成功

修改_config.yml的配置项

然后就可以准备开始部署了，在git之前需要下载插件，需要在刚刚的博客目录下安装哦

1
npm install hexo-deployer-git --save

然后一套小连招部署到github

1
2
3
4
hexo clean
hexo g
hexo s
hexo d     // 部署

配置个人域名

在买域名的服务商处配置CNAME记录

在仓库中找到设置

写上需要解析的域名

然后就可以了

报错解决

fatal: not a git repository (or any of the parent directories): .git

虽然不知道为啥报错，但是将hexo根目录下的.deploy_git/删除掉，重新部署即可

本博客采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议(CC BY-NC-SA 4.0) 发布.
⬆︎TOP