您的当前位置:首页正文

Hexo+GitHub Pages个人博客(1):搭建

来源:华拓网

对于喜欢折腾个人博客的人来说,一个可玩性强的博客/博客平台才是最适合自己的。可玩性包括自定义主题/功能,现有的通用型博客平台在自定义这一块上基本没法满足可玩性,太专业的博客系统对于非专业型人才来说门槛又比较高,并且管理繁杂。因此这里推荐一种比较简单的搭建个人博客方式:Hexo+GitHub Pages。

Hexo和GitHub Pages以及个人博客搭建的概念

个人博客搭建,一般可以拆解为三个步骤:你需要去选择一个合适的博客系统,把系统上传部署到你所购买的服务器上,然后在服务器上设置好你购买的域名。

这样下来包含的时间成本(学习博客系统/服务器)以及金钱成本(购买服务器/域名)会比较高,而使用Hexo+GitHub Pages的方式去搭建博客,相当于GitHub帮助你购买了域名和服务器,省去了这两块成本,Hexo的简单上手性又减少了你学习博客系统的时间成本。

环境与前期准备

  1. 安装Node.js
    到 下载对应平台的版本,推荐选择LTS稳定版,安装。
  2. 安装Git
    到 下载对应平台的版本,安装。
  3. 安装文本编辑器
    下载你喜欢的文本编辑器,方便后面的文本/代码编辑,代码编辑器推荐 和 ,Markdown文本编辑器推荐 ,安装。
  4. GitHub帐号与Pages(有帐号以及pages的可跳过)
    注册/登录Github帐号,新建一个「仓库(Repository)」,命名为「你的GitHub账户名.github.io」
  5. Markdown
    入门,学会md文档写作有助于博客发布

GitHub Pages的部署

  1. 打开Git,输入GitHub的邮箱和用户名:

    git config --global user.email 
    git config --global user.name "yourname"
    
  2. 生成公钥:

    ssh-keygen -t rsa -C 
    
  3. 一路回车即可,公钥默认保存路径会显示出来

  4. 复制公钥:

    复制git窗口中「The key fingerprint is:」下面的一行内容

    SHA256:m9eyW063av9khxQbYP1dfbxWthzJIRV2wHAiWUragsM 
    
  5. 登录你的GitHub主页,添加SSH公钥:「Settings」-「SSH and GPG keys」-「New SSH key」

  6. 粘贴刚刚复制的公钥到「key」一栏中,在「title」一栏中填入对这个SSH公钥的说明,确认添加「Add SSH key」

  7. 完成以上步骤后,可在Git窗口输入以下代码验证SSH key是否生效:

    ssh -T 
    

这里的SSH公钥相当于你电脑访问你GitHub上博客的钥匙,添加了相应的公钥才能允许你向GitHub上部署/发布/修改你的博客

Hexo博客的初始化

以上各种环境以及前期了解准备后,我们终于可以着手搭建博客啦:

  1. 选择你想存放你的博客的电脑文件位置,在该文件夹右键,选择「Git Bash Here」

  2. 安装Hexo:
    在Git窗口中输入以下代码安装Hexo:

    npm install -g hexo
    
  3. 初始化Hexo:
    在Git窗口中输入以下代码初始化Hexo:

    hexo init
    
  4. 生成博客静态页面:
    在Git窗口中输入以下代码生成静态页面:

    hexo server(或者hexo s)
    

Hexo博客的上线部署

以上步骤完成后,你已经得到了一个本地部署的博客,那么接下来是如何将它发布到线上:

  1. 登录你的GitHub主页,点击你之前以账户名新建的「yourname.github.io」,点击「Clone or download」,复制该项目的SSH key

  2. 打开你存放博客的文件位置,找到「_config.yml」文件,使用文本/代码编辑器打开编辑

  3. 找到deploy 参数,将刚刚复制的SSH key粘贴到repo后面,其余参数按以下设置,保存:

    deploy:  
    type: git 
    repo: 
    branch: master
    
  4. 在博客文件位置右键,选择「Git Bash Here」,输入「hexo deploy」或者「hexo d」

Hexo博客的文章发布

我们已经将博客部署到GitHub线上了,不过显示的文章只有内置的一篇「Hello World」,如何才能换成我们自己的文章发布呢?

使用Git客户端新建和发布:
  1. 打开Git客户端,输入:

    hexo new  "articleName"
    

    articleName为你新建文章的标题

  2. 打开你的博客存放目录,新建的markdown格式的文章会放在「Source」-「_posts」下面

  3. 使用文本编辑器编辑刚刚你新建的文章

  4. 在Git窗口输入hexo g 生成静态文件,再输入hexo d 发布到线上

使用文本编辑器新建再用Git发布:
  1. 使用文本编辑器新建以及编辑markdown格式的文章
  2. 将写好的markdown格式的文章放到博客存放目录下的「Source」-「_posts」下面
  3. 在Git窗口输入hexo g 生成静态文件,再输入hexo d 发布到线上

完成文章发布之后,只需要浏览器打开你的博客地址,就可以看到刚刚发布的文章了

博客存放目录下的「Source」-「_posts」下面存放的都是博客文章,你也可以直接在这里删除你不需要的文章,例如系统自动生成的「Hello World」文章