hexo配置文件初识及主题更换

第一篇只是完成了基础的博客建立,接下来再带大家认识一下hexo中很重要的一部分–配置文件,里面包含了很多有用的配置选项,了解之后能使自己的博客更加定制化。同时默认的主题大家肯定也不会都喜欢,这个时候就需要更换主题。这一篇就带大家认识这两部分。

参考 https://hexo.io/zh-cn/docs/configuration.html

配置文件 _config.yml

网站Site

1
2
3
4
5
6
7
8
9
10
11
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# 博客的基本信息
title: 博客标题
subtitle: 博客副标题
description: 博客描述,部分主题会用来生成简介
author: 博客作者
language: 语言
timezone: 时区

其中,description主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

网址 URL

1
2
3
4
5
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com 你自己的域名
root: / 网站根目录,如果是github pages的子目录需要更改
permalink: 文章的 永久链接 格式 默认值:year/:month/:day/:title/
permalink_defaults: 永久链接中各部分的默认值

网站存放在子目录

如果您的网站存放在子目录中,例如 http://yoursite.com/blog,则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。

目录Directory

1
2
3
4
5
6
7
8
9
# 文件结构 默认即可
source_dir: source #资源文件夹,这个文件夹用来存放内容。
public_dir: public #公共文件夹,这个文件夹用于存放生成的站点文件。
tag_dir: tags #标签文件夹
archive_dir: archives #归档文件夹
category_dir: categories #分类文件夹
code_dir: downloads/code #Include code 文件夹
i18n_dir: :lang #国际化(i18n)文件夹
skip_render: #跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。

提示

如果您刚刚开始接触Hexo,通常没有必要修改这一部分的值。

文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Writing #编辑博文的选项
new_post_name: :title.md # 新文章的文件名称
default_layout: post # 预设布局
auto_spacing: false # 在中文和英文之间加入空格
titlecase: false # 把标题转换为 title case
external_link: true # 在新标签中打开链接
filename_case: 0 # 把文件名称转换为 (1) 小写或 (2) 大写
render_drafts: false # 显示草稿
post_asset_folder: false # 启动 Asset 文件夹
relative_link: false # 把链接改为与根目录的相对位址
future: true # 显示未来的文章
highlight: #代码高亮-代码块的设置
enable: true #是否启用
line_number: true #是否显示行号
auto_detect: true
tab_replace:

相对地址

默认情况下,Hexo生成的超链接都是绝对地址。例如,如果您的网站域名为example.com,您有一篇文章名为hello,那么绝对链接可能像这样:http://example.com/hello.html,它是绝对于域名的。相对链接像这样:/hello.html,也就是说,无论用什么域名访问该站点,都没有关系,这在进行反向代理时可能用到。通常情况下,建议使用绝对地址。

Category & Tag #分类与标签

1
2
3
default_category: uncategorized  # 默认分类
category_map: # 分类别名
tag_map: # 标签别名

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

1
2
3
4
5
6
# 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 # 时间格式

Pagination 分页器

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

Extensions 拓展

1
2
3
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: next # 当前主题名称。值为false时禁用主题

Deployment部署参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/xdlrt/xdlrt.github.io.git
branch: master

index_generator:
per_page: 3 ##首頁默认10篇文章标题 如果值为0不分页

archive_generator:
per_page: 10 ##归档页面默认10篇文章标题
yearly: true ##生成年视图
monthly: true ##生成月视图

tag_generator:
per_page: 10 ##标签分类页面默认10篇文章

category_generator:
per_page: 10 ###分类页面默认10篇文章
-------------本文结束感谢您的阅读-------------