Hashub

醉后不知天在水,满船清梦压星河

0%

hexo+github部署搭建个人网站踩坑超全记录

上个图先
image
这是最后成功的预览图 地址是:blog.zhashub.com

先说一下大致的步骤:

  • 先在本地搭建好hexo
  • 再把本地的hexo部署到github
    是不是很简单(呸,等下你就知道多少坑了) 本地的hexo搭建:
  • 安装Git Bash(这个不会装那就算了吧,接下来的不适合你)
  • 安装NodeJs(http://nodejs.cn/ 傻瓜式安装,应该不难对你来说)
  • 在本地新建一个空文件夹(英文目录)
  • 右键git bash进入

image

输入:

1
npm -v //检查npm是否安装成功

image

  1. 安装hexo
1
2
npm install hexo-cli -g //这里是利用node的npm来下载hexo
hexo -v //这里-v是查看版本的意思

image

1
hexo init //初始化hexo

去你新建的文件夹可以看到很多文件,到这里hexo是安装成功了
image


接下来再切换到你的git bash

1
2
hexo g
hexo s

这里会提示:

1
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

这时候打开–http://0.0.0.0:4000/

你就可以看到hexo的网页了
image

到这一步那基本的hexo算是在本地搭建成功了,接下来看看怎么更换主题,毕竟私人博客总得漂亮点!


这里我用的是next主题

百度搜索:next主题

image

两种方式下载主题:

  • 一、使用GIT
    image
  • 二、下载解压包并解压到themes下面

(注意如果有二级目录的话就要删掉一级目录,保证进去next文件夹里面就是一堆文件)
image

无论哪种方式请确保你下载的路径是在\themes下面

image
上面的next就是我下载的,只是把名字换成了next。

再次提醒要注意next里面可能会有两层目录,要去掉一层确保next文件夹在themes目录下


回到你文件主目录找到_config.yml用编辑器打开

image

找到theme,把它后面改为,theme: next

image

在这个配置文件你可以修改一些基本的配置

image

接下来查看一下效果

  • 切换到git bash,输入
1
2
3
4
5
hexo clean

hexo g

hexo s

等待运行完毕后打开网址–http://0.0.0.0:4000/

不出意料应该是next的主题网站了
image

至此,在本地搭建个性化next主题的hexo个人博客算是完成了


二、接下在是最最最(也不是很麻烦的)部署到GitHub上面

在github(没有GitHub的话,注册呗~)新建仓库
image

下面这一步一定要特别小心,把仓库名字一定要写成 ”你的用户名.github.io“
image

打开设置
image

拉到下面github page 选择master branch 记住要 save(保存)
image

到这里,远端的仓库算是创建好了


接下来,回到你文件的主目录,右键git bash 输入

1
git init   /初始化仓库

初始化完,先放一放

回到_config.yml配置文件,找到deploy:

image

1
2
3
4
deploy:
type: git
repository: https://github.com/newHashub/hashub.github.io.git
branch: master

repository: https://github.com/newHashub/hashub.github.io.git

上面从https开始的这个地址在你GitHub上,直接复制粘贴
image

接下来切回git bash

输入

1
2
3
npm install hexo-deployer-git --save
hexo g
hexo d

稍等它在将本地的项目put到远端的github,(这里涉及到ssh密钥,或者要登录你的GitHub,或者设置你的邮箱,之类的,在这里不多赘述,网上有教程。)

回到刚才GitHub设置的页面,打开下面的地址。
image


不出意料,你会开心的像个孩子!

image


至此在使用hexo搭建博客并部署到GitHub算是基本完成了!撒花!

但是!!!

没完!!!

接下来补充几个坑:


  • 输入hexo init后出现FATAL

你误删文件了,或者顺序不对,可以试试下面这个方法

1
2
3
hexo init <新文件夹>
cd <新文件夹>
hexo setup

换句话说就是先别创建文件夹 而是使用hexo init创建文件夹


git bash上重置本机git设置git config –global credential.helper store

以上还不行的话,应该是涉及到SSH,具体上网百度,这里提供你百度的方向(SSH)。


  • 使用Git出现HttpRequestException encountered错误

主要原因是Github禁用了TLS v1.0 and v1.1这种弱加密标准,手动更新Windows的git凭证管理器即可,下载Git在Window上的凭证管理器并默认安装


  • 输入hexo d 后出现 ERROR Deployer not found: git

没输入下面这个:

1
npm install --save hexo-deployer-git

以上,待补充,欢迎骚扰zht_bb0864@163.com