Playground
Rust Playground 是一个通过网页界面体验 Rust 代码的平台。
在 mdbook
中使用 Playground
在 mdbook
中,你可以让代码示例变得可运行和可编辑。
fn main() { println!("Hello World!"); }
这不仅允许读者运行你的代码示例,还能修改和调整它。关键是在代码块标记中添加 editable
关键字,用逗号分隔。
```rust,editable
//...place your code here
```
此外,如果你希望 mdbook
在构建和测试时跳过某段代码,可以添加 ignore
关键字。
```rust,editable,ignore
//...place your code here
```
在文档中使用 Playground
你可能注意到在一些官方 Rust 文档中有一个"运行"按钮,点击后会在 Rust Playground 的新标签页中打开代码示例。要启用此功能,需要使用 #[doc]
属性中的 html_playground_url
。
#![doc(html_playground_url = "https://play.rust-lang.org/")]
//! ```
//! println!("Hello World");
//! ```