This ius a simple utility that allows you to generate working code from your markdown files. This is super early alpha so there's probably missing parts and it's a bit hacky.
Single source can be installed through cargo like:
bash
cargo install single_source
Just put you code in your md file as usual marked with the language like:
```\rust
fn my_cool(stuff: ()) {
}
```
Then proceding that you mark it with the flag \#S: (yeh I know it's a weird marker but try finding something markdown doesn't use) and some tags.
bash
single_source code path/to/source.md path/to/code_file_to_be.generated lang
Example:
bash
single_source code path/to/my_tutorial.md path/to/lib.rs rust
bash
single_source md path/to/source.md path/to/md_file_to_be_generated.md
Example:
bash
single_source md path/to/my_tutorial_source.md path/to/finished_tutorial.md
Integration tests runnable tutorials
#S:EXTERNAL=external.rs
(note this is actually \#S:EXTERNAL=external.rs but your md render might remove the \)
Some tutorial stuff
Some tutorial stuff
Some tutorial stuff
Skip this because it's just for information purposes and should not be included in the generate code file.
#S:SKIP ```rust // <---- Add the struct here.
mod something {
This code block also gets skipped.
rust
fn open() {}
```
This one will be included
#S:INCLUDE
rust
fn say() {
println!("hello");
}
also included
rust
fn say2() {
println!("hello2");
}
Going to hide the closing tag for the mod that we opened in external.rs
#S:HIDE
rust
}
rust
mod my_mod {