免费搭建个人技术博客 Github and Hexo

0 环境

Windows 10

1 环境安装

1.1 安装Node.js

Node.js下载地址:https://nodejs.org/en/,下载完成后安装
(由于很多程序都是从境外的网站下载的,下载会比较慢,挂个VPN后下载更快,可以从网上找免费的VPN,但绝大多数都不稳定,建议购买付费VPN,花钱买时间,大家若没有自己喜欢的VPN的话,可以试下我正在使用的’一枝红杏’:https://my.yizhihongxing.com/aff.php?aff=2840

1.2 安装Cmder(with git)

Cmder是一款Windows下的命令行终端软件,完爆Windows自带的cmd,推荐下载!
Cmder(with git)下载地址:https://cmder.net/
直接下载包含git的完全版,可以不用再去单独安装git了。

1.3 安装Hexo

打开Cmder,输入以下命令使用npm安装Hexo

    npm install -g hexo-cli

等待时间视网速而定,此时可以先去找找自己喜欢的主题:https://hexo.io/themes/,或是先按照1.4 配置Github来进行Github的配置

1.4 配置Github

1.4.1 创建New repository

Github网址:https://github.com

  • 注册完账号后(如之前没有的话),点击右上角的+ ,而后选择New repository

  • Repository name内填入你的用户名.github.io,如下图,务必保证两个红框内的用户名一致,否则会导致404 not found error,将来你的用户名.github.io就是你的博客域名,如我的博客域名就是’shelmingsong.github.io’

1.4.2 生成SSH key

  • 在Cmder内输入
    ssh-keygen -t rsa -C '你的Github注册邮箱'

  • 一直enter下去就可以了,最后会提示:
    Your public key has been saved in /c/Users/smy/.ssh/id_rsa.pub.
  • 找到这个文件,用sublime或是其它编辑器打开,复制文件内全部内容,而后打开https://github.com/settings/keys,点击new SSH key,Title随便写,建议写Blog,Key内粘贴刚才复制的内容。

2 Hexo博客本地发布

  • 在你认为合适的目录创建文件夹,将来博客的所有本地内容将存储在此目录
  • 在所创建文件夹内按住shift后鼠标右击,选择Cmder here
  • 在打开的Cmder内输入(就这样写,不要在init后面加任何东西,不然后面进行设置的时候会比较麻烦):
    hexo init
  • 等待一段时间后,成功提示:
    INFO  Start blogging with Hexo!
  • 输入以下命令,生成静态页面:
    hexo g

  • 输入以下命令,启动本地服务器:
    hexo s


* 在浏览器地址栏输入https://localhost:4000/就可以看到你的博客了,此时你的博客仅本地可见,要挂到Github服务器上还需要执行下面的步骤

3 修改博客参数

执行完上述步骤后,你的博客上尚未体现出你的任何信息,此时需要修改博客参数
* 在你所创建的博客目录里面,找到_config.yml

* 用sublime或其它编辑器打开_config.yml,修改以下参数,#后面为注释:

在Site菜单

    title: Shelming.Song's Blog # 博客主标题
    subtitle: Song's Share # 博客副标题
    description: Life is short, I use Python! # 网站描述
    author: Shelming.Song # 作者信息
    language: zh-Hans # 语言
    timezone: # 时区,可以空着

在Deployment菜单

    deploy: 
      type: git # 就填这个,别改成其它的
      repo: https://github.com/shelmingsong/shelmingsong.github.io.git # 将两个'shelmingsong'改成你的用户名
      branch: master # 就填这个,别改成其它的

注意
yml文件内每个参数的冒号后面,都需要加上一个空格,在sublime文件内通过颜色能显现

4 上传博客到Github服务器

  • 在Cmder输入以下命令
    hexo d
  • 出现以下提示即为上传成功
    INFO  Deploy done: git

  • 如果提示error deployer not found:git,则需要执行以下命令
    npm install hexo-deployer-git --save
  • 如果提示No such device or address,则需要将_config.yml文件内的repo改成ssh格式的,如下:
    deploy: 
      type: git
      repo: git@github.com/shelmingsong/shelmingsong.github.io.git# 将两个'shelmingsong'改成你的用户名
      branch: master
  • 如果提示登录Github登录,输入账号密码登录就可以了
  • 然后你就可以在浏览器地址栏输入你的博客网址,如https://shelmingsong.github.io/,如此别人也可以通过域名来访问到你的博客了
  • 如果打开网页后提示404 not found error,一般有两种可能,一是网速不好,Github是美国的网站,会延迟个几分钟,二是你创建New repository的时候,没有将以下图片中红框内的用户名保持一致

5 常用hexo命令

  • 创建新文章
    hexo new '文章名'

而后进入所提示的目录,用md编辑器(推荐使用MarkdownPad)打开文件,用Markdown语法写文章
Markdown语法教程:https://wowubuntu.com/markdown/basic.html

  • 生成静态文件
    hexo g
  • 启动本地服务器(用于修改后的预览)
    hexo s
  • 发布博客到服务器
    hexo d

6 修改博客主题

https://hexo.io/themes/上挑选自己喜欢的主题,不同的主题会有不同的配置方法,推荐使用next主题,next主题使用文档:https://theme-next.iissnan.com/

说点什么

  Subscribe  
提醒