Установка

Готовые бинарные файлы

Скачайте файл со страницы релизов:

Положите adoctra в каталог из PATH и проверьте:

adoctra --version

С crates.io

Нужен Rust 1.94 или новее (устанавливается через rustup):

cargo install adoctra-cli     # устанавливает команду `adoctra`

Из исходников

git clone https://github.com/avskor/adoctra
cd adoctra
cargo install --path crates/adoctra-cli

Первая конвертация

Создайте hello.adoc:

= Привет, adoctra
:toc:

== Раздел

Абзац с *жирным* и _курсивным_ текстом.

[source,rust]
----
fn main() {
    println!("Привет");
}
----

Сконвертируйте его:

adoctra -a source-highlighter=rouge hello.adoc   # создаёт hello.html

Откройте hello.html в браузере. Или обойдитесь без установки и вставьте документ в песочницу.

Дополнительные инструменты

Большинству возможностей больше ничего не нужно. Диаграммы запускают собственные программы (dot, mmdc, plantuml, d2, …), если не рисовать их через сервер; см. Диаграммы.