前言

本篇仅介绍Hexo常用指令及Hexo博客搭建过程中使用的命令,需要完整教程请转至上篇Hexo博客搭建教程(全)


Hexo搭建(仅命令)

1、安装

  • 安装GIt
  • 安装Nodejs

检查配置是否成功

1
2
node -v
npm -v
  • 安装cnpm
1
npm install -g cnpm --registry=https://registry.npm.taobao.org

检查cnpm是否安装成功

1
cnpm -v
  • 安装hexo
1
cnpm install hexo-cli -g

2、初始化博客

1
hexo init

若在Install dependencies卡住则执行Ctrl + C结束命令

使用国内的镜像完成博客的初始化工作

1
cnpm install

3、配置主题

1
git clone 复制的地址 themes/主题名字

修改配置文件

打开博客根目录的_config.yml文件,找到theme这一行,修改主题名字

1
theme: next

4、上传

请先配置Git的SSH等信息

安装上传插件

1
cnpm install hexo-deployer-git --save

上传

1
2
hexo clean
hexo g -d

5、配置多终端工作

先在仓库中新建一个hexo分支,并设置默认分支为hexo(这样每次同步的时候就不用指定分支,比较方便)。

  1. 克隆hexo分支
1
git clone git@e.coding.net:eawakeofi/Colsrch/Colsrch.git
  1. 克隆到本地的Coding中,把除了.git 文件夹外的所有文件都删掉
  2. 把之前我们写的博客源文件全部复制过来,除了.deploy_git

这里应该说一句,复制过来的源文件应该有一个.gitignore,用来忽略一些不需要的文件,如果没有的话,自己新建一个,在里面写上如下,表示这些类型文件不需要git:

1
2
3
4
5
6
7
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/

注意,如果你之前克隆过theme中的主题文件,那么应该把主题文件中的.git文件夹删掉,因为git不能嵌套上传,最好是显示隐藏文件,检查一下有没有,否则上传的时候会出错,导致你的主题文件无法上传,这样你的配置在别的电脑上就用不了了。

  1. 上传
1
2
3
git add -A
git commit –m "add branch"
git push

6、更换电脑使用

一样的,跟之前的环境搭建一样,

  • 安装git

    • 设置git全局邮箱和用户名
    • 设置ssh key
  • 安装nodejs

  • 安装hexo

    但是已经不需要初始化了

直接在任意文件夹下,

1
git clone git@………………

然后进入克隆到的文件夹:

1
2
npm install
npm install hexo-deployer-git --save

生成,部署:

1
2
hexo g
hexo d

然后就可以开始写你的新博客了

1
hexo new "文章名"

Tips:

不要忘了,每次写完最好都把源文件上传一下

1
2
3
git add -A
git commit -m "xxx"
git push

如果是在已经编辑过的电脑上,已经有clone文件夹了,那么,每次只要和远端同步一下就行了

1
git pull

7、国内外分流

具体方法请查看上篇,这里只给出_config.yml的修改

hexo官方文档是这样的:

1
2
3
4
5
6
deploy:
type: git
message: [message]
repo:
github: <repository url>,[branch]
coding: <repository url>,[branch]

那么,我们只需要:

1
2
3
4
5
deploy:
type: git
repo:
coding: git@e.coding.net:eawakeofi/Colsrch/Colsrch.git,master
github: git@github.com:1332925715/1332925715.github.io.git,master

之后直接部署

1
2
hexo g
hexo d

常用命令

转自Hexo中文站

你无需全部记住,可以只记住下面几个常用的,具体作用可以点击对应命令跳转到其用法

命令 描述
init 初始化博客
new 新建文章
generate 生成静态文件
server 本地预览
deploy 部署博客
clean 清理缓存

init

1
hexo init [folder]

新建一个网站。如果没有设置 folder ,Hexo 默认在目前的文件夹建立网站。

new

1
hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

1
hexo new "post title with whitespace"
参数 描述
-p, --path 自定义新文章的路径
-r, --replace 如果存在同名文章,将其替换
-s, --slug 文章的 Slug,作为新文章的文件名和发布后的 URL

默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:

1
hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 "About me"

注意!title 是必须指定的!如果你这么做并不能达到你的目的:

1
hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 "page"。这是因为在上述命令中,hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout

创建草稿

1
hexo new draft "new draft"

会在source/_drafts目录下生成一个new-draft.md文件。但是这个文件不被显示在页面上,链接也访问不到。也就是说如果你想把某一篇文章移除显示,又不舍得删除,可以把它移动到_drafts目录之中。

1
2
3
4
5
//如果你希望强行预览草稿,更改配置文件:
render_drafts: true

//或者,如下方式启动server:
hexo server --drafts

发布草稿的指令:publish

generate

1
hexo generate

生成静态文件。

选项 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动
-b, --bail 生成过程中如果发生任何未处理的异常则抛出异常
-f, --force 强制重新生成文件 Hexo 引入了差分机制,如果 public 目录存在,那么 hexo g 只会重新生成改动的文件。 使用该参数的效果接近 hexo clean && hexo generate
-c, --concurrency 最大同时生成文件的数量,默认无限制

该命令可以简写为

1
hexo g

publish

1
hexo publish [layout] <filename>

发表草稿。

server

1
hexo server

启动服务器。默认情况下,访问网址为: http://localhost:4000/

选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式

deploy

1
hexo deploy

部署网站。

参数 描述
-g, --generate 部署之前预先生成静态文件

该命令可以简写为:

1
hexo d

render

1
hexo render <file1> [file2] ...

渲染文件。

参数 描述
-o, --output 设置输出路径

migrate

1
hexo migrate <type>

从其他博客系统 迁移内容

clean

1
hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令。

list

1
hexo list <type>

列出网站资料。

version

1
hexo version

显示 Hexo 版本