hexo+github-pages搭建静态博客

发表于   |   分类于

前言

1.疑问咨询：Hexo 错误咨询：troubleshooting或GitHub.
2.本文意在总结搭建博客的步骤与提供一些我所遇问题的解决方法
3.使用hexo与github有诸多好处，不多赘叙。如果不喜欢 .github.io的域名可自己随意绑定别的域名

准备

  • 注册github
  • 安装node.js，git

搭建

github阶段

1.进入github首页，点击白色按钮Start a project.在首行填写一个以.github.io结尾的仓库名（Repository name，也可叫做版本库）（记得点README进行初始化）。

2.在桌面鼠标右键呼出菜单栏点击Git Bash Here，接着输入命令：

1
2
$ cd ~/.ssh //若有提示则此处向上的操作出现错误，建议重新操作
$ ssh-keygen -t rsa -C "邮箱地址" //为注册Github所用邮箱地址

Create directory ‘/c/Users/Administrator/.ssh’.
Enter passphrase(empty for no passphrase):
 Enter same passphrase again: The key’s randomart image is:

三次回车就可以了。
接着打开C盘用户（users）文件夹，进入‘...ssh\id_rsa.pub’，copy里面内容（若未找到，查看隐藏文件）。
3.进入github主页，点击右上角显示下拉菜单，找到‘SSH and GPG keys’->’New SSH key’,将刚才copy的文字粘贴到内容框中，titile任意即可。
4.测试github是否本地连接成功，输入命令：

1
$ ssh -T git@github.com

等待…

1
Are you sure you want to continue connecting(yes/no)?

出现上述提示时，输入yes

1
Hi strangleboy!You've successfully authenticated,but Github does not provide shell access.

提示上述则成功！

hexo阶段

1.安装hexo

1
$ npm install -g hexo

当出现INFO Start blogging with Hexo!即安装成功！
2.在分区创建一个hexo文件夹，然后分别输入下列命令：

1
$ cd /f/hexo
1
$ hexo init

3.修改主题（下面是我的主题hexo-theme-next）,主题的查找可咨询知乎。

1
$ git clone https://github.com/idhyt/hexo-theme-next.git

接下来就是修改配置了！<轻松>在hexo目录下的_config.yml。使用sublime或notepad++等编辑软件打开，修改theme: landscape为theme: hexo-theme-next;修改url: http://yoursite.com为url: http://strangleboy.github.io(此处即是你的github的存储库名)。其中还有“#site”下的

1
2
3
4
5
6
title: 航//网页名
subtitle: 我的大学//副标题
desciption: 生无可“畏”，"思"不可绝//你喜欢的一段签名:)
author： strangleboy//博主的名字
language： //默认utf-8
timezone： //时区---可不填

接着输入命令hexo -g进行部署。
然后在添加配置：

1
2
3
4
5
deploy：
type: git
repository: git@github.com:strangleboy/strangleboy.github.io.git
//strangleboy是我的仓库名
branch: master

注意：上述的每个‘：’后均有空格。

4.输入命令：

1
$ npm install hexo-deployer-git --save

这个插件很重要！
如果你没安装则将来你的博客将无法上传。接下来就是

等待…

等待…

等待…

当遇到这样的问题

1
packet_write_wait: Connection to 192.30.253.113: Broken pipe

可以试试再次安装上面的hexo-deployer-git –save就好了。
安装完成后，输入：

1
$ hexo d -g

完成！

写博客

1.用markdown语法写入。
2.工具：sublime（强大补全功能，还有多行游标输入）
vim(可以告别鼠标了:>)
3.写文章只需在hexo文件夹的..\source\_posts下创建md文件即可。
完成操作后输入：

1
$ hexo s -g

进行本地的预览修改。修改后使用hexo d -g上传即成！

PS:移动过程中需要一同把.ssh和hexo、git、node.js转移。（当即使这样也需重新安装git、hexo，并且还需要重新上述命令操作）

意外状况

重装后git不能用了？

今天系统出了点小问题，重装了系统。当时重新打开后，我发现不能自由的使用我的git了，只能在git bash中的git文件中使用git。这可不行。当然这个问题很好解决了，只要设置环境变量就可以了。只需要把git下cmd的所在路径加入系统环境变量就可以了，为了保险可以把bash，git的安装目录的路径也放进去。重启之后就可以用了

git push出错了？

虽然和hexo没什么关系，但也是遇到一个错误。
遇到这种情况，可以先查看一下自己的信息：

1
2
3
git config --global user.name
git config --global user.email
git config --global --list

如果不行，就git init一下然后使用git config –global重新配置，见上文。
如果.ssh文件不在，则需要重新生成，即重复 搭建>github阶段 的部分。

hexo没有了？

好久没打开博客了，今天写了篇博文，兴致满满地在gitbash中输入$hexo s -g$预览一下我辛苦的成果XD…结果

1
2
$ hexo
bash: hexo: command not found

开什么玩笑！！！我的hexo命令竟然找不到？
赶紧google起来
得到了如下的解决方案：

  1. 使用git bash输入一下命令，检查nodejs是否安装

    1
    $ node -v

  2. 检查npm是否安装

    1
    $ npm -v

嗯~很好没有问题

  1. 检查hexo相应模块是否安装
    进入文件夹查看是否有node_modules
  2. 配置环境变量
    将于_config.yml同文件夹的node_modules中的.bin文件夹的路径放入Path中

很好！你可以执行你的hexo了吗？虾米？你可以了？我。。。看来我只能使用我的终极绝招了

1
npm install hexo-cli -g

完美解决！！！XDD
————————————————–OVER BOLG—————————————————–