Hexo 博客 github.io MD

Markdown版本笔记	个人GitHub首页	个人博客	个人微信	个人邮箱
MyAndroidBlogs	baiqiantao	baiqiantao	bqt20094	baiqiantao@sina.com

---

目录

目录
Hexo
博客网站搭建
本地环境配置
配置 SSH keys
发布项目
源码结构
建立文章
布局 layout
文件名称 title
草稿 drafts
Front-matter
资源文件夹 asset
模版 scaffolds
分类和标签
命令
服务器 server
生成文件 generate
部署 deploy
永久连接 permalinks
示例
多语种支持
主题 themes
国际化 i18n
推荐主题
使用主题
插件 plugins
连接持久化插件
自动生成分类插件
配置文件 config

Hexo

Hexo 官网中文文档
个人首页
使用技巧

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其余渲染引擎）解析文章，在几秒内，便可利用靓丽的主题生成静态网页。

Hexo 是高效的静态站点生成框架，她基于 Node.js。 经过 Hexo 你能够轻松地使用 Markdown 编写文章，除了 Markdown 自己的语法以外，还可使用 Hexo 提供的 标签插件 来快速的插入特定形式的内容。

标签插件和 Front-matter 中的标签不一样，它们是用于在文章中快速插入特定内容的插件。

博客网站搭建

使用 hexo + github 搭建博客网站过程

本地环境配置

环境配置

• 打开cmd，输入git --version，能够看到打印的Git版本信息。若是没有，请配置Git环境变量。
• 打开cmd，输入node -v和npm -v，能够看到打印的Node和npm版本信息。若是没有，请配置Node环境变量。
• 打开cmd，输入hexo -v，检查hexo是否安装成功，若没有安装，可输入npm install hexo -g安装。

因为Hexo的不少操做都涉及到命令行，您能够考虑始终使用Git Bash来进行操做。

项目配置

• 在任意目录建立一个文件夹，而后经过命令行进入到该文件夹里面
• 输入hexo init初始化，最后会看到成功提示INFO Start blogging with Hexo!
• 输入npm install安装所须要的组件
• 输入hexo g或hexo generate生成html、js、css、png等网页相关的文件
• 输入hexo s或hexo server开启服务器，在浏览器中输入 http://localhost:4000 即可正式体验 Hexo

在服务器启动期间，Hexo 会监视文件变更(包括文件内容变动以及新增删除文件变动)并自动更新，您无须重启服务器
咱们能够经过Ctrl+c中止服务器，
若是您想要更改端口，或是在执行时遇到了 EADDRINUSE 错误，能够输入hexo server -p 端口号来改变端口号

配置 SSH keys

建立 SSH Keys

• 在任意目录右键，点击git bash here，而后经过cd ~/.ssh命令可快速定位到C盘->用户->本身的用户名->.ssh目录
• 若是C盘->用户->本身的用户名下没有.ssh目录，可经过cd ~而后mkdir .ssh命令建立
• 查看.ssh目录下是否有id_rsa、id_rsa.pub文件，也可经过ls命令查看，若是没有须要按如下步骤生成
• 输入ssh-keygen -t rsa -C "baiqiantao@sina.com"生成密钥，密钥类型能够用-t选项指定，这里使用的是rsa；-C用来指定注释，这里输入本身的邮箱或者其余都行。
• 以后会让你确认文件名和输入密语(passphrase)，空表示没有密语；什么都不要输入，连输三个回车就行。
• 而后会发如今当前目录中生成了两个文件，其中id_rsa是私钥文件，id_rsa.pub文件是公钥文件
• 打开你的id_rsa.pub文件，复制下里面的内容

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCy8mYQSRxSi3RdisKxEPM2QUDcuyEI5KR3XS7pLhO9nXqKCRSCZk+MPdQQiIGW56Y7zNz5eUvzIOSW79OReZoEVHqLD5z4L56n13HhvCfFO/HXujOBYsWB1pzI6Lj25MHMZDyUtnJXzbvs8Kiqh3rFi9gy0ogdOEETG6WuTlkOijGE4ly7Ll6KyWRJRBm7X7Sof4jyOuNwholLiU0Zidaykac41/OXVyp/MpX6PeCyv1h5f36Uhsgut82olAOUN+AsYsVOrN9ab/C24jS1BmTXcjGlw8wHUQ9h/URMnOGk8jsJ+fJQf2MIv7LpdpPFANEx6nNW0IrIgFzttPm4wfWR baiqiantao@sina.com

配置到 GitHub

• 进入Github首页，右上角头像旁边的三角形 -> Settings -> SSH and GPG keys -> New SSH key
• 在Title处填入任意的标识，在Key部分里面添加刚才复制的id_rsa.pub文件里的内容，点击添加便可
• 验证 SSH Keys 是否添加成功：ssh -T git@github.com

若是是第一次的会提示是否continue，输入Yes后若是看到以下提示就表示已成功连上Github：
Hi baiqiantao! You've successfully authenticated, but GitHub does not provide shell access.

发布项目

建立 GitHub 项目

• 新建项目(New repositor)，项目名称必需要严格遵照以下格式：帐户名.github.io，好比个人为baiqiantao.github.io，否则接下来会有不少麻烦。
• 建立完以后点击Settings并找到GitHub Pages一栏，你会看到那边有个网址，点击访问它，你将会惊奇的发现该项目已经被部署到网络上，可以经过外网来访问它。
• 点击Choose a theme，还能够选择本身喜欢的主题，选择以后保存，再访问刚才那个网站，会发现选择已经生效了。

将 Hexo 部署到 Github
先安装git插件：

npm install hexo-deployer-git --save

而后在项目文件夹根目录中，找到_config.yml文件，修改末尾的deploy为以下：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:baiqiantao/baiqiantao.github.io.git
  branch: master

而后输入hexo d或hexo deploy，完成之后，你就能在你的Github上看到上传的代码了，这时看到的应该是纯静态的一个站点。能够发现，GitHub上上传的仅仅是public目录下的文件。

注意，hexo d 只会上传 public 目录中生成的文件，而不会生成静态文件，因此你可能须要先执行 hexo g 命令生成静态文件。

而后等待几分钟，访问 baiqiantao.github.io 便可发现本身的博客能够访问了！到此为止，最基本的也是最全面的hexo + github搭建博客网站过程完结。

源码结构

文件/文件夹	说明
_config.yml	配置文件，无论是博客的基础配置，仍是模板，都是修改这个文件
package.json	应用程序的信息
public	生成的静态文件，这个目录最终会发布到服务器(上传到GitHub仓库)
scaffolds	模板文件夹。当您新建文章时，Hexo 会根据 scaffold 来创建文件。Hexo的模板是指在新建的 Markdown 文件中默认填充的内容，通常用于配置title、date、tags等信息。
source	资源文件夹。咱们平常操做的文件夹，_drafts为草稿文件，_posts为发布的文章。除_posts文件夹以外，开头命名为_的文件、文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到public文件夹，而其余文件会被拷贝过去。
themes	主题 文件夹。Hexo 会根据主题来生成静态页面。

注意，若是出现乱码状况，极可能是你的markdown文件或_config.yml配置文件不是以utf-8编码格式保存的。

建立文章

官方新编写BLOG，建议的是使用命令

hexo new [layout] <title>

其实，你能够直接在source/_drafts新建草稿文章，在source/_posts新建发布文章。而后在文章顶部加上相关的描述，如:

---
title: new 命令中输入的 title
date: 2019-03-14 17:38:41
---

这个效果和用命令新建文件是同样同样的。

注意，从其余地方拷文件到source/_posts时，须要保证文件头有必要的描述(通常title是必须的)，不然此文件可能会被忽略
注意，若是发布后出现乱码状况，极可能是你的文章或_config.yml配置文件不是以utf-8编码格式保存的

布局 layout

Hexo 有三种默认布局：post、page 和 draft，它们分别对应不一样的路径，而您自定义的其余布局和post相同，都将储存到 source/_posts 文件夹。

布局	路径
post	source/_posts，默认title便是文件名
page	source，默认title是文件夹名，文件名为index.md
draft	source/_drafts，默认title便是文件名

若是你不想你的文章被处理，你能够将 Front-Matter 中的layout: 设为 false。

好比使用命令hexo new false 测试layout建立一篇文章，执行后会在source\_posts中生成测试layout.md文件，文件内容为：

---
layout: 'false'
title: 测试layout
date: 2019-03-15 13:37:40
tags:
---

# 这里是添加的文章内容  
此内容*不会*被渲染，**固然**，原始的`markdown`仍是被渲染成了`html`。其中`false`能够*不加*引号。

而后执行hexo g -d，完成后发现访问此文章，发现此文章没有任何被设置任何主题等效果(固然，原始的markdown仍是被渲染成了html)

文件名称 title

Hexo 默认以标题作为文件名称(默认值:title.md)，但您可编辑 new_post_name 参数来改变默认的文件名称。

变量	描述
:title	标题。小写，空格将会被替换为短杠，默认值为:title.md
:year	创建的年份，好比， 2015
:month	创建的月份（有前导零），好比， 04
:i_month	创建的月份（无前导零），好比， 4
:day	创建的日期（有前导零），好比， 07
:i_day	创建的日期（无前导零），好比， 7

草稿 drafts

刚刚提到了 Hexo 的一种特殊布局：draft，这种布局在创建时会被保存到 source/_drafts 文件夹。您可经过 hexo publish [layout] <filename> 命令将草稿中的指定文件(不带后缀名) 移动 到 source/_posts 文件夹，该命令的使用方式与 new 十分相似，您也可在命令中指定 layout 来指定布局。

草稿默认不会显示在页面中，您可在执行时加上--draft参数，或是把render_drafts参数设为true来预览草稿。

Front-matter

Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量，举例来讲：

title: Hello World
date: 2013/7/13 20:46:25
---

如下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

参数	描述	默认值
layout	布局
title	标题
date	创建日期	文件创建日期
updated	更新日期	文件更新日期
comments	开启文章的评论功能	true
tags	标签（不适用于分页）
categories	分类（不适用于分页）
permalink	覆盖文章网址

例如，若是你在模板中正文部分添加以下内容：

布局为 {{ layout }}，标题为 {{ title }}，创建日期为 {{ date }}，更新日期为 {{ updated }}
开启评论功能 {{ comments }}，标签为 {{ tags }}，分类为 {{ categories }}，覆盖文章网址 {{ permalink }}

那么，在发布后实际的效果为(PS：经过此模板建立的文章的内容并无改变，只是发布后内容才改变)：

资源文件夹 asset

资源（Asset）表明 source 文件夹中除了文章之外的全部文件，例如图片、CSS、JS 文件等。比方说，若是你的Hexo项目中只有少许图片，那最简单的方法就是将它们放在 source/images 文件夹中。而后经过相似于 ![](/images/image.jpg) 的方法访问它们。

如下几种方式貌似均可以【images/image.jpg】【/images/image.jpg】【../images/image.jpg】

文章资源文件夹
对于那些想要更有规律地提供图片和其余资源，以及想要将他们的资源分布在各个文章上的人来讲，Hexo也提供了更组织化的方式来管理资源。这个稍微有些复杂可是管理资源很是方便的功能能够经过将 config.yml文件中的 post_asset_folder 选项设为 true 来打开。

当资源文件管理功能打开后，Hexo将会在你每一次经过 hexo new [layout] <title> 命令建立新文章时，自动在此文章同一目录中建立一个同名的文件夹。将全部与你的文章有关的资源放在这个关联文件夹中以后，你能够经过相对路径来引用它们，这样你就获得了一个更简单并且方便得多的工做流。

相对路径引用的标签插件

{% asset_path slug %}        //打印相对路径
{% asset_img slug [title] %}        //显示图片
{% asset_link slug [title] %}        //生成图片连接

好比说：当你打开文章资源文件夹功能后，你把一个 example.jpg 图片放在了你的资源文件夹中，若是经过使用相对路径的常规 markdown 语法 ![](/example.jpg) ，它将 不会 出如今首页上。（可是它会在文章中按你期待的方式工做）

正确的引用图片方式是使用下列的标签插件而不是 markdown ：

{% asset_img example.jpg 鼠标在图片上悬浮时显示的内容 %}

经过这种方式，图片将会同时出如今文章和主页以及归档页中。

模版 scaffolds

在新建文章时，Hexo 会根据scaffolds文件夹内相对应的文件来创建文件，例如：

hexo new abc "My Gallery"

在执行这行指令时，Hexo 会尝试在 scaffolds 文件夹中寻找 abc.md，并根据其内容创建文章。

你能够在模板中的Front-matter中直接使用如下三个值(其余 Front-matter 不支持)：

---
title: {{ title }}
date: {{ date }}
layout: {{ layout }}
---

这样以后，你经过此模板建立的文章中的这三个变量就有值了。

分类和标签

只有文章支持分类和标签，您能够在 Front-matter 中设置。在其余系统中，分类和标签听起来很接近，可是在 Hexo 中二者有着明显的差异：分类具备顺序性和层次性，也就是说 Foo, Bar 不等于 Bar, Foo；而标签没有顺序和层次。

categories:
- Android
tags:
- 小经验
- 面试心得

category_map 和 tag_map
在_config.yml中，咱们能够经过category_map给一个 category 设置别名，而后在组合 url 的时候，用这个 slug 来替代 category 名称。tag_map的功能相似。

例如：

category_map: # 分类别名
  baiqiantao: bqt    #在组合 url 时，用 bqt 代替 baiqiantao

命令

hexo init [folder]    //新建网站。若是没有设置 folder，Hexo 默认在目前的文件夹创建网站
hexo new [layout] <title>    //新建一篇文章。若是没有设置 layout，默认使用 default_layout 参数代替。若是标题包含空格，请使用引号括起来
hexo generate  //能够简写为 hexo g，生成静态文件
hexo publish [layout] <filename>    //发表草稿
hexo server    //能够简写为 hexo s，启动服务器
hexo deploy //能够简写为 hexo d，部署网站
hexo render <file1> [file2] ...    //渲染文件。`-o`设置输出路径
hexo migrate <type>    //从其余博客系统迁移内容
hexo clean    //清除缓存文件(db.json)和已生成的静态文件(public)
hexo list <type>    //列出网站资料
hexo version    //显示 Hexo 版本
hexo --safe    //安全模式。在安全模式下，不会载入插件和脚本。当您在安装新插件遭遇问题时，能够尝试以安全模式从新执行
hexo --debug    //调试模式。在终端中显示调试信息并记录到`debug.log`
hexo --silent    //简洁模式。隐藏终端信息
hexo --config custom.yml    //自定义配置文件的路径
hexo --draft    //显示`source/_drafts`文件夹中的草稿文章
hexo --cwd /path/to/cwd    //自定义当前工做目录的路径

服务器 server

hexo-server
Hexo 3.0 把服务器独立成了个别模块，您必须先安装 hexo-server 才能使用。

npm install hexo-server --save

安装完成后，输入如下命令以启动服务器，您的网站会在 http://localhost:4000 下启动。在服务器启动期间，Hexo 会监视文件变更并自动更新，您无须重启服务器。

hexo server    //可简写为【hexo s】

若是您想要更改端口，或是在执行时遇到了 EADDRINUSE 错误，能够在执行时使用 -p 选项指定其余端口，以下：

hexo s -p 5000

静态模式
在静态模式下，服务器只处理 public 文件夹内的文件，而不会处理文件变更，在执行时，您应该先自行执行 hexo generate，此模式一般用于生产环境下。

hexo s -s

自定义 IP
服务器默认运行在 0.0.0.0，您能够覆盖默认的 IP 设置，以下：

hexo s -i 192.168.1.1

指定这个参数后，您就只能经过该IP才能访问站点。
例如，对于一台使用无线网络的笔记本电脑，除了指向本机的127.0.0.1外，一般还有一个192.168.*.*的局域网IP，若是像上面那样使用-i参数，就不能用127.0.0.1来访问站点了。
对于有公网IP的主机，若是您指定一个局域网IP做为-i参数的值，那么就没法经过公网来访问站点。

生成文件 generate

使用 Hexo 生成静态文件快速并且简单。

hexo generate    //可简写为【hexo g】

Hexo 可以监视文件变更并当即从新生成静态文件，在生成时会比对文件的 SHA1 checksum，只有变更的文件才会写入。

hexo g --watch    //可简写为【hexo g -w】

您可执行下列的其中一个命令，让 Hexo 在生成完毕后自动部署网站，两个命令的做用是相同的。

hexo g -d
hexo d -g

部署 deploy

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

hexo deploy    //可简写为【hexo d】

在开始以前，您必须先在 _config.yml 中修改参数，一个正确的部署配置中至少要有 type 参数，例如：

deploy:
  type: git

您可同时使用多个 deployer，Hexo 会依照顺序执行每一个 deployer。

deploy:
- type: git
  repo:
- type: heroku
  repo:

YAML依靠缩进来肯定元素间的从属关系。所以，请确保每一个deployer的缩进长度相同，而且使用空格缩进。

永久连接 permalinks

您能够在 _config.yml 配置中调整网站的永久连接 或者在每篇文章的 Front-matter 中指定。

除了下列变量外，您还 可以使用 Front-matter 中的全部属性。

变量	描述
:year	文章的发表年份（4 位数）
:month	文章的发表月份（2 位数）
:i_month	文章的发表月份（去掉开头的零）
:day	文章的发表日期 (2 位数)
:i_day	文章的发表日期（去掉开头的零）
:title	文件名称
:post_title	文章标题
:id	文章 ID
:category	分类。若是文章没有分类，则是 default_category 配置信息。

您可在 permalink_defaults 参数下调整永久连接中各变量的默认值：

permalink_defaults:
  lang: en

示例

假设 source/_posts 文件夹中有个 hello-world.md，包含如下内容：

title: Hello World
date: 2013-07-14 17:01:34
bqtdir: 包青天
categories:
- foo
- bar

参数	结果	备注
:year/:month/:day/:title/	2018/07/14/hello-world	有多个层级
:year-:month-:day-:title.html	2018-07-14-hello-world.html	只有一个层级
:category/:title	foo/bar/hello-world	不是以【/】结尾的
:bqtdir/	包青天/	彻底自定义的变量

多语种支持

若要创建一个多语种的网站，您可修改 new_post_name 和 permalink 参数，以下：

new_post_name: :lang/:title.md
permalink: :lang/:title/

当您创建新文章时，文章会被储存到：

hexo new "Hello World" --lang tw
# => source/_posts/tw/Hello-World.md

而网址会是：http://localhost:4000/tw/hello-world/

主题 themes

主题列表

建立 Hexo 主题很是容易，您只要在 themes 文件夹内，新增一个任意名称的文件夹，并修改 _config.yml 内的 theme 设定，便可切换主题。一个主题可能会有如下的结构：

├── _config.yml        主题的配置文件，不一样的主题可配置的选项也各不相同。
├── languages        语言文件夹，请先在项目的`_config.yml`中调整 language 的值
├── layout            布局文件夹，用于存放主题的模板文件，决定了网站内容的呈现方式
├── scripts            脚本文件夹，在启动时，Hexo 会载入此文件夹内的 JavaScript 文件
└── source            资源文件夹，除了模板之外的 Asset，例如 css、js 文件等，都应该放在这个文件夹中

国际化 i18n

internationalization，i18n
若要让您的网站以不一样语言呈现，您可以使用国际化功能。请先在_config.yml中调整 language 设定，这表明的是预设语言，您也可设定多个语言来调整预设语言的顺位。

language: 
- zh-tw
- en

您可在front-matter中指定该页面的语言，也可在_config.yml中修改i18n_dir设定，让 Hexo 自动侦测。
i18n_dir 的预设值是 :lang，这样 Hexo 会捕获网址中的第一段以检测语言。

推荐主题

官方 主题推荐 里面会列出不少主题，点击图片会进入到主题做者的博客里面(预览效果)，点击标题能够进入到主题GitHub仓库里面(使用说明)。目前推荐的有 246 个主题。

也可直接在GitHub 搜索 关键字hexo，也会精准的搜索出大量高星的主题。

几个流行的主题：

• landscape：默认主题
• NexT：14K，星星最多的主题，中文文档
• Yilia：6K
• indigo：2K

其余主题：

• material：3.5K
• tranquilpeak：1.5K
• icarus：2K
• Yelee：1K
• Hueman：1K
• Jacman：1K

使用主题

这里以使用主题 Concise 为例进行介绍

一、将主题下载到themes目录，如：

git clone https://github.com/HmyBmny/hexo-theme-concise.git themes/concise

二、修改_config.yml中的theme：

theme: concise  # 默认为landscape

三、必要的设置
不一样的模板，会有不少不一样的设置，这里就须要针对模板的使用说明进行修改了。建议经过github找到模板，看下readme。好比Concise主题的部分设置：

menu:
  About: http://www.cnblogs.com/baiqiantao
  Archives: /archives

基本上，这样就能在本机进行预览使用了。

修改了模板之后不生效，建议先 hexo clean，而后再 hexo g，只执行 hexo g 可能模板后者静态文件不会被替换。

插件 plugins

通常不建议使用杂七杂八的插件！

Hexo 有强大的插件系统，使您能轻松扩展功能而不用修改核心模块的源码。

在 Hexo 中有两种形式的插件：

• 脚本 Scripts：若是您的代码很简单，建议您编写脚本，您只须要把 JavaScript 文件放到 scripts 文件夹，在启动时就会自动载入。
• 插件 Packages：若是您的代码较复杂，或是您想要发布到 NPM 上，建议您编写插件。

安装插件：npm install 插件名称 --save
卸载插件：npm uninstall 插件名称 -save

连接持久化插件

permalink-pathed-title

实现方案：使用文件的相对路径生成连接(推荐)

abbrlink，相关介绍

实现方案：对标题+时间进行md5而后再转base64，而后给每篇文章的front-matter中自动增长abbrlink属性
相似：【abbrlink: 4a17b156】

Hexo-UUID，相关介绍

实现方案：hook hexo new命令(意味着必须在命令行中建立文章)，而后给每篇文章的front-matter中自动增长uuid属性
相似：【uuid: 2f2dd790-1e71-11e6-95e1-ffc09ba0b003】

Tips：

百度蜘蛛抓取网页的规则: 对于蜘蛛说网页权重越高、信用度越高抓取越频繁，例如网站的首页和内页。蜘蛛先抓取网站的首页，由于首页权重更高，而且大部分的连接都是指向首页。而后经过首页抓取网站的内页，并非全部内页蜘蛛都会去抓取。

搜索引擎认为对于通常的中小型站点，3层足够承受全部的内容了，因此蜘蛛常常抓取的内容是前三层，而超过三层的内容蜘蛛认为那些内容并不重要，因此不常常爬取。出于这个缘由因此permalink后面跟着的最好不要超过2个斜杠。

自动生成分类插件

auto-category
auto-category 介绍
相似插件：directory-category

一种自动生成 categories 的插件，根据 Markdown 文件在文件目录自动分类，即自动生成 Markdown 的front-matter中的categories变量。

例如，对于博客 source/_post/web/framework/hexo.md，该插件会自动生成如下categories：

categories:
  - web
  - framework

安装：npm install hexo-auto-category --save
修改配置文件，添加以下内容：

# Generate categories from directory-tree
auto_category:
 enable: true
 depth:  # the depth of directory-tree you want to generate, should > 0

配置文件 config

# Site 网站
title: 白乾涛的技术博客  # 网站标题
subtitle: 白乾涛的Android开发之旅  # 网站副标题
description: Android Java 前端 程序员 技术 博客 GitHub baiqiantao  # 主要用于SEO
keywords: Android Java 前端 程序员 技术 博客 GitHub baiqiantao # 主要用于SEO
author: 白乾涛  # 用于主题中显示文章的做者
language: zh-Hans # 网站使用的语言，中文通常为【zh-CN】或【zh-Hans】，可用值决于你themes\concise\languages下有哪些文件
timezone:  # 网站时区，默认使用您电脑的时区

# URL 网址
url: http://yoursite.com  # 网址
root: /  # 若是您的网站存放在子目录中，例如 http://bqt.com/blog，则请将您的 url 设为 http://bqt.com/blog 并把 root 设为 /blog/
permalink: :bqtdir/  # 文章的永久连接，格式【:year/:month/:day/:title/】注意，要以/或.html结尾
permalink_defaults:  # 永久连接中各部分的默认值

# Directory 目录
source_dir: source  # 资源文件夹，这个文件夹用来存放内容。
public_dir: public  # 公共文件夹，这个文件夹用于存放生成的站点文件。
tag_dir: tags  # 标签文件夹
archive_dir: archives  # 归档文件夹
category_dir: categories  # 分类文件夹
code_dir: downloads/code  # Include code 文件夹
i18n_dir: :lang  # 国际化文件夹，捕获网址中的第一段以检测语言
skip_render:  # 跳过指定文件的渲染，您可以使用 glob 表达式来匹配路径。

# Writing 文章
new_post_name: :title.md # 新文章的文件名称，默认值【:title.md】
default_layout: post  # 预设布局，【post】
auto_spacing: false  # 在中文和英文之间加入空格，false
titlecase: false # 把标题转换为 title case，false
external_link: true # 在新标签中打开连接，true
filename_case: 0  # 把文件名称转换为 (1) 小写或 (2) 大写，0
render_drafts: false  # 显示草稿，false
post_asset_folder: false  # 启动 Asset 文件夹，【false】
relative_link: false  # 把连接改成与根目录的相对位址，false
future: true  # 显示将来的文章，true
highlight:  # 代码块高亮设置
  enable: true
  line_number: true
  auto_detect: false
  tab_replace:

# Home page setting 首页设置
index_generator:
  path: '' # 博客索引页面(index)的根路径，默认=''
  per_page: 10 # 每页显示的帖子，0 =禁用分页
  order_by: -date # 排序方式，默认状况下按日期降序排序

# Category & Tag 分类 & 标签
default_category: blog # 当没有分类时的默认分类，uncategorized
category_map: # 分类别名，要在配置文件中获取category的值请使用【:category】，不要使用【:categories】
  baiqiantao: bqt
tag_map: # 标签别名

# Date / Time format 日期 / 时间格式，Hexo使用Moment.js来解析和显示日期
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination 分页
per_page: 10 # 每页显示的文章量，0 = 关闭分页功能，10
pagination_dir: page # 分页目录，page

# Deployment 部署
deploy:
  type: git
  repo: git@github.com:baiqiantao/baiqiantao.github.io.git
  branch: master

# Extensions 扩展
theme: next  # 当前主题名称，值为false时禁用主题，默认为【landscape】

2019-3-14