(转自官方文档)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 | $ git config --global user.name "Your Name" |
为了方便记忆,建议将名字和邮箱直接设置成与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
的内容复制进去并保存。
¶测试连接
在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 -v
和npm -v
检查Node.js
及npm
是否安装成功,如果显示版本数字,则表示已经安装成功
-
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.js
和npm
是否安装成功
¶安装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已经初始化成功了
¶部署到github个人主页
上面只是本地预览,要想让自己的博客被所有能上网的人都看到,就需要将Hexo和github关联起来,在初始化blog的文件夹中,找到站点配置文件_config.yml
,把这个文件打开,翻到最后修改:
1 | type: git |
最后安装git部署插件,运行:
1 | npm install hexo-deployer-git --save |
此时在命令行中依次输入三个命令:
1 | hexo clean |
随后用浏览器访问xxx.github.io
,如果看到与本地服务器同行的页面,就说明你的blog现在可以在网络中被访问了
¶绑定域名:
如果你在之前注册了域名,那么现在需要将你的博客与该域名绑定.
第一步,登录阿里云或腾讯云(由于我使用的是阿里云,故仅在阿里云演示),进入控制台,给你管理的域名添加解析:
第一条解析记录类型为A,主机记录填@,记录值为你的github个人主页(xxx.github.io)的ip地址(xxx.xxx.xxx.xxx)。要获取该地址,你可以在命令行或终端中输入ping xxx.github.io
来查看
第二条解析记录类型为CNAME,主机记录为www,记录值为你的github个人主页网址。
第二步,登录github,进入你创建的xxx.github.io
仓库,点击仓库的setting
,在Options
一栏中往下翻,找到Github Page
,在Custom domain
中填入自己注册好的域名,然后点击save
保存
第三步,进入本地博客文件夹的blog/source
目录,新建一个文本文档,内容为你的域名
将文件重命名为CNAME
,类型为所有文件(注意不是txt)
做完这三步,回到/blog
目录,在这个目录下用命令行或终端执行:
1 | hexo clean |
用浏览器访问你注册的域名,看到能够加载博客,就大功告成了