Windows环境下Hexo、Github搭建个人博客
- 感谢github提供免费空间
- 带有“$”符号的是git命令
- 站在巨人的肩膀上
去我的Blog查看效果
环境准备
正确搭建姿势
新建github项目
(前提:gihub账号,通过github上提供的方式或者通过git的git gui 获取并且设置了github的SSH 获取SSH参考网址)
建立与你github用户名对应的仓库,仓库名必须为your_user_name.github.io
安装配置Hexo
此处给出的并不是完全适合hexo所有版本的方法,具体还应以hexo官网的方式作为参考。
安装hexo
安装hexo之前必须先安装git,之后的操作基本大多集中在git的操作上。
打开git命令行输入:$ npm install -g hexo
Quick Start
(比较重要的一部分)
1 . Setup your blog$ hexo init
Hexo随后会自动在目标文件夹建立网站所需要的文件。然后按照提示,还是 在/E/Hexo执行:
$ npm install
在E:\Hexo目录中安装 node_modules。
2 .Start the server
运行下面的命令(在 /E/Hexo下)$ hexo server
[info] Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
[info]表明Hexo Server已经启动了,在浏览器中打开http://localhost:4000/,这时可以看到Hexo已为你生成了一篇blog。
在这里如果你接下来要上传一个自己的文章就要按Ctrl+C 停止Server。否则会提交两次。3 .Create a new post
$ hexo new “My New Post”
[info] File created at e:\Hexo\source_posts\My-New-Post.md
刷新http://localhost:4000/,可以发现已生成了一篇新文章”My New Post“。(我开启hexo server之后才可以看到)4 .Generate static files
将markdown(My New Post)文件生成静态网页$ hexo generate
该命令执行完后,会在 E:\Hexo\public\ 目录下生成一系列html,css等文件
注意:在每次 hexo generate之后才能保存修改。5 .编辑生成的文档
hexo new “My New Post”会在E:\Hexo\source_posts目录下生成一个markdown文件:My-New-Post.md
可以使用一个支持markdown语法的编辑器(比如 Sublime Text)来编辑文件。6.部署到Github
部署到Github前需要配置_config.yml文件,首先找到下面的内容
deploy:
type:
然后将它们修改为:
deploy:
type: git
repository: git@github.com:Darksiderlyd/Darksiderlyd.github.io
branch: master注意:使用SSH git@github.com:Darksiderlyd/Darksiderlyd.github.io
所有键的冒号后面留一个空格,如type: git
url不能为空,否则报错
type: github报错hexo ERROR Deployer not found: github的解决方法:
先运行 npm install hexo-deployer-git –save
再改为 type: git执行:
$ hexo deploy
[info] Start deploying: github
[error] is not a valid repositor URL!
使用SSH url,如果电脑没有开放SSH 端口,会致部署失败。
fatal: Could not read from remote repository.Please make sure you have the correct access rightsand the repository exists.
另外:如果你是为一个项目制作网站,那么需要把branch设置为gh-pages。7.测试
当部署完成后,在浏览器中打开http://Darksiderlyd.github.io/(以我的为例https://Darksiderlyd.github.io/) ,正常显示网页,表明部署成功。8.总结:部署步骤
每次部署的步骤,可按以下三步来进行:
hexo clean
hexo generate
hexo deploy命令总结
常用命令:
hexo new “postName” #新建文章
hexo new page “pageName” #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,’ctrl + c’关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help #查看帮助
hexo version #查看Hexo的版本复合命令:
hexo deploy -g #生成加部署
hexo server -g #生成加预览命令的简写为:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy主题插件安装和优化
推荐参考文章:主题详细介绍问题Issue
在操作过程中,由于对.deploy_git文件的误操作(删除.git),导致提交不上文件,然后还执行了hexo init等操作,究其原因,主要是_config.yml文件也被初始化,回到了最初的状态,导致hexo deploy没有反应也不报错,所以重新配置一下deploy就好了,还有就是强烈建议备份一下这个文件。域名绑定
推荐参考文章:http://blog.csdn.net/qq_23435721/article/details/50876942
以上搭建过程共参考以下文章:
http://www.cnblogs.com/zhcncn/p/4097881.html
https://segmentfault.com/a/1190000000458953
http://www.cnblogs.com/liulangmao/p/4323064.html
http://blog.csdn.net/qq_23435721/article/details/50876942