写在前面
从搭建到布置到GitHub花费时间大概用了五个小时,中间删除repo N次,localhost运行正常,git上出现过404页面、若干次README.md页面,本文将简略介绍搭建过程,主要内容是搭建过程当中出现的问题解决方法。
https://hexo.io/zh-cn/docs/ hexo官方文档
https://c-axis.github.io/ 博客地址node
环境配置
安装Git,注册GitHub,并建立博客的repository
具体过程自行百度(注意点:repository的名称必须是 Name.GitHub.io)
安装Node https://nodejs.org/zh-cn/download/
下载了以后一直点就好了
安装hexo
建立一个文件夹hexo,存放hexo的配置文件,右键Git Bush Here执行下面的代码git
npm install hexo-cli -g npm install hexo --save hexo -v # 查看是否安装成功
初始化仓库github
$ hexo init yourname.github.io #建议和建立仓库时使用同一个 这里使用的不是GitHub上已经建好的那一个,而是在本地初始化的一个文件夹,若是已经建好的话,请删除后在使用初始化命令 npm install npm -v #查看npm版本 hexo g # 使用默认主题本地测试下 hexo s
以后顺利的画就能够在本地 http://localhost:4000 进行预览了
此时文件夹的目录以下:npm
. ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
具体内容不作介绍有问题咨询度娘或者Google,这里离上传GitHub就不远了。
修改这里的_config.yml文件json
deploy: type: git repo: https://github.com/yourname/yourname.github.io.git branch: master
写博客与发布 浏览器
通过上述步骤,本地博客已经完成,那么接下来就是写博客了。缓存
你的博客文件须要存放到 xxx.github.io/source/_posts 文件夹中,在该文件夹下面你能够按照你的博客分类创建一系列的文件夹来管理博客原文件。ruby
一、在本地运行测试
hexo s
二、安装上传Git功能:在浏览器中输入 http://localhost:4000 访问本地博客
npm install hexo-deployer-git --save
三、清理缓存并发布常见问题
hexo clean #清理缓存 多数页面没有更新的时候均可以用这个东西多刷新几回 hexo g #生成页面 hexo d #Git上传
- Git上显示为404页面,这里大部分缘由应该Git的错误,等待或者从新建立repository(捂脸)。
- 本地查看博客正常可是yourname.git.io查看时为空或者是README.md的样式。从新查看_config.yml文件的delpoy下的设置,肯定无误后进行
hexo clean
多刷新几回,从新上传,等几分钟再看。
写在最后
官方文档是个好东西,出现问题时最好先去看看官方有没有列出,而后就在问人,个人大部分问题出在布置好本地,上传git的过程当中,有些BUG这里没有列出,以后再补吧。并发