hexo+github搭建经历和过程

经历了一天多的操作,各种错误等,终于弄好了,在这写下搭建过程中会遇到的错误和自己犯的毛病。

准备工作

刚开始我们需要准备一点东西.

  • github:总得有账号,并且对于日后做项目也有用
  • 七色牛:可以用来存放一些软件和图片来生成外链(对于我而言免费的已经够用了,如果有更好的可以推荐下哦)

前面都是网站的注册,后面就需要工具的。

  • Node.js:hexo的环境,必备的
  • Git:上传本地文件到github的工具,这里给的是win版的下载地址
  • MarkdownPad :写文章的工具
  • NotePad++:用来打开修改配置文件的编辑器,也可以用来写代码

以上的工具中后两个也可以选择其他的软件,并不局限于这两个,看个人喜好,哪个好用就选哪个即可。


搭建过程

接下去就是开始搭建了。

首先将Node.js和Git安装好,然后建立一个文件夹(接下去称之为根目录),其中存放着你博客的相关文件,至于文件夹名字你喜欢就行,比如我的叫 blog

接下去进入你建立的文件夹中,右键选择git bash here ,然后在弹出的界面中开始安装hexo。

  • 安装命令npm install -g hexo
  • 安装完后进行初始化,初始化命令hexo init

完成初始化后在根目录下用编辑器打开_config.yml文件,拉到底修改如下中的内容

1
2
3
4
5
6
7
8
> deploy:
>
> type: git
>
> repo: Your_git_io_url
>
> branch: master
>

注意!

reop:Your_git_io_url是这样修改的
repository: git@github.com:JammyLin/jammylin.github.io

至于_config.yml中其他配置,比如标题(title),小标题(subtitle),作者(author)等等就看自己需求更改了,相信大家都能看懂这些英语单词的意思。

最后,第一次部署到github前需要在根目录下安装 hexo-deployer-git

  • 安装命令为npm install hexo-deployer-git --save
  • 安装完即可部署,部署命令为hexo deploy 也可以缩写打成hexo d

然后就是模板了,自己去找一个自己喜欢的模板,看模板的介绍需要这么配置,跟着配置,然后看自己需要哪些配置修改下就好了。

以上就是搭建的所有内容。

当然,当你hexo d后发现有错误,这是因为你的ssh还没有设置,接下去将会告诉你如何弄好ssh


设置ssh

接下来弄好ssh。

  • 如果是第一次设置git的ssh:

$ git config –global user.name “name”

$ git config –global user.email “email”
只需要更改引号中的name或email改成你的就行。

至于name想叫啥都行。(但是会不会有事就不知道了)

  • 生成密钥

    $ ssh-keygen -t rsa -C “email”

如果不需要密码,直接3个回车

然后得到两个文件:id_rsa和id_rsa.pub。

如果不是第一次,就选择overwrite.

  • 添加密钥到ssh-agent

    输入ssh-add
    如果Could not open a connection to your authentication agent
    那就依次输入1.exec ssh-agent bash
    2.eval ssh-agent -s
    3.ssh-add “C:\Users\Administrator\.ssh\id_rsa”
    引号中的路径就是你私匙文件的路径,路径需要使用英文双引号包裹。

如果本来就有ssh私钥输入ssh-add -D清除原有私钥

然后去github账户里面的setting设置下ssh。

注意:设置中要输的ssh是id_rsa.pub中的内容,标题随意.

最后输入ssh -T git@github.com测试下

如果有Hi,XXX.那就是成功了。


遇到的错误的解决方法

当弄好后hexo d却遇到Please tell me who you are
那就依次输入下面的命令:

1.git init
2.git config –global user.name “name”
3.git config –global user.email “email”
4.git add *
5.git commit -m “some init msg”

就可以hexo d成功了。

如果hexo d后Deployer失败,那就尝试下执行

$ npm install hexo-deployer-git

如果还不行,那直接把blog文件夹删了,里面的东西备份下,重新建一个blog,再拷贝回去hexo d应该就可以了。


如果遇到git错误:
Fatal: Not a git repository (or any of the parent directories): .git

那就是没有.git目录输入git init就行了。

如果遇到Page build failed: Missing submodule。

那你就把blog里面的东西备份了,然后原blog删了,github上的repository也删了,然后重建个repository如前面网站操作就行了。

现在,差不多全弄好了,感觉yourname.github.io太长了,想绑定自己买的阿里云等的域名,点击这里就可以。
然后在source文件夹中新建一个CNAME文件(无后缀名),然后用文本编辑器打开,在首行添加你的网站域名,如 xxx.com,注意前面没有http://,也没有www,然后使用hexo d -g上传部署。
这里说的主要是阿里云的,如果是其他的域名,这样操作无效那就百度看看怎么操作。(毕竟我也不知道,但是感觉应该一样)


最后,差不多全操作完毕,博客也应该完成了。

当以后写了文章或者更新了配置文件、主题等,就需要先生成再部署了

  • 生成的命令为hexo generate 缩写为hexo g

部署的命令上面已经有介绍了,这里说下生成和部署的合并命令hexo d -g ,这就简便多了

部署之前我们可以在本地预览自己的博客,省的修改后不是自己想要的结果,导致多次部署。

  • 本地服务器预览命令为hexo server ,缩写为hexo s

至此,教程结束。

如果想知道markdown常用语法hexo常用命令,这博客里面都有写,当然,要更详细的百度就好了。


总结一句话,善用百度。