2016-11-19 发表于个人博客
经过一天的辛苦作战,总算基础的东西出来了。踩了太多的坑,综合我踩坑的经过,明白到,选好一篇引导文很重要!有些步骤不要先做了,不然后面会把你坑的很惨..
很多博客都已经详细讲述了Hexo博客框架的好处和怎么做,下面的推荐文章里会给出链接。但有些过于复杂,让初次配置的人有点雨里雾里;有些又太简单,出了问题就会不知道怎么回事。下面是自己的搭建记录,及所遇问题的解决。
在此感谢小马哥Mark和 wingjay先前分享的教程,有些段落是从你们里搬运过来的,希望博主见谅,如有侵权,请联系我删除。
Ok,现在开始:
在不购买服务器的前提下,我们的网站需要挂在GitHub Pages上。GitHub Pages是面向用户、组织和项目开放的公共静态页面搭建托管服务,可用于搭建个人博客。
http://username.github.io
了。至此,我们已经利用GitHub Pages搭建好了个人博客雏形了。下面要做的,就是个性化了。
注意:如果你
http://username.github.io
首页就要是博客首页的话,建议初次配置选择首页,就是这样。完成后可以把index.html
给删了,因为到最后你发现那是没用的,它将会给你造成干扰。
参考中文文档或英文文档。完成该步后,你的电脑便拥有了Git、Node.js和Hexo。
$ node -v
v4.2.4
$ npm -v
2.14.12
$ hexo -v
确定拥有了Git、Node.js和Hexo后,进行下一步:
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init
$ cd
$ npm install
新建完成后,指定文件夹的目录如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
这样Hexo会在该文件夹创建本地博客所需的一切资源。这样本地博客就搭建好了,输入以下命令:
hexo s --debug // 启动本地hexo 服务器,默认localhost:4000可以访问,可以看到调试信息
这样就开启了一个本地博客服务器,打开浏览器,在地址栏输入localhost:4000
,就可以查看本地博客了,hexo默认生成了一片hello world博客。出现问题可以看terminal终端错误信息。按control + c
关闭调试。
注意:以上hexo开头的命令,执行目录必须是你创建的博客文件夹目录。使用hexo s 也可以,只是没有了调试信息。
现在你已经可以在本机查看你的博客了,但是要想让别人通过网络可以查看你的博客,还需要一步,那就是将你的博客发布到github仓库。在terminal终端,将当前目录切换到你的本地博客目录,执行以下命令:
npm install hexo-deployer-git --save
安装完成之后,打开本地博客目录的_config.yml
文件,编辑其中的deploy
节点:
deploy:
type: git
repo: https://github.com/youlookwhat/youlookwhat.github.io.git
branch: master
注意:字段前需加空格,hexo有严格的格式规范。
保存配置之后,你可以不着急传到仓库,先刷新本地博客,看是否还是原样,如有问题可以看到terminal终端上的错误信息,然后检查没问题为止。
确认无误之后,在本地博客目录执行以下命令:
hexo clean // clean本地项目,防止缓存
hexo g // 全拼是:hexo generate,可以简写成 hexo g; 根据你编辑的md格式的博客,生成静态网页
hexo d // 全拼是:hexo deploy,可以简写成 hexo d; 将本地博客发布到github
然后,在浏览器地址栏输入username.github.io
就可以访问你的博客了,别人也可以通过这个地址访问你的博客。如果错误请重复看以前流程,或参考其他文章,也可以联系我.
Hexo主题非常多,可以参考丰富多彩的Hexo主题,本文选Next为主题,NexT主题是一套简约的主题,设置完成之后,就像我的博客现在的样子,里面有详细的配置说明,这里就不重述了。
配置后调试:
hexo clean
hexo g
hexo s --debug
确认无误后上传:
hexo clean
hexo g
hexo d
注意:因为hexo有严格的格式规范,所以建议配置时及时调试页面。
大家可以看:替换自己的域名 ,里面讲述的详细。
注意:在万网买了域名以后直接在里面配置,这里只是参考用的。
大家可以看:其他遗漏的点
注意:配置后进入调试模式测试一下,这样错了就可以马上更正。
cd 到仓库所在文件夹目录下:
hexo init //在指定目录执行该命令,会将当前目录初始化为hexo站点,生成hexo站点所需的一切文件
hexo new “my new blog title” //新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
hexo s --debug // 启动本地hexo 服务器,默认localhost:4000可以访问
hexo clean // 清除缓存,如果对本地文件做了修改,同步到远程验证修改的效果之前,先clean,清除缓存
hexo generate // 可以简写成hexo g 根据markdown文件生成静态文件
hexo deploy // 或者简写成hexo d 将本地修改,部署到远端
hexo version // 显示hexo版本
_config.yml
文件其中的deploy
节点时,注意repo
的值。social:
下面字段前要有两个空格,切记。NexT、多说、百度统计、leancloud、阿里云、fork me、ico制作