是什么 ? | : | a fast, simple & powerful static website generator. |
开发语言 | : | Node.js |
官方主页 | : | https://hexo.io |
源码仓库 | : | https://github.com/hexojs/hexo |
包管理器 | 安装命令 |
---|---|
npm | npm install -g hexo-cli |
yarn | yarn global add hexo-cli |
hexo
命令的使用方式为:
hexo COMMAND
查看COMMAND
的使用帮助。
示例:
创建Hexo
项目。
这个过程可能会比较慢,主要做了2件事情:
生成项目的文件和目录结构如下:
文件和目录的作用:
_config.yml | 项目配置文件 |
package.json | 项目依赖配置及开发者信息 |
node_modules | 存放所有的项目依赖库的地方 |
source | 源文件存放目录 |
scaffolds | 模板文件存放目录 |
themes | 主题存放目录 |
启动Hexo
用于本地开发的HTTP服务器。
option
有如下:
--port | 设置监听的端口号,默认是4000 |
--log | 打开日志 |
--open | 启动成功后会立即打开浏览器 |
示例:
网站界面如下:
这样我们在本地编写的时候,在部署到服务器之前,都可以在本地进行预览。没有问题之后再进行部署。
生成一篇新文章。
layout
是模板名称,模板是放在scaffolds
中的那些.md
文件, 文件名前缀就是模板名称。默认的,此目录下有3
个文件,分别是draft.md
、page.md
、post.md
。您也可以根据自己的需要自己添加文件。
layout
参数不是必需的,默认是post
。
title
既是生成的文件名前缀,也是页面的标题。
这个命令执行后,会生成一个source/_posts/<fileName>.md
的文件, 我们从后缀名即可知道,这是Markdown
文件。我们以后编写博客就用Markdown
语言了。
为什么使用这个命令来创建Markdown
文件呢?这是因为这命令生成的文件会有一些额外的信息,比如标签、创建时间等。 而且此命令创建的Markdown
文件是在模板文件的基础上得来的,我们可以直接修改模板文件,非常方便。
如果我们想将Markdown
转换成HTML
等静态资源文件,可以使用下面的命令:
hexo generate
执行这个命令后,会发现多了一个db.json
的文件和public
的文件夹。
public
的文件夹中存放的就是我们的静态网站资源。
等开发完成后,我们为了让别人访问到我们的网站,就需要部署到服务器上。
静态博客
可以被方便的部署在GitHub Pages、Gitee Pages上。
https://hexo.io/themes是个专门的主题市场, 目前大约有260
多个主题可以使用。
点击这些主题的链接,通常都是跳转到GitHub上的对应项目中。
项目的描述中有详细的安装说明。不过一般的步骤如下:
1、进入项目的themes
目录:
cd themes
2、使用git下载主题:
git clone https://github.com/yelog/hexo-theme-3-hexo.git
3、修改_config.yml
中的theme: landscape
为theme: hexo-theme-3-hexo
4、重新部署。
大部分主题,通过上面的步骤就可以安装成功了,不过,有些复杂的主题,需要配置的东西很多,需要看他们的详细说明。