プレイグラウンド
Rust Playgroundでは、RustのコードをWebのインターフェースを通じて実験できます。
mdbook
と組み合わせる
mdbook
では、コード例を実行・編集可能にできます。
fn main() { println!("Hello World!"); }
これにより、読者はあなたのコード例を実行するだけでなく、変更することもできます。editable
という単語をカンマで区切って、あなたのコードブロックに追加するのがキーです。
```rust,editable
//...place your code here
```
加えて、mdbook
がビルドやテストを実行するときに、あなたのコードをスキップさせたい場合は、ignore
を追加できます。
```rust,editable,ignore
//...place your code here
```
ドキュメントと組み合わせる
Rustの公式ドキュメントには、「実行(Run)」ボタンがある場合があります。クリックすると、新しいタブでRust Playgroundが開き、コード例が表示されます。この機能は、#[doc]アトリビュートのhtml_playground_url
の値で有効化できます。
#![doc(html_playground_url = "https://play.rust-lang.org/")]
//! ```
//! println!("Hello World");
//! ```