Hexo中文官网 https://hexo.io/zh-cn/

  1. 安装git
  2. 安装NodeJs
  3. 安装hexo
  4. 生成SSH并添加到github
  5. 部署项目到github
  6. 绑定个人域名
  7. 修改并配置主题
  8. 发布并管理文章

一、安装Git工具

Git官方网站 https://git-scm.com/

Windows安装

下载exe安装包直接安装下一步就可以
安装完成打开终端输入 git --version 输出版本号

Mac安装

1)首先查看电脑是否安装Git,终端输入:

git

安装过则会输出:

    MacBook-Pro:~ WENBO$ git
usage: git [--version] [--help] [-C <path>] [-c name=value]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
................
'git help -a' and 'git help -g' list available subcommands and some
concept guides. See 'git help <command>' or 'git help <concept>'
to read about a specific subcommand or concept.

2)通过homebrew安装Git

  • 未安装homebrew,需安装homebrew
 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • 安装git
 brew install git

Linux安装

根据自己系统选择使用
yum install -y git
或者
apt-get install -y git

二、安装Nodejs

Nodejs 官网 https://nodejs.org/en/

WIN安装Nodejs

官网下载对应exe版本,下一步安装

Mac安装Nodejs

类似于之前步骤,使用brew安装

brew install -g node

Linux安装Nodejs

Linux安装稍显复杂,时间原因没有整理,可查看百度或者试用此脚本
nodejs_install.sh

三、安装Hexo(此步骤以后Win、Mac等平台操作命令一样)

1)在自己想要的目录新建一文件夹,命名自定义 例如Hexo
2)终端进入到新建的目录
3)使用命令安装Hexo

npm install hexo-cli -g

4)安装完毕之后,输入 hexo -v输出版本信息

$ hexo -v
hexo: 4.0.0
hexo-cli: 3.1.0
os: Windows_NT 10.0.18362 win32 x64
http_parser: 2.8.0
node: 10.16.2
v8: 6.8.275.32-node.54
uv: 1.28.0
zlib: 1.2.11
brotli: 1.0.7
ares: 1.15.0
modules: 64
nghttp2: 1.34.0
napi: 4
openssl: 1.1.1c
icu: 64.2
unicode: 12.1
cldr: 35.1
tz: 2019a

5)初始化命令 hexo init
会输出以下目录结构

node_modules:是依赖包
public:存放的是生成的页面
scaffolds:命令生成文章等的模板
source:用命令创建的各种文章
themes:主题
_config.yml:整个博客的配置
db.json:source解析所得到的
package.json:项目所需模块项目的配置信息

6)使用命令npm install安装依赖
7)使用命令 hexo generate 生成页面
8)使用命令 hexo server 启动服务

$ hexo server
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

打开浏览器输入 http://localhost:4000 访问成功
使用Ctrl+C中断本地服务,也可使用命令hexo server -p 5000指定端口,访问http://localhost:5000/

四、生成SSH添加到github
1)登录github新建一个仓库,格式为 username.github.io
例如 我的用户名为 zhangsan 那么 仓库名应为 zhangsan.github.io

2) 回到gitbash中,配置github账户信息(YourName和YourEail都替换成你自己的):

git config --global user.name "YourName"
git config --global user.email "YourEail"

3)在gitbash中输入:ssh-keygen -t rsa -C "替换成你的github邮箱 生成ssh。
然后按终端给出的路径的方式找到id_rsa.pub文件 并复制其中的内容。

4)进到新建的github仓库 点击右上角setting进入设置找到Deploy keys
选择 Add Deploy keys Title随便填写 Key的内容为刚才复制的 id_rsa.pub文件中的内容

5)在gitbash中验证是否添加成功:ssh -T git@github.com

五、部署项目的github

1)用编辑器打开你的hexo项目文件夹,修改_config.yml文件的一些配置(冒号之后都是有一个半角空格的)

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

2)回到gitbash中,进入你的hexo目录,分别执行以下命令

npm install hexo-deployer-git --save  #安装部署工具
hexo clean   #清除缓存
hexo generate    #生成静态文件
hexo deploy    #部署到github

在浏览器中输入http://yourgithubname.github.io 就可以看到你的个人博客

六、修改配置文件,编辑网站信息

修改根目录下 _config.yml 文件的配置
官网页面
language zh-CN
timezone Asia/Shanghai

七、设置主题-obsidian

打开官方主页
安装

git clone https://github.com/TriDiamond/hexo-theme-obsidian.git obsidian

启用
打开 Hexo 配置文件 _config.yml, 设置主题为 obsidian

...
theme: obsidian
...

根据文档修改评论插件和代码块样式

添加搜索

npm install hexo-generator-search --save

在你的根目录配置 _config.yml 里面添加hexo-generator-search的配置

search:
  path: search.xml
  field: post
  content: true

hexo clean && hexo g

新建文章测试

hexo new 标题
编辑 source-- _post
添加分类、标签、和图片

title: My awesome title
date: 2019-07-14 18:38:45
categories:
    - 分类1
    - 分类2
tags:
    - 标签1
    - 标签2
mp3: http://domain.com/awesome.mp3
cover: http://domain.com/awesome.jpg

修改固定连接

中文链接容易乱码 修改为id
默认随机生成,可以指定

手动设置麻烦,修改文章模板

scaoffolds -- post.md

---
title: {{ title }}
date: {{ date }}
categories:
    -
tags:
    -
cover:
---

创建分类页和标签页,并修改对应模板

Last modification:November 14th, 2019 at 11:43 am
If you think my article is useful to you, please feel free to appreciate