front matter(扉页)使用
在YAML开头中使用---作为开头和结尾,在JSON格式中使用;;;作为结束
| 设置 | 描述 | 默认值 |
|---|---|---|
layout |
布局 | config.default_layout |
title |
标题 | 文章的文件名 |
date |
建立日期 | 文件建立日期 |
updated |
更新日期 | 文件更新日期 |
comments |
开启文章的评论功能 | true |
tags |
标签(不适用于分页) | |
categories |
分类(不适用于分页) | |
permalink |
覆盖文章的永久链接. 永久链接应该以 / 或 .html 结尾 |
null |
excerpt |
纯文本的页面摘要。 使用 该插件 来格式化文本 | |
disableNunjucks |
启用时禁用 Nunjucks 标签 {{ }}/{% %} 和 标签插件 的渲染功能 |
false |
lang |
设置语言以覆盖 自动检测 | 继承自 _config.yml |
published |
文章是否发布 | 对于 _posts 下的文章为 true,对于 _draft 下的文章为 false |
Front Matter就是预先告诉文章的基本属性
hexo 基础命令
init
$ hexo init [folder]
新建一个网站。 如果没有设置 folder ,Hexo 默认在目前的文件夹建立网站。
本命令相当于执行了以下几步:
- Git clone hexo-starter 和 hexo-theme-landscape 主题到当前目录或指定目录。
- 使用 Yarn 1、pnpm 或 npm 包管理器下载依赖(如有已安装多个,则列在前面的优先)。 npm 默认随 Node.js 安装。
new
$ hexo new [layout] <title>
hexo n
新建一篇文章。 如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。 使用布局 draft 来创建草稿。 如果标题包含空格的话,请使用引号括起来。
| 选项 | 描述 |
|---|---|
-p, --path |
文章的路径。 自定义文章的路径。 |
-r, --replace |
如果存在的话,替换当前的文章。 |
-s, --slug |
文章别名。 自定义文章的 URL。 |
默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。 对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。 你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:
hexo new page --path about/me "About me"
以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 "About me"
注意! title 是必须指定的! 例如,这不会产生您可能期望的行为:
hexo new page --path about/me
此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 "page"。 这是因为在上述命令中,hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout。
generate
$ hexo generate
hexo g
生成静态文件。
| 选项 | 描述 |
|---|---|
-d, --deploy |
在生成完成后部署。 |
-w, --watch |
监视文件变动 |
-b, --bail |
生成过程中如果发生任何未处理的异常则抛出异常 |
-f, --force |
强制重新生成 |
-c, --concurrency |
要同时生成的文件的最大数量。 默认无限制 |
publish
$ hexo publish [layout] <filename>
发表草稿。
server
$ hexo server
hexo s
启动服务器。 默认情况下,访问网址为: http://localhost:4000/。
| 选项 | 描述 |
|---|---|
-p, --port |
重设端口 |
-s, --static |
只使用静态文件 |
-l, --log |
启用日志。 Override logger format. |
deploy
$ hexo deploy
部署你的网站,到github(默认)
| 选项 | 描述 |
|---|---|
-g, --generate |
在部署前生成 |
render
$ hexo render <file1> [file2] ...
渲染文件。
| 选项 | 描述 |
|---|---|
-o, --output |
输出目标地址 |
migrate
$ hexo migrate <type>
从其他博客系统 迁移内容。
clean
$ hexo clean
hexo cl
清除缓存文件 (db.json) 和已生成的静态文件 (public)。
list
$ hexo list <type>
列出所有路由。
version
$ hexo version
hexo v
显示版本信息。
config
$ hexo config [key] [value]
列出网站的配置(_config.yml)。 如果指定了 key,则只展示配置中对应 key 的值;如果同时指定了 key 和 value,则将配置中对应的 key 的值修改为 value。
显示草稿
$ hexo --draft
显示 source/_drafts 文件夹中的草稿文章。
转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论,也可以邮件至 jaytp@qq.com