当前位置: 首页 > 文档资料 > mdBook 中文文档 >

3.3.2. 语法高亮显示

优质
小牛编辑
132浏览
2023-12-01

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

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

```rust
fn main() {
    // Some code
}
```

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

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

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

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

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

# fn main() {
    let x = 5;
    let y = 6;

    println!("{}", x + y);
# }

将渲染为

# fn main() {
    let x = 5;
    let y = 7;

    println!("{}", x + y);
# }

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

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

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

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