建站历程:安装及部署篇

(转自官方文档)Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

而通过将静态博客托管给github,可以让你的博客更方便地被其他人看到。

以下就是我自己整理的安装Hexo框架,并部署到github的教程:

前期准备

安装git

由于该blog是基于github+hexo搭建的,因此在电脑上,需要首先安装git:

  • 如果你是windows用户,直接从这里下载安装包,并默认安装即可。安装完成后,运行git bash
  • 如果你是Linux用户,且为基于Debian的发行版,则直接运行
1
$ sudo apt-get install git-core

配置github

本地配置

在linux的终端或者windows的git bash中配置自己的个人信息:

1
2
$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

为了方便记忆,建议将名字和邮箱直接设置成与github账号一致。

链接到远程仓库

依然是在linux的终端或者windows的git bash中,生成新的SSH钥匙:

1
$ ssh-keygen -t rsa -C "your_email@example.com"

用你在本地配置中设置的邮箱替换your_email@example.com,随后按三次回车,你可以看到,共生成了两把钥匙,分别是秘钥和公钥,这里我们需要用到公钥,它被保存在了C/Users/xxx/.ssh/id_rsa,pub (windows)或者~/.ssh/id_rsa.pub(linux)中,找到并打开id_rsa.pub文件。

登录你的github,在网页的右上角,点击三角形,进入Setting页面,随后进入SSH and GPG keys一栏,点击New SSH key。在Title框内给这个key取个名字,然后把id_rsa.pub的内容复制进去并保存。
image

测试连接

在linux的终端或者windows的git bash中输入ssh -T git@github.com,在看到提示后输入yes,如果在之后弹出的内容中提示的用户名是你的,说明SSH key已经匹配成功了,接下来就可以使用github了

创建个人网站仓库

登录github,点击New repository创建新仓库,命名为用户名.github.io,注意这里一定要用你github账号的用户名

获取个人网站域名(可选)

这一步不是必须,即使你没有注册自己的域名,也可以在配置完成后,通过访问xxx.github.io来查看自己的blog.但是域名是一个网站的入口,好记且有个人标识的域名,你值得拥有。比较简便的注册域名的途径是阿里云腾讯云

安装和部署

安装Node.js

我们选用的是Hexo,一款基于Node.js的静态博客框架,若要安装Node.js

  • Windows: 从这里下载安装包并安装。该安装包除了Node.js还会一并安装npm,安装完成后,可以通过在命令行(注意不是git bash)输入node -vnpm -v检查Node.jsnpm是否安装成功,如果显示版本数字,则表示已经安装成功
    image

  • Linux:

    安装npm

    1
    $ sudo apt install npm

    升级npm为最新版:

    1
    $ sudo npm install npm@latest -g

    安装用于安装Node.js的模块n

    1
    $ sudo npm install -g n

    然后通过n模块安装稳定版本的Node.js

    1
    $ sudo n stable

    用与Windows同样的方法,检查Node.jsnpm是否安装成功

安装Hexo

在windows的命令行窗口或linux的终端中输入:

1
$ npm install -g hexo-cli

耐心等待安装完成。

初始化博客

在Hexo安装完成后,用cd前往你想要放blog文件的文件夹,初始化blog,输入:

1
hexo init blog

随后生成静态文件:

1
hexo g

启动本地服务器预览:

1
hexo s

之后在浏览器中访问localhost:4000,若看到如下页面,恭喜你blog已经初始化成功了
image

部署到github个人主页

上面只是本地预览,要想让自己的博客被所有能上网的人都看到,就需要将Hexo和github关联起来,在初始化blog的文件夹中,找到站点配置文件_config.yml,把这个文件打开,翻到最后修改:

~/blog/_config.yml
1
2
3
type: git
repo: git@github.com:用户名/用户名.github.io.git,记得加上 .git
branch: master

最后安装git部署插件,运行:

1
npm install hexo-deployer-git --save

此时在命令行中依次输入三个命令:

1
2
3
hexo clean 
hexo g
hexo d

随后用浏览器访问xxx.github.io,如果看到与本地服务器同行的页面,就说明你的blog现在可以在网络中被访问了

绑定域名:

如果你在之前注册了域名,那么现在需要将你的博客与该域名绑定.

第一步,登录阿里云或腾讯云(由于我使用的是阿里云,故仅在阿里云演示),进入控制台,给你管理的域名添加解析:  
image
第一条解析记录类型为A,主机记录填@,记录值为你的github个人主页(xxx.github.io)的ip地址(xxx.xxx.xxx.xxx)。要获取该地址,你可以在命令行或终端中输入ping xxx.github.io来查看    
image
第二条解析记录类型为CNAME,主机记录为www,记录值为你的github个人主页网址。
image
第二步,登录github,进入你创建的xxx.github.io仓库,点击仓库的setting,在Options一栏中往下翻,找到Github Page,在Custom domain中填入自己注册好的域名,然后点击save保存
image
第三步,进入本地博客文件夹的blog/source目录,新建一个文本文档,内容为你的域名
image

将文件重命名为CNAME,类型为所有文件(注意不是txt)  
做完这三步,回到/blog目录,在这个目录下用命令行或终端执行:

1
2
3
hexo clean
hexo g
hexo d

用浏览器访问你注册的域名,看到能够加载博客,就大功告成了

参考文献

0%