用Hexo搭建Blog
安装需要
1.node.js
2.git
如果你已经配置好了,那么可以直接跳转到安装hexo
首先,你需要下载好node.js,我们需要node.js的npm命令下载hexo。
进入node.js的网站,下载安装包进行下载, 这里就不做太多介绍了。
然后再是下载git,用来从github上面获取文件。
git
如果Windows用户下载失败,可以试一下淘宝 Git for Windows 镜像下载 git 安装包.
安装hexo
很好,你已经来到这一步了~
接下来你需要通过刚才下载的node.js里面的npm命令来下载hexo
npm install hexo-cli -g
只需要等一阵子,然后就可以成功安装hexo了,最后给hexo环境变量。
开始搭建
初始化hexo博客文件
hexo init
然后会出现一些博客的文件或文件夹,主要是source,themes,_config.yml等文件。
先说一下source是用于储存博客页面或文章的。
可以通过这条命令创建文章
hexo new [文章名字] # 创建文章
这条命令创建页面
hexo new page [页面名字] # 创建页面
source文件夹里面有_post文件夹,里面放置文章。
theme文件夹里面是放置你博客主题文件的,你可以在Hexo官网下载主题对你的博客渲染界面,主题的详细看主题的作者的介绍,进行配置。
_config.yml文件储存你博客的配置。
_config.yml配置
先看博客的基本配置
参数 | 介绍 | 特别介绍 |
---|---|---|
title | 博客标题 | ~ |
subtitle | 博客小标题 | ~ |
description | 博客描述 | ~ |
keywords | 博客关键词 | ~ |
author | 博客主人 | ~ |
language | 博客使用语言 | 这个具体要看你的主题支持语言 |
timezone | 博客时区 | 你服务器或所在地区时区 |
常见的中文有zh-Hans和zh-CN
时区可以参考这个表格
下面是网址配置
参数 | 介绍 |
---|---|
url | 你博客网址 |
permalink | 文章的永久链接格式 |
permalink_defaults | 永久链接中各部分的默认值 |
pretty_urls | 改写permalink的值来美化 URL | |
---|---|---|
trailing_index | 是否在永久链接中保留尾部的index.html,设置为false时去除 | |
trailing_html | 是否在永久链接中保留尾部的.html, 设置为 false时去除 |
目录
这部分不详细介绍
写作
参数 | 介绍 | 特别介绍 |
---|---|---|
new_post_name | 新文章的文件名 | |
default_layout | 默认布局 | |
titlecase | 把标题转换为标题大小写 |
external_link | 在新标签中打开链接 | |
---|---|---|
enable | 在新标签中打开链接 | |
field | 对整个网站生效或仅对文章生效 | |
exclude | 需要排除的域名。主域名和子域名如www需分别配置 |
参数 | 介绍 | 特别介绍 |
---|---|---|
filename_case | 文章名字大小写转换 | |
render_drafts | 显示草稿文章 | |
post_asset_folder | 启动Asset文件夹 | |
future | 显示未来的文章 | |
highlight | 代码块设置 | 通过主题配置文件或参考Highlight.js文件进行配置 |
prismjs | 代码块设置 | 参考PrismJS进行设置 |
主页设置
参数 | 介绍 |
---|---|
index_generator | 生成文章的存档,由hexo生成器索引提供支持 |
path | 日志索引页的根路径 |
per_page | 每页显示的帖子数量 |
order_by | 文章排序形式 |
分类 & 标签
参数 | 介绍 |
---|---|
default_category | 默认分类 |
category_map | 分类别名 |
tag_map | 标签别名 |
日期和时间的格式
参数 | 介绍 |
---|---|
date_format | 博客日期格式 |
time_format | 博客时间格式 |
updated_option | 当Front Matter中没有指定updated时updated的取值 |
分页
参数 | 介绍 |
---|---|
per_page | 每页显示的文章数量 |
pagination_dir | 分页目录 |
扩展
参数 | 介绍 |
---|---|
theme | 使用的主题 |
包括/排除文件
参数 | 介绍 |
---|---|
include | Hexo默认会忽略隐藏文件和文件夹(包括名称以下划线和.开头的文件和文件夹,Hexo的_posts和_data 等目录除外)。通过设置此字段将使Hexo处理他们并将它们复制到source目录下。 |
exclude | Hexo 会忽略这些文件和目录 |
ignore | 忽略文件/文件夹 |
部署
参数 | 介绍 |
---|---|
type | 部署方式/类型 |
repo | 部署仓库 |
git
先安装hexo-deployer-git
npm install hexo-deployer-git --save
配置
参数 | 填写 |
---|---|
type | git |
repo | git仓库地址 |
branch | git仓库分支 |
message | 自定义提交信息 |
token | 用于向repo进行身份验证的可选令牌值。用$前缀从环境变量读取令牌 |
命令
详细看初始化的文章Hello-World
上传至仓库,部署网站
hexo clean
hexo deploy
在本地运行网站
hexo server
创建文章或页面
hexo new [文章名]
hexo new page [页面名]
参考文章:
https://hexo.io/
https://hexo.io/zh-cn/docs/