将 GitHub Pages Jekyll 主题自定义为不是背景颜色或框内联代码

问题描述

我在一些 GitHub Pages 站点中使用 Cayman 和 Slate Jekyll 主题进行软件文档编制。

这些主题样式内联代码部分(在 Markdown 中被反引号包围的文本)具有不同的背景颜色和框阴影。

Slate theme formatting showing inline code sections

我认为这会损害可读性。我希望内联代码跨度为固定宽度字体,但其他方面看起来像周围的文本,没有框或背景颜色变化。更像这样:

My customization of Slate theme with simpler inline code formatting

有没有办法对主题应用自定义来实现这一点?

我目前的做法是将完整的主题定义复制到我的 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 (将#修改为@)

相关问答

Selenium Web驱动程序和Java。元素在(x,y)点处不可单击。其...
Python-如何使用点“。” 访问字典成员?
Java 字符串是不可变的。到底是什么意思?
Java中的“ final”关键字如何工作?(我仍然可以修改对象。...
“loop:”在Java代码中。这是什么,为什么要编译?
java.lang.ClassNotFoundException:sun.jdbc.odbc.JdbcOdbc...