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

这样就可以把你的新文章传上去啦。

posted @ 2017-06-12 12:35  抹茶MM  阅读(329)  评论(0编辑  收藏  举报