准备工作
github的注册
gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。
所以要使用github,就请先到github官网进行注测。具体注册过程和关于git的学习,建议到廖雪峰的官方网站,这个网站上面有很详细的git教程,希望仔细阅读。
node.js下载
由于hexo是基于Node.js的静态博客框架,所以我们先下载node.js,移步Node.js官网下载稳定版即可,下载完成后打开安装(按照默认路径安装即可)。
然后打开cmd命令行或者git Bash 输入:
node -v
如果出现版本号就说明已经安装成功了。
关于github和hexo的内容就到这里。下面就开始我们的主题(hexo和github搭建个人博客)吧。
搭建过程
安装hexo
Node和Git都安装好后,用户存放hexo的配置文件,然后安装Hexo。打开 node.js输入:
sudo npm install -g hexo 或者(nmp i -g hexo)
安装完成后,到github登录你前面注册的账号,然后点击New repository新建一个项目,项目名为:yourname.github.io,注意:一个账号只能建立一个名为yourname.github.io,如果已经有了,就随便建一个 如:blog
将项目克隆到本地仓库,打开git Bash上(注意:你想把这个 项目放到哪个磁盘就在哪个磁盘打开git Bash,但是最好不要放在C盘).
git clone 你项目上的SSh
克隆完成后,打开文件夹,打开git Bash或者cmd(注意是当前路径就行)输入:
hexo init
安装hexo所需要的依赖。
好啦,到此为止呢,所有的安装工作都完成了!接下来就是生成博客页面了。
生成静态页面
hexo generate (hexo g)
这时你的博客页面已经生成,然后再输入:
hexo sever (hexo s)
启动本地服务,进行博客页面的预览,完成这一步后,进入localhost:4000查看hexo页面是否出现,一般来说使用了yourname.github.io创建的项目名都可以看到页面,而其他的看不到页面的,因为你们的环境还没配置好(不要着急,接着往下看!)
全局配置
首先,你要找到项目根目录下的_config.yml文件,打开文件进行配置。
Site(基本信息部分)
# Site
title: //博客名
subtitle: //可填可不填
description: //你博客的描述
author: //作者
language: zh-Hans
timezone: Asia/Shanghai
特别提醒:冒号后面有个空格,这个空格必不可少!!下面的内容也一样!!!!
URL(博客地址)
如果你是使用yourname.github.io为项目名的话,那你就如下配置就行。root后面不能为空
url: https://yourname.github.io/
root: /
要是你是用其他的项目名的话,比如blog,请按照下面配置:
url: https://yourname.github.io/blog
root: /blog
完成这里之后,看到文件的最后。
Deployment(部署信息)
deploy:
type: git
repository: 你项目的SSH
branch: master(如果博客地址是“https://yourname.github.io/blog”,分支名就是gh-pages)
全局配置结束。这时候你需要更新你的本地仓库。在命令行输入:
hexo generate(hexo g)
hexo sever (hexo s)
点击localhost:4000,如果页面标题是你前面配置Site里的title.恭喜你更新成功。
部署到github
在部署到github之前还需要安装一个依赖 在命令行输入:
npm install hexo-deployer-git --save
安装完后再输入:
hexo deploy (hexo d)
部署到github上了,这时候你到github打开你的项目,你会看到你在本地仓库的文件都传到了这里。这时,你可以用你的博客地址来查看你的博客了。
主题配置
hexo这里有各种各样的主题,总用一款适合你。
选好主题之后,进入主题,里面有很详细的配置信息。按照里面的介绍配置即可,在这里我就不再啰嗦了
注意:记得在根目录的_config.yml下主题theme那加上你的主题名
theme: 你的主题名
然后更新上传即可
