搭建GithubPages踩过的坑

前言

搭建了属于自己的GitHub Page作为个人博客,上手Hexo+Material感觉比较花哨,后改用Yilia主题并决定长期使用。期间发现并解决了一些问题,贴出值得记录的部分作为参考:

  • 维护
  • 书写
  • 内容
  • 标签
  • 图床

维护

在本地安装后Hexo后每次deploy到master branch有很大的局限性,换台电脑更新博客很麻烦。后来借鉴其他网友做法:新建Hexo分支并将repository的默认branch设为Hexo,每次更新将Hexo全部文件commit至Hexo分支,Hexo自带.gitingore文件无须担心提交不必要文件。换电脑只需clone一份到本地,需要更新博客时调用hexo d命令更新master分支,省时省力。

书写

试用了不少支持MarkDown语法的编辑器,最后停留在了全平台兼容的Visual Studio Code,据说就是套了壳的Atom……不管那么多,反正Mac端和PC体验高度一致,支持的扩展也非常丰富。平时都用Ayu Dark主题,实现MarkDown的快速书写和实时预览依赖以下两款插插件:

前者有丰富的热键支持,后者可以实现分屏预览。

内容

Hexo使用三方主题具体配置需要修改theme对应的_config.yml文件,其中包括个人信息、社交账号以及主页个性化等设置。

# Content

# 文章太长,截断按钮文字 
excerpt_link: more
# 文章卡片右下角常驻链接,不需要请设置为false
show_all_link: '展开全文'
# 数学公式
mathjax: false
# 是否在新窗口打开链接
open_in_new: false

一开始不懂为什么首页会展示全文无法自动折叠,仔细阅读设置文件并参考其他博主写法后明白了。
用法:在书写md博文时 插入<!-- more-->后续内容均会被折叠。
效果:文章预览会出现一个蓝色的 more>>

标签

使用hexo new <title>命令建立的md文件默认会带三行注释,可以自定义标题、时间和标签。
如需多标签写成tags: [技术,GitHub,Hexo]形式即可。
注意:冒号后面一定要空一格,格式与配置yml相同,不空格会报错无法生成博文!

图床

作为一个优秀的代码托管网站,个人不建议将博文配图全部上传至GitHub仓库内保存,大量配图请另寻图床。建议使用自己的图床,也可以用微博图床(不知道新浪能放任多久)。
网站图标、用户头像和二维码等个性化图片可存放于/source/assets/img下与主题分开,更新主题不会导致覆盖,备份起来也更方便。记得修改主题配置文件~

这里推荐一个图床工具iPic支持调用常见图床一键生成Markdown插图代码,不过目前只有Mac版。

猜你喜欢

转载自www.cnblogs.com/azureology/p/12343365.html
今日推荐