Minimal Mistakes踩坑记录

少于 1 分钟读完

使用Minimal Mistakes和GitHub Pages搭建个人Blog时的踩坑记录,如:切换语言为简体中文,科学使用Algolia作为检索插件, 集成Utterances评论插件,根据Tag和Category进行分类。

踩坑

  • 第一坑: 如果是远程主题引用,切换语言为中文后,一定要拷贝_data/ui-text.yml文件到本地
  • 第二坑: 如果使用algolia查询,第一行文字一定要是正常文字内容,不包括标题等特殊文字,否则js会报错
    Uncaught TypeError: Cannot read property 'value' of undefined
      at hitTemplate ((index):559)
    
  • 第三坑:关于集成utterances评论插件,这个评论插件只会在生产环境下显示,所以在测试时请不要惊讶为什么它不展示, 顺带说一下这个插件是真的好用。
  • 第四坑:根据时间、标签和类别访问博客时要拷贝原库中下列文件,否则在博客中点击tag或者category只能看到404😂
    • minimal-mistakes/docs/_pages/category-archive.md
    • minimal-mistakes/docs/_pages/tag-archive.md
    • minimal-mistakes/docs/_pages/year-archive.md

相关小知识:

  • 超链接跳转新页面:[Text](#link){:target="_blank"}
  • 超链接添加按钮样式与控制大小:[Text](#link){: .btn .btn--primary .btn--x-large}
  • 小提示:paragraph with {: .notice--success}

小提示的示例(注意空行与样式位置):


The world is being influenced by **COVID-19**
{: .notice--success}

The world is being influenced by COVID-19

相关命令

  • 本地启动jekyll bundle exec jekyll serve
  • 同步ALGOLIA索引 ALGOLIA_API_KEY=********** bundle exec jekyll algolia

分类:

更新时间: