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