hexo+github搭建blog

hexo+github搭建blog

十一月 13, 2018

目录

前期步骤

https://blog.csdn.net/ainuser/article/details/77609180

域名解析配置时,主机记录www项中,点击记录类型选择CNAME。


域名https需要申请ssl证书

(这里仅申请即可)

https://cloud.tencent.com/developer/article/1198841

申请后即自动转为https,无需以上文章中的其余操作。


新建模板

$ hexo init “文件夹名”

$ cd “文件夹名”

$ npm install

具体文件夹说明请看官方文档:https://hexo.io/zh-cn/docs/setup


更换主题

  • 在官网 https://hexo.io/themes/ 选择好主题,并用github clone到本地

  • 将clone下来的主题放入我们blog主目录下的themes文件夹

  • 修改主目录的_config.yml中的这一行

theme: [添加的主题文件夹名]


简易常用命令说明

  • 新建文章:

$ hexo new “name”

  • 更新页面:

$ hexo clean && hexo g && hexo d

  • 本地调试:

$ hexo server

然后浏览器输入localhost:4000就可以看到页面了

执行hexo clean && hexo g && hexo d时,(以下均需要进到.deploy_git目录中git bash输入

出现fatal: HttpRequestException encountered错误的解决办法:

http://www.bubuko.com/infodetail-2551073.html

出现fatal: The remote end hung up unexpectedly错误的解决办法:

(文件太大无法上传导致

https://blog.csdn.net/qq_21383435/article/details/79711386

出现Fatal: TaskCanceledException encountered错误的解决方法:

(这里global前面是两个横杆

https://yq.aliyun.com/php/472


评论插件Gitalk的使用

相关文章:https://segmentfault.com/a/1190000014085547

其中文章中集成Gitalk的这个文件 /[themeName]/layout/_partial/comment.ejs 在我的模板中没有,类似的文件倒是见到了一个,就是 /themes/diaspora/layout/post/gitalk.ejs ,这个文件的内容也是已经弄好了的,所以这一步我没弄,但是结果看来并没有影响到使用。

可能是因为我的主题本身已经集成了Gitalk的原因吧。(我也是新手,不太懂

另外接下来说到的这个文件 icalm/_config.yml ,注意了,icalm是这篇文章作者的主题名,这个你要按你自己的实际主题名称来,别改错地方了,比如我的主题是diaspora,那么目录地址就是 diaspora/_config.yml

说到主题目录下的_config.yml配置,我在这再给一个实例吧,不然不知道有些该则呢填(可能是因为我自己懵逼,总之写出来没坏处,更方便理解。

然后附上我的实例:

gitalk:

autoExpand: true

clientID: ‘手动屏蔽’

clientSecret: ‘手动屏蔽’

repo: ‘macrazdhao.github.io’

owner: ‘macrazdhao’

admin: ‘macrazdhao’

id: location.pathname

distractionFreeMode: false

上面的distractionFreeMode属性我也不太懂…搜好像也搜不到啥,总之我开启试了下,点评论输入框,然后整个网页全都暗了,只有输入框是亮着的,和关灯了一样,具体有什么其他作用就不知道了,总之我就关掉了。

然后最后一步就是添加issue了:

  • 在你Blog的repo里面点 Issue
  • 点击 New issue,随便输入点东西
  • Submit new issue 就搞定了

让谷歌搜索到github博客

参考资料:https://www.jianshu.com/p/df46bca5889d


Hexo Markdown添加目录

参考文章:https://www.imys.net/20150514/hexo-toc.html

  • 终端下安装plugin:

    $ npm install hexo-toc –save

  • 在博客根目录的_config.yml添加配置:

    toc:

    maxDepth: 3
    此处maxDepth为3表示生成最深深度为3级目录,可按需求更改

  • 在Markdown文档使用:

    任何地方输入以下语句即生成目录

    <!– toc –>

    (这里是左右各两个横杆-,别看成一个了!还有!toc是小写,两个各一个空格,千万不能漏!
    注意:生成的目录内容为该行语句往下的内容,往上的内容不会录入

貌似还会有一些奇怪的问题,比如目录点击后不会跳转,但是我没遇到这个问题。如果有遇到这些问题的可以去参考文章看看。

另附:Markdown特殊符号输入代码
https://www.cnblogs.com/cheese320/p/8906179.html