You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Jekyll minima主题配置遇阻:深色皮肤不生效及SCSS导入报错求助

解决Minima深色皮肤不生效及SCSS导入报错问题

第一步:确认Minima版本

Minima的skin配置从3.0.0版本开始支持,先检查当前版本:

bundle show minima

如果版本低于3.0.0,执行更新:

bundle update minima

第二步:修复深色皮肤不生效问题

修正_config.yml的格式错误(description字段的多余换行可能导致配置解析异常),确保配置正确:

title: IT thoughts...
author:
  name: joharr
  email: <myemailaddress>
description: Self-taught geekology...
baseurl: ""
url: <me>.github.io
twitter_username: <mine>
github_username:  <mine>

minima:
  skin: dark
theme: minima

保存后重启服务:bundle exec jekyll serve,深色皮肤即可生效。

第三步:正确自定义样式(避免SCSS导入报错)

无需复制主题全部SCSS文件,只需在站点根目录创建assets/css/style.scss,内容如下:

---
---

@import "minima/skins/dark";
@import "minima";

# 在这里添加自定义样式,示例:
body {
  font-size: 16px;
}

这种方式会自动从gem包加载主题的SCSS文件,既继承原有样式,又能通过自定义代码覆盖调整,不会出现路径错误。

报错原因说明

直接复制主题的style.scss到站点根目录会报错,是因为主题内部的SCSS导入路径基于gem包目录,复制到站点后Jekyll无法识别minima/skins/classic的正确位置,按上述方式导入即可解决。

内容的提问来源于stack exchange,提问作者joharr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.08 06:40:37