本文介绍基于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:
gitee:
配置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
如果创建的是about即hexo 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 generate
和 hexo 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还有其他要求,请自己摸索。