hexo+github/gitee搭建个人博客

本文介绍基于windows10系统的hexo+github安装教程

使用的工具

名称 版本 作用
git v2.15.0 生成静态页面
node v8.11.2 将本地hexo内容提交到服务器
hexo v3.7.1
github账号 or gitee账号 博客远程仓库、域名、服务器

本文默认读者已经安装git和node

hexo

hexo是一款基于Node.js的静态博客框架

安装hexo

打开cmd,输入一下命令:

npm install -g hexo-cli

初始化博客

npm下载速度慢怎么办?
从cmd中,cd进一个你喜欢的目录,例如:

C:\Users\zcolder>D:

进入D盘,在这里初始化,输入以下命令:

D:\>hexo init folder_name
D:\>cd folder_name
D:\folder_name>npm install

folder_name即文件名,例如:hexo init zcolderBlog, 下面都以zcolderBlog为例
为了避免可能部署错误(ERROR Deployer not found: git),需要!这个目录下,再装一个插件

D:\zcolderBlog>npm install hexo-deployer-git –save

配置网站信息

打开 “文件资源管理器(文件夹)” 进入你刚才初始化的文件夹中,如: D:\zcolderBlog
找到 “_config.yml” 网站配置文件打开它 (PS:记得找个靠谱的编辑工具,只有记事本的回去等通知吧)
在文件大概第5行,做如下修改:

# Site
title: zcolderBlog #网站标题
subtitle: 鸽王の个人博客 #网站副标题
description: 美好的生活从相信假象开始。 #写一句司马的话
keywords: 个人博客 #关键词
author: zcolder #作者
language: zh-CN #设置网站语言,本选项需要主题支持,主题在后面介绍
timezone: Asia/Shanghai #时间设置,如果主题文件有timezone一项,那两者需要一致

注意!:yml文件的冒号“:”后面需要空格, ex. title:(这里有空格)zcolderBlog

配置github或gitee

创建git仓库

首先,选择github或gitee创建一个仓库,仓库名必须是你github或gitee的用户名, ex.

github:

github创建page项目官方教程

gitee:

码云创建page项目官方教程

配置git

还是在 “_config.yml” 文件,对鼠标中键来一发 !车轮滚滚 ,滑倒文件最后,找到deploy项

deploy:
  type: git
  repo: git@(你的刚才创建项目的git地址)/XXX.git
  branch: master

这里建议使用ssh地址(如果你配置了shh密钥的话),因为使用http,每次发布都要输入账号密码。

配置主题

下载主题

首先选择一个自己喜欢的主题,点击图片预览,点击主题名字直达github该主题安装教程。
hexo主题网页连接

这里以最出名的Next主题为例。
打开 “文件资源管理器(文件夹)” 进入你blog的文件夹中,如: D:\zcolderBlog
右键,选择 “Git Bash Here”,键入:
git clone https://github.com/theme-next/hexo-theme-next themes/next

配置主题文件

NexT主题使用说明
官网说明了大部分配置,这里说其他的一下配置
打开文件路径 D:\zcolderBlog\themes\next 找到主题配置文件(没错,主题也有一个_config.yml配置文件)

找到文件第119行 menu项,按需求打开注释,并创建对应页面。

menu:
  home: / || home #主页
  tags: /tags/ || tags #标签页
  categories: /categories/ || th #分类页
  archives: /archives/ || archive #归档
  about: /about/ || user #关于你
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

创建导航页面

这里以tags为例
cmd进入博客文件目录,ex. D:\zcolderBlog
输入 hexo new page tags
然后在目录 D:\zcolderBlog\source 就会出现一个tags文件,打开可以看到有一个index.md文件
文件头修改添加,type: “tags”和comments: false(这句是关闭页面评论,本博客暂时不教配置评论)

title: tags
date: 2018-06-08 17:15:18
type: “tags”
comments: false

如果创建的是abouthexo new page about则为, 以此类推

title: tags
date: 2018-06-08 17:15:18
type: “about”
comments: false

设置时间

还记得网站配置文件中的timezone选项吗,这里主题配置文件必须与其一致
找到文件第703行,timeZone项,设置为 timeZone: Asia/Shanghai

语言设置

打开主题文件目录中的languages文件。
主题语言选择
将文件名填写到网站配置文件的language项,ex. language: zh-CN

部署项目到github

在cmd中,目录为博客项目的。输入:

D:\zcolderBlog>hexo clean
D:\zcolderBlog>hexo generate
D:\zcolderBlog>hexo deploy

hexo clean:清除缓存文件 (db.json) 和已生成的静态文件 (public)。
hexo generate:生成静态文件。简写hexo g.
hexo deploy:部署网站。简写hexo d.

写作

在不更换主题的情况下,每次写作,更新到githubpage或giteepage,只需要:
hexo generatehexo deploy指令。
新建文章命令 hexo new "title文件名",注意,这里不需要new page
新建的文件默认生成在_posts文件夹中。
打开你新建的文件:

title: postName #文章页面上的显示名称,一般是中文
date: 2013-12-02 15:30:16 #文章生成时间,一般不改,当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签,可空,多标签请用格式,注意:后面有个空格 tag1的值为String

hexo常用命令

hexo常用命令
其实,官方文档足矣。

结束

OK到这里,你已经可以开始写作了,如果你对Hexo还有其他要求,请自己摸索。


zcolder wechat
写得不好?加我QQ开始喷我!