Hexo+Github托管:搭建自己的博客

Hexo是一个快速、简洁且高效的博客框架,而Github是一个免费的代码托管工具,利用Github Page可以免费创建一个静态网站。下面将介绍如何使用Hexo和Github,在win10环境下搭建一个静态的博客。

安装和配置Hexo及Github

安装Hexo

安装Hexo前,需要安装以下:

  • Node.js
  • Git

如果已经安装完成以上程序,打开Git-bash或者cmd,输入
npm install -g hexo-cli 即可完成Hexo的安装。

使用Hexo进行本地建站

选择一个本地的文件夹,如

D:\hexo。

输入

hexo init D:\hexo

cd D:\hexo

npm install

如果hexo安装成功,则在D:\hexo文件夹下的文件目录为

.

├── _config.yml // 网站的配置信息,你可以在此配置大部分的参数。

├── package.json

├── scaffolds // 模板文件夹。当你新建文章时,Hexo会根据scaffold来建立文件。

├── source // 存放用户资源的地方

| ├── _drafts

| └── _posts

└── themes // 存放网站的主题。Hexo会根据主题来生成静态页面。

详细文件或文件夹的具体含义见 Hexo官方文档之建站https://hexo.io/zh-cn/docs/setup.html

为了测试本地建站是否成功,输入

hexo s

如果显示如下

hexo s 本地建站成功

则说明本地建站成功,访问本地地址可以看到Hexo默认主题的效果。

至此,Hexo的安装和本地建站完成,如需更加深入全面地了解Hexo,可访问Hexo官方文档。

创建Github账号

如果已经注册Github,可跳过此步骤。否则,访问Github官网进行注册,下面假设你注册Github账号名为MyGithub。

创建与账号同名的Repository

注册并登陆Github官网成功后,点击页面右上角的
+,选择 New repository

Repository name中填写你的Github账号名.github.io,这里是MyGithub.github.ioDescription中填写对此repository的描述信息(可选,但建议填写,如Personal website)。

点击Create repository,完成创建。

配置SSH

(1) 生成SSH

检查是否已经有SSH Key,打开Git Bash,输入

cd ~/.ssh

如果没有这个目录,则生成一个新的SSH,输入

ssh-keygen -t rsa -C "your e-mail"

其中,your e-mail是你注册Github时用到的邮箱。

然后接下来几步都直接按回车键,最后生成如下(这里要特别注意:在哪个路径下,输入哪个命令

warning text1

(2) 复制公钥内容到Github账户信息中

打开~/.ssh/id_rsa.pub文件,复制里面的内容;

打开Github官网,登陆后进入到个人设置(点击头像->setting),点击右侧的SSH Keys,点击Add SSH key;填写title之后,将之前复制的内容粘贴到Key框中,最后点击Add key即可。

(3) 测试SSH是否配置成功

输入

ssh -T git@github.com

如果显示以下,则说明ssh配置成功。

Hi username! You’ve successfully authenticated, but GitHub does not
provide shell access.

warning text1

将网站发布到Github的同名repository中

打开D:\Hexo文件夹中的_config.yml文件,找到如下位置,填写

deploy:

type: git

repository: git@github.com:MyGithub/MyGithub.github.io,master

注: (1) 其中MyGithub替换成你的Github账户; (2) 注意在yml文件中,:后面都是要带空格的。

此时,通过访问http://MyGithub.github.io可以看到默认的Hexo首页面(与之前本地测试时一样)。

热评文章