个人静态博客的从无到有
目录
- 1.安装hexo到本地
- 2.搭桥到github
- 3.修改配置
- 4.常见问题
1.1安装Git到本地
从官网或者本文提供的百度网盘下载Git安装包,由于众所周知的原因,官网下载十分缓慢。下
载完安装即可,这里推荐装在c盘根目录下,不然可能报错.
- 下载地址
- 安装: 一路默认就可以
- 检测: 打开命令行模式(使用win+r,输入cmd),输入命令Git version
(git已经自动将环境变量配好,所以在任何目录下都可运行) 看到这个
这就表示安装成功,可以进行下一步.
1.2安装NODE.JS到本地
从官网或者本文提供的百度网盘下载NODE安装包
- 下载地址
- 安装: 一路默认就好(如果在Custom Setup这一步Add to PATH前面有框的话 记得勾选 如果没有框 就已经默认选择了)
- 检测: 打开命令行模式,查看版本 输入命令node -v
看到这个
这就表示安装成功,可以进行下一步.
1.3安装Hexo到本地
首先在你想要的位置下建一个文件夹(例如hexo),在命令行中定位到该文件夹下(也可在我的电脑中这个文件夹的上方路径处输入cmd)
- 安装: 在你定位到该文件夹下后,输入命令npm install -g hexo
- 检测:输入命令hexo -version
看到这个
这就表示安装成功 接下来:- 初始化hexo: 输入命令hexo init,完成后会看到以下文件
- 然后就开始搭桥到github
2.1注册github账号
2.2创建REPOSITORY
创建一个新的repository,名称为yourname.githubio(yourname是你github的用户名)
- 回到命令行中,进行配置,将下面的XXX换成自己的用户名和邮箱
1
2 git config --global user.name "XXX"
git config --global user.email"XXX"
2.3 创建ssh,生成key,输入以下命令
1 | ssh-keygen -t rsa -C "youremail@example.com" |
输完命令后敲击三次回车,设置的密码为空,生成key成功
2.4将获取的好的ssh放到github中
定位到ssh文件下(C:\用户\你的用户名目录进入.ssh文件夹),用编辑器打开id_rsa.pub文件,复制里面的内容,然后按下面步骤进行
添加一个 New SSH key ,title随便取,key就填复制的那一段.
- 检测: 这个可以在gitbash(前面安装好git后,会有一个gitbash,打开也是命令行模式的)中检测,输入命令ssh -T git@github.com
如果显示hi,XXX 代表添加成功.
3.1hexo(你创建的文件夹)文件夹下_config.yml的配置
注意_config.yml文件共有两个 一个在hexo主题下 一个在theme下的主题文件下 在配置文件中所有冒号后面都有一个英文状态下的空格
- 打开hexo文件夹下的_config.yml文件,进行修改(XXX是你的用户名)
1
2
3
4 deploy:
type: git
repo: git@github.com:XXX/XXX.github.io.git
branch: master
3.2在本地运行
- 在命令行中定位到你的文件下,执行下面命令
1
2
3 hexo clean
hexo generate
hexo server
- 打开浏览器输入http://localhost:4000, 然后就会看到
这就代表你成功了
3.3上传到github,在网页上显示
- 为hexo安装Git插件 输入命令
1 npm install hexo-deployer-git --save
- 在命令行中定位到你的文件下,执行下面命令
1
2
3 hexo clean
hexo generate
hexo deploy
即可完成部署,然后访问xxx.github.io就能访问你的博客了(注意deploy的过程中要输入你的username及passward)
3.4域名绑定
- 如果想使用自己的域名,只需要把域名CNAME解析到xxx.github.io,然后在~\hexo\source目录
中创建文件CNAME(没有后缀名),文件里填上你的自定义域名(没有http://或者https://)然后执行一遍
3.5文章创建
- 在cmd中,输入下面命令
1 hexo new 你的文件名
就会发现在hexo/source/posts中出现 你的文件名.md 文档,用编辑器打开就可以进行编辑了
语法参考第一篇hello_world或者这个模版
- 改动后再次执行下面命令(前提是cmd切换到了hexo目录)
- 预览
1
2
3 hexo clean
hexo generate
hexo server
- 发布
1
2
3 hexo clean
hexo generate
hexo deploy
4.常见问题
- ssh
注意两个错误:
1.ssh-keygen中间没有空格
2.rsa -C “youremail@example.com“中-C C是大写
- 配置文件
在每个冒号后都有一个英文空格
如果配置文件是格式问题时可用这个网站来纠正yamllint- 单词释义: clean 清除 generate 生成
deploy 部署 server 服务器
.md markdown的缩写,markdown也是一种标记
.yml YML文件格式是YAML (YAML Aint Markup Language)编写的文件格式
hexo generate可缩写为 hexo g
hexo deploy 可缩写为 hexo d
本文参考资料: visugar的博客 hexo官方文档 Dr34m’s blog
v1.5.2