安装
首先需要安装 node.js,node.js 安装教程可参看 https://www.runoob.com/nodejs/nodejs-install-setup.html
然后执行npm install -g hexo
或 yarn global add hexo
安装 Hexo。
建站
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm i 或 yarn install
目录结构如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
在执行 hexo init 的时候可能git会报错,可以到 https://github.com/hexojs/hexo-starter.git 这个地址直接把 Hexo 项目下载下来,然后改成自己项目名字。
scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo 的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改 scaffold/post.md 中的 Front-matter 内容,那么每次新建一篇文章时都会包含这个修改。
_config.yml
网站的配置信息,可以配置网站名称、关键字、语言、作者、时区等信息。
source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
themes
主题文件夹。可以去 https://hexo.io/themes/ 寻找喜欢的主题。
安装主题
我使用的主题是 pure
启用主题
在你的 hexo 项目文件夹下执行:
git clone https://github.com/cofess/hexo-theme-pure.git themes/pure
修改配置文件 hexo/_config.yml
中 theme
为 pure
。
gitalk 评论
Gitalk 是一个基于 Github Issue 的评论插件,每增加一条评论相应的在 GitHub 项目增加一条 Issue。
注册 GitHub Application
到 https://github.com/settings/applications/new 注册 GitHub Application
填写 Application name(项目名称),Homepage URL(博客链接),Application description(描述),authorization callback URL(回调地址,博客链接)等信息,完成注册,获取到 Client ID 和 Client Secret。
如果项目在 Organization 下,需要进入到相应的 Organization,点击 Settings > OAuth Apps,注册 GitHub Application。
配置 _config.yml
配置文件位置 themes/pure/_config.yml。
修改 comment > type 为:gitalk,将 Client ID 和 Client Secret 填写的相应位置,并填写 owner,admin,repo。owner 为项目所有者,如果是 Organization,这填写 Organization 名称。admin 为你的用户名,repo 对应 GitHub 中的项目名。
常用命令
创建一个新网站
hexo init [folder]
新建一篇文章
$ hexo new [layout] <title>
layout 可选,如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。如:
$ hexo new "post title with whitespace"
参数 | 描述 |
---|---|
-p, --path | 自定义新文章的路径 |
-r, --replace | 如果存在同名文章,将其替换 |
-s, --slug | 文章的 Slug,作为新文章的文件名和发布后的 URL |
默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:
hexo new page --path about/me "About me"
生成静态文件
$ hexo generate 或 g
参数 | 描述 |
---|---|
-d, --deploy | 文件生成后立即部署网站 |
-w, --watch | 监视文件变动 |
示例
检测文件变动实时预览:
$ hexo g -w
生成文件自动部署:
$ hexo g -d
启动服务器
$ hexo server 或 s
默认情况下,访问网址为: http://localhost:4000/。
部署
$ hexo deploy
部署方式请看 https://hexo.io/zh-cn/docs/one-command-deployment
清除缓存文件
$ hexo clean