hexo搭建github静态博客总结

倖福魔咒の 提交于 2020-02-28 16:30:13

具体效果 github不仅能免费提供代码托管,此外还提供了创建github博客的功能,网上有jekyll的方法,之前我试过最终由于Ubuntu下安装ruby及其他组件失败没成功,过程也比较繁琐,但有另一种方法,操作起来很简单,而且达到的效果也很好,那就是通过hexo搭建github博客。搭建环境为window, ###步骤 1.安装git客户端,以及github账号:通过gitBash 生成ssh key,将公钥加入到github中,具体方法,百度搜索:为gthub配置ssh key。 2.登陆github创建仓库,注意仓库名必须和用户名相同,比如username/username.github.io 将username换成自己的用户名,是用户名不是注册邮箱。 3.安装node,去node官网下载安装包,.msi文件,通过npm安装hexo,Hexo 是一个基于nodejs 的静态博客网站生成器,作者是来自台湾的 Tommy Chen,具体安装方法参照hexo官网介绍。注意 npm install hexo-cli -g 是在安装完node后,开始菜单里会有个node的命令行工具,在这里面入的。 4.随便选择目录创建要生成博客的文件目录,进入该目录:右键选择git bash 输入

$ hexo init <folder>
$ cd <folder>
$ npm install

folder 为要创建博客的文件夹名称。 5.通过以上步骤做完后,继续输入 hexo server 启动服务器,就可以用浏览器访问localhost:4000/ 查看效果了。 博客文件目录 ├── _config.yml ├── package.json ├── scaffolds ├── scripts ├── source | ├── _drafts | └── _posts └── themes 根目录的_config.yml文件是站点设置,可应用于真个站点,在theme目录下也有个_config.yml该设置仅适用于当前主题,换个主题就不适用了。 根目录的_config.yml的详细配置参照此处 目前博客仅限于本地访问,要部署到github上需要将_config.yml中的deploy改为:

deploy:
  type: git
  repository: https://github.com/username/username.github.io.git
  branch: master

保存在gitbash中输入:hexo deploy 成功后,github在国外,估计要等上几分钟再能访问username.github.io.git 看到效果,推荐部署到gitcafe上面,很快就能看到效果,如果部署到gitcafe的话需要改为:

deploy:
  type: git
  repository: https://gitcafe.com/username/username.gitcafe.io.git
  branch: gitcafe-pages

###主题的安装:

$ cd your-hexo-site`
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

next 是主题文件夹的名字,可以任意取名。如果要设置当前主题为next只需要在根目录的_config.yml文件中 theme: next 注配置文件中的冒号后必须有一个空格。 这里推荐一个主题next,我个人比较喜欢,主题继承了评论,rss等功能,具体设置见此处,比如要增加多说插件,只需要在该主题文件下的_config.yml的duoshuo_shortname:name 后填写申请的名称即可,非常方便。

注意一下几点: 1.关于hexo的命令输出都是在git bash下输入的 2.配置文件中的冒号后必须有空格 3.本地文件的任何改动都需要再hexo generate一下在部署,才会生效。

我本人在安装过程中参照 http://zipperary.com/2013/05/28/hexo-guide-2/ 的文章,但其中部分内容不适合新版本的hexo。如果机子上给github生成过ssh key,再给gitcafe生成ssh key时估计会连接不上gitcafe,生成ssh key时需要指定文件名,和给github生成略有不同。

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!