hexo使用手册

  1. front matter(扉页)使用
  2. hexo 基础命令
    1. init
    2. new
    3. generate
    4. publish
    5. server
    6. deploy
    7. render
    8. migrate
    9. clean
    10. list
    11. version
    12. config
    13. 显示草稿

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官方文档

Front Matter就是预先告诉文章的基本属性

hexo 基础命令

init

$ hexo init [folder]

新建一个网站。 如果没有设置 folder ,Hexo 默认在目前的文件夹建立网站。

本命令相当于执行了以下几步:

  1. Git clone hexo-starterhexo-theme-landscape 主题到当前目录或指定目录。
  2. 使用 Yarn 1pnpmnpm 包管理器下载依赖(如有已安装多个,则列在前面的优先)。 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 的值;如果同时指定了 keyvalue,则将配置中对应的 key 的值修改为 value

显示草稿

$ hexo --draft

显示 source/_drafts 文件夹中的草稿文章。


转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论,也可以邮件至 jaytp@qq.com

×

喜欢就点赞,疼爱就打赏