问题描述
我在一些 GitHub Pages 站点中使用 Cayman 和 Slate Jekyll 主题进行软件文档编制。
这些主题样式内联代码部分(在 Markdown 中被反引号包围的文本)具有不同的背景颜色和框阴影。
我认为这会损害可读性。我希望内联代码跨度为固定宽度字体,但其他方面看起来像周围的文本,没有框或背景颜色变化。更像这样:
我目前的做法是将完整的主题定义复制到我的 GitHub Pages 站点中,然后像这样进行编辑:
[docs] $ diff -C 3 ../../slate/_sass/jekyll-theme-slate.scss _sass/jekyll-theme-slate.scss
*** ../../slate/_sass/jekyll-theme-slate.scss 2021-01-16 18:56:40.000000000 -0500
--- _sass/jekyll-theme-slate.scss 2021-03-14 21:28:51.000000000 -0400
***************
*** 1,4 ****
! @import "rouge-github";
/*******************************************************************************
MeyerWeb Reset
--- 1,10 ----
! /*
! * This is a customized version of jekyll-theme-slate.scss that turns off the
! * background coloring on inline code spans,which I think improves readability.
! * -apjanke
! */
!
! @import "rouge-github";
/*******************************************************************************
MeyerWeb Reset
***************
*** 156,162 ****
pre,code {
color: #222;
- background-color: #fff;
font-family: Monaco,"Bitstream Vera Sans Mono","Lucida Console",Terminal,monospace;
font-size: 0.875em;
--- 162,167 ----
***************
*** 167,184 ****
}
pre {
padding: 10px;
Box-shadow: 0 0 10px rgba(0,.1);
overflow: auto;
}
! code {
padding: 3px;
margin: 0 3px;
Box-shadow: 0 0 10px rgba(0,.1);
}
pre code {
display: block;
Box-shadow: none;
}
--- 172,191 ----
}
pre {
+ background-color: #fff;
padding: 10px;
Box-shadow: 0 0 10px rgba(0,.1);
overflow: auto;
}
! code_OFF {
padding: 3px;
margin: 0 3px;
Box-shadow: 0 0 10px rgba(0,.1);
}
pre code {
+ background-color: #fff;
display: block;
Box-shadow: none;
}
[docs] $
但我宁愿将其定义为原始主题定义之上的小自定义here,这样我仍然可以自动获取上游主题的更新,甚至可以将我的自定义用于多个基本主题。
有人知道怎么做吗?似乎这种表单的 CSS 自定义只能在它们定义或自定义的类上添加或修改属性,而不能删除或“重置”它们。
解决方法
暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!
如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。
小编邮箱:dio#foxmail.com (将#修改为@)