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配置文件详解的主要内容,如果未能解决你的问题,请参考以下文章

Hexo+NexT:Next主题配置详解

Hexo+NexT:Hexo站点及Next主题配置详解

hexo 搭建静态博客 + Next 主题配置

hexo常用命令

一文详解Hexo+Github小白建站

Hexo系列 | Hexo源文件备份(防丢失)