7 releases
new 0.1.6 | Mar 23, 2023 |
---|---|
0.1.5 | Mar 16, 2023 |
0.1.2 | Feb 2, 2023 |
0.1.0 | Jan 3, 2023 |
#192 in Development tools
4,132 downloads per month
Used in 3 crates
29KB
677 lines
rhai-autodocs
Generate Markdown documentation from a rhai::Engine
instance.
Features
- Output Rhai documentation as Markdown w/ HTML.
- Function ordering.
- Rust docs 'sections' format with default Markdown format or displayed using tabs.
How to use
This library can be imported as a build dependency into your build script. A typical documentation generation workflow would look like this:
// -- build.rs
fn main() {
// Specify an environment variable that points to the directory
// where the documentation will be generated.
if let Ok(docs_path) = std::env::var("DOCS_DIR") {
let mut engine = rhai::Engine::new();
// register custom functions and types ...
let docs = rhai_autodocs::options()
.include_standard_packages(false)
.generate(&engine)
.expect("failed to generate documentation");
// Write the documentation in a file, or output to stdout, etc.
}
}
You need to import the styles/default.css
file and src/tabs.js
script for everything to work correctly. (You can of course override the styles and javascript code if you wish)
The generated markdown / HTML works best with mdbook. See the mdbook example for more details.
Dependencies
~4.5MB
~89K SLoC