至上篇搭建博客文章后,断更了后续,在此说声抱歉。
zoluo 个人公众号
由于后面的配置篇在网上较为冗余,我把自己的配置过程做了详细记录,其中借鉴了些其他作者的思路,也感谢 Hexo 及 Next 给我们提供这么好的平台。
由于本篇幅较长,本着长时间查看不方便,还是分下篇,由天、地、玄、黄四篇配置组成,配置由高到低,博友们可选择配置自己的站点。
欢迎关注的我的公众号 zoluo 及博客 zoluo!
在上一篇文章 Hexo博客建站一〈基础搭建〉 我们已经在本地搭建好了博客的整体框架,接下来,我们应该把文章部署到外网可访问的位置,毕竟只是在本地玩玩就没意思了。
Hexo 部署到 GitHub Page
在上篇文章我们已经在 GitHub 上创建好了名为 username.github.io 的仓库,下载我们只需按照提示上传我们生成的静态代码到此仓库就行了。
在此先声明两点:
- 站点配置文件
_config.yml
位于最外层文件夹下 - 主题配置文件
_config.yml
位于最外层文件夹/themes/next/_config.yml。
- Hexo 配置 GitHub
在站点配置文件下,修改以下配置,如:
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@github.com:zoluoc/zoluoc.github.io.git
branch: master
- SSH配置
ssh
配置主要是上传代码时hexo d
免输用户名和密码,因此有必要配置以下。
(1) 首先打开命令行工具,通常我们可以直接右键鼠标任意位置打开 Git Bash Here,然后输入以下命令:
$ cd ~/.ssh
# Checks to see if there is a directory named ".ssh" in your user directory
(2) 使用 ssh-keygen 生成密钥
$ ssh-keygen -t rsa -C "your_email@example.com"
# Creates a new ssh key using the provided email
Generating public/private rsa key pair.
Enter file in which to save the key (/home/you/.ssh/id_rsa):
简化流程的话在键入命令ssh-keygen -t rsa -C "your_email@example.com"
以后的三次提示输入都可以直接回车跳过。
密钥生成成功,如:
Your identification has been saved in /home/you/.ssh/id_rsa.
Your public key has been saved in /home/you/.ssh/id_rsa.pub.
The key fingerprint is:
…………………此处是密钥内容…………………… your_email@example.com
(3) 设置此仓库的 SSH keys
按下图找到 GitHub 设置 SSH 的位置
hexo ssh
然后将生成的 id_rsa.pub 中的内容全选复制到 key 输入框中,然后点击 Add key 完成添加公钥。
hexo add keys
(4) 测试配置是否成功
如果出现以下内容即表示配置完成并且成功!
ssh -T git@github.com
Hi username! You've successfully authenticated, but GitHub does not
provide shell access.
这个时候我们再使用hexo d
就能上传代码到服务器了!
上传代码
hexo d
到 GitHub 仓库可以看到我们的代码已经上传成功。
最后我们访问 https://username.github.io
就可以访问到我们的站点了,是不是很6,这不算啥,接下来我们让网站变的更炫酷!
黄阶配置
以下配置都是修改站点配置文件_config.yml
来完成的,参考 Hexo 官网
- 网站
参数 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
author | 您的名字 |
language | 网站使用的语言,中文使用zh-Hans
|
timezone | 网站时区。Hexo 默认使用您电脑的时区,可不填。时区列表。比如说:America/New_York, Japan, 和 UTC |
- 网址
参数 | 描述 | 默认值 |
---|---|---|
url | 网址 | |
root | 网站根目录 | / |
permalink | 文章的永久链接格式 | :year/:month/:day/:title/ |
permalink_defaults | 永久链接中各部分的默认值 |
注:这里根目录的设置其实就是把网站放入到子目录,如:将根目录修改成/blog/
,则 URL 后须加上/blog
。
- 目录
参数 | 描述 | 默认值 |
---|---|---|
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 表达式来匹配路径 | source |
注:如果您刚刚开始接触Hexo,通常没有必要修改这一部分的值,到需要时可后续来修改。
- 文章
参数 | 描述 | 默认值 |
---|---|---|
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 | 代码块的设置 |
- 分类 & 标签
参数 | 描述 | 默认值 |
---|---|---|
default_category | 默认分类 | uncategorized |
category_map | 分类别名 | |
tag_map | 标签别名 |
- 日期 / 时间格式
Hexo 使用 Moment.js 来解析和显示时间。
参数 | 描述 | 默认值 |
---|---|---|
date_format | 日期格式 | YYYY-MM-DD |
time_format | 时间格式 | H:mm:ss |
- 分页
参数 | 描述 | 默认值 |
---|---|---|
per_page | 每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir | 分页目录 | page |
- 扩展
参数 | 描述 |
---|---|
theme | 当前主题名称。值为false时禁用主题 |
deploy | 部署部分的设置 |
- 创建 Menu 菜单
这里主题默认只有两个菜单:首页和归档,因此我们得创建自己的菜单,一下是创建方法:
hexo new page "tags"
hexo new page "categories"
hexo new page "about"
网友评论