前言
本篇仅介绍Hexo常用指令及Hexo博客搭建过程中使用的命令,需要完整教程请转至上篇Hexo博客搭建教程(全)
Hexo搭建(仅命令)
1、安装
- 安装GIt
- 安装Nodejs
检查配置是否成功
1 | node -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 | hexo clean |
5、配置多终端工作
先在仓库中新建一个hexo分支,并设置默认分支为hexo(这样每次同步的时候就不用指定分支,比较方便)。
- 克隆hexo分支
1 | git clone git@e.coding.net:eawakeofi/Colsrch/Colsrch.git |
- 克隆到本地的Coding中,把除了.git 文件夹外的所有文件都删掉
- 把之前我们写的博客源文件全部复制过来,除了.deploy_git
这里应该说一句,复制过来的源文件应该有一个.gitignore,用来忽略一些不需要的文件,如果没有的话,自己新建一个,在里面写上如下,表示这些类型文件不需要git:
1 | .DS_Store |
注意,如果你之前克隆过theme中的主题文件,那么应该把主题文件中的.git
文件夹删掉,因为git不能嵌套上传,最好是显示隐藏文件,检查一下有没有,否则上传的时候会出错,导致你的主题文件无法上传,这样你的配置在别的电脑上就用不了了。
- 上传
1 | git add -A |
6、更换电脑使用
一样的,跟之前的环境搭建一样,
安装git
- 设置git全局邮箱和用户名
- 设置ssh key
安装nodejs
安装hexo
但是已经不需要初始化了
直接在任意文件夹下,
1 | git clone git@……………… |
然后进入克隆到的文件夹:
1 | npm install |
生成,部署:
1 | hexo g |
然后就可以开始写你的新博客了
1 | hexo new "文章名" |
Tips:
不要忘了,每次写完最好都把源文件上传一下
1 | git add -A |
如果是在已经编辑过的电脑上,已经有clone文件夹了,那么,每次只要和远端同步一下就行了
1 | git pull |
7、国内外分流
具体方法请查看上篇,这里只给出_config.yml
的修改
hexo官方文档是这样的:
1 | deploy: |
那么,我们只需要:
1 | deploy: |
之后直接部署
1 | hexo g |
常用命令
转自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 | //如果你希望强行预览草稿,更改配置文件: |
发布草稿的指令: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 版本