语法高亮

对于我使用的语法高亮Highlight.js自定义主题.

自动语言检测已关闭,因此您可能希望指定您使用的编程语言

  1. ```rust
  2. fn main() {
  3. // Some code
  4. }
  5. ```

自定义主题

与主题的其余部分一样,用于语法突出显示的css,可以使用您自己的文件覆盖.

  • highlight.js 通常你不应该覆盖这个文件,除非你想使用更新的版本.
  • highlight.css highlight.js用于语法高亮的主题.

如果你想使用highlight.js另一个主题,可从他们的网站下载,或自己制作,重命名为highlight.css,并把它放进去src/theme(或等效的,如果您更改了源文件夹)

现在将使用您的主题,而不是默认主题.

隐藏代码行数

mdBook中有一个功能,可以通过在代码行前加上来隐藏代码行#.

  1. # fn main() {
  2. let x = 5;
  3. let y = 6;
  4. println!("{}", x + y);
  5. # }

将渲染为

  1. # fn main() {
  2. let x = 5;
  3. let y = 7;
  4. println!("{}", x + y);
  5. # }

目前,这仅适用于带注释的代码示例rust。因为它会与某些编程语言的语义冲突.在未来,我们希望通过这个,可在book.toml配置,这样每个人都可以从中受益.

加强默认主题

如果您认为默认主题看起来不适合特定语言,或者可以改进。随意地submit a new issue解释你的想法,我会看看它.

您还可以使用建议的改进创建拉取请求.

总的来说,主题应该是清淡和清醒,没有许多华丽的颜色.