Re:0从零开始在Github上用Hexo搭博客

2017-09-13  本文已影响71人  米娜浮莲子

前言:

现在网上虽然已经有了不少详细的在github上搭建独立博客教程,但是不少都是几年前的,或是需要一些门槛才能理解,完全新手的话单看一个教程难免走些弯路。我打算在前人经验基础上结合自己的摸索经历写一篇非“程序员”也能照做的教程。

强调一下,如果有足够的阅读能力的话建议直接阅读文档就能解决许多问题,这就像游戏的新手教学,虽然无趣了点,但对上手绝对是帮助最大的。

为什么要搭博客

可能有人会觉得有了简书、WordPress这样的网站,为什么我还要费力去搭一个?自己的博客其实有这些好处

须要知道的基础设定

本地准备: 首先不用去管域名服务器方面的事,我们可以先在本地把环境装好。需要的有以下几个软件
Git
Node.js
以上就是安装hexo的必备软件,如果不能下载了的话也可以搜一下国内的镜像

接下来开始本地环境的搭建:

首先注册个github网页,自己新建个username.github.io的库,其中username指你注册时的用户名,下同。依据官方介绍,这个名字的库的github pages可以从非库目录里上传,所以我们可以以后通过hexo来发布博客,大概就是为了做个人主页这一用途吧,注意每个账号仅限一个这种库,而且用别的库后改名是无效的。

在本地新建个空文件夹,用来存放你的博客内容,在该文件夹下右键选择“打开Git Bash”打开控制台,如果事先打开了git bash的话需要用cd命令来到该目录下。控制台可以右键粘贴代码的,所以不会命令行也不用慌;
然后需要安装ssh key,ssh key是用来连接本地项目和你的github项目的,具体可以参照使用Github Pages建独立博客的内容,为了方便把代码部分拷贝过来了

1·、首先检查本地是否已有ssh :

$ cd ~/.ssh

如果显示“No such file or directory”,跳到第三步,否则继续。

2、 备份和移除原来的ssh key设置:

因为已经存在key文件,所以需要备份旧的数据并删除:

$ ls
config  id_rsa  id_rsa.pub  known_hosts
$ mkdir key_backup
$ cp id_rsa* key_backup
$ rm id_rsa*

3、生成新的SSH Key:

输入下面的代码,就可以生成新的key文件

$ ssh-keygen -t rsa -C "邮件地址@youremail.com"

显示

Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):

我们只需要默认设置就好,所以当需要输入文件名的时候,回车就好
然后系统会要你输入加密串(Passphrase)

Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>

最后会出现一个字符画表明生成完毕

4、添加SSH Key到github

在本机搜索id_rsa.pub这个文件,一般来说在c盘下,用自带搜索很方便就找到了,搜不到把隐藏文件设为可见。用文本编辑工具,如记事本打开文件,打开github,点击自己头像,在settings选项下SSH key下新建一个,把刚才文件中的内容全部复制粘贴保存即可。

5. 测试一下

控制台输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:

$ ssh -T git@github.com

会显示,直接输yes就好

The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

6. 设置你的账号信息

现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。

Git会根据用户的名字和邮箱来记录提交,GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字不要和昵称相同。邮箱是用来接受博客信息的。

$ git config --global user.name "你的名字"
$ git config --global user.email "your_email@youremail.com"

安装Hexo

以上准备完毕后开始安装hexo,因为我们采用hexo框架,所以官方文档和某些博客中提到的用ruby和jykell模板的方法就不推荐大家使用了,这样也不用安装配置ruby(RWBY?( ̄▽ ̄)~*)环境了
安装只需要在控制台输入

$ npm install -g hexo-cli
$ hexo init //需要在空文件夹下执行该命令
$ npm install

然后稍等会自动下载文件到你选的文件夹中,建立完成后文件结构如下。

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

hexo可以使用多种模板,如果对自带的样式不满意可以到这里下载,下载完的文件解压到themes文件夹下,可以改个简短的名字

之后需要修改_config.yml文件来进一步部署博客,在#Site标签下的一些是你个人站点的信息,如果想要进一步个性化自己的站点还可以修改其他标签下的参数,但是要注意冒号后面要空一格,不然会报错●| ̄|_
如果要利用Git部署的话,需要把deploy下面添加如下

type: git
repo: 你的项目网址
branch: master

如果了使用不同主题,需要把themes后面改成你所用主题的名字,同时需要更改主题文件夹下的_config.yml文件对显示的信息进行调整,这个因不同主题而异。

开始写文章时可以用命令$ hexo new "title",或者直接新建md文件放在\source_posts下也可以,编辑md文件,注意语法,编辑完成后执行部署命令

$ hexo generate
$ hexo deploy

生成并部署页面,因为是及时刷新的,直接上传再看有没有需要改的也可以

域名和DNS配置

现在你的个人主页地址仍然还是https://username.github.io ,如果想要真有拥有自己的独立博客的话一个有个性的域名是必要的。

购买域名其实很容易,这里就推荐大家去腾讯云或者阿里云搞一个.cn或.com就好,有微信支付宝账号就可以搞定了。去Godaddy狗爹买域名虽然可以买些.me .io之类有趣的域名,但是由于国内互联网大环境已经某些无良供应商,如某联通宽带,的原因会导致国外域名dns解析不出来,希望大家三思。至于买几年就看你自己想法了,可以买一年,到时候再更换或者续费

DNS服务推荐大家使用腾讯旗下的DNSPod,免费还不错。登录DNSPod后台,新建两条记录,类型分别是“www”和“*”类型填CNAME。更改地址还需要在博客项目的setting中,gh-page选项那填上你的域名,然后在库里新建个叫CNAME文件,注意没有后缀,也输入域名然后保存。如果不出差错的话,这时访问你的个人域名就可以看到博客的内容了。

至此个人的独立博客算基本完成了,如果按照教程来做就算不太明白原理你也应该能搭出来,当然此时博客也就相当于一个简单的网络日记本,功能还很粗糙。后续的优化和各种插件的安装使用、SEO优化之类就是新手级的问题了,后续如果有机会再写个教程讲述一下。

写这篇教程参考了以下文章:

上一篇下一篇

猜你喜欢

热点阅读