使用hexo搭建github主页中间遇到的一些问题及总结

[pramper]

本主页基于github，使用hexo搭建，主题为maupassant

一些问题

博客搭建过程中遇到了一些问题，现把问题和解决方案归纳如下：

• hexo deploy出错，无法部署到github，报错信息如下：

  FATAL fatal: remote error: You can't push to git://github.com/pramper/pramper.github.io.git Use https://github.com/pramper/pramper.github.io.git

  意思是你不能使用SSH的方式部署到github，应该使用HTTPS的方式部署。由于使用HTTPS的方式进行部署，每次都得输入账号、密码，很麻烦，所以选择SSH方便些。步骤如下：

  1. 创建一个SHH Key：一般SSH Key在windows系统中存放在C:\Users\你的用户名\.ssh下，一般会有id_rsa和id_rsa.pub两个文件，前者是私钥，后者公钥；如果存在着两个文件则不需要创建SHH Key了；如果不存在，在命令行输入ssh-keygen -t rsa -C "[email protected]"，-t指定密钥类型，这里使用rsa，-C注释文字;
  2. 在github上添加deploy key，打开博客所在的repo，按下图操作即可：

• 设置网站缩略图，favicon

  这个花了我快一个小时，其实很简单，是我自己给自己挖了个坑-_-!。方法如下：首先你得有一个大小建议为32*32的ico图标，记住一定要是ico格式的；简单的把png|jpg之类的图片改一个后缀名是行不通的，我就是随便找了张图，改了个后缀，然后浪费了快一小时找错~~~ 可以到比特虫等网站进行格式转换。有了ico图标后，把它放到hexo根目录的source文件夹下即可。

• 更换网站语言

  在目录themes\maupassant\languages下可以查看当前主题支持哪些语言。在hexo根目录下_config.yml中，language控制着网站所用语言，使用简体中文为language: zh-CN。如果你在hexo server命令下修改的话，必须重启该命令再刷新页面才能看到效果。

• 新建页面

  hexo搭建完成后默认没有about页面，我们添加about页面:

  1. 打开你主题中的_config.yml文件
  2. 找到menu，添加

  page: about
  directory: about/
  

  1. 输入命令hexo new page about，然后hexo根目录下地source文件夹中会出现一个about文件夹，里面有个index.md文件，编辑此文件即可。

• 给github添加README

  由于hexo会把文件夹下的素有*.md文件解析为HTMl文件，而github只支持md文件。解决办法就是在blog/source下创建一个README.MDOWN文件，这样hexo无法解析它，而github却依然可以把它解析为md文件。

hexo常用指令，官网

• hexo init [foldername]：以hexo新建一个网站
• hexo new [layout] <title>：新建一篇文章
• hexo s/server：启动本地服务器，访问网址：http://localhost:4000 ；启动本地服务器后，可以进行网站的修改或写文章，不需要重启hexo s命令，刷新页面后，所做修改会自动呈现出来
• hexo d -g：生成静态文件并部署到github；一定要先生成静态文件才能部署。

参考资料

• 大道至简——Hexo简洁主题推荐