- 我觉得写博客是一个非常好的习惯,有多好我就不说了。技术博客也好,心路历程也好,尝试着用博客记录你的生活吧。
- 你想拥有你的个人博客么,不必受制于新浪、博客园等平台,完全属于你的博客。
- 这篇文章将自己利用 Hexo 搭建 Github 静态博客的过程分享给大家。
一、注册、配置 Github
- Github 是一个面向开源及私有软件项目的托管平台,大神云集,你可以在上面找到海量的开源代码。程序猿必备!
1.注册
2.创建仓库
如你的用户名为 "xxx",那么仓库名就应为 "xxx.github.io"
⚠️ 仓库名必须与你的用户名对应。
3.配置 SSH-Key
- 创建 SSH-Key,"这里是你的邮箱",无需密码,一路回车,默认设置即可
ssh-keygen -t rsa -C "xxx@xxx.com" - 查看你的 public key,复制下来
cat ~/.ssh/id_rsa.pub - 在 Github -> Settings -> SSH and GPG keys 中,点击 New SSH key,填写你的 Title,在 Key 中粘贴你的 public key
GitHub 需要识别操作确实是你提交的,而不是他人提交的,因为 Git 支持 SSH 协议,所以 GitHub 只要知道你的公钥,就能确认是你本人的提交。
二、安装 Node、Hexo
- 只有几句简单的命令,非常简单,Hexo 是基于 node.js 的,所以先安装 node
1.安装 Node
brew install node
最新版的 node.js 已经集成了 npm 包。所以只需验证一下 node, npm 是否安装成功即可
node -v
npm -v
2.安装 Hexo
npm install hexo -g
三、编写、部署博客
- cd 到你要存放博客的目录下
1.初始化
hexo init QP_blog (我起的文件夹名叫 QP_blog,你可以随意替换)
2.生成静态页面
cd 到你 init 的文件夹下
例如:我的文件创建在桌面上
cd Desktop/QP_blog
hexo generate
3.预览
hexo server
浏览器输入 http://localhost:4000 就可以看到效果。
预览完了可以 ctrl + c 关闭本地服务。
4.编写博客
hexo new "article"
你可以在 QP_blog\source_post下找到 article.md 这个文件,打开它开始用MarkDown 写东西了。
- PS:推荐两款 Mac 上非常好用的 MarkDown 软件,Mou 和 MacDown,个 人比较喜欢 Mou,可惜在系统升级到10.12后,Mou 无法使用了,其实这两个差不多。
打个样,我们可以像这样给它设置题目,日期,分类,标签等
title: "Hello Blog"
date: 2016-11-1 12:48:02
categories:
- 记事本
tags:
- 日记
---
自定义页面
如果想在你的博客中介绍下自己,你需要个“关于”界面。
hexo new page "about"
然后直接去 source 下的 about 文件夹,编辑 index.md 就可以了。还有别忘了修改在 themes 下的具体主题下的 _config.yml 文件。
menu:
首页: /
归档: /archives
关于: /about
rss: /atom.xml
5.部署
部署到 Github 前需要配置 _config.yml 文件
至于 title,description 等随你怎么写都写,主要是 deploy 中要加上这一段
"xxx"为你的用户名
deploy:
type: git
repository: git@github.com:xxx/xxx.github.io.git
branch: master
⚠️ 必须是SSH形式的 url,(git@github.com:xxx/xxx.github.io.git)
执行:
hexo deploy
如果报错:hexo ERROR Deployer not found: github
那就先安装:
npm install hexo-deployer-git --save
再执行:
hexo deploy
OK!大功告成,属于你自己的博客搭建完成了。可以在浏览器中输入 xxx.github.io 查看你的博客。("xxx"为你的用户名)PS:每次发布博客时,可按以下三步进行
hexo clean
hexo generate
hexo deploy
如果嫌网页加载慢,上传时把关于google字体的代码注掉。
至于加主题、评论、挂件等,自行 google 一下
这是我的技术博客,没事去逛逛吧 http://jackiequ.github.io/
- 常用命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭 server )
hexo deploy #将.deploy 目录部署到 GitHubhexo
help #查看帮助
hexo version #查看 Hexo 的版本
- 复合命令
hexo deploy -g #生成加部署
hexo server -g #生成加预览
- 简写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy