hexo站点配置文件配置项介绍

发表于 更新于 分类于 评论数： 阅读次数： 本文字数： 3.3k 阅读时长 ≈ 6 分钟

本章概述：站点配置文件配置项介绍

这篇文章主要是介绍一下站点配置文件中各配置项。

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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site 
title: Hexo       # 网站的标题
subtitle: ''      # 网站子标题
description: ''   # 网站的描述，主要用于SEO，告诉搜索引擎站点的描述
keywords:          # 网站的关键词，支持多个
author: John Doe  # 网站的作者
language: en      # 网站采用的语言，中文可以设置为zh-CN，这里需要参考主题配置的languages目录来配置
timezone: ''      # 网站的时区，默认使用电脑的时区

# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: http://example.com     # 网站的网址，必须以http或https开头
permalink: :year/:month/:day/:title/  # 文章永久链接的形成模版。每一篇文章都有唯一的url
permalink_defaults:    #文章永久链接中，各部分的默认值。
pretty_urls:   # 改写 permalink 的值来美化 URL
  # 是否在永久链接中保留尾部的 index.html，设置为 false 时去除
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
  # 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)
  trailing_html: true # Set to false to remove trailing '.html' from permalinks

# Directory
source_dir: source          # 资源文件夹，这个文件夹用来存放写的博客内容。
public_dir: public          # 公共文件夹，这个文件夹用于存放生成的站点文件。
tag_dir: tags               # 标签文件夹
archive_dir: archives       # 归档文件夹
category_dir: categories    # 分类文件夹
code_dir: downloads/code    # Include code 文件夹，source_dir 下的子目录
i18n_dir: :lang             # 国际化（i18n）文件夹
skip_render:                # 跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。

# Writing
new_post_name: :title.md # 默认新建的文件名
default_layout: post     # 新建文档的默认布局
titlecase: false          # 是否要把标题中的首字符大写
external_link:           
  enable: true           # 是否要在新开tab中打开链接
  field: site             # 对整个网站（site）生效或仅对文章（post）生效
  exclude: ''            # 需要排除的域名。主域名和子域名如 www 需分别配置
filename_case: 0         # 把文件名称转换为 (1) 小写或 (2) 大写
render_drafts: false     # 显示草稿
post_asset_folder: false # 是否启用资源文件夹。如启用，新建文档同时建立同名的资源文件夹
relative_link: false     # 是否把站内资源的链接改为站内相对链接。建议关闭。
future: true             # 文档中指定为未来时间创建
highlight:               
  enable: true           # 是否开启代码高亮功能
  line_number: true      # 代码块中是否在前面加上行号
  auto_detect: false     # 是否自动检测代码块的语言（比如xml、JavaScript、mermaid等）
  tab_replace: ''        # 用什么字符来代替tab(`\t`)字符。
  wrap: true
  hljs: false
prismjs:                 
  enable: false
  preprocess: true
  line_number: true
  tab_replace: ''

# Home page setting
# path: Root path for your blogs index page. (default = '')
# per_page: Posts displayed per page. (0 = disable pagination)
# order_by: Posts order. (Order by date descending by default)
index_generator:
  path: ''           # 主页所在路径，默认为''
  per_page: 10       # 主页的索引页包含文章数量，如未定义，则采用根目录下的`per_page`值
  order_by: -date    # 文章（Post类型）排序属性，`-`为降序  

# Category & Tag  # 分类及标签
default_category: uncategorized   # 对文档的默认分类
category_map:                     # 分类别名
tag_map:                          # 标签别名

# Metadata elements
## https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta
meta_generator: true

# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD      # 日期格式
time_format: HH:mm:ss        # 时间格式
## updated_option supports 'mtime', 'date', 'empty'
updated_option: 'mtime'

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10            # 每页显示的文章量 (0 = 关闭分页功能)
pagination_dir: page    # 分页目录

# 处理或不处理目录或文件
# Include / Exclude file(s)
## include:/exclude: options only apply to the 'source/' folder
include:
exclude:
ignore:


# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next   # 主题配置，参考上一篇博客

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:          # 部署时的配置，参考上一篇博客
  type: ''

站点配置文件的配置项就介绍到这里，这里面有很多配置项默认即可。