Skip to content

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

Open

Description

@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 "your_email@example.com",-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;一定要先生成静态文件才能部署。

参考资料

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions