使用hexo+github搭建免费个人博客

1.前言


github pages介绍:

1.一般多用于托管个人的静态网站

2.省去了购买服务器、域名等等一系列复杂的操作

github pages好处:

1.全是静态文件,访问速度快

2.免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器不需要后台

3.数据绝对安全,基于github的版本管理,想恢复到哪个历史版本都行

4.博客内容可以轻松打包、转移、发布到其它平台

5.等

2.准备工作


1.注册一个github账号(已有不用)

2.安装了node.js、npm,并了解相关基础知识;

3.安装了git for windows(或者其它git客户端)

3.开始搭建github博客


3.1github中创建仓库

仓库名为用户名.github.io(必须与用户名一致),网站访问地址是 http://用户名.github.io 了创建成功后,默认会在你这个仓库里生成一些示例页面,以后你的网站所有代码都是放在这个仓库里。

4.配置SSH key


配置原因:因为提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh key来解决本地和服务器的连接问题

用git bash执行如下命令:

1.$ cd~/.ssh#检查本机已存在的ssh密钥 

(如果提示:No such file or directory 说明你是第一次使用git。)

2.$ ssh-keygen -t rsa -C "邮件地址"

(然后连续3次回车,最终会生成一个文件在用户目录下,打开用户目录,到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key:)

(id_rsa和id_rsa.pub,分别表示私钥和公钥文件, 私钥文件自己使用, 公钥文件需要上传到Github上.)

3.测试是否成功

$ ssh [email protected]# 注意邮箱地址不用改

(如果提示Are you sure you want to continue connecting (yes/no)?,输入yes,然后会看到:Hi QzzBL You’ve successfully authenticated, but GitHub does not provide shell access.)

说明SSH已配置成功!

4.继续配置设置用户信息

$ git config --global user.name "liuxianan"// 你的github用户名,非昵称

$ git config --global user.email "[email protected]"// 填写你的github注册邮箱

5.hexo写博客


5.1 安装

$ npm install-g hexo

5.2 初始化

$ cd/f/Workspaces/hexo/

$ hexo init

5.3

$ hexo g# 生成(静态页面)

$ hexo s# 启动服务(开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容)

(执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的:)

6.上传到github


首先,ssh key肯定要配置好。

其次,配置_config.yml中有关deploy的部分:

正确写法:

deploy:  type: git  repository:[email protected]:liuxianan/liuxianan.github.io.git  

branch: master

错误写法:

deploy:  type: github  repository:https://github.com/liuxianan/liuxianan.github.io.git

branch: master

后面一种写法是hexo2.x的写法,现在已经不行了,无论是哪种写法,此时直接执行hexo d的话一般会报如下错误:

Deployer not found: github 或者 Deployer not found: git

原因是还需要安装一个插件:

npm install hexo-deployer-git --save   (hexo-deployer-git 会存在于node_modules文件夹中)

打开你的git bash,输入hexo d就会将本次有改动的代码全部提交

7.常见hexo命令及上传步骤


常见命令

hexo new "postName" #新建文章

hexo new page "pageName" #新建页面

hexo generate #生成静态页面至public目录

hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)

hexo deploy #部署到GitHub

hexo help  # 查看帮助

hexo version  #查看Hexo的版本

hexo new page 'postName'命令和hexo new 'postName'有区别:

hexo new page "my-second-blog"

生成如下:

最终部署时生成:hexo\public\my-second-blog\index.html,但是它不会作为文章出现在博文目录。

缩写:

hexo n == hexo new

hexo g == hexo generate(此三步骤完成上传)

hexo s == hexo server

hexo d == hexo deploy

组合命令:

hexo s -g #生成并本地预览

hexo d -g #生成并上传

8.个人安装时问题


1.访问username.github.io时出现404错误(可能与没有分支 git init 等安装分支)

2.主题修改本地可看,github上看不了

3.等等

9.参考文章


http://blog.haoji.me/build-blog-website-by-hexo-github.html?from=xa

https://www.jianshu.com/p/380290deb8f0

https://blog.csdn.net/zxy987872674/article/details/72491066

你可能感兴趣的:(使用hexo+github搭建免费个人博客)