Hexo配置文件详解
Posted wsmrzx
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Hexo配置文件详解相关的知识,希望对你有一定的参考价值。
写在前面的话:上一篇文章 我们已经实现了利用Hexo搭建一个可以在远端运行的网站了,而接下来我们将来了解一下网站的配置文件_config.yml,可以根据自己的习惯对网站进行个性化的定制优化哦
温馨提示:想要了解更规范的官方说明,可参考文档:https://hexo.io/docs/configuration
Site
Setting | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
keywords | 网站关键字 |
author | 网站作者 |
language | 网站使用的语言,默认是en ,中文网站填zh-Hans |
timezone | 网站使用的时区,默认为 计算机的预设置,可以不填 |
这里是对网站的个性化描述
URL
Setting | 描述 |
---|---|
url | 网站的网址 |
root | 网站的根目录, 也是文章存放的目录 |
permalink | 文章的链接格式 ,默认为 :year/:month/:day/:title/ |
permalink_defaults | 永久链接中每个段的默认值 |
这里一般可以不用进行更改
Directory
Setting | 描述 |
---|---|
source_dir | 资源文件夹 ,存放用户的资源文件,默认为 source |
public_dir | 公用文件夹 ,存放生成的静态文件,默认为 public |
tag_dir | 标签目录 ,默认为 tags |
archive_dir | 档案目录 ,默认为 archives |
category_dir | 分类目录 ,默认为 categories |
code_dir | 包含代码目录 ,默认为 downloads/code |
i18n_dir | i18n目录 ,默认为 :lang |
skip_render | 储存站长验证文件,跳过指定文件的渲染 |
这里一般可以不用进行更改
Writing
Setting | 描述 |
---|---|
new_post_name | 文章的文件名格式,默认为 :title.md |
default_layout | 预设的布局模板,默认为 post |
titlecase | 标题使用首字母大写模式 ,默认为 false |
external_link | 在新标签中打开链接,默认为 true |
filename_case | 将文件名转换为 1 小写 或 2 大写,默认为0 |
render_drafts | 显示渲染草稿,默认为 false |
post_asset_folder | 启用Asset文件夹,默认为 false |
relative_link | 建立相对于根文件夹的链接,默认为 false |
future | 显示未来的文章,默认为 true |
highlight | 代码块高亮设置 |
highlight
Setting | 描述 |
---|---|
enable | 使用代码高亮 ,默认为 true |
line_number | 显示行号 ,默认为 true |
auto_detect | 自动检测语言 ,默认为 false |
tab_replace | tab替代 |
这里的设置可能刚开始并不知道有什么用,但是这些其实都是比较常用的写作设置了,以后用习惯之后可以根据自己的需要改
Home page setting
Setting | 描述 |
---|---|
index_generator | 主页设置 |
index_generator
Setting | 描述 |
---|---|
path | 首页根目录 |
per_page | 每页显示文章数量,默认为 10 |
order_by | 文章顺序,默认为 -date |
首页设置,可以自己决定每页显示的文章数量和显示文章的顺序
Category & Tag
Setting | 描述 |
---|---|
default_category | 预设分类,默认为 uncategorized |
category_map | 分类别名 |
tag_map | 标签别名 |
暂时还没发现有更改的必要
Date / Time format
Setting | 描述 |
---|---|
date_format | 日期格式,默认为 YYYY-MM-DD |
time_format | 时间格式,默认为 HH:mm:ss |
时间和日期的显示格式,一般没特殊要求的也不需要改
Pagination
Setting | 描述 |
---|---|
per_page | 单个页面上显示的文章数量,默认为 10 ,用 0 表示禁用分页 |
pagination_dir | 分页目录,默认为 page |
这里是分页设置
Extensions
Setting | 描述 |
---|---|
theme | 博客使用的主题,默认为 landscape |
这里可以设置主题类型和插件
Deployment
Setting | 描述 |
---|---|
deploy | 网站部署配置 |
deploy
Setting | 描述 |
---|---|
type | 网站部署类型 |
repo | 网站部署地址 |
这里是关于网站部署的配置,常用的有部署类型和部署地址
写在后面的话 :至此我们已经对Hexo博客框架有了一个初步了解,可以根据自己的习惯进行一些配置优化,下一篇文章 我们将继续来分析Hexo框架的常用命令,谢谢大家
以上是关于Hexo配置文件详解的主要内容,如果未能解决你的问题,请参考以下文章