Github 结合 Hexo 搭建轻量博客
http://www.open-open.com/lib/view/open1481532171287.html
开始
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
也有很多此类的文章了,不过还是要记录一下,分享给大家,我自己也做个复习。我也是不久前才弄好 ^_^
工具准备
- 1.安装Node.js
- 2.安装Git
安装过程就不说了,估计没有不会的。
- 3.注册Github帐号
点击进入 Github ,注册帐号(用户名关系到博客以后的 域名前缀)。
安装Hexo
安装完上述程序,就可以进行Hexo的安装了。
打开命令行,输入安装命令:
npm install hexo-cli -g
等待完成,安装 Hexo 后,依次执行下列命令,Hexo将会在指定文件夹中新建所需要的文件。
folder(不用打[])是你新建的文件夹名称,用于存放博客的所有文件。
默认安装在你打开的命令行默认所在的目录,可以切换至其他目录进行安装。
hexo init [folder] cd [folder] npm install
比如我把目录切换到D盘进行安装。
列出一个目录,看见下面这句话,就说明安装成功了。
可以打开电脑看一下目录结构。
执行下面命令,生成网站(public文件夹):
hexo g
结果如下:
执行下面命令,运行服务,就可以在浏览器中访问了,地址为: http://localhost:4000 :
hexo s
如果遇到 hexo s 无效或者错误,可能是因为没有安装hexo server,执行下面命令,然后再试:
npm install hexo-server --save
浏览器查看(这就是安装好的模样,这是默认主题,可以添加新的主题):
但是现在我们只能在我们本地的电脑上面浏览,别人无法看见,我们还需要将它部署到Github上面。这样就可以让别人访问了。
hexo 基本命令,先了解,后面会用到。
hexo g #完整命令为hexo generate,用于生成静态文件 hexo s #完整命令为hexo server,用于启动服务器,主要用来本地预览 hexo d #完整命令为hexo deploy,用于将本地文件发布到github上 hexo n #完整命令为hexo new,用于新建一篇文章 hexo clean #清除生成的文件
部署
新建仓库(New repository)
登录到你的Github帐号,在右上角+号点击新建。
填写信息。格式为:你的用户名.github.io。然后创建。
配置网站信息
打开你的文件夹,找到 _config.yml 文件,打开它。最开始和最后。
默认可能会没有repo和branch选项,我们要手动写上。
repo: 地址为下图中的地址。替换成你的就可以。
Github 默认分支是 master。
暂时修改这些信息就可以。
# Site title: Hexo #网站标题 subtitle: #副标题 description: #描述 author: zgm #作者,你的名字 language: zh-Hans #设置语言 zh-Hans为中文 timezone: #时区 默认使用电脑的时区 # Deployment ## Docs: https://hexo.io/docs/deployment.html deploy: type: git repo: https://github.com/你的用户名/你的用户名.github.io.git branch: master
设置Git
在Git Bash输入以下指令(任意位置点击鼠标右键),检查是否已经存在了SSH keys。
ls -al ~/.ssh
如果不存在就没有关系,如果存在的话,可以直接删除.ssh文件夹里面所有文件。输入以下指令:
邮箱就是你注册Github时候的邮箱
执行命令,生成密钥。
ssh-keygen -t rsa -C "xxx@xxx.com"
然后回车,出现提示就直接回车,第一次会问你是否继续,回车,第二次问你是否设置一个密码,写不写都可以,第三次是重复输入密码,没有的话就直接回车。
之后找到用户目录下.ssh文件夹,打开id_rsa.pub文件,复制里面的内容。
打开github网页找到右上角点击你的头像,找到Setting,进去点SSH keys,新建一个SSH。
在Git Bash输入下面的命令:
ssh -T git@github.com
登陆成功。
前面我们说过,hexo d 是部署到Github的命令,但是现在我们执行的话,会提示你
ERROR Deployer not found:git
所以我们还要安装hexo-deployer-git:
npm install hexo-deployer-git --save
安装完成后,在Git Bash配置一下用户名和密码(分别是你的邮箱和用户名):
git config --global user.email "xxx@xxx.com" git config --global user.name "你的用户名"
执行部署命令:
hexo d
通常情况下是先生成网站,然后部署。可以将两个步骤放到一起:
hexo d -g
现在你就可以打开网站看到效果了。
发表
新建文章
通过以下命令新建文章:
hexo new "文章名字"
然后用编辑器打开你文件夹下面的 source\_posts 里面的 文章名字.md 文件。
title: 文章名字 #标题 date: 2016-12-09 12:04:29 #发表日期 categories: blog #文章文类 tags: [文章,blog] #文章标签 --- #这里是正文,用markdown写,你可以选择写一段显示在首页的简介后 #加上<!--more-->,在<!--more-->之前的内容会显示在首页, #之后的内容会被隐藏,点击Read more才能看到。
更新文章
在命令行执行:
hexo d -g
这样就可以把你的新文章传上去啦。