今晚月色真美

前言

由于网上太多关于github+hexo搭建教程,搭建这里就不多说了,推荐之前搭建参考的网址:

使用hexo+github搭建免费个人博客详细教程

GitPages+Hexo搭建个人博客

搭建完成后,怎么使用hexo这个框架,网页的排版这些就很难找到相关资料了,自己研究了下,具体整理出来,方便后面的人使用。

目录

  • 博客功能配置
  • 根目录_config.yml配置
  • Hexo常用命令

博客功能配置

主题配置

官方提供很多主题,这里放两个主题,其他可以自行度娘,博主更偏爱material-x主题,哈哈。到指定目录下clone。

1
2
3
4
$ cd /Users/TangDan/GitHub/MyHexoBlog/themes
$ hexo clean
$ git clone https://github.com/iissnan/hexo-theme-next
$ git clone https://github.com/xaoxuu/hexo-theme-material-x themes/material-x //本博客使用主题

现在themes目录下应该多了两个目录:next、material-x,然后到_config.yml修改theme: material-x,再执行

1
2
3
4
$ cd /Users/TangDan/GitHub/MyHexoBlog
$ hexo g
$ hexo d //推送到远端
$ hexo server //本地查看

PS:运行中出现任何问题,可以先hexo clean再执行。

两个主题配置

这两个主题配置其实说难不难,说简单不简单,目前我是只去研究了material-x主题的配置,过程即酸爽又享受。

Next主题官方配置文档

Material-X主题官方配置文档

PS:请一定要仔细的去读官方文档,不要看了这个文档一半又跑去查其他的资料,其他的资料可能更新没官方那么快,是老版本的,到最后一顿操作猛如虎,结果等于白忙,不要问我怎么知道的,我不会告诉你,= =!

链接持久化

hexo默认的链接是http://xxx.com/2017/08/18/hello-world 这种类型的,这种路径看着也挺low的,这源于站点配置文件_config.yml里的配置: permalink: :year/:month/:day/:title/. 这种默认配置的缺点就是当我们创建的博文名包含中文的名的时候,url 链接地址经常会变成一串很长的难以理解的字符串,不利于博文的链接分享,以及搜索引擎搜索,另外就是年月日都会有分隔符。我们可以让 url 链接持久化来解决这个问。

安装hexo-abbrlink插件

$ sudo npm install hexo-abbrlink

修改站点配置文件 _config.yml

  • permalink: post/:abbrlink.html

  • 添加 abbrlink:

1
2
3
4
5
6
permalink: post/:abbrlink.html  # :year/:month/:day/:title/     # 文章的永久链接格式
permalink_defaults: # 永久链接中个部分的默认值
# abbrlink config 需安装插件hexo-abbrlink
abbrlink:
alg: crc32 # 算法: crc16(default) and crc32
rep: hex # 进制: dec(default) and hex

站内搜索

安装 hexo-generator-search 插件

$ sudo npm install hexo-generator-search

配置站点文件_config.yml:

1
2
3
4
5
6
7
# 站内搜索
search:
path: search.xml
field: post

local_search:
enable: true

根目录_config.yml配置

站点配置(重要)

1
2
3
4
5
6
title: 博客名   //网站标题
subtitle: To strive, to seek, to find //网站副标题
description: To strive, to seek, to find, and not to yield. //网站描述
author: WenBo //您的名字
language: zh-Hans //网站使用的语言 简体中文 zh-Hans
timezone: //网站时区。Hexo 默认使用您电脑的时区

URL配置

1
2
3
4
url: http://blogwenbo.com/   //网址
root: / //网站根目录
permalink: :year/:month/:day/:title/ // 文章的 [永久链接](https://hexo.io/zh-cn/docs/permalinks.html) 格式 | `:year/:month/:day/:title/` |
permalink_defaults: //永久链接中各部分的默认值

目录配置

1
2
3
4
5
6
7
8
source_dir: source  //资源文件夹,这个文件夹用来存放内容。默认值:source
public_dir: public //公共文件夹,这个文件夹用于存放生成的站点文件。默认值:public
tag_dir: tags //标签文件夹 默认值:tags
archive_dir: archives //归档文件夹 默认值:archives
category_dir: categories //分类文件夹 默认值:categories
code_dir: downloads/code //Include code 文件夹 默认值:downloads/code
i18n_dir: :lang //国际化(i18n)文件夹 默认值::lang
skip_render: README.md //跳过指定文件的渲染,您可使用 [glob 表达式](https://github.com/isaacs/node-glob)来匹配路径。

Git部署配置(重要)

1
2
3
4
deploy:
type: git //填git
repo: git@github.com:wenmobo/wenmobo.github.io.git //SSH地址
branch: master //分支

Hexo常用命令

其实搭建成功后,在/Users/TangDan/GitHub/MyHexoBlog/source/_posts里默认会有生成一个hello-world.md,这个里面描述了常用的哪些命令及意义,可在里面查看。

常用创建命令:

1
2
$ hexo new "xxx" //创建一篇文章
$ hexo new page "xxx" //创建一个分类

总体来说,提交一个修改到github,最好顺序执行以下命令:

1
2
3
4
$ hexo clean
$ hexo g
// $ hexo s //这个是提交到本地
$ hexo d //推送到github

 评论

本站总字数统计:18.4k

感谢您的浏览, 本站总访问量为 次 。
载入天数...载入时分秒...