配置

网站配置

配置_config.yml_,下面仅对常用配置作介绍，完整配置参考官方文档1

Site

字段 描述
title 网站标题
subtitle 副标题
description 描述
keywords 关键词
author 作者
language 语言。使用 2 个字母的 ISO-639-1 代码，或 它的变体。 默认为 en。
timezone 网站时区。 Hexo 默认使用您电脑的时区。 请参考时区列表进行设置，如 America/New_York, Japan, 和 UTC 。 一般的，对于中国大陆地区可以使用 Asia/Shanghai。

URL

字段 描述 默认值
url 网站对应的url，需以http://或是https://开头
root 网站根目录。 如果您的网站存放在子目录中，例如 http://example.com/blog ，则请将您的 url 设为 http://example.com/blog 并把 root 设为 /blog/ 。
permalink 文章的 永久链接 格式 :year/:month/:day/:title/
permalink_defaults 永久链接中各部分的默认值
pretty_urls 改写 permalink 的值来美化 URL
pretty_urls.trailing_index 是否在永久链接中保留尾部的 index.html，设置为 false 时去除 true
pretty_urls.trailing_html 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效 true

示例：

1
2
3
4
# e.g. page.permalink is http://example.com/foo/bar/index.html  
pretty_urls:  
  trailing_index: false   
# becomes http://example.com/foo/bar/

Directory

字段 描述 默认值
source_dir 源文件夹，内容存储位置 source
... ... ...
skip_render 匹配到的文件将会被不做改动地复制到public目录中。可使用glob表达式来匹配路径，避免一些不需要渲染的文件被渲染。

示例：

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

Extension

字段名 描述
theme 当前主题名称。 值为false时禁用主题
theme_config 主题的配置文件，在这里放置的配置会覆盖主题目录下的_config.yml中的配置
deploy 部署部分的设置

Include&Exclude

使用以下选项可明确处理或忽略某些文件/文件夹。 可以使用 glob 表达式进行路径匹配。
include 和 exclude 选项只会应用到 source/ ，而 ignore 选项会应用到所有文件夹。

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 处理或不处理目录或文件
include:
  - ".nojekyll"
  # 处理 'source/css/_typing.css'
  - "css/_typing.css"
  # 处理 'source/_css/' 中的任何文件，但不包括子目录及其其中的文件。
  - "_css/*"
  # 处理 'source/_css/' 中的任何文件和子目录下的任何文件。
  - "_css/**/*"

exclude:
  # 不处理 'source/js/test.js'。
  - "js/test.js"
  # 不处理 'source/js/' 中的文件、但包括子目录下的所有目录和文件。
  - "js/*"
  # 不处理 'source/js/' 中的文件和子目录下的任何文件。
  - "js/**/*"
  # 不处理 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件。
  - "js/test*"
  # 不处理 'source/js/' 及其子目录中任何以 'test' 开头的文件。
  - "js/**/test*"
  # 不要用 exclude 来忽略 'source/_posts/' 中的文件。
  # 你应该使用 'skip_render'。 或者在要忽略的文件的文件名之前加一个下划线 '_'。
  # - "_posts/hello-world.md" # 在这里配置是没有用的。

ignore:
  # 忽略任何一个名叫 'foo' 的文件夹。
  - "**/foo"
  # 只忽略 'themes/' 下的 'foo' 文件夹。
  - "**/themes/*/foo"
  # 对 'themes/' 目录下的每个文件夹中忽略名叫 'foo' 的子文件夹。
  - "**/themes/**/foo"

参考链接

  1. https://hexo.io/zh-cn/docs/configuration↩︎

Hexo使用指南
#Hexo
配置
https://ljxkkk0.github.io/Hexo使用指南/配置/
作者
ljx
发布于
2024年7月26日
许可协议