转载了多个教程,么么哒~~
1.注册
如果你还没有自己的Github账号,那请到Github官网注册账号:https://github.com/
打开https://github.com/,在下图的框中,分别输入自己的用户名,邮箱,密码。
然后前往自己刚才填写的邮箱,点开Github发送给你的注册确认信,确认注册,结束注册流程。
一定要确认注册,否则无法使用gh-pages!
2.创建代码库
注册完成后,点击Start a project来新建一个版本库
如果你已经注册,则在自己的主页,点击”New repository”,即可新建一个代码库
输入Repository name:yourname.github.io (yourname与你的注册用户名一致,这个就是你博客的域名了)
注意:比如我的github名称是hxlitong,这里你就填 hxlitong.github.io
3.启用GitHub Page
进入版本库后,点击右上方的setting
下来到Githubs pages栏目,点击Launch automatic page generator
来到New user site页面后点击右下角的Continue to layouts
最后点击”Publish page”,发布github默认生成的一个静态站点
至此,我们已经配置好了github默认的静态站点,并且可以访问:你的github用户名.github.io测试我们刚刚建立好的站点主页。
4.下载并安装Git
下载
根据自己电脑操作系统的位数到git官网下载相应的版本:
安装
根据自己的需要安装到相应的路径下,其他的一路点击next即可
配置环境变量
选中桌面图标计算机,右键选择属性,打开左边的高级系统设置,打开弹出窗口的环境变量,找到path进行编辑。
找到git的安装目录,将其复制后粘贴到path后面。注意每一个加进来的路径后面都要带英文格式的分号。
安装与配置过程可参考图文教程:git的安装和配置
测试是否安装成功
windows+R输入cmd打开命令提示符窗口,输入如下命令:
git --version
若安装成功会打印出本机安装的git的版本。
添加SSH KEY到Github
SSH Key是一个认证,让github识别绑定这台机器,允许这台机器提交。
(1)检查本机是否有SSH KEY设置
打开git bash,输入cd ~/.ssh 或cd .ssh
如果没有则提示: No such file or directory
如果有则进入~/.ssh路径下(ls查看当前路径文件,rm * 删除所有文件)
(2)配置生成SSH KEY
$ cd ~ #保证当前路径在”~”下
$ ssh-keygen -t rsa -C "这里填写你的邮箱地址"
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/xxxx_000/.ssh/id_rsa): #不填直接回车
Enter passphrase (empty for no passphrase): #输入密码(可以为空)
Enter same passphrase again: #再次确认密码(可以为空)
Your identification has been saved in /c/Users/xxxx_000/.ssh/id_rsa. #生成的密钥
Your public key has been saved in /c/Users/xxxx_000/.ssh/id_rsa.pub. #生成的公钥
The key fingerprint is:
e3:51:33:xx:xx:xx:xx:xxx:61:28:83:e2:81 xxxxxx@yy.com$
至此,已经生成ssh key,其存放路径为:c:/Users/你电脑的用户名/.ssh/下。
注释:可生成ssh key自定义名称的密钥,默认id_rsa。
(3)复制SSH KEY到Github
到C盘你的用户目录下找到.ssh文件夹,查看里面是否有id_rsa和id_rsa.pub这两个文件。
登录GitHub系统;点击右上角账号头像的“▼”→Settings→SSH kyes→Add SSH key,Title自定义,复制id_rsa.pub的公钥内容到GitHub中Add an SSH key的key输入框,最后“Add Key”。
(4)配置账户
$ git config --global user.name “your_username” #设置用户名
$ git config --global user.email “your_registered_github_Email”#设置邮箱地址(建议用注册giuhub的邮箱)
(5)测试SSH KEY是否设置成功
$ ssh -T git@github.com
接下来会返回一些信息,并需要你输入一次yes,若生成ssh key时设置有密码则还会让你输入生成ssh key时设置的密码。
Hi xxx! You’ve successfully authenticated, but GitHub does not provide shell access. #出现词句话,说明设置成功。
SSH-KEY的生成与配置可参考图文教程window下配置SSH连接GitHub、GitHub配置ssh key:
5.下载并安装node.js
下载
根据自己电脑操作系统的位数到git官网下载相应的版本:
https://nodejs.org/en/download/
安装
根据自己的需要安装到响应的地方,其他的一路点击next即可
配置环境变量
选中桌面图标计算机,右键选择属性,打开左边的高级系统设置,打开弹出窗口的环境变量,找到path进行编辑。
找到node.js的安装目录,将其复制后粘贴到path后面。注意每一个加进来的路径后面都要带英文格式的分号。
测试是否安装成功
windows+R输入cmd打开命令提示符窗口,输入如下命令:
node -v
若安装成功会打印出本机安装的node.js的版本。
6.安装Hexo
在你喜欢的路径下新建一个文件夹blog,用来存放博客的文件,在此文件夹中右键打开Git Bash
输入如下指令进行安装:
npm install -g hexo-cli
如果执行这条命令时长时间未成功,那么请先使用下面的命令将npm镜像源更改为国内的镜像,再执行上面的安装命令,因为国外的镜像源很有可能被墙了。
npm config set registry https://registry.npm.taobao.org
初始化hexo
$ hexo init hexo
这里会将Github上的hexo项目clone下来,得到hexo文件夹。
初始化成功后会在最后打印一行:INFO Start blogging with Hexo!
安装依赖文件
进入到hexo文件夹
cd hexo
安装依赖文件:
npm install
部署形成文件:
hexo generate
本地测试
hexo server
在浏览器输入:http://localhost:4000/即可访问到我们搭建好的hexo站点。
7.将本地hexo项目托管到Github
修改全局配置文件_config.yml
说明:hexo文件夹下一个_config.yml,我们称之为全局配置文件,在每个主题文件夹内还会有一个_config.yml文件,我们称之为主题配置文件。
用sublime text3或者notepad++等编辑器打开hexo文件夹下的_config.yml文件。
注意:配置文件中每个字段后面的冒号是英文格式的,且在其后要加一个空格再写值
编辑最后面的deploy属性,加入代码:
type: git
repository: https://github.com/你的Github用户名/你的Github用户名.github.io.git
branch: master
type使用是git。
repository属性改成你的刚才创建仓库git地址。
分支branch填写master。
安装hexo-deployer-git插件
npm install hexo-deployer-git --save
部署到Github上
依次执行以下三条命令:
hexo clean #清除缓存 网页正常情况下可以忽略此条命令
hexo generator #生成静态页面至public目录
hexo deploy #将.deploy目录部署到GitHub
执行hexo deploy命令之后,如果最后一行打印出如下信息则表示部署成功
INFO Deploy done: git
然后你再去访问你创建的Github pages地址,也就是:你的Github用户名.github.io,即可看到你本地的hexo项目已经被部署到github上去了。此时博客的默认主题是landscape,即上面本地测试时的样子。
参考文章