hexo详细指南

hexo官方文档

官方中文文档
本文章参考为官方文档

安装

前提

1. nodejs
   nodejs官网
   建议使用 Node.js 12.0 及以上版本
2. git
   git官网

关于安装nodejs后安装hexo的权限问题

如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误，请遵循 由 npmjs 发布的指导 修复该问题。强烈建议 不要 使用 root、sudo 等方法覆盖权限

npmjs指导

大概两点解决方案

1. 使用node版本控制器重装npm（推荐）

   npm install -g npm # 这个是安装最新版

2. 手动更改npm的安装目录
   1. 备份电脑
   2. mkdir ~/.npm-global # 在home目录，创建文件夹给全局安装
   3. npm config set prefix ‘~/.npm-global’ # 配置npm使用新目录
   4. export PATH=~/.npm-global/bin:$PATH # 打开或创建~/.profile文件并加入此句
   5. source ~/.profile # 更新系统环境变量
   6. npm install -g jshint # 全局安装一个包来测试新配置（不要使用sudo）

关于mac编译时可能会遇到的问题

如果在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

安装hexo

使用npm安装hexo

npm install -g hexo-cli

进阶安装

适合熟悉hexo的用户
npm install hexo

两种方式执行 Hexo

• npx hexo
• 将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo ：

  echo ‘PATH=“$PATH:./node_modules/.bin”’ >> ~/.profile

Node.js 版本限制

hexo的使用

执行以下命令，hexo将在指定文件夹新建所需的文件

hexo init <folder>
cd <folder>
npm install

新建完成后，指定文件夹的目录结构如下
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

目录结构含义

_config.yml

网站的 配置 信息，您可以在此配置大部分的参数。

如果网站存放在子目录中，例如 http://example.com/blog，则要把 url 设为 http://example.com/blog 并把 root 设为 /blog/。

比如，一个页面的永久链接是 http://example.com/foo/bar/index.html
pretty_urls:
trailing_index: false
此时页面的永久链接会变为 http://example.com/foo/bar/

skip_render: "mypage/**/*"
# 将会直接将 `source/mypage/index.html` 和 `source/mypage/code.js` 不做改动地输出到 'public' 目录
# 你也可以用这种方法来跳过对指定文章文件的渲染
skip_render: "_posts/test-post.md"
# 这将会忽略对 'test-post.md' 的渲染

默认情况下，Hexo 生成的超链接都是绝对地址。例如，如果您的网站域名为 example.com，您有一篇文章名为 hello，那么绝对链接可能像这样：http://example.com/hello.html，它是绝对于域名的。相对链接像这样：/hello.html，也就是说，无论用什么域名访问该站点，都没有关系，这在进行反向代理时可能用到。通常情况下，建议使用绝对地址。

通常配置

1. site部分的网站名称和副标题名称
2. deployment部分的type那块，比如使用git

package.json

应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装，您可以自由移除。

package.json
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^3.8.0",
    "hexo-generator-archive": "^0.1.5",
    "hexo-generator-category": "^0.1.3",
    "hexo-generator-index": "^0.2.1",
    "hexo-generator-tag": "^0.2.0",
    "hexo-renderer-ejs": "^0.3.1",
    "hexo-renderer-stylus": "^0.3.3",
    "hexo-renderer-marked": "^0.3.2",
    "hexo-server": "^0.3.3"
  }
}

scaffolds

模版 文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。

Hexo的模板是指在新建的文章文件中默认填充的内容。例如，如果您修改scaffold/post.md中的Front-matter内容，那么每次新建一篇文章时都会包含这个修改。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

主题 文件夹。Hexo 会根据主题来生成静态页面。

指令

init

hexo init
如果没有设置folder，默认在当前文件夹下建立网站

new

hexo new [layout]