自建博客系列(六)Hexo博客的常用配置修改
2017-02-07 本文已影响114人
海天心Y2kking
在我的自建博客之路系列的前面几篇文章中,我们已经一起在本地和github、coding搭建起了自己的hexo博客站点,更换了Next主题,并且绑定了自己选择的个人独立域名,但是还未发表过文章,站点的配置还是原来的默认值。在本节,我们来进行个性化的设置,按照自身需要情况将站点打造成自己的。
这里首先要知道在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml,它们均是用于站点配置使用的。其中,一份位于站点根目录下(比如我的:D:\hexo_config.yml),主要包含 Hexo 本身整站的配置;另一份位于主题目录(D:\hexo\themes\next_config.yml)下,这份配置由主题作者提供,主要用于配置主题相关的选项。为了描述方便,在以下说明中,将前者称为站点配置文件, 后者称为主题配置文件。下面我们先来看看站点配置文件的配置修改。
修改配置文件时的注意点:
- 请使用Notepad++或者Sublime Text 2之类的程序,不要使用Windows自带的记事本。(如已忽略,产生中文乱码请修改文件编码格式为UTF-8。)
- 本人用的是Notepad++,需要的朋友可以到此处——npp_6.9.2——下载。
- 不要忽略了冒号后面的空格。
一、站点配置文件中可设置的功能
1.网站
参数 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
author | 您的名字 |
language | 网站使用的语言 |
timezone | 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York,Japan, 和 UTC 。 |
2.网址
项目 | 价格 | 数量 |
---|---|---|
url | 网址 | |
root | 网站根目录 | |
permalink | 文章的 永久链接 格式 | :year/:month/:day/:title/ |
permalink_default | 永久链接中各部分的默认值 |
3、目录
参数 | 描述 | 默认值 |
---|---|---|
source_dir | 资源文件夹,这个文件夹用来存放内容。 | source |
public_dir | 公共文件夹,这个文件夹用于存放生成的站点文件。 | public |
tag_dir | 标签文件夹 | tags |
archive_dir | 归档文件夹 | archives |
category_dir | 分类文件夹 | categories |
code_dir | Include code 文件夹 | downloads/code |
i18n_dir | 国际化(i18n)文件夹 | :lang |
skip_render | 跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。 |
4、文章
参数 | 描述 | 默认值 |
---|---|---|
new_post_name | 新文章的文件名称 | :title.md |
default_layout | 预设布局 | post |
auto_spacing | 在中文和英文之间加入空格 | false |
titlecase | 把标题转换为 title case | false |
external_link | 在新标签中打开链接 | true |
filename_case | 把文件名称转换为 (1) 小写或 (2) 大写 | 0 |
render_drafts | 显示草稿 | false |
post_asset_folder | 启动 Asset 文件夹 | false |
relative_link | 把链接改为与根目录的相对位址 | false |
future | 显示未来的文章 | true |
highlight | 代码块的设置 |
5、分类 & 标签
参数 | 描述 | 默认值 |
---|---|---|
default_category | 默认分类 | uncategorized |
category_map | 分类别名 | |
tag_map | 标签别名 |
6、日期-时间格式)日期 / 时间格式
Hexo 使用 Moment.js 来解析和显示时间。
参数 | 描述 | 默认值 |
---|---|---|
date_format | 日期格式 | YYYY-MM-DD |
time_format | 时间格式 | H:mm:ss |
7、分页
参数 | 描述 | 默认值 |
---|---|---|
per_page | 每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir | 分页目录 | page |
8、扩展
参数 | 描述 |
---|---|
theme | 当前主题名称。值为false时禁用主题 |
deploy | 部署部分的设置 |
二、可能需要安装的插件
1.添加百度/谷歌/本地 自定义站点内容搜索
在站点的根目录下执行以下命令:
npm install hexo-generator-searchdb --save
2.hexo-generator-feed 用于生成RSS订阅
npm install hexo-generator-feed --save
3.hexo-generator-sitemap 用于生成搜索引擎网站地图
npm install hexo-generator-sitemap --save
4.其他插件
更多插件请移步Hexo官方插件页了解
三、我个人目前的一些相关设置
title: Dream Come True
subtitle: 现实梦想
description: The Pursuit of Happyness
author: 海天心Y2kking
avatar: /images/avatar.png
email: 182036669@qq.com #你的联系邮箱
language: zh-Hans #语言包,需要主题自带才可设置。如Jcaman自带简繁英,设置简体中文填入 zh-CN
timezone:
# URL #这项暂不配置,绑定域名后,欲创建sitemap.xml需要配置该项
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://cometrue.top #站点域名
root: /
permalink: :year/:month/:day/:title/ #文章永久链接格式,可添加.html后缀,如 :title.html
permalink_defaults:
# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
enable: true
line_number: true
auto_detect: false
tab_replace:
# Category & Tag
default_category: uncategorized
category_map:
tag_map:
# 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
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page
# Extensions 主题选择
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next #当前主题名称
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo:
github: git@github.com:yusmile/yusmile.github.io.git,master
coding: git@git.coding.net:yusmile/yusmile.git,master
message: 'Daily updated:{{now("YYYY-MM-DD HH:mm:ss")}} by 海天心Y2kking personal PC'
# 自己另外添加的功能
#1.baidu_analytics
baidu_analytics: 8759f43af3e04f8088e92ff251867945
#2.站内搜索 Local Search 添加百度/谷歌/本地 自定义站点内容搜索。 需在站点的根目录下执行以下命令:$ npm install hexo-generator-searchdb --save
search:
path: search.xml
field: post
format: html
limit: 10000
#3.Feed 订阅
feed: # 需安装插件:npm install hexo-generator-feed --save
type: atom
path: atom.xml
limit: 20
hub:
#4.自动生成sitemap SEO推广,需执行以下命令,安装插件npm install hexo-generator-sitemap --save
sitemap:
path: sitemap.xml
baidusitemap:
path: baidusitemap.xml
#5.内容分享服务
# JiaThis 分享服务
jiathis: true
# 百度分享服务
baidushare: true
# 多说分享服务
duoshuo_share: true
duoshuo_hotartical: true # 多说热评文章 true 或者 false
duoshuo_shortname: yusmile
# Disqus Disqus插件,如果使用的话
#disqus_shortname:
四、检查成果
现在执行
hexo clean
hexo generate
hexo server
打开localhost:4000查看效果了。
一切顺利 ^_^既然来了,留下个喜欢再走吧,鼓励我继续创作……
如果喜欢我的文章,那就关注我的简书账号吧,我们一起做朋友~~
欢迎关注个人微信公众号:海天心