使用 mdbook 探索 Rust 在线编译器

简介

在本实验中，你将了解 Rust 在线编译器（Rust Playground），这是一个允许你试验 Rust 代码的 Web 界面。你还将发现如何将其与 mdbook 配合使用，以使代码示例可运行和可编辑。此外，你将探索如何将其与文档配合使用，并通过在 Rust 代码中使用 html_playground_url 属性来启用“运行”按钮。

注意：如果实验未指定文件名，你可以使用任何你想要的文件名。例如，你可以使用 main.rs，并通过 rustc main.rs &&./main 进行编译和运行。

Skills Graph

在线编译器

Rust 在线编译器 是一种通过 Web 界面试验 Rust 代码的方式。

与 mdbook 配合使用

在 mdbook 中，你可以使代码示例可运行且可编辑。

fn main() {
    println!("Hello World!");
}

这使读者既能运行你的代码示例，又能对其进行修改和调整。关键在于在代码围栏块中添加单词 editable，并用逗号分隔。

```rust
//...将你的代码放在这里
```

此外，如果你希望 mdbook 在构建和测试时跳过你的代码，可以添加 ignore。

```rust
//...将你的代码放在这里
```

与文档配合使用

你可能在一些官方 Rust 文档中注意到一个名为“运行”的按钮，它会在 Rust 在线编译器的新标签页中打开代码示例。如果你使用名为 html_playground_url 的 #\[doc\] 属性，此功能将被启用。

总结

恭喜你！你已完成在线编译器实验。你可以在 LabEx 中练习更多实验以提升技能。