docima

Generate images at build time for embedding in the Rust documentation.

Usage

1. First configure your build script to generate the images in the desired path. They will be encoded as png → base64 and saved as HTML tags. E.g.:

ImageFile::new()
    .path("images/my_image.html")
    .width(600)
    .height(400)
    .title("My image")
    .id("image-01")
    .style("display: block; margin:auto;")
    .wrapper("div")
    .wrapper_style("background-color:red; padding:3px;")
    .overwrite(true)
    .generate(my_image_generator_function)?;

2. Include your image in the Rust documentation by using the doc attribute and the include_str macro.

#[doc = include_str!("../images/my_image.html") ]

3. Generate the docs:

cargo doc --open

You can refer to the crate documentation for more details. And there's also a full practical example available.

Similar crates

• embed-doc-image