GitHub Pages 博客搭建

GitHub Page 建立博客

Github作为现在最流行的代码仓库,已经得到很多大公司和项目的青睐,比如AlibabaSpring等。为使项目更方便的被人理解,介绍页面少不了,甚至会需要完整的文档站,Github替你想到了这一点,他提供了Github Pages服务。不仅可以方便的为项目建立介绍站点,也可以用来建立个人博客。


搭建博客初衷

  • 拥有属于自己的个人博客
  • 发布技术感想、技术沉淀落地
  • 记录自己的生活
  • 免费!免费!免费!
  • github是趋势,学习使用Git

GitHub Pages

Github Pages 是什么

github Pages可以被认为是用户编写的、托管在github上的静态网页。

Github Pages有以下几个优点:

  1. 轻量级的博客系统,没有麻烦的配置
  2. 使用标记语言,比如Markdown
  3. 无需自己搭建服务器
  4. 根据Github的限制,对应的每个站有300MB空间
  5. 可以绑定自己的域名

Github Pages有以下几个缺点:

  • 使用Jekyll模板系统,相当于静态页发布,适合博客,文档介绍等。
  • 动态程序的部分相当局限,比如没有评论,不过还好我们有解决方案
  • 基于Git,很多东西需要动手,不像Wordpress有强大的后台

搭建

配置和使用Github

  1. 学习使用 Git
  2. 申请 GitHub 账号
  3. Github Pages创建站点仓库
  4. 配置SSH keys

    配置SSH KEYS

    首先我们需要检查你电脑上现有的ssh key:

$ cd ~/. ssh 检查本机的ssh密钥

生成新的SSH Key:

$ ssh-keygen -t rsa -C “这里可以随意写,主要是注释功能,也可以写邮箱地址”
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<此处可以写生成文件的名称,比如我的 id_rsa_hexo>

然后系统会要你输入密码:

$ Enter passphrase (empty for no passphrase):[输入加密串]

$ Enter same passphrase again:[再次输入加密串]


添加SSH Key到GitHub

  1. 登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
  2. 把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了

参考
常见问题及解决方法

安装Node

我的是Mac环境,因此使用的是brew。

brew install node

node的模块管理工具是npm,用brew安装node的时候,npm会默认安装。

安装Hexo

npm cache clean 清理npm缓存
npm config set registry=”http://registry.cnpmjs.org
npm install node-pre-gyp -g
npm install hero-cli -g

发布到 Github 个人站点

克隆主题到自己的博客目录下

git clone https://github.com/iissnan/hexo-theme-next themes/next

编辑 _config.yml (在 H:\hexo 下)。你在部署时,要把下面的 zippera 都换成你的账号名。

deploy:
type: github
repository: https://github.com/xxxx/xxxx.github.com.git
branch: master

执行下列指令即可完成部署。

hexo generate
hexo deploy
hexo server –debug

然后在浏览器中输入http://localhost:4000 就可以看到效果。

Hexo命令常用命令:

npm install hexo-deployer-git —save # git发布插件
hexo server –debug
hexo new “postName” #新建文章
hexo new page “pageName” #新建页面
hexo generate #生成静态页面至public目录
hexo deploy #将.deploy目录部署到GitHub
hexo server #开启预览访问端口(默认端口4000,’ctrl + c’关闭server)

Hexo 配置和第三方插件

404公益页面
第三方服务集成
Hexo主题配置

遇到的问题:
1、Permission denied (publicly).
解决方案:ssh-add ~/.ssh/id_rsa_work
2、发布失败
解决方法:npm install hexo-deployer-git —save

参考:
Hexo 文档 搭建过程基本安装官网步骤
Hexo高效的静态站点生成框架的使用 基本过程都是按照这个做的!
如何搭建一个独立博客——简明Github Pages与Hexo教程这篇文章帮助很大

多账号配置
Hexo搭建博客1
Hexo搭建博客2
Hexo搭建博客3