hexo+github搭建博客
1.1 准备工作
- github账号
- nodejs、npm环境
- git for windows
- 实验环境win10
2.1 github创建仓库
新建一个名为 你的github名.github.io的仓库,比如说你的github 名为x,则新建一个名为 x.github.io的仓库,其他名称无效,因为之后你搭建好的博客地址将会是 http://x.github.io
2.2 配置SSH KEY
当你向github提交代码的时候需要github权限,但是直接使用密码不安全,所以我们通过ssh key来解决本地和服务器连接的问题。
首先我们需要安装git,安装完git后可以用 git --version 来查看一下git的版本。
打开git
查看我们的电脑上已有的ssh密钥
$ ls ~/.ssh/
如果没有id_rsa id_rsa.pub,或者提示no such file or directory说明是第一次使用。
那么我们新生成一个密钥(邮件地址是github注册时用的邮箱)
$ ssh-keygen -t rsa -C 邮件地址
然后连续输入3次回车,最终会生成一个文件在用户目录下,打开用户目录,找到
.ssh\id_rsa.pub
文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key:
测试是否成功
$ ssh -T git@github.com
如果提示Are you sure you want to continue connecting (yes/no)?,输入yes
接着提示Hi xxxx! You've successfully authenticated, but GitHub does not provide shell access.
说明配置成功!
紧接着配置
$ git config --global user.name "xxx"// github用户名,非昵称 $ git config --global user.email "xxx@qq.com"// 填写你的github注册邮箱
验证是否输入正确
$ git config --global user.name $ git config --global user.email
3.1 hexo安装
打开git
$ npm install -g hexo
3.2 hexo 具体初始化
在电脑上找一个地方新建一个文件夹,用于存放hexo安装文件,(如:E:\myblogs)
$ cd /e/myblogs $ hexo init
hexo 会自动生成一些文件在这个文件夹下,
$ hexo g #生成 $ hexo s #启动
执行完上边的命令之后,hexo会在public文件夹下生成相关的html文件。
hexo s
是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故。
3.3 修改主题
将下载好的主题放在E:\myblogs\themes文件夹下,(自己创建的hexo文件夹)
将myblogs文件夹根目录下的_config.yml中的theme: theme-ad
,(theme-ad)为自己下载的主题,然后重新执行hexo g
来重新生成。
如果出现一些莫名其妙的问题,可以先执行
hexo clean
来清理一下public的内容,然后再来重新生成
3.4 上传之前注意
一定要先把原来github上的代码下载下来备份一下,因为每次提交代码的时候会将之前的代码都删除。
SSH KEY要设置好
_config.yml文件中的deploy部分配置:
deploy: type: git repository: git@github.com:liuxianan/liuxianan.github.io.git branch: master
最后安装一个插件
$ npm install hexo-deployer-git --save
3.5 提交
最后,将本地内容提交到github中(用 git bash)
hexo d
4.1 常用指令
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
hexo s -g #生成并本地预览
hexo d -g #生成并上传
4.2 注意
- _config.yml 为全局配置
- 冒号后边需要跟一个空格
5 参考