Я могу генерировать документы в формате JSON для своей собственной библиотеки.
rustdoc -Z unstable-options --output-format json --out-dir=json_docs src/lib.rs
Однако не удалось найти способ сделать это для всей стандартной библиотеки Rust. Является ли это возможным?
В большинстве случаев вам не нужно генерировать документацию: JSONrustdoc для стандартной библиотеки доступен с помощью компонента ржавчиныrus-docs-json :
rustup component add --toolchain nightly rust-docs-json
Если вам нужно их сгенерировать, клонируйте репозиторий (достаточно --depth=1
) и выполните
python x.py doc library -- --output-format=json
Спасибо! Я ценю ссылку! Кроме того, я получил подсказку, которую вы можете использовать x.py
в репозитории Rust-Land для создания документации JSON, если это необходимо.
@MorganWilde Действительно; если вам действительно нужно сгенерировать документы, достаточно клонировать репозиторий --depth=1
) и выполнить python x.py doc library
.
@cafce25 Я хочу сказать, что вам не нужно создавать документацию, если она у вас есть в наличии. Я могу согласиться, что есть несколько случаев использования, когда можно создавать сами документы, но для большинства случаев достаточно готовых документов, поэтому этот ответ хорош.