This project is a POC/experimental frontend for the rustdoc json output format to generate html documentation.

⚠️ This project is currently broken for newer rustdoc (>=2023)! ⚠️

• nix (docs.rs)
• libc (docs.rs)
• regex (docs.rs)
• rustix (docs.rs)
• memchr (docs.rs)
• curl (docs.rs)
• curl-sys (docs.rs)
• openssl-sys (docs.rs)

• [X] Pretty printing of items (methods, structs, traits, ...)
• [X] Minimal self-contained search engine with index
• [X] Bootstrap 5 html pages
• [X] Syntax highlighting of items
• [X] Navigation between items (even external if available)
• [X] Improved markdown output (similar to rustdoc)
• [X] Table of contents (markdown + items)
• [X] Deprecation notice and attributes filtering
• [X] cfg and doc printing
• [X] Themes (currently light and black)
• [] Generation of the global index.html
• [] Handling of re-export(s) (Mostly done, but links to them won't work)
• [ ] Source code inclusion
• [ ] Options/customization

rd 0.1.0
Commande-line options

USAGE:
    rd [FLAGS] <FILE>... --output <output>

FLAGS:
    -h, --help       Prints help information
        --open       Open the generated documentation if successful
    -V, --version    Prints version information
    -v, --verbose    Verbose mode (-v, -vv, -vvv, etc.)

OPTIONS:
    -o, --output <output>    Output directory of html files

ARGS:
    <FILE>...    Rustdoc json input file to process

Generating the json output format currently requires a nightly toolchain.

$ RUSTDOCFLAGS="-Z unstable-options --output-format json" cargo +nightly doc

You should see in the target/doc directory a file called MY_CRATE.json, that's the json rustdoc output. This file will be used by rd to generate the documentation.

$ cargo run -- -v --output html/ --open my_crate.json