Playground
Rust Playground 是一种通过网页界面体验 Rust 代码的方式。
与 mdbook
一起使用
在 mdbook
中,您可以使代码示例可播放和可编辑。
fn main() { println!("Hello World!"); }
这允许读者运行您的代码示例,还可以修改和调整它。这里的关键是在您的代码块中添加单词 editable
,并用逗号分隔。
```rust,editable
//...place your code here
```
此外,如果您希望 mdbook
在构建和测试时跳过您的代码,则可以添加 ignore
。
```rust,editable,ignore
//...place your code here
```
与文档一起使用
您可能已经在一些Rust 官方文档中注意到一个显示“运行”的按钮,它会在 Rust Playground 的新标签页中打开代码示例。如果您使用名为 html_playground_url
的 #[doc]
属性,则会启用此功能。
#![doc(html_playground_url = "https://play.rust-lang.org/")]
//! ```
//! println!("Hello World");
//! ```