Hexo 搭建博客笔记

HEXO:基于Node.js的一个简单快速的开源博客框架。

一、环境部署

1. Node.js下载安装

• 安装包下载安装
  Node下载官网
  安装完成，可打开CMD窗口，执行命令node -v检查node版本，确认node是否安装成功
• node环境部署
  Node环境配置教程

2. Git下载安装

Hexo的项目源代码以及相关插件是放在Github上托管的。
安装参考步骤：https://mp.csdn.net/mdeditor/103214060#

3. Hexo安装

先安装好Node和Git，安装hexo很简单。命令行运行npm install hexo-cli -g即可
检查：hexo version

二、启动

1. 目录文件

• 初始化Hexo：

	hexo init >    #初始化目录
	cd >
	npm install    #安装依赖

初始化完成后，

	├── _config.yml   #站点配置文件
	├── package.json    #应用数据
	├── scaffolds       #模板文件
	├── source          #文章资源
	|   ├── _drafts
	|   └── _posts
	└── themes   #站点主题配置文件

• 启动命令

	hexo clean   #清空静态文件（public目录）
	hexo g     #生成静态页面
	hexo s    #启动hexo服务，本地访问
	hexo d    #部署

2. 部署

• Github新建仓库，仓库名称格式：.github.io
• 将本地Hexo博客推送到Github上
  • 安装hexo-deployer-git插件：$ npm install hexo-deployer-git --save
  • 如果没有配置ssh，则添加SSH key（具体参考：https://mp.csdn.net/mdeditor/103214060#）
  • 修改站点配置文件（_config.yml）:
    仓库地址写ssh地址，不写http地址

	# Deployment
	## Docs: https://hexo.io/docs/deployment.html
	deploy:
	  type: git
	  repo: [email protected]:>/>.github.io.git
	  branch: master

• 推送：

	hexo -g
	hexo -d

后，浏览器访问网址： https://.github.io

三、hexo配置说明

1. _config.yml

根目录的_config.yml的配置会覆盖其它部分的相同配置

//site 站点参数配置
title 站点标题
subtitle 站点副标题 description 网站描述
keywords 关键字
author 文章的作者
language 网站使用的语言,默认英语
timezone 网站时区，默认使用电脑的时区

//url
url 网址
root 网站根目录
permalink 文章的永久链接格式，默认是:year/:month/:day/:title/
permalink_defaults 设置永久链接中各部分的默认值

//directory 目录配置
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 跳过指定文件的渲染

//write 写作配置
new_post_name 新文章的文件名称格式 :title.md或者:year-:month-:day-: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 启动资源文件夹，默认是 false，表示source文件夹中除了文章以外的所有文件，例如图片、CSS、JS 文件等(如果Hexo项目中只有少量图片，那最简单的方法就是将它们放在source/images 文件夹中)。
relative_link 把链接改为与根目录的相对位址，默认是false，默认情况下，Hexo生成的超链接都是绝对地址。例如，如果你的网站域名为example.com,您有一篇文章名为hello，那么绝对链接可能像这样：http://example.com/hello.html，它是绝对于域名的。相对链接像这样：/hello.html，也就是说，无论用什么域名访问该站点,一般建议用绝对路径
future 显示未来的文章，默认是true
highlight 代码块的设置
     enable: true 启动高亮
     line_number: true 显示行号
     auto_detect: false 自动检查
     tab_replace: 缩进大小

//home page setting
path 博客默认页面的路径，默认为空
per_page 主页中每页显示的贴子，0表示禁止分页
order_by 按时间倒序排列

//category& tag 分类和标签设置
default_category 默认分类，默认为没有分类uncategorized
category_map 分类别名，默认为空
tag_map 标签别名，默认为空

//date/time format （hexo使用moment.js来处理时间）
date_format 日期格式，默认为MMM D YYYY，可配置 YYYY-MM-DD
time_format 时间格式 H:mm:ss

//pagination
per_page 每页显示的文章量（0表示关闭分页），默认是10
pagination_dir 分页目录，默认是page

//extensions
plugins 插件，插件列表
theme 当前主题名称,为false时禁用主题,主题列表
theme_config 自定义主题配置，这和全局的_config.yml文件是分离的，你可以写themes/my-theme/_config.yml，如果全局的_config.yml文件是
theme_config:
     bio: “hello_world”

//deploy
deploy: 部署配置，即把public目录文件部署到服务器上
     type: git
     repository: https://github.com/xxx/xxx.github.io.git
     branch: master

//include/exclude files or folders
设置键值使hexo显式或忽略某些文件
include
-Impo 包含Impo这个文件，include参数一般不使用，需要包含的文件hexo都做好了
exclude
-.Igno 忽略.Igno这个文件

//using am alternate config
自定义配置文件，使用hexo server启动时是默认加载_config.yml里面的配置，如果我们自定义文件custom.yml，那么启动时使用hexo server --config custom.yml,甚至是多个自定义文件custom1.yml,custom2.json,启动时使用hexo server --config custom1.yml,custom2.json，注意默认后面文件的优先级高，也就是先加载.json，多个自定义文件可以写入_multiconfig.yml中，同样最后一个文件优先加载

2. scaffolds（文章脚手架）

模板文件夹。新建文章时，hexo会根据该文件夹下的相对应的模板文件来建立文件，默认是post.md（default_layout配置）。

模板中的 参数有

• layout 布局
• title 标题
• date 文章建立日期

在/scaffolds下可配置对应的layout的front-matter，使用命令新建或者发布文章时：

	hexo new [layout] >
	hexo publish >

3. Data(数据文件)

使用一些不在post中的模版数据，或者想复用这些数据，可以使用一下Hexo3中的『Data files』功能。这个特性加载source/_data目录中的YAML或者JSON文件，从而用到你的网站中。
友情链接页面举例

• 添加数据文件
  在source目录下新建_data目录，该目录下新建links.yml文件（）

	a Blog: http://a.com
	b Blog: http://b.com
	c: http://www.c.com

• 添加主题布局文件

	<% if (site.data.links){ %>
	  <div class="widget tag">
	    <h3 class="title">友情链接h3>
	      <ul class="entry">
	      
	        <% for (var i in site.data.links){ %>
	          <li class='link'><a href='<%- site.data.links[i] %>'><%= i %>a>li>
	        <% } %>
	      ul>
	  div>
	<% } %>

4. source（资源文件）

文件内以_开头的文件都会被忽略，.md和.html文件会被解析并放到public中，其它文件也会被直接拷贝或渲染过去

5. Asset（资源目录）

source 文件夹中除了文章以外的所有文件
当资源文件管理功能打开后(post_asset_folder: true)，Hexo将会在你每一次通过 hexo new [layout]